Guide d'administration BRMS

Procédure 2.1. Installer le package autonome

1. Download

   Télécharger le fichier compressé autonome du portail client Red Hat à partir de https://access.redhat.com. Naviguez dans Downloads, puis Plateforme BRMS, puis, sélectionner la version. La version actuelle est 5.2.0. Toutes les instructions ci-dessous utilisent les noms de package de 5.2.0, mais appliquent également des versions antérieures parfois.

2. Extrait

   Le package autonome contient un seul répertoire contenant l'installation de la plate-forme Web de JBoss Enterprise avec l'application web JBoss Enterprise BRMS Platform déjà déployées. Extrayez le contenu du fichier zip dans le répertoire où il sera installé.

   [localhost ]$ unzip brms-standalone-5.2.0.zip

   Copy to Clipboard Toggle word wrap
   JBoss Enterprise BRMS Platform est déployée à la fois dans les profils de serveur production et par défaut : brms-standalone-5.2.0/jboss-as-web/server/PROFILE/deploy/jboss-brms.war/

   Note

   Ce guide utilise PROFILE dans un chemin d'accès de répertoire, comme ci-dessus, pour indiquer les profils production ou par défaut.

3. Autoriser les utilisateurs

   La configuration par défaut utilise le profil d'applications JAAS brms. Ce profil stocke des noms d'utilisateurs et des mots de passe dans le fichier PROFILE/conf/props/brms-users.properties.
   On ajoute des utilisateurs par des entrées au fichier sous le format nom d'utilisateur=mot de passe. On peut commenter les entrées en ajoutant le caractère de hachage (#) en début de ligne.

   #admin=password
   jsmith=s@r@hSm1th
   tandrews=pp3rrss0nn3ll

   Copy to Clipboard Toggle word wrap
   Consulter Section 6.1, « Authentification » pour obtenir des détails sur la façon de changer le profil JAAS qui supporte un système d'authentification comme LDAP.

4. OPTION : Installer le référentiel de ModeShape

   ModeShape est un JRC (Java Content Repository / Référentiel de contenu Java) qui peut être utilisé à la place de Apache Jackrabbit. Consulter Section 2.2.3, «  Installer et activer ModeShape » pour obtenir davantage d'informations.

   Note

   Modeshape est un aperçu technologique dans BRMS 5.2.

5. OPTION : Activation de Rule Package Signing (signature des règles de package).

   La fonctionnalité Rule Signing Package utilise la cryptographie de clés publiques pour veiller à ce que les packages ne soient pas corrompus ou falsifiés au cours du téléchargement. Red Hat recommande que cette fonctionnalité soit activée dans un environnement de production.
   Consulter Section 6.3, «  Rule Package Signing » pour étudier ce sujet.

6. Configuration de la base de données

   Les configurations par défaut utilisent des bases de données qui ne sont ni adaptées, ni prises en charge pour des environnements de production. Avant de déployer dans un environnement de production, cette configuration doit être changée en un serveur de base de données pris en charge.
   Consulter Chapitre 4, Configuration de la base de données.

7. Démarrer le serveur

   Pour lancer le serveur à partir de la ligne de commande, utiliser la commande run.sh sur un système UNIX ou Linux, ou run.bat sur un système Microsoft Windows. Le paramètre -c doit être utilisé pour indiquer quel profil de serveur utiliser.

   [localhost ]$ ./run.sh -c production

   Copy to Clipboard Toggle word wrap
   Les scripts run.sh et run.bat sont situés dans le répertoire bin.
   Ainsi, le chemin d'accès au répertoire bin du serveur autonome BRMS 5.2.0 est brms-standalone-5.2.0/jboss-as-web/bin/.
   Consulter la documentation de JBoss Enterprise Web Platform 5 pour obtenir des informations sur les paramètres supplémentaires de lancement du serveur, http://docs.redhat.com/docs/en-US/JBoss_Enterprise_Web_Platform/.

8. Test de connexion

   Connectez-vous à l'application web JBoss Enterprise BRMS Platform pour confirmer qu'elle est installée et qu'elle exécute correctement. Voir Section 2.3, «  Première connexion » pour plus de détails.

Procédure 2.2. Installer Deployable Package (package déployable)

1. Download

   Télécharger le fichier zip de Deployable Package à partir du portail à la Clientèle de Red Hat à l'adresse suivant: https://access.redhat.com. Naviguez dans Downloads, puis BRMS Platform, et sélectionner la version. La version courante est 5.2.0. Toutes les instructions ci-dessous utilisent les noms de package de 5.2.0, mais s'appliquent également aux versions précédentes si noté.

2. Extraire le logiciel

   Extraire les fichiers de déploiement BRMS du package zip.

   [localhost ]$ unzip brms-deployable-5.2.0.zip

   Copy to Clipboard Toggle word wrap
   Cela va créer les fichiers suivants :
   • jboss-brms.engine.zip
   • jboss-brms.manager.zip
   • modeshape.zip

     Note

     modeshape.zip n'est inclus dans le package déployable de BRMS 5.2 qu'en tant qu'aperçu technologique.
   Extraire jboss-brms.war de jboss-brms-manager.zip.

   [localhost ]$ unzip brms-manager.zip

   Copy to Clipboard Toggle word wrap
   Cela va créer un répertoire jboss-brms.war qui contient l'application web JBoss Enterprise BRMS Platform sous forme d'archive explosée.
   Extraire les bibliothèques client de jboss-brms-engine.zip dans un répertoire.

   [localhost ]$ unzip brms-engine.zip -d client

   Copy to Clipboard Toggle word wrap
   Cela crée un répertoire qui contient les fichiers jar de bibliothèques client.

3. Copier dans le serveur d'applications.

   Copier l'archive d'applications web explosées dans le répertoire de déploiement de votre serveur d'applications. Veillez à ce que le nom de fichier de l'archive d'applications web explosée soit jboss-brms.war. L'exemple ci-dessous démontre que cette opération est effectuée au niveau ligne de commande sur Linux.

   [localhost ]$ cp -rf ~/temp/jboss-brms.war /opt/brms-server/jboss-as/server/production/deploy/

   Copy to Clipboard Toggle word wrap
   L'application ne sera pas déployée tant que le serveur d'applications n'est pas lancé.
   Copier les fichiers jar du répertoire clients créé dans l'étape précédente dans le serveur d'applications selon les besoins. Veuillez consulter la documentation sur le serveur d'applications pour obtenir davantage d'informations.

4. Autoriser les utilisateurs

   La configuration d'authentification par défaut utilise le profil JAAS jmx-console. En cas de déploiement dans un serveur d'applications existant, il est possible que ce profil ait déjà été modifié. Dans ce cas, consulter la documentation sur les serveurs d'applications pour obtenir des instructions sur la façon d'ajouter de nouveaux utilisateurs.

   Note

   Tout utilisateur défini dans le serveur d'applications sera en mesure de se connecter à l'installation de JBoss Enterprise BRMS Platform.
   Red Hat recommande qu'un système d'autentification séparé soit utilisé pour les utilisateurs de JBoss Enterprise BRMS Platform. Voir Section 6.1, « Authentification » pour savoir comment modifier le profil JAAS.
   La configuration par défaut du profil de la jmx-console pour les produits JBoss Platform utilise le module de connexion UsersRolesLoginModule pour stocker les noms d'utilisateurs et les mots de passe dans le fichier PROFILE/conf/props/jmx-console-users.properties.
   On peut ajouter des utilisateurs en ajoutant des entrées à ce fichier sous le format suivant nom d'utilisateur=mot de passe. On peut commenter les entrées en ajoutant le caractère de hachage (#) en début de ligne.

   #admin=sekretz
   jsmith=s@r@hSm1th
   tandrews=p3r50n311

   Copy to Clipboard Toggle word wrap

   Note

   Ce guide utilise PROFILE dans un chemin d'accès de répertoire, comme ci-dessus, pour indiquer les profils production ou par défaut.

5. OPTION : Activation de Rule Package Signing (signature des règles de package).

   La fonctionnalité Rule Signing Package utilise la cryptographie de clés publiques pour veiller à ce que les packages ne soient pas corrompus ou falsifiés au cours du téléchargement. Red Hat recommande que cette fonctionnalité soit activée dans un environnement de production.
   Consulter Section 6.3, «  Rule Package Signing » pour étudier ce sujet.

6. Configuration de la base de données

   Les configurations par défaut utilisent des bases de données qui ne sont ni adaptées, ni prises en charge pour des environnements de production. Avant de déployer dans un environnement de production, cette configuration doit être changée pour un serveur de base de données pris en charge.
   Consulter Chapitre 4, Configuration de la base de données.

7. Démarrer le serveur

   Pour lancer le serveur à partir de la ligne de commande, utiliser la commande run.sh sur un sytème UNIX, ou bien exécuter run.bat sur un système Microsoft Windows. Le paramètre -c doit être utilisé pour spécifier quel profil de serveur utiliser.

   [localhost ]$ ./run.sh -c production

   Copy to Clipboard Toggle word wrap
   Les scripts run.sh et run.bat sont situés dans le répertoire bin.
   Ainsi, le chemin d'accès au répertoire bin du serveur autonome BRMS 5.2.0 est brms-standalone-5.2.0/jboss-as-web/bin/.
   Consulter la documentation de JBoss Enterprise Web Platform 5 pour obtenir des informations sur les paramètres supplémentaires de lancement du serveur, http://docs.redhat.com/docs/en-US/JBoss_Enterprise_Web_Platform/.

8. Connexion

   Connectez-vous à l'application web JBoss Enterprise BRMS Platform pour confirmer qu'elle est installée et qu'elle exécute correctement. Voir Section 2.3, «  Première connexion » pour plus de détails.

Procédure 2.3. Configuration de ModeShape

1. Téléchargement et Extraction

   Note

   Cette étape est utile uniquement pour 5.1.0. Le package autonome 5.2.0 est fourni avec ModeShape.
   Télécharger le package ModeShape package (modeshape.zip) du portail Red Hat Support Portal à partir de https://access.redhat.com
   Extraire le répertoire modeshape du fichier ZIP du package, et le mettre dans le répertoire d'installation BRMS. Pour la version autonome de JBoss Enterprise BRMS Platform, il s'agit de brms-standalone-5.1.0.

   [localhost ]$ unzip modeshape.zip

   Copy to Clipboard Toggle word wrap
   Après l'extraction, le répertoire aura la structure suivante :

   - brms-standalone-5.2.0
       |- jboss-as-web
       |- mod_cluster
       |- modeshape
       |- picketlink
       |- resteasy
       `- seam

   Copy to Clipboard Toggle word wrap

2. Exécuter l'installateur

   Note

   Vous aurez besoin des étapes suivantes pour 5.1.0 et 5.2.0, et ces instructions feront référence à 5.2.0 à partir de ce point.
   Pour installer ModeShape dans le profil de serveur qui convient, utiliser la ligne de commande pour exécuter ant, et quand vous y serez invité, indiquer le profil du serveur où ModeShape sera installé.

   [localhost modeshape]$ ant
   Buildfile: /opt/BRMS/5.1.0/brms-standalone-5.1.0/modeshape/build.xml
   
   determine_home:
   
   set-web-home:
   
   set-as-home:
   
   set-soa-home:
   
   init:
        [echo] JBoss Home is ../jboss-as-web
   
   prompt:
       [input] Enter profile to install ModeShape to:  [default]
   
   

   Copy to Clipboard Toggle word wrap
   Le script installe tous les services de ModeShape dans le profil de serveur spécifié.

3. Utilisateurs et rôles pour l'installation

   Ajouter les comptes d'utilisateur admin et mailman, et leur assigner les rôles indiqués ci-dessous. La configuration par défaut utilise des fichiers de texte pour stocker les noms d'utilisateur, les mots de passe et les rôles assignés. Les instructions données assument qu'à ce point, la configuration d'autorisation n'a pas été changée. Si elle a été changée, alors il faut ajouter les utilisateurs suivant cette configuration. Consulter Chapitre 6, Sécurité pour obtenir davantage d'informations.

   1. Ajouter les utilisateurs admin et mailman

      Ouvrir le fichier PROFILE/conf/props/brms-users.properties dans l'éditeur de texte et ajouter les utilisateurs admin et mailman à ce fichier comme nouvelle ligne avec la syntaxe : username=password.

      admin=s3kr3t5
      mailman=53cur3m@1l

      Copy to Clipboard Toggle word wrap

   2. Assigner les rôles

      Assigner les rôles indiqués ci-dessous aux deux utilisateurs en ouvrant le fichier PROFILE/conf/props/brms-roles.properties dans un éditeur de texte, et en ajoutant une nouvelle ligne pour chaque utilisateur avec la syntaxe : username=role1, role2, role3.
      L'utilisateur admin doit posséder les rôles de JBossAdmin, HttpInvoker, user, et d' admin.
      L'utilisateur de mailman doit posséder les rôles de JBossAdmin, readwrite.

      admin=JBossAdmin, HttpInvoker, user, admin
      mailman=JBossAdmin, readwrite

      Copy to Clipboard Toggle word wrap

   3. OPTION : Encoder les mots de passe

      En option, les mots de passe peuvent être stockés en forme encodée et non pas en texte ordinaire. Pour cela, exécuter la commande suivante dans le répertoire du serveur d'application (jboss-as or jboss-as-web) pour créer la forme encodée du mot de passe, et en remplaçant PASSWORD par le mot de passe qui convient.

      [localhost]$ java -cp client/jboss-logging-spi.jar:lib/jbosssx.jar org.jboss.resource.security.SecureIdentityLoginModule PASSWORD
      Encoded password: 5f78dc15b9a559cbdf8592078de921bc

      Copy to Clipboard Toggle word wrap
      Puis, remplacer les mots de passe stockés dans PROFILE/conf/props/brms-users.properties par les versions encodées.

4. OPTION : Configuration de la base de données

   La configuration par défaut de Modeshape utilise une base de données qui ne convient, ni n'est supportée dans les environnements de production. Avant de déployer dans un environnement de production, cette configuration doit être changée en serveur de bases de données supportées.
   Consulter Chapitre 4, Configuration de la base de données pour obtenir davantage d'instructions.

5. Retirer les fichiers JAR Non utilisés

   Supprimer les fichiers JAR suivants du répertoire server/PROFILE/deploy/jboss-brms.war/WEB-INF/lib/.
   • jackrabbit-api-2.1.0.jar
   • jackrabbit-core-2.1.0.jar
   • jackrabbit-jcr-commons-2.1.0.jar
   • jackrabbit-spi-2.1.0.jar
   • hibernate-commons-annotations-3.1.0.GA.jar
   • hibernate-core-3.3.2.GA.jar
   • hibernate-validator-3.1.0.GA.jar
   • lucene-core-2.4.1.jar
   • jcr-2.0.jar

6. Activer ModeShape dans le WAR

   Modifier le fichier jboss-brms.war/WEB-INF/components.xml pour retirer la configuration d'Apache Jackrabbit et ajouter la configuration de ModeShape.
   Pour retirer la configuration d'Apache Jackrabbit, il faut supprimer ou dé-commenter la section suivante :

   <property name="properties">
   <key>org.drools.repository.configurator</key>
   <value>org.drools.repository.jackrabbit.JackrabbitRepositoryConfigurator</value>
   <!-- the root directory for the repo storage the directory must exist. -->
   <!-- <key>repository.root.directory</key><value>/opt/yourpath</value> -->
   </property>

   Copy to Clipboard Toggle word wrap
   La configuration de ModeShape est dé-commentée dans la configuration par défaut. Dé-commenter la configuration comme suit :

   <property name="properties">
   <key>org.drools.repository.configurator</key>
   <value>org.drools.repository.modeshape.ModeShapeRepositoryConfigurator</value>
   <key>org.modeshape.jcr.URL</key><value>jndi:jcr/local?repositoryName=brms</value>
   <key>org.drools.repository.secure.passwords</key><value>false</value>
   <key>org.drools.repository.admin.password</key><value>admin</value>
   <key>org.drools.repository.mailman.password</key><value>mailman</value>
   </property>

   Copy to Clipboard Toggle word wrap

7. Définir les mots de passe

   ModeShape a besoin de deux comptes d'utilisateur, admin et mailman. Les mots de passe ce ces comptes doivent être spécifiés dans la configuration ModeShape de l'étape précédente.

   <key>org.drools.repository.secure.passwords</key><value>false</value>
   <key>org.drools.repository.admin.password</key><value>password</value>
   <key>org.drools.repository.mailman.password</key><value>password</value>

   Copy to Clipboard Toggle word wrap

8. Démarrage du serveur

   Pour lancer le serveur à partir de la ligne de commande, utiliser la commande run.sh d'un système UNIX ou Linux, ou bien run.bat sur un système Microsoft Windows. Le paramètre -c doit être utilisé pour indiquer quel profil de serveur utiliser.

   [localhost ]$ ./run.sh -c production

   Copy to Clipboard Toggle word wrap
   Les scripts run.sh et run.bat se situent dans le répertoire bin.
   Par exemple, le chemin complet vers le répertoire bin du serveur autonome BRMS 5.2.0 est brms-standalone-5.2.0/jboss-as-web/bin/.
   Consulter la documentation JBoss Enterprise Web Platform 5 pour obtenir des informations sur les paramètres supplémentaires nécessaires pour lancer le serveur, http://docs.redhat.com/docs/en-US/JBoss_Enterprise_Web_Platform/.

9. Connexion

   Connectez-vous à l'application web JBoss Enterprise BRMS Platform pour confirmer que l'installation et l'exécution soient au point. Consulter Section 2.3, «  Première connexion » pour obtenir davantage d'informations.

Procédure 4.1. Changer la base de données du référentiel.

1. Fermeture

   Fermer le serveur de l'application avant d'effectuer ces changements.

2. Installer le JAR du pilote JDBC

   Copier le fichier JAR qui contient le pilote JDBC dans le répertoire lib du serveur, qui pourrait correspondre, par exemple à jboss-as-web/PROFILE/production/lib/.

3. Ouvrir repository.xml dans un éditeur de textes.

   Ouvrir le fichier repository.xml dans un éditeur de texte. Quand on utilise JBoss, ce fichier réside dans le répertoire bin du serveur d'applications, à moins qu'une autre adresse n'ait été spécifiée (comme expliqué dans Section 4.3.1, « Changer l'adresse du référentiel de JackRabbit »).

4. Mise à jour de la configuration de PersitenceManager

   Trouver l'élément <PersistenceManager>, qui se trouve dans <Workspace>.
   Par exemple :

   <PersistenceManager class=
     "org.apache.jackrabbit.core.persistence.bundle.DerbyPersistenceManager">
       <param name="url" value="jdbc:derby:${wsp.home}/db;create=true"/>
   	<param name="schemaObjectPrefix" value="${wsp.name}_"/>
   </PersistenceManager>

   Copy to Clipboard Toggle word wrap
   Remplacer cela par la configuration de la base de données à utiliser pour la base de données. Voir Annexe C, Exemple de configuration du gestionnaire de persistance pour les exemples.

5. Définir le paramètre schemaObjectPrefix

   Cette valeur est indiquée par le préfixe du nom de chaque tableau de base de données géré par le gestionnaire de persistance. (Cela doit être unique dans chaque base de données). La configuration par défaut utilise la variable ${wsp.name} qui contient le nom de l'espace de travail en cours.

   <param name="schemaObjectPrefix" value="${wsp.name}_"/>

   Copy to Clipboard Toggle word wrap

6. Effacer l'ancien espace de travail.

   Effacer le répertoire workspaces/Default/.

7. Redémarrage

   Redémarrer le serveur d'applications.

Procédure 4.2. Modifier la base de données de Versions

1. Fermeture

   Fermer le serveur de l'application avant d'effectuer ces changements.

2. Installer le JAR du pilote JDBC

   Copier le fichier JAR qui contient le pilote JDBC dans le répertoire lib du serveur, qui pourrait correspondre, par exemple à jboss-as/server/PROFILE/lib/.

3. Ouvrir repository.xml dans un éditeur de textes.

   Ouvrir le fichier repository.xml dans un éditeur de texte. Quand on utilise JBoss, ce fichier réside dans le répertoire bin du serveur d'applications, à moins qu'une autre adresse n'ait été spécifiée (comme expliqué dans Section 4.3.1, « Changer l'adresse du référentiel de JackRabbit »).

4. Mise à jour de la configuration de PersitenceManager

   Trouver l'élément <PersistenceManager>, qui se trouve dans <Workspace>.
   Par exemple :

   <PersistenceManager class=
     "org.apache.jackrabbit.core.persistence.bundle.DerbyPersistenceManager">
     <param name="url" value="jdbc:derby:${rep.home}/version/db;create=true"/>
     <param name="schemaObjectPrefix" value="version_"/>
   </PersistenceManager>

   Copy to Clipboard Toggle word wrap
   Remplacer cela par la configuration de la base de données à utiliser pour la base de données. Voir Annexe C, Exemple de configuration du gestionnaire de persistance pour les exemples.

5. Définir le paramètre schemaObjectPrefix

   Cette valeur est indiquée par le préfixe qui se trouve sur le nom de chaque tableau de base de données géré par le Gestionnaire de persistance. (Cela doit être unique pour chaque base de données.) Si la même base de données est utilisée pour les deux Versions et pour le datastore, veillez à ce que le même schemaObjectPrefix ne soit pas utilisé pour les deux. (La configuration par défaut utilise version_.)

   <param name="schemaObjectPrefix" value="version_"/>

   Copy to Clipboard Toggle word wrap

6. Redémarrage

   Redémarrer le serveur d'applications.

Procédure 4.3. Changer la location du référentiel

1. Fermer le serveur d'applications

   Stopper le serveur d'applications avant d'effectuer ces changements.

2. Trouver le fichier components.xml

   Le fichier components.xml se situe dans le répertoire WEB-INF/, (deploy/jboss-brms.war/WEB-INF/.) Il s'agit d'un fichier de configuration standard qui permet la personnalisation de différentes parties de l'application.

3. Trouver l'attribut Key-Value de repository.root.directory

   Ouvrir le fichier components.xml dans un éditeur de texte et trouver l'attribut Key-Value de repository.root.directory. Il est contenu dans le composant repositoryConfiguration et est "dé-commenté" par défaut.

   <property name="properties">
      <key>org.drools.repository.configurator</key>
      <value>org.drools.repository.jackrabbit.JackrabbitRepositoryConfigurator</value>
      <!--  the root directory for the repo storage the directory must exist. -->
      <!--  <key>repository.root.directory</key><value>/opt/yourpath</value>  -->
   </property>

   Copy to Clipboard Toggle word wrap

   Note

   Pour les versions de BRMS antérieures à 5.1, suivre les étapes suivantes :

   • Trouver la propriété homeDirectory
   • Ouvrir le fichier components.xml dans un éditeur de textes et trouver la propriété homeDirectory. Elle se trouve dans le composant repositoryConfiguration et elle est "dé-commentée" par défaut.

   <component name="repositoryConfiguration"> 
   <!-- 
   *** This is for configuring the "home" directory for the repository
    storage. the directory must exist. ***
   <property name="homeDirectory">
       /home/michael/RulesRepository_001
   </property>
   -->  
   </component> 
   

   Copy to Clipboard Toggle word wrap

4. Mettre à jour l'attribut Key-Value de repository.root.directory

   Retirer les balises de commentaires qui se trouvent autour de l'attribut de Key-Value repository.root.directory et modifier la valeur du chemin d'accès au répertoire où va se trouver le datastore. (Ce répertoire doit déjà exister).

   <property name="properties">
      <key>org.drools.repository.configurator</key>
      <value>org.drools.repository.jackrabbit.JackrabbitRepositoryConfigurator</value>
      <!--  the root directory for the repo storage the directory must exist. -->
      <key>repository.root.directory</key>
      <value>/opt/brms-standalone-5.2.0/BRMSRulesRepository</value>
   </property>
   

   Copy to Clipboard Toggle word wrap

   Note

   Pour les versions de BRMS antérieures à 5.1, le code est le suivant :

   <component name="repositoryConfiguration"> 
       <property name="homeDirectory">/opt/jboss-soa-platform/BRMSRulesRepository</property>
   </component>
   

   Copy to Clipboard Toggle word wrap

5. Déplacer le datastore existant (en option)

   La JBoss Enterprise BRMS Platform va créer un nouveau datastore à cette adresse s'il n'y en a pas déjà un. Pour conserver un datastore déjà existant, copier les fichiers existants à une autre adresse avant de redémarrer le serveur d'applications.

6. Redémarrage du serveur d'applications

   Redémarrer le serveur d'applications. Si un datastore existant n'a pas été déplacé vers la nouvelle adresse, un nouveau datastore sera créé.

Procédure 4.4. Configurer un RDBMS externe par l'outil de configuration du référentiel.

1. Connectez-vous à l'interface utilisateur

   Ouvrir un navigateur Web et saisir l'URL http://localhost:8080/jboss-brms/ en remplaçant localhost par le nom d'hôte du serveur pour accéder au dialogue de login.

2. Sélectionner l'outil de configuration du référentiel

   À partir du panneau de navigation, sélectionner Administration, puis Configuration Référentiel.
   

   View larger image

   

   Figure 4.1. Outil de configuration du référentiel

3. Sélectionner le Type RDBMS

   À partir du menu déroulant Select RDBMS type:, choisir le type RDBMS.
   

   View larger image

   

   Figure 4.2. Type RDBMS

4. Saisir les informations sur le RDBMS

   Sélectionner la case USE JNDI si JNDI est configuré.
   Sélectionner Continue et saisir le nom JNDI configuré dans la source de données déployée.
   Si JNDI n'est pas utilisé, saisir les informations RDBMS requises :
   • Pilote
   • URL
   • Utilisateur
   • Mot de passe
   

   View larger image

   

   Figure 4.3. Information RDBMS

5. Générer le fichier de configuration du référentiel

   Sélectionner Generate repository config pour générer le fichier repository.xml.
   Vous pouvez, soit couper/coller le texte généré dans un fichier et le sauvegarder dans repository.xml, ou bien, vous pouvez sélectionner Save Configuration pour télécharger le texte sous forme de fichier. Remplacer le repository.xml existant par le nouveau repository.xml. À moins qu'un répertoire d'accueil différent ne soit spécifié, (comme décrit dans Section 4.3.1, « Changer l'adresse du référentiel de JackRabbit »), le fichier repository.xml se trouvera dans le répertoire bin du serveur d'applications.

Procédure 6.1. Exemple d'authentication : UserRolesLoginModule

1. Veillez à ce que le système d'authentification soit configuré correctement

   Ce module de login utilise deux fichiers pour stocker le nom de login, le mot de passe, et les rôles assignés à chaque utilisateur. Créer les fichiers brms-users.properties et brms-roles.properties dans le répertoire jboss-as-web/server/PROFILE/conf/props/, puis spécifier au moins un utilisateur dans brms-users.properties en utilisant le format : username=password. (le fichier brms-roles.properties peut rester vide.)

2. Fermeture

   Fermer le serveur d'applications avant de procéder à ces changements.

3. Configurer le module de login de JBoss

   Pour configurer les modules de login de JBoss, ouvrir jboss-as-web/server/PROFILE/conf/login-config.xml dans un éditeur de texte. Il s'agit d'un fichier XML qui contient un élément <policy> avec plusieurs éléments enfant <application-policy>. Chaque élément d' <application-policy> définit un plan d'authentification différent. Ajouter l'extrait XML suivant de <application-policy> en tant que nouvel enfant de l'élément <policy> :

   <!--BRMS Platform Security Domain-->
   <application-policy name="brms">
      <authentication>
          <login-module
              code="org.jboss.security.auth.spi.UsersRolesLoginModule"
              flag="required">
               <module-option name="usersProperties">
                   props/brms-users.properties
               </module-option>
               <module-option name="rolesProperties">
                   props/brms-roles.properties
               </module-option>
           </login-module>
       </authentication>
   </application-policy>
   

   Copy to Clipboard Toggle word wrap

4. Configurer la platform BRMS pour utiliser le Module de login

   Ouvrir le fichier jboss-as-web/server/PROFILE/deploy/JBoss-BRMS.war/WEB-INF/components.xml. Il contient un élément <components> ayant plusieurs éléments enfant, y compris <security:identity> .
   Dé-commentez les éléments <security:identity> existants pour empêcher les conflits. Ajouter l'élément <security:identity> suivant :

   <security:identity authenticate-
   method="#{authenticator.authenticate}" jaas-config-name="brms"/>
   

   Copy to Clipboard Toggle word wrap
   La propriété jaas-config-name doit être la même que application-policy. Si la propriété application-policy a été modifiée dans l'étape précédente, modifier la propriété jaas-config-name ici pour la faire correspondre.

5. Démarrage à nouveau

   Démarrer le serveur d'applications à nouveau.

Procédure 6.2. Second exemple d'authentification : LDAP

1. Veillez à ce que le serveur LDAP soit configuré correctement

   Vérifier que les paramètres de configuration du pare-feu et du réseau n'empêchent pas la communication entre le serveur d'applications et le serveur LDAP.

2. Fermeture

   Fermer le serveur d'applications avant de procéder à ces changements.

3. Configurer le module de login de JBoss

   Pour configurer les modules de login de JBoss, ouvrir jboss-as-web/server/PROFILE/conf/login-config.xml dans un éditeur de texte. Il s'agit d'un fichier XML qui contient un élément <policy> avec plusieurs éléments enfant <application-policy>. Chaque élément d' <application-policy> définit un plan d'authentification différent. Ajouter l'extrait XML suivant de <application-policy> en tant que nouvel enfant de l'élément <policy> :

   <application-policy name="brms">
    <authentication>
     <login-module code="org.jboss.security.auth.spi.LdapExtLoginModule" 
         flag="required" >
       <module-option name="java.naming.provider.url">
           ldap://ldap.company.com:389
       </module-option>
       <module-option name="bindDN">DEPARTMENT\someadmin</module-option>
       <module-option name="bindCredential">password</module-option>
       <module-option name="baseCtxDN">cn=Users,dc=company,dc=com
       </module-option>
       <module-option name="baseFilter">(sAMAccountName={0})</module-option>
       <module-option name="rolesCtxDN">cn=Users,dc=company,dc=com
       </module-option>
       <module-option name="roleFilter">(sAMAccountName={0})</module-option>
       <module-option name="roleAttributeID">memberOf</module-option>
       <module-option name="roleAttributeIsDN">true</module-option>
       <module-option name="roleNameAttributeID">cn</module-option>
       <module-option name="roleRecursion">-1</module-option>
       <module-option name="searchScope">ONELEVEL_SCOPE</module-option>
     </login-module>
    </authentication>
   </application-policy>

   Copy to Clipboard Toggle word wrap
   Mettre à jour les valeurs de ce fichier de configuration avec celles qui sont appropriées pour votre serveur LDAP.

4. Configurer la platform BRMS pour utiliser le Module de login

   Ouvrir le fichier jboss-as-web/server/PROFILE/deploy/jboss-brms.war/WEB-INF/components.xml. Il contient un élément <components> ayant plusieurs éléments enfants, y compris <security:identity>.
   Dé-commentez les éléments <security:identity> existants pour empêcher les conflits. Ajouter l'élément <security:identity> suivant :

   <security:identity authenticate-method="#{authenticator.authenticate}" jaas-config-name="brms"/>

   Copy to Clipboard Toggle word wrap
   La propriété jaas-config-name doit être la même que application-policy. Si la propriété application-policy a été modifiée dans l'étape précédente, modifier la propriété jaas-config-name ici pour la faire correspondre.

5. Démarrage à nouveau

   Démarrer le serveur d'applications à nouveau.