Guide d administration Jahia v6.5

Transcription

1 DOCUMENTATION Guide d administration Jahia v6.5 Jahia, le CMS open source de nouvelle génération apportant à vos projets la convergence applicative (web, document, social, recherche et portail) unifiée par la simplicité d utilisation des outils de gestion de contenu web. Jahia Solutions Group SA 9 route des Jeunes, CH-1227 Les acacias Genève, Suisse

2 Sommaire Introduction à l Administration de Jahia Première partie : Paramètres du Serveur Gestion des Sites Virtuels Création d un site web Supprimer un site Exporter un site Modifier les informations d un site Autres réglages propres aux sites Gérer les utilisateurs Créer un utilisateur Modifier un utilisateur Supprimer un utilisateur Suspendre un utilisateur Créer un lot d utilisateurs par import Configuration des notifications s Gérer les portlets Editer les propriétés du Super Administrateur Statut du serveur et des caches Gestion de la politique des mots de passe Gestion des rôles Création d un nouveau rôle Suppression, copie d un rôle Export / Import des rôles Système de suivi des incidents Documentation A propos de Jahia Seconde partie : Paramètres du site Abordons maintenant chacune des options disponibles pour paramétrer un site Page 2 sur 61

3 2.1 Gérer les groupes Créer un groupe Ajouter et supprimer des utilisateurs Supprimer un groupe Dupliquer un groupe Gérer les langues Utiliser plusieurs langues lors de la navigation sur le site Ajouter une nouvelle langue Supprimer une langue Paramètres HTML Afficher les vanity URL Gestion des templates Vérificateur de liens Comment auditer les liens externes en utilisant le module de vérification des liens Page 3 sur 61

4 Introduction à l Administration de Jahia Jahia propose un module de back office pour répondre aux besoins des administrateurs des sites et de la plateforme dans son ensemble. Ce module est appelé l Administration ou Admin. Center. Le fait d avoir les droits d administration vous donne accès à l Administration - En saisissant directement l adresse de votre serveur Jahia dans un navigateur, suivi de /administration - à partir de votre page personnelle, dans les liens situés en haut à droite de la page - à partir des barres de menu présentes dans certains Modes. Via l Edit mode : Via le studio : Par défaut, après installation et création d un site, Jahia est livré avec : Un utilisateur «root» : C est utilisateur est le «super utilisateur» du système, il a tous les droits sur la totalité du système. Il peut accéder à toutes les fonctionnalités de la plateforme pour tous les sites hébergés. C est un utilisateur système à qui les droits ne peuvent être modifiés, même s il n apparaît pas directement dans les interfaces de gestion des permissions des différents objets de contenu. L utilisateur «root», naturellement, n est pas contraint aux permissions du système, il a tous les droits et ils sont irrévocables. Un groupe Administrateur de site (site-administrators) qui représente les personnes qui auront en charge l administration du site et qui auront les «pleins pouvoirs» sur celui-ci, écriture, participation aux workflows, Ainsi qu un groupe d utilisateurs privilégiés (site-privileged), qui représente les personnes ayant besoin d un accès au workspace default, utilisé notamment en mode edit et contribute. Ceci permet de sécuriser les accès. A noter que si vous attribuer à un Page 4 sur 61

5 utilisateur un rôle qui nécessite d avoir accès au workspace default (rôle éditeur par exemple), celui-ci sera automatiquement ajouté à ce groupe. Pour finir, les administrateurs de sites ou du server ont la possibilité de déléguer des tâches à d autres utilisateurs du système. Par exemple, l administrateur du site pourra donner l accès de la gestion des utilisateurs et groupes à d autres utilisateurs. Bien entendu ces utilisateurs n auront accès qu aux fonctionnalités définies par l administrateur du site et à celle-ci uniquement. La première partie de ce guide traite des fonctions de gestion de la plateforme dans son ensemble, en particulier la création des projets web (sites), des utilisateurs et des rôles. La plupart des fonctions de gestion du serveur sont réservées au compte super administrateur (root) La seconde partie traite des fonctions de gestion disponibles pour chaque projet web créé sur la plateforme. Ces fonctions sont utilisées plus couramment que les fonctions de gestion de la plateforme et sont accessibles aux utilisateurs disposant du rôle «site administrator» Page 5 sur 61

6 1 Première partie : Paramètres du Serveur L onglet Paramètres du serveur est normalement réservé au seul Super Administrateur du fait que les actions et opérations effectuées vont impacter l ensemble des sites mutualisés au sein du même serveur (ou cluster) Jahia. C est donc à partir de cet onglet que l on va pouvoir créer de nouveaux utilisateurs, rajouter des nouveaux portlets ou modifier les rôles disponibles sur la plateforme. C est également depuis cet onglet que l on va pouvoir lister, administrer, créer ou effacer des instances de sites virtuels. De manière similaire à l onglet Paramètres du site, le Super Administrator peut parfaitement déléguer l accès à un ou plusieurs modules disponibles dans cette section à d autres utilisateurs. Cette option de délégation est disponible au sein du menu «Gérer les rôles». Figure 1 : écran d'accueil des Paramètres du Serveur 1.1 Gestion des Sites Virtuels Vous pouvez créer de multiples sites virtuels au sein du même serveur Jahia. Chaque site virtuel possèdera ainsi son propre jeu de pages, de contenu, de fichiers, Page 6 sur 61

7 La notion de «site virtuel» dans Jahia n est cependant pas une mutualisation entière de la plateforme mais signifie plutôt la capacité de créer des «espaces virtuels» distincts. Ainsi chaque site peut disposer de : Son propre domaine (par exemple vous pouvez décider de gérer un premier site sur le domaine: et un second site qui sera disponible sur le domaine les deux tournant en définitive sur le même serveur Jahia). Son propre plan de site avec sa propre arborescence Ses groupes propres (par exemple vous pouvez parfaitement disposer de deux groupes Auteurs distincts dont la composition des membres différents selon le site A ou le site B) Ses propres paramétrages (voir les fonctionnalités décrites dans le chapitre précédant) Cependant chaque site partage avec les autres sites : La même base de données sous-jacente et la même API : Il est ainsi possible d accéder aux objets de contenu disponibles dans les autres sites virtuels. Ceci permet ainsi de facilement réutiliser du contenu identique entre plusieurs sites (ex : des nouvelles qui sont identiques pour chaque département disposant chacun de leur propre site), mais cela peut poser évidemment des problèmes de sécurité en cas de mutualisation complète de la plateforme (ex : deux sociétés distinctes sont hébergées sur le même serveur). Les mêmes sets de templates (du moins pour les sites qui partagent le même set de templates). Les mêmes modules Le même arbre de catégorie Les mêmes utilisateurs (LDAP ou Jahia : il n est ainsi pas possible d avoir deux utilisateurs distinct (ex : John) avec le même identifiant entre deux sites. Les groupes LDAP sont pour leur part, à l instar des utilisateurs LDAP, également commun à tous les sites. Créer un nouveau site virtuel est donc utile lorsque la même société doit gérer plusieurs initiatives web différentes (ex : un site web public, un ou plusieurs extranets et un ou plusieurs intranets départementaux). La notion de sites virtuels permet ainsi de mieux déléguer les rôles, de disposer de vues (sitemap, thèmes, résultats de recherche ) ou d url/domaine différenciés par site tout en conservant des capacités de partage de contenu, d utilisateurs ou de mashups. Page 7 sur 61

8 Figure 2 : Menu principal du module de gestion des sites virtuels Vous pouvez accéder à la liste de tous les sites virtuels existants depuis cette interface. Le site par défaut est celui qui est indiqué par une croix verte. Les opérations nécessaires à la création, modification ou suppression d un site Page 8 sur 61

9 1.1.1 Création d un site web Si aucun site n a encore été créé sur la plateforme (ce qui est peu probable sur un serveur de production, les équipes de développement remettant généralement un environnement prêt à l emploi) Jahia propose par défaut un écran pour créer un nouveau site. Figure 3 : Ecran de création du premier site virtuel Si des sites existent déjà sur la plateforme, une interface légèrement différente par sa disposition, mais proposant les mêmes options est affichée. Figure 4 Ecran de gestion des sites virtuels Page 9 sur 61

10 Trois possibilités sont offertes à l utilisateur qui souhaite créer un site. Nous n aborderons ici que la première dans le détail, la seconde étant plutôt utilisée lorsque l on souhaite se former et la troisième lors d une restauration d un site sauvegardé ou pour le transfert d un site d un serveur vers un autre serveur Créer un nouveau site vide Figure 5 : Création d un nouveau site web : Titre / Domaine / Clef / Description Titre du site : champ purement informatif, c est ce titre qui apparaitra dans diverses interfaces de Jahia pour identifier le site. Cette valeur peut être modifiée ultérieurement. Nom du serveur du site : nom de domaine sur lequel ce site sera accessible. Si le site que vous créez n est pas destiné à de la production immédiate mais doit servir de site de développement ou de test, laissez la valeur localhost dans le champ, cette valeur sera convenablement configurée sur le serveur de production. En cas de doute laissez toujours la valeur localhost et demandez à un administrateur ou un responsable d hébergement. Cette valeur peut être modifiée ultérieurement. Clé du site : nom du nœud racine du site. Ce nom apparaitra dans les urls par défaut, puisque toutes les pages et les contenus du site seront stockés en dessous de celui-ci, aussi est-il recommandé de choisir un titre court et descriptif. Cette valeur ne peut pas être modifiée ultérieurement, aussi est-il important de bien réfléchir avant de définir celle-ci. Page 10 sur 61

11 Description du site : champ purement informatif permettant de décrire un peu plus en détail le site. Cette valeur peut être modifiée ultérieurement. Utiliser comme projet Web par défaut : si cette case est cochée et que la plateforme comporte plusieurs sites, c est vers ce site que seront dirigés les utilisateurs qui appellent le serveur sans préciser le site désiré. Cette valeur peut être modifiée ultérieurement. Ne pas créer d administrateur : aucun compte administrateur pour le site ne sera créé, les utilisateurs disposant de suffisamment de droits (dont le compte ROOT bien sûr) pourront administrer le site. Sur une plateforme multi sites gérée par un webmestre unique, ou plusieurs webmestres intervenant sur tous les sites, cette option est préférable. Créer un nouvel utilisateur : créer un nouveau compte utilisateur disposant de tous les droits sur le site en cours de création. Cette option est utile si le site doit avoir un webmestre spécifique. Si le webmestre dispose utilise le compte ROOT, ou que le compte utilisateur qui va assumer le rôle de webmestre existe déjà (dans Jahia ou dans un annuaire d entreprise) il n est pas utile de créer un nouveau compte. Une fois ces champs d information remplis, cliquez sur «Etape suivante» pour accéder à l écran de choix de des templates et de sélection de la langue par défaut du site. Figure 6 : Création d un nouveau site web : set de templates et langues Page 11 sur 61

12 Veuillez sélectionner un jeu de modèles : liste déroulante permettant de sélectionner le set de templates souhaité ; Si le set de template dispose d une image de prévisualisation, celle-ci sera affichée en dessous de la liste déroulante pour faciliter son identification. Sélectionnez la langue par défaut du site : liste déroulante de choix de la langue et des variantes locales. Pour un site multilingue sélectionnez la langue considérée comme la plus importante, celle vers laquelle les utilisateurs seront redirigés s ils tentent d accéder au site sans préciser la langue souhaitée. Cliquer sur «Etape suivante» L écran suivant récapitule toutes les informations saisies précédemment pour permettre une dernière vérification avant création du site. En cas d erreur, il est possible de revenir au début du processus de création pour modifier ces valeurs. Les informations précédemment rentrées sont mémorisées tant que la session utilisateur est active, ce qui évite d avoir à retaper toutes les informations. Figure 7 : Création d un nouveau site web : récapitulatif Si les informations sont correctes cliquez sur «Créez votre projet Web». Une petite fenêtre flottante apparait pour montrer que des opérations sont en cours et disparaît une fois que la création du site est terminée. Page 12 sur 61

13 Figure 8 : Création en cours d un nouveau site web COMPRENDRE : Pourquoi la création d un site prend-elle un peu de temps? La création d un site, même si celui-ci semble presque vide lors de sa création, est un processus qui implique plus que la création d un simple nœud racine contenant les informations saisies dans les écrans de paramétrage. L essentiel du temps est en fait consacré à copier le set de templates sélectionné sous le nœud racine et à associer toutes les permissions nécessaires. Une fois la création du site terminée, vous êtes redirigé sur l écran de liste des sites, dans laquelle le site nouvellement créé doit apparaître. Figure 9 : écran de gestion des sites virtuels Page 13 sur 61

14 Pour accéder directement au site nouvellement créé, cliquez sur l onglet «Accéder au Mode Edition». Vous êtes alors redirigé sur la première page du site, plus ou moins vide selon le set de templates utilisé, mais prête à être remplie, comme cela est expliqué dans le Guide de l Editeur Utiliser un site préconfiguré : Cette option crée un nouveau site contenant déjà des pages et du contenu (généralement des exemples fournis par Jahia à titre de démonstration) : sélectionner dans la liste déroulante le site d exemple voulu, cliquer sur «Poursuivre». Sur l écran suivant donner un titre au site, le nom de domaine et l identifiant unique du site qui apparaitra dans les URLs par défaut puis cliquer sur Importer. Figure 10 : Création d un site préconfiguré : Titre / Domaine / Clef / Description Importer un site préalablement exporté Cette option permet de sélectionner sur un disque dur un fichier au format zip résultant d un export préalable. L export aura été réalisé via les interfaces d exportation de Jahia (voir plus loin). Un nouveau site sera créé reprenant fidèlement les réglages et le contenu de celui-ci au moment de son export. Page 14 sur 61

15 1.1.2 Supprimer un site Pour supprimer un site unique, cliquez sur l icône rouge en face de son nom. Attention cette action est irréversible, il est fortement conseillé d exporter le site au préalable, par sécurité. Figure 11 : Suppression d un site virtuel Pour supprimer plusieurs sites, utilisez les cases à cocher pour sélectionner ceux désirés puis cliquez sur «Supprimer les sites sélectionnés». Page 15 sur 61

16 Exporter un site L export de site peut répondre à divers besoins : - Sauvegarde : il est possible de réimporter un site exporté tel qu il était. Cependant, cette solution demande une intervention manuelle d un webmaster ou d un administrateur et ne peut en aucun cas être considérée comme une méthode de backup fiable. - Transfert vers un autre serveur : qu il s agisse d effectuer une copie à l identique à un instant T pour travailler sur un autre serveur, faire des tests, servir de base de départ d un nouveau projet. - Transfert d un serveur de développement vers un serveur de production : dans le cas d un projet qui a été réalisé et pré-rempli avec du contenu sur un environnement de développement, il peut être pratique de réaliser un export et une réimportation vers le serveur qui servira à la production. Figure 12 : Suppression d un site virtuel Pour exporter un site unique, cliquer sur l icône la plus à droite en face de son nom Pour exporter plusieurs sites, utilisez les cases à cocher pour sélectionner ceux désirés puis cliquez sur «Exporter les sites sélectionnés». Page 16 sur 61

17 Pour exporter tous les sites, cliquez sur «Exporter tous les sites» Modifier les informations d un site Pour modifier les informations concernant un site, cliquez sur son titre. L écran suivant permet d éditer les champs - Titre - Nom du serveur - Description Autres réglages propres aux sites D autres réglages sont disponible directement en mode édition, dans le Sélecteur, vous pouvez utiliser le menu contextuel (clic-droit) pour éditer le nœud représentant un site Web, afin d accéder à des informations et réglages complémentaires. Plus d informations sont disponibles dans le guide du Webmestre. Figure 13 : Paramètres de site virtuel disponibles directement depuis le Mode Edition Page 17 sur 61

18 1.2 Gérer les utilisateurs Contrairement aux groupes, les utilisateurs sont communs à l ensemble de la plateforme afin de garantir leur unicité et sont donc gérés au niveau des paramètres du serveur Créer un utilisateur Rendez-vous dans la rubrique Gérer les utilisateurs, et cliquez sur «Créer un nouvel utilisateur». Figure 14 : Ecran de gestion des utilisateurs Vous arrivez alors sur l écran de création où vous pouvez saisir les différentes propriétés du nouvel utilisateur : Page 18 sur 61

19 Figure 15 : Formulaire de création d un nouvel utilisateur Modifier un utilisateur Pour modifier un utilisateur, double cliquez simplement sur son nom, vous serez alors redirigé vers un écran similaire à celui de la création d un utilisateur et vous pourrez modifier toutes ses propriétés à l exception bien sûr de son nom d utilisateur Supprimer un utilisateur Sélectionner dans la liste l utilisateur à supprimer en cliquant dessus puis cliquez sur le bouton «Supprimer l utilisateur sélectionné». Page 19 sur 61

20 Figure 16 : Formulaire de création d un nouvel utilisateur Suspendre un utilisateur Il est possible de suspendre un utilisateur c'est-à-dire de rendre son compte inactif, l empêchant ainsi de s authentifier. L avantage de la suspension de compte est de bloquer l utilisateur sans pour autant détruire celui-ci c'està-dire sans pour autant supprimer l ensemble des informations, documents ou contenus stockés dans son répertoire personnel. Pour suspendre un utilisateur vous devez vous rendre dans la fiche détaillée de l utilisateur en double cliquant sur son nom dans la liste (ou en le sélectionnant et en cliquant sur le bouton «Editer / Afficher les Page 20 sur 61

21 propriétés de l utilisateur sélectionné»). Une fois dans sa fiche, vous devez cliquer sur la case «compte bloqué», puis «OK». Figure 17 : Désactivation d un compte utilisateur Page 21 sur 61

22 1.2.5 Créer un lot d utilisateurs par import Des lots d utilisateurs peuvent être chargés dans Jahia par l intermédiaire d un ficher CSV. Celui-ci doit contenir au minimum un nom d utilisateur et mot de passe, mais peut contenir l ensemble des propriétés de l utilisateur. Il est impératif de spécifier les champs référencés dans le CSV en spécifiant un header, comme ceci : j:nodename,j:password,j:firstname,j:lastname steven,steven1234,steven,acme robert, robert1234, Robert, ABME Enfin pensez bien à spécifier le séparateur au moment de l import, ici «,». Figure 18 : Import d utilisateur par lot (CSV) Page 22 sur 61

23 1.3 Configuration des notifications s Depuis ce module vous pouvez modifier les paramètres du serveur qui servira de relai pour l envoi des notifications par . Ces paramètres ont normalement été saisis au préalable lors de l installation du serveur Jahia. Figure 19 : Configuration des s Afin de paramétrer correctement votre serveur mail, entrer tout d abord l adresse de votre serveur SMTP. Vous pourrez ensuite saisir le mail de l administrateur système. Ce dernier recevra les s de notifications en cas d erreurs système. Vous pouvez également déterminer l adresse qui servira de source lors de l envoi des notifications automatiques par le système. Cette adresse doit bien sûr être reconnue et acceptée par le serveur SMTP. Vous pourrez trouver des compléments d informations de paramétrage ci-dessous : 1. "Serveur de messagerie": ce champ contient l adresse SMTP du serveur . Ce champ peut contenir certaines propriétés avancées telles que : - le numéro de port : si ce dernier diffère du port SMTP standard (25) - l utilisateur et son mot de passe : dans le cas où le serveur SMTP requiert une authentification - des propriétés additionnelles : par exemple afin d activer le TLS Page 23 sur 61

24 Le format pour ce champ est le suivant : <utilisateur>:<mot de passe>@<smtp-host>:<smtp-port>[paramètre1=valeur1,paramètre2=valeur2,...] Tous les arguments à l exception de <smtp-host> sont optionnelles. Merci de consulter les exemples d utilisation ci-dessous pour plus de détails. 2. Le champ " à l administrateur" contient une ou plusieurs adresses s séparées par des virgules. Chacun de ces utilisateurs recevra les notifications systèmes (si ces dernières sont activées). 3. Finalement le champ " de" déterminera le nom par défaut utilisé par Jahia pour envoyer les s de notifications. Afin d illustrer différentes configurations possibles, veuillez trouver différents exemples d utilisation cidessous : 1. Le serveur SMTP ne requiert aucune authentification et utilise le port standard 25 : smtp.acme.com 2. Le serveur SMTP requiert une authentification et utilise le port non standard : utilisateur : mot-de-passe-secret@smtp.acme.com: Exemple pour un compte GMail : Le serveur SMTP requiert une authentification et le TLS est activé : acme@gmail.com: 4. Si nécessaire activation des options de debuging avancées afin de voir le détail de la communication avec le serveur SMTP : smtp.acme.com:25[mail.debug=true] Finalement l option concernant le niveau de notification est uniquement utilisée afin d envoyer des s de notification concernant certaines erreurs systèmes. Normalement seuls les administrateurs système de la plateforme sont concernés par cette option (voir ci-dessus pour la liste des récepteurs). La configuration du serveur concerne pour sa part l envoi de tous les s de notification de Jahia (y compris les notifications des workflows par exemple) et ne s arrêtent pas uniquement aux messages d alerte système. Page 24 sur 61

25 1.4 Gérer les portlets L application Jahia supporte nativement la norme JSR168 (Portlet 1.0) et JSR286 (Portlet 2.0). Des portlets génériques peuvent donc être facilement déployés et réutilisés au sein du système Jahia qui peut se substituer à un serveur de portail additionnel. Un portlet est généralement une micro-application web qui peut gérer plusieurs instances. Par exemple un administrateur peut déployer une portlet générique de type «Portlet RSS» servant à lire et afficher un flux RSS. Cette portlet générique peut ainsi être utilisée au sein de plusieurs pages, voire plusieurs sites afin d afficher des flux RSS totalement différents. Chaque flux sera donc traité par Jahia comme une instance de ce portlet. Chaque instance est sauvée et est considérée comme un «mashup» disponible au sein de l application. Ainsi la portlet générique est déployée et gérée directement au sein du centre d administration à partir de ce module. Le Super Administrateur peut ensuite déterminer quels seront les utilisateurs qui auront le droit de créer des nouvelles instances à partir de ce portlet (par ex : des nouveaux flux RSS). Ensuite chacune de ces instances pourra elle-même recevoir des droits d utilisation distincts par utilisateur. Ce mécanisme permet à l administrateur de déterminer qui peut ajouter des nouveaux flux et qui peut les positionner au sein d une page dans un site précis. Ce système ne fait évidement de sens que si l administrateur souhaite contrôler les «instances de mashups» qui auront été générées. Si tel n est pas le souhait, il suffit de rajouter le groupe «utilisateurs» (tous les utilisateurs identifiés) à chacune des portlets et chaque utilisateur sera alors libre de créer le nombre d instances de ce portlet qu il souhaite. Merci de vous référez à la documentation en ligne disponible sur le site afin d apprendre comment développer de nouvelles portlets ou comment déployer un portlet existant au sein de votre environnement de travail Jahia. Page 25 sur 61

26 Figure 20 : Gérer des portlets De manière similaire au menu concernant la gestion des sites virtuels, vous trouverez dans le menu des portlets une liste de tous les portlets déjà déployés dans la partie supérieure de l interface principale. Vous pouvez cliquer sur les opérations et actions disponibles à côté de chaque portlet afin d obtenir des détails, de modifier leurs permissions d accès ou d accéder à la liste de leur utilisation. Afin de déployer un portlet dans le serveur d application Tomcat livré par défaut avec Jahia, un développeur aura besoin de réaliser une légère modification dans un fichier de configuration fourni avec le portlet. Cette manipulation est décrite dans l écran affiché après avoir cliqué sur le bouton d aide. Cette modification peut également être automatiquement réalisée en cliquant sur «Préparer» ou «Préparer et Déployer la portlet». Page 26 sur 61

27 Figure 21 : Ecran de déploiement d une nouvelle portlet Si vous utilisez un autre serveur d application que Tomcat, vous devez effectuer de manière manuelle cette opération et déployer vos portlets tels que précisés dans la documentation de votre serveur d application. 1.5 Editer les propriétés du Super Administrateur En tant que Super Administrateur vous pouvez bien entendu modifier à n importe quel moment vos propriétés personnelles (nom, mot de passe, , ). Figure 22 : Propriétés du Super Administrateur Mettez simplement à jour les informations nécessaires et cliquez sur le bouton OK. Page 27 sur 61

28 1.6 Statut du serveur et des caches Ce module permet de renseigner le Super Administrateur sur les différents paramètres systèmes disponible depuis son serveur Jahia ainsi que de vérifier (voire purger) les différents niveaux de caches gérés par l application. Tout d abord en haut à droite, l administrateur peut exporter un «full status» de son serveur avec toutes les informations techniques qui peuvent être utile au support (thread dump, cache status, paramètres systèmes, ). Ensuite, le premier onglet concerne les caches, on peut y purger l ensemble des caches Jahia (back end + front end) ou uniquement les caches HTML (front end), ou encore consulter l efficacité des différents caches). On peut d ailleurs choisir ou non d activer les statistiques. Page 28 sur 61

29 Figure 23 : Liste et statut des caches gérés par Jahia On peut également superviser la mémoire maximum autorisée, utilisée ou libre grâce à l onglet mémoire. Il est possible, depuis cet onglet - de déclencher le garbage collector pour purger la mémoire utilisée (attention, les conséquences d une purge de mémoire forcée sur un site en production ne sont pas anodins en terme de performances, seuls des administrateurs maitrisant bien les principes de fonctionnement des serveurs d application et des JVM devraient utiliser cette option) - de générer un thread dump pour analyser les threads en cours d exécution. Un Thread Dump Analyzer est également disponible depuis cet onglet. Page 29 sur 61

30 Figure 24 : Onglet mémoire Enfin le dernier onglet concerne les informations système, et rassemble les informations relative au système et à l environnement dans lequel évolue Jahia (OS / JVM / Path d installation / Base de données / ). Figure 25 : Informations système Page 30 sur 61

31 1.7 Gestion de la politique des mots de passe Le module de gestion de politique de mot de passe a pour objectif de fixer les règles servant à sécuriser les identifiants des utilisateurs. Des paramètres tels la taille minimale pour les mots de passe, l intégration de certains caractères spéciaux, l obligation de changer de mots de passe après un certain délai, etc peuvent être ajustés depuis ce menu. Figure 26 : Gestion de la politique des mots de passe Il est important de mentionner que cette politique de sécurisation des mots de passe ne concerne que les utilisateurs Jahia et non pas les utilisateurs LDAP ou Active Directory qui sont directement gérés et soumis aux règles édictés par ces serveurs distants. Page 31 sur 61

32 1.8 Gestion des rôles Le système de gestion des habilitations (accès à certaines pages, droit d écriture, possibilité d utiliser certains outils, etc.) repose sur des permissions groupées entre elles pour former un rôle. Figure 27 : Gestion des rôles En standard, Jahia fourni des permissions relatives aux «repository», c'est-à-dire à la lecture / écriture dans les workspace live ou default (edit), des permissions permettant de restreindre l accès aux managers ou encore des permissions pour gérer l accès aux différents modes contribute / edit / studio. Néanmoins, chaque module déployé dans Jahia peut venir ajouter ses propres permissions, pour effectuer ses propres contrôles d accès. C est par exemple le cas du blog ou des commentaires, qui définissent des permissions permettant de créer des commentaires ou des entrées de blog directement en live. Enfin, certaines opérations dans Jahia vont venir générer automatiquement des permissions, tel que le déploiement de Page 32 sur 61

33 portlet, ou le déploiement template, ce qui va permette de gérer l utilisation de ces éléments au sein du système. Le couplage de plusieurs permissions va permettre de définir un rôle. Par exemple un rôle de traducteur, devra avoir la permission d accès à l édit mode, la permission de modifier du contenu en mode edit dans une langue donnée, mais pas celle d en créer! Un rôle de publicateur, qui doit valider le contenu, aura lui la permission «publish», et la permission lecture du mode edit, mais pas écriture car il n est là que pour valider! ect Libre à vous de créer vos propres rôles pour répondre à vos besoins. Par exemple un rôle «blogueur». Ces rôles pourront ensuite être associés à des groupes d utilisateurs ou à des utilisateurs pour tout ou partie d un site directement via l édit mode Création d un nouveau rôle Cliquer sur le bouton en haut à gauche pour créer un nouveau rôle. Une fenêtre de saisie apparait alors et vous pouvez y saisir le nom «technique» du rôle. Page 33 sur 61

34 Figure 28 : Création d un nouveau rôle Une fois que vous avez cliquez sur OK, la liste des rôles est mise à jour et on peut alors sélectionner le rôle en question pour l éditer via un simple click : Page 34 sur 61

35 Figure 29 : Edition d un nouveau rôle On peut alors ajouter un titre, correspondant au rôle qui est internationalisable. On peut également ajouter une description du rôle encore une fois de façon internationale avec une valeur par langue. Enfin on va pouvoir définir quel type de nœud est concerné par ce rôle (une page, un site, un type de composant en particulier) ainsi que le fait que le rôle soit un rôle privilégié ou non. Figure 30 : Edition d un nouveau rôle - Suite Page 35 sur 61

36 Si le rôle que vous créez nécessite d accéder en lecture au workspace default (c'est-à-dire lire du contenu via le Mode Contribution, le Mode Edition ou le Studio) vous devez cocher la case «j_privilegedaccess». Lorsque cette case est cochée, tout utilisateur qui sera associé à ce rôle sera automatiquement placé dans le groupe «site-priviliged», ce qui lui permettra d accéder au workspace default en lecture. Une fois la partie contenu correctement configuré, il faut se rendre sur l onglet permissions pour sélectionner les permissions que l on veut associer à ce rôle : Figure 31 : Edition d un nouveau rôle ajout des permissions Page 36 sur 61

37 Les permissions sont regroupées par «rubrique». Si l on coche directement la rubrique, alors l ensemble des sous permissions sont sélectionnées : Figure 32 : Sélection d un groupe de permissions Les différents groupes de permissions sont : actions (possibilité de participer à un blog, de commenter, ) admin (paramétrage des accès aux différents items de l administration) contributemode (paramètres d accès au contribute mode) editmode (paramètres d accès à l édit mode et personnalisation du mode edit) job (paramètrage de la gestion des background jobs) managers (accès aux managers : catégories, tags, document, repository, ) repository-permissions (droits de lecture / écriture / modifcation sur les worspace live et default) studiomode (droits d accès et personnalisation du studio) templates (droits d utilisation des templates mis à disposition sur la plateforme) webapps (droits d utilisation des portlets ou webapps déployées sur le système) wokflow-tasks (paramétrage des étapes de workflow accessible avec le rôle) wysiwyg-editor-toolbar (paramétrage du type d éditeur FCK associé à ce rôle) Page 37 sur 61

38 1.8.2 Suppression, copie d un rôle Les opérations usuelles de suppression ou de copie d un rôle sont disponibles dans l interface de gestion. Pour les utiliser sélectionner le rôle avec lequel vous voulez interagir via un simple clic, puis cliquer sur l icône de l action de votre choix : Figure 33 : Sélection d un groupe de permissions Export / Import des rôles Afin de vous éviter d avoir à reconfigurer les rôles sur l ensemble des serveurs, ceux-ci sont exportables au format XML ou ZIP. Vous pouvez ainsi les réimporter à souhait sur d autres serveurs. Pour cela utilisez les deux icones prévues à cet effet dans le panneau de gestion des rôles. Page 38 sur 61

39 1.9 Système de suivi des incidents Ce raccourci vous redirige directement vers le système de gestion des tickets des incidents disponible en ligne. Une connexion internet est donc nécessaire. Deux systèmes de gestion des incidents coexistent : Le système gratuit mis à disposition de la communauté Jahia. Le système commercial uniquement à disposition des clients avec un contrat de support valide Le système communautaire a également pour objectif d enregistrer et de suivre les différentes propositions d amélioration. Donc n hésitez pas à suggérer des propositions ou des idées afin d améliorer l application. Comme ces tickets sont disponibles publiquement, merci de ne pas faire mention de vos paramètres propres à votre environnement ou d autres données confidentielles. Le système de suivi des tickets commercial est uniquement disponible pour les clients. Chaque client dispose de son environnement distinct et sécurisé uniquement disponible via une accréditation spécifique. Tous les tickets de bugs traités par ce système le sont par des employés de Jahia Solutions Group sous le couvert des règles classiques de confidentialité. Les tickets ne sont donc pas partagés entre les clients et chaque client dispose d un temps minium ainsi que d une obligation de réponse de la part de l éditeur Documentation Ce lien vous redirige vers l espace de documentation. De manière similaire au système de gestion des incidents, la documentation Jahia est séparée en deux parties : la documentation gratuite et communautaire disponible sur le site jahia.org. la documentation commerciale uniquement disponible pour les clients des versions payantes qui est disponible dans l espace Extranet client. Page 39 sur 61

40 1.11 A propos de Jahia Finalement le module: A Propos de Jahia résume l ensemble des fonctionnalités disponibles dans le cadre de votre clé de licence actuelle (nombre d utilisateurs, contraintes sur certains modules, expiration des versions d essais, ). Figure 34 : A propos de Jahia Dans cette section vous trouverez également le numéro de version de l applicatif. Ce numéro apparaît normalement également en bas de chaque écran d édition. Ce numéro doit être mentionné dans chaque report d incident afin de simplifier la résolution de ce dernier par l équipe de support. Page 40 sur 61

41 2 Seconde partie : Paramètres du site L interface d administration se présente comme ci-dessous en tant qu administrateur de site : Figure 35: Ecran d'accueil de gestion d'un site virtuel Cet écran propose tous les outils nécessaires à l administration d un site hébergé sur la plate-forme Jahia. Dans la mesure où l administrateur de site à les droits d administration sur d autres sites virtuels hébergés sur le système, il peut via une liste déroulante accéder à chacun des autres sites virtuels et gérer celui-ci avec les mêmes options. Figure 36: Un administrateur de site gérant plusieurs sites virtuels. Un administrateur de site peut accéder aux «Paramètres du serveur» mais seules certaines options seront disponibles, les autres étant grisées car réservées à des administrateurs ayant des droits plus élevés. En cliquant sur «Accéder au Mode Edition», l administrateur du site sera redirigé vers la page d accueil du site couramment sélectionné. Page 41 sur 61

42 Un utilisateur avancé ayant certains droits d administration pourra accéder aux options sur lesquelles des droits lui ont été conférés, les autres choix étant grisés. Dans l exemple ci-dessous, l utilisateur avancé ne pourra accéder qu à la gestion des utilisateurs et groupes. Figure 37: Paramètres du site pour un utilisateur avancé avec droits limités Abordons maintenant chacune des options disponibles pour paramétrer un site. Page 42 sur 61

43 2.1 Gérer les groupes La gestion des groupes est réalisée dans l interface d Administration, à partir de l onglet «Paramètres du site», en effet, si les utilisateurs sont globaux sur la plateforme afin de garantir leur unicité, chaque site possède son propre jeu de groupes qui peut être différent des groupes d un autre site. Figure 38 : interface de gestion des groupes Page 43 sur 61

44 2.1.1 Créer un groupe Cliquer sur le bouton «Créer un nouveau groupe» puis dans l interface saisissez un nom pour celui-ci. Figure 39 : créer un groupe Une fois la création validée, la liste des groupes se réaffiche, mise à jour. Figure 40: écran principal après création d'un nouveau groupe Lors de sa création un nouveau groupe est vide Page 44 sur 61

45 2.1.2 Ajouter et supprimer des utilisateurs Dans la liste des groupes, faites un double-clic sur le groupe souhaité ou sélectionnez ce groupe et cliquez sur le bouton «Editer le groupe sélectionné». Figure 41 : sélection d un groupe Page 45 sur 61

46 Figure 42 : Ecran d ajout d utilisateurs dans un groupe donné Pour ajouter des utilisateurs dans le groupe cliquez sur «Ajouter des membres». Une fenêtre flottante apparaît listant la totalité des utilisateurs enregistrés sur la plateforme, par ordre alphabétique. Si votre plateforme comporte de nombreux utilisateurs, un champ de recherche placé de haut de la fenêtre permet de saisir un nom ou une partie d un nom. Page 46 sur 61

47 Figure 43 : Liste des utilisateurs de la plateforme pouvant être ajouté au groupe Pour ajouter un utilisateur unique, sélectionnez celui-ci dans la liste puis cliquez sur le bouton «Ajouter». La fenêtre flottante se ferme pour afficher la liste des utilisateurs du groupe mise à jour. Pour ajouter plusieurs utilisateurs, sélectionnez ceux-ci avec un CTRL-clic puis cliquez sur «Ajouter», ou double-cliquez sur chacun des utilisateurs souhaités puis fermez la fenêtre en cliquant sur la croix rouge en haut à droite de la fenêtre. (note : l ajout d utilisateurs via double-clic est réalisé instantanément, de ce fait, même en cliquant sur le bouton «Annuler» les utilisateurs ajoutés de la sorte seront bel et bien ajoutés dans le groupe même en fermant la fenêtre via le bouton «Annuler»). Une fois la fenêtre de sélection d utilisateurs fermée, la liste des membres du groupe apparaît mise à jour. Page 47 sur 61

48 Figure 44 : Ecran de gestion des utilisateurs du groupe Pour retirer un utilisateur d un groupe, sélectionnez-le (ou les via ctrl+click) dans la liste et cliquez sur «Supprimer ces membres». Notez que cette action ne supprime pas l utilisateur de la plateforme, il retire juste celui-ci des membres du groupe. Page 48 sur 61

49 2.1.3 Supprimer un groupe Dans la liste des groupes, sélectionnez le groupe à supprimer en cliquant dessus puis cliquez sur le bouton «Supprimer le groupe sélectionné». Figure 45 : Suppression d un groupe Page 49 sur 61

50 2.1.4 Dupliquer un groupe Si vous avez besoin de définir un nouveau groupe dont les membres sont très proches de ceux existant d ores et déjà dans un autre groupe, vous pouvez dupliquer celui-ci en le sélectionnant et en cliquant sur «Copier le groupe sélectionné». Jahia vous demande alors de saisir un nom pour le nouveau groupe qui sera créé. Il ne vous reste plus qu à retirer les membres excédentaires ou ajouter les membres manquants dans ce nouveau groupe, mais sans avoir à refaire toutes les inscriptions manuellement. Figure 46 : Duplication d un groupe Page 50 sur 61

51 2.2 Gérer les langues Ce menu vous permet de gérer les paramètres concernant les langues du site courant. La partie haute de l interface affiche les langues déjà déclarées comme actives pour le site. Vous pouvez choisir si la langue est obligatoire et si c est celle par défaut (une seule possible). Figure 47 : Gérer les langages L ordre des langues déclarées ici est sans incidence aucune. Si un visiteur appelle une page dans une langue sépcifiée via l url, par exemple Jahia lui retournera la page demandée. Si le visiteur appelle une page sans spécifier de version de langue, par exemple Jahia se basera sur les préférences de langue déclarées au niveau du navigateur, puis la langue du navigateur lui-même pour servir la langue appropriée. Si Jahia ne parvient pas à trouver de Page 51 sur 61

52 correspondance entre les préférences de l utilisateur, la langue de son navigateur et les langues dans lequel le site est disponible, Jahia servira la page dans la langue par défaut spécifiée dans cette interface Utiliser plusieurs langues lors de la navigation sur le site Pour des besoins intranet ou extranet, vous pourriez avoir besoin d afficher du contenu indépendamment de la langue du navigateur de l utilisateur. Dans le cas, par exemple, où vous ne voudriez pas de pages vides dans certaines langues sachant que tout le site n a pas été entièrement traduit ou disponible dans toutes les langues, vous pouvez alors activer l option de mixité des langues (Utiliser plusieurs langues lors de la navigation). Si cette option est activée et que l objet de contenu n existe pas dans la langue courante, Jahia affichera le contenu dans la langue par défaut. Si l anglais est la langue par défaut et que certains contenus ne sont pas traduits en français, ceux-ci pourraient alors être remplacés automatiquement par de l anglais. L utilisation de cette option n est pas recommandée sur des sites ouverts au public car le résultat peut dérouter des utilisateurs non avertis, elle peut être envisagée sur des sites de type intranet si les personnes sont au fait de ce choix et ne sont donc pas susceptibles d être déroutées par des contenus en deux langues sur une même page Ajouter une nouvelle langue Pour ajouter une ou plusieurs langues à un site virtuel, il faut sélectionner les langues désirées et cliquer sur le bouton «ajouter des langues» pour les ajouter à la liste des langues disponibles. Figure 48 : ajouter des langues Page 52 sur 61

53 Vous remarquerez que certaines langues sont listées plusieurs fois. En effet la liste est basée sur les langues locales (langue de la région), les langues disponibles sont en fait une combinaison entre une langue et sa région. Jahia peut identifier ces langues locales en provenance des préférences du navigateur et saura réagir différemment suivant la langue détectée (fr_ca ou fr_fr par exemple). Vous pourriez avoir 2 sites distincts avec du contenu différent pour des français et canadiens. Si vous préférez gérer le français de manière générique, il faudra alors choisir la langue française FR. Si vous n avez pas l intention d avoir du contenu spécifique à un pays ou à une région (comme fr_ca ou fr_fr), vous devriez utiliser systématiquement la langue locale générique pour la langue spécifiée. La liste des langues et langues locales disponibles proviennent directement de la Machine Virtuelle Java (JVM) utilisée. Chaque JVM supporte des langages différents. Les langues officielles ISO peuvent ne pas être présentes suivant la JVM utilisée. Dans ce cas, vous pouvez utiliser une autre langue que vous n utiliserez jamais (comme langue disponible sur le site) et modifier l icône de la langue (drapeau) sur le disque ou le template. Jahia ne pourra pas automatiquement reconnaitre cette langue à des fins de redirection pour les utilisateurs, cependant ils pourront naviguer entre les différentes langues à partir de la page d accueil Supprimer une langue Pour supprimer une langue, il suffit de coche la check box dans la colonne supprimer et de cliquer sur Sauver en bas de page. Page 53 sur 61

54 Figure 49 : Supprimer des langues Supprimer une langue sur un site n implique pas de supprimer les contenus traduits dans cette langue. Si vous rajoutez la langue après coup, les contenus déjà traduits au préalable réapparaitront. Page 54 sur 61

55 2.3 Paramètres HTML Lors de l édition d un site, les contributeurs utilisent souvent un éditeur HTML riche. Du fait que les contributeurs aient la possibilité d utiliser directement des balises HTML ou de copier/coller du contenu HTML, cela peut mener à des incohérences vis-à-vis des normes W3C, ou déformer le rendu de la page. Ils peuvent par exemple oublier de fermer une balise, déformer une page en incluant un large tableau, etc. Jahia offre la possibilité de vérifier la conformité du code généré grâce à l option Conformité WCAG. Vous avez également la possibilité d empêcher l usage de certaines balises HTML dans les zones HTML riches. Vous devrez spécifier dans l option «filtrage des balises», la liste des champs non autorisés dans l éditeur HTML, séparés d une virgule. A la sauvegarde du contenu, Jahia extraira automatiquement les balises du contenu. Exemple de filtrage : H1,script,table,tr,td,strong,hr Figure 50 : Paramètres HTML Page 55 sur 61

56 2.4 Afficher les vanity URL Cette rubrique de l administration permet d afficher un tableau de bord de l ensemble des vanity URL (URL explicites, optimisées pour le référencement) définies sur la plateforme. Pour chacune d entre elle, différentes informations sont affichées dont l url «technique» la langue, le statut, et le fait qu elle soit l url par défaut ou non. Figure 51 : Tableau de bord des vanity urls Vous pouvez accéder à la page concernée par la vanity URL en cliquant sur le lien. Page 56 sur 61

57 2.5 Gestion des templates Cette rubrique permet de forcer la mise à jour des templates du site en cliquant sur le bouton deploy templates. Figure 52 : bouton de déploiement des templates 2.6 Vérificateur de liens Le vérificateur de liens est un puissant outil d administration permettant aux administrateurs du site de vérifier la validité des liens externes dans un site web complet fonctionnant sous Jahia. Par lien externe, on entend des liens qui pointent vers des pages hors de la plateforme, donc hors du périmètre de Jahia. Par définition est lien externe est susceptible de poser des problèmes et d être «cassé» : que les éditeurs aient mal tapé le lien désiré (goggle.com au lieu de google.com) ou simplement que la page visée par le lien disparaisse avec le temps, change de nom ou d emplacement. Le but du module de vérification des liens est de parcourir toutes les pages Jahia à la recherche de liens externes saisis par les auteurs. Il affiche ensuite un rapport qui aide l administrateur du site à corriger les liens cassés. Le module passe sur toutes les pages dans la langue et le mode sélectionné. Figure 53 : barre de menu du module de vérification de liens externes Page 57 sur 61

58 Pour lancer le scan, il suffit de cliquer sur «Start checking». Puis de cliquer sur «Display progress» pour voir les résultats. Le «Display progress with auto refresh» permet de rafraichir la page automatiquement. «Clean stored results» permet de vider les résultats avant de relancer un scan. Attention, le vérificateur des liens est un outil qui sollicite fortement le serveur, son usage ponctuel contribue à maintenir la qualité éditoriale du site, mais il n est pas recommandé d utiliser celui-ci en continu Comment auditer les liens externes en utilisant le module de vérification des liens Cas d utilisation Dans le site de demo ACME, sur la page Accueil, l auteur saisit un texte et y insère par erreur, un mauvais lien vers au lieu de Le lien est donc un lien «mort» qui pointe vers un site n existant pas. Le lien est embarqué dans un paragraphe (de type Big Text) saisit à l aide de l éditeur de texte riche fourni par Jahia Comment lancer une analyse du site web Pour procéder à un audit de vérification des liens et détecter puis réparer les liens cassés, l administrateur du site peut cliquer sur le bouton Start checking dans le module de vérification des liens : Figure 54 : démarrer la vérification Le temps nécessaire à la réalisation de l audit dépend du volume de données à analyser. Dès que l administrateur du site lance le processus de vérification des liens, un statut d activité sera disponible en bas de module après avoir cliqué sur «Display progress». L affichage ressemblera à ca: Page 58 sur 61

59 Figure 55 : Rapport d analyse des liens cassés A noter que le tableau contient uniquement les liens cassés. Les liens valides ne sont pas affichés dans le rapport Description du rapport de vérification des liens Le rapport de vérification des liens contient 5 colonnes : Figure 56 : Rapport d analyse des liens cassés Chemin : chemin du nœud qui contient le lien cassé Propriété : propriété dans le nœud concerné qui contient le lien cassé Lien : lien qui pose problème Status : cause du problème Code : code d erreur http Remarque : la console de Tomcat affiche le chemin du nœud traité, ainsi que le code HTML associé et les tentatives de connexions aux liens qui en découlent. Page 59 sur 61