Chapitre 11. Installation de Red Hat JBoss BPM Suite avec Red Hat SSO.

Procédure 11.1. Configurer RH-SSO avec un domaine client

1. Installer et configurer un serveur autonome RH-SSO. Pour cela, suivre les instructions du Guide d'installation RH-SSO.

   Note

   Si vous souhaitez exécuter à la fois les serveurs RH-SSO et Red Hat JBoss BPM Suite sur la même machine, veillez à éviter les conflits de ports. Pour cela, procédez ainsi :

   • Mettez à jour le fichier $RHSSO_HOME/standalone/configuration/standalone.xml et définissez le décalage de port à 100. Exemple :

     <socket-binding-group name="standard-sockets" default-interface="public" port-offset="${jboss.socket.binding.port-offset:100}">

     Copy to Clipboard Toggle word wrap
   • Utiliser une variable d'envirionnement pour exécuter le serveur :

     bin/standalone.sh -Djboss.socket.binding.port-offset=100

     Copy to Clipboard Toggle word wrap
2. Démarrez le serveur RH-SSO en utilisant la commande suivante dans $RHSSO_HOME/bin:

   ./standalone.sh

   Copy to Clipboard Toggle word wrap
   Une fois que le serveur RH-SSO a démarré, ouvrir http://localhost:8180/auth/admin dans un navigateur web, et connectez-vous à l'aide de vos identifiants admin que vous avez créés lors de l'installation de RH-SSO.

   Note

   Si vous n'avez pas créé d'utilisateur RH-SSO admin pendant l'installation, vous pourrez en créer un en naviguant dans $RHSSO_HOME/bin par la commande suivante  :

   ./add-user.sh -r master -u admin -p <ADMIN_PASSWORD>

   Copy to Clipboard Toggle word wrap
3. Dans la console admin RH-SSO, cliquer sur l'onglet Configurations de domaine.
4. Dans la page Configurations de domaine, cliquer sur Ajouter Domaine.
   La page Ajouter Domaine s'ouvrira.
5. Dans la page Ajouter Domaine, donner un nom au domaine et cliquer sur Créer.
6. Cliquer sur l'onglet Client dans le menu principal d'administration de console, et cliquer sur Créer.
   La page Ajouter Client s'ouvrira.
7. Dans la page Ajouter Client, fournir les informations requises pour créer un nouveau client pour votre domaine. Exemple :
   • ID Client : kie
   • Protocole Client : openid-connect
   • Type d'accès : confidentiel
   • URL Root : http://localhost:8080
   • URL de base : /business-central
   • URI de redirection valides: /business-central/*

     Note

     Les valeurs des URI de redirection valides et l'URL de base doivent correspondre à votre nom de contexte d'application Red Hat JBoss BPM Suite et la valeur de l'URL Root doit correspondre à l'URL de base HTTP de votre application.
8. Cliquez Enregistrer pour enregistrer vos modifications.
   À ce stade, le serveur RH-SSO est configuré avec un domaine et un client pour des applications de Red Hat JBoss Suite BPM (Business Centre, dans cet exemple) et en cours d’exécution, à l’écoute des connexions HTTP à localhost:8180. Ce domaine fournit différents utilisateurs, rôles et sessions pour les applications de Red Hat JBoss Suite BPM.

Procédure 11.2. Installer l'adaptateur de client RH-SSO dans EAP

1. Installer EAP 6.4.x. Consulter Chapitre 2. Instructions d'installation du Guide d'installation de Red Hat JBoss Enterprise Application Platform.
2. Télécharger l'adaptateur EAP de la la page de téléchargements de BPM Suite.
3. Décompressez et installez l'adaptateur. Pour obtenir des instructions sur l'installation, voir Installer des adaptateurs pour Red Hat SSO dans le Guide d'installation RH-SSO.

Procédure 11.3. Configurez l'adaptateur RH-SSO

1. Naviguez dans $JBOSS_EAP/standalone/configuration dans votre installation EAP et modifier standalone.xml pour pouvoir ajouter la configuration du sous-système RH-SSO. Exemple :

   <subsystem xmlns="urn:jboss:domain:keycloak:1.1">  
    <secure-deployment name="business-central.war">  
      <realm>demo</realm>  
      <realm-public-key>MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCrVrCuTtArbgaZzL1hvh0xtL5mc7o0NqPVnYXkLvgcwiC3BjLGw1tGEGoJaXDuSaRllobm53JBhjx33UNv+5z/UMG4kytBWxheNVKnL6GgqlNabMaFfPLPCF8kAgKnsi79NMo+n6KnSY8YeUmec/p2vjO2NjsSAVcWEQMVhJ31LwIDAQAB</realm-public-key>  
      <auth-server-url>http://localhost:8180/auth</auth-server-url>  
      <ssl-required>external</ssl-required>  
      <enable-basic-auth>true</enable-basic-auth>  
      <resource>kie</resource>  
      <credential name="secret">password</credential>  
      <principal-attribute>preferred_username</principal-attribute>  
    </secure-deployment>  
   </subsystem>

   Copy to Clipboard Toggle word wrap
   Voici ici,
   • secure-deployment name: nom du fichier WAR de votre application.
   • realm: nom du domaine que vous avez créé à utiliser pour vos applications.
   • realm-public-key: clé publique du domaine que vous avez créé. Vous pourrez la trouver dans l'onglet Clés qui se trouve dans la page de domaine Configurations Domaine que vous avez créée dans la console d'administration RH-SSO. Si vous ne donnez aucune valeur à realm-public-key, le serveur en extraira une automatiquement.
   • auth-server-url: URL du serveur d'authentification RH-SSO.
   • enable-basic-auth: paramètre pour activer le mécanisme d’authentification de base, afin que les clients puissent utiliser les deux méthodes d’authentification: basée jetons ou de base pour exécuter les requêtes.
   • resource: nom du client que vous avez créé.
   • credential name: clé secrète du client que vous avez créé. Vous pourrez la trouver dans l'onglet Informations d'identification dans la page Clients de la console d'administration RH-SSO.
   • principal-attribute: le nom de connexion de l'utilisateur. Si vous ne procurez pas cette information, votre ID Utilisateur s'affichera à la place de votre nom d'utilisateur dans l'application.

     Note

     Le serveur RH-SSO convertit en minuscules les noms d’utilisateurs. Donc, après l'intégration avec RH-SSO, votre nom d’utilisateur apparaîtra en minuscules dans Business Central. Si vous avez des noms d’utilisateur en lettres majuscules codées en dur dans les processus métier, l’application n’est peut-être pas en mesure d’identifier les majuscules dans l’utilisateur.
2. Naviguez dans $EAP_Home/bin/ et démarrez le serveur EAP par la commande suivante :

   ./standalone.sh

   Copy to Clipboard Toggle word wrap
   Vous pouvez maintenant vous connecter à votre application Red Hat BPM Suite (pour cet exemple, Business Central) une fois que le serveur exécute avec les identifiants admin RH-SSO.

Procédure 11.4. Désactiver BasicAuthSecurityFilter

1. Ouvrir votre fichier de descripteur de déploiement d'applications (WEB-INF/web.xml) et appliquez-y les changements suivants :
   • Supprimer les lignes suivantes pour supprimer le filtre du servlet et ses mappages pour la classe org.uberfire.ext.security.server.BasicAuthSecurityFilter :

     <filter>  
         <filter-name>HTTP Basic Auth Filter</filter-name>  
         <filter-class>org.uberfire.ext.security.server.BasicAuthSecurityFilter</filter-class>  
         <init-param>  
           <param-name>realmName</param-name>  
           <param-value>KIE Workbench Realm</param-value>  
         </init-param>  
       </filter>  
       
       
       <filter-mapping>  
         <filter-name>HTTP Basic Auth Filter</filter-name>  
         <url-pattern>/rest/*</url-pattern>  
         <url-pattern>/maven2/*</url-pattern>  
         <url-pattern>/ws/*</url-pattern>  
       </filter-mapping>

     Copy to Clipboard Toggle word wrap
   • Ajouter les lignes suivantes pour ajouter la security-constraint aux url-patterns que vous avez supprimés du mappage de filtre :

     <security-constraint>  
         <web-resource-collection>  
           <web-resource-name>remote-services</web-resource-name>  
           <url-pattern>/rest/*</url-pattern>  
           <url-pattern>/maven2/*</url-pattern>  
           <url-pattern>/ws/*</url-pattern>  
         </web-resource-collection>  
         <auth-constraint>  
           <role-name>rest-all</role-name>  
         </auth-constraint>  
       </security-constraint>

     Copy to Clipboard Toggle word wrap
2. Enregistrez vos modifications.

Procédure 11.5. Intégrer RH-SSO dans BAM

1. Dans la console d'administration RH-SSO, ouvrir le domaine de sécurité que vous avez créé.
2. Cliquer sur l'onglet Client dans le menu principal d'administration de console, et cliquer sur Créer.
   La page Ajouter Client s'ouvrira.
3. Dans la page Ajouter Client, fournir les informations requises pour créer un nouveau client BAM pour votre domaine. Exemple :
   • Nom : dashbuilder
   • URL Root : http://localhost:8080
   • Protocole Client : openid-connect
   • Type d'accès : confidentiel
   • URI de redirection valides: /dashbuilder/*
   • URL de base: /dashbuilder

   Note

   Le chemin de contexte de l'application Dashbuilder est dashbuilder par défaut.
4. Configurer l'adaptateur client RH-SSO. Pour ce faire, naviguez dans $JBOSS_EAP/standalone/configuration dans votre installation EAP et modifier standalone.xml pour pouvoir ajouter la configuration du sous-système RH-SSO. Exemple :

   <secure-deployment name="dashbuilder.war">  
        <realm>demo</realm>  
        <realm-public-key>MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCrVrCuTtArbgaZzL1hvh0xtL5mc7o0NqPVnYXkLvgcwiC3BjLGw1tGEGoJaXDuSaRllobm53JBhjx33UNv+5z/UMG4kytBWxheNVKnL6GgqlNabMaFfPLPCF8kAgKnsi79NMo+n6KnSY8YeUmec/p2vjO2NjsSAVcWEQMVhJ31LwIDAQAB</realm-public-key>  
        <auth-server-url>http://localhost:8180/auth</auth-server-url>  
        <ssl-required>external</ssl-required>  
        <resource>dashbuilder</resource>  
        <enable-basic-auth>true</enable-basic-auth>  
        <credential name="secret">e92ec68d-6177-4239-be05-28ef2f3460ff</credential>  
        <principal-attribute>preferred_username</principal-attribute>  
     </secure-deployment>

   Copy to Clipboard Toggle word wrap
   Voici ici,
   • secure-deployment name: nom du fichier BAM en cours de déploiement.
   • realm-public-key: clé publique du domaine que vous avez créé.
   • resource: nom du client que vous avez créé pour BAM (dashbuilder).
   • enable-basic-auth: paramètre pour activer le mécanisme d’authentification de base, afin que les clients puissent utiliser les deux méthodes d’authentification: basée jetons ou de base pour exécuter les requêtes.
   • credential name: clé secrète du client que vous avez créé pour BAM. Vous pourrez la trouver dans l'onglet Informations d'identification dans la page Clients de la console d'administration RH-SSO.
   • principal-attribute: le nom de connexion de l'utilisateur. Si vous ne procurez pas cette information, votre ID Utilisateur s'affichera à la place de votre nom d'utilisateur dans l'application.
5. Redémarrez le serveur EAP et ouvrir http://localhost:8080/dashbuilder dans un navigateur web pour accéder BAM. Connectez-vous à BAM par le biais de vos identifiants admin RH-SSO.
   Vous pouvez maintenant accéder aux deux applications (Business Central et BAM) sans avoir à vous re-connecter.