Configuration manuelle du conteneur Web d'Apache Tomcat pour utiliser LDAP

Si vous avez utilisé l'assistant de configuration de Jazz Team Server pour créer les fichiers de configuration de Tomcat, cette procédure a déjà été exécutée automatiquement et il est inutile de configurer le conteneur Web.

Pourquoi et quand exécuter cette tâche

Si vous préférez configurer manuellement le conteneur Web pour LDAP dans Apache Tomcat, procédez comme suit :

Procédure

  1. Ouvrez le fichier répertoire_installation_Jazz/server/tomcat/conf/server.xml pour le modifier et placez la balise suivante dans un commentaire :
    <Realm className="org.apache.catalina.realm.UserDatabaseRealm"
                 resourceName="UserDatabase" 
                 digest="SHA-1"
                 digestEncoding="UTF-8"/>
  2. En fonction du répertoire que vous utilisez, ajoutez l'une des balises suivantes :
    Ajoutez la balise suivante pour Oracle Internet Directory (OID) et modifiez les informations afin qu'elles correspondent à votre configuration :
    <Realm className="org.apache.catalina.realm.JNDIRealm" 
     debug="99"
     connectionURL="ldap://ldap.company.com:389"
     roleBase="cn=Groups,dc=company,dc=com"
     roleSearch="(uniquemember={0})" 
     roleName="cn"
     userBase="cn=Users,dc=company,dc=com"
     userSearch="(uid={0})"/>
    Ajoutez la balise suivante pour Microsoft Active Directory et modifiez les informations afin qu'elles correspondent à votre configuration :
    <Realm className="org.apache.catalina.realm.JNDIRealm" 
     debug="99"
     connectionURL="ldap://ldap.company.com:3268"
     authentication="simple"
     referrals="follow"
     connectionName="cn=LDAPUser,ou=Service Accounts,dc=company,dc=com"
     connectionPassword="VerySecretPassword" 
     userSearch="(sAMAccountName={0})"
     userBase="dc=company,dc=com" 
     userSubtree="true"
     roleSearch="(member={0})" 
     roleName="cn" 
     roleSubtree="true"
     roleBase="dc=company,dc=com"/>
    Ajoutez la balise suivante pour Tivoli Directory Server et modifiez les informations en fonction de votre configuration :
    <RealmclassName="org.apache.catalina.realm.JNDIRealm"
    debug="9"
    connectionURL="ldap://Machine sur laquelle TDS est installé>:389"
    userBase="o=company.com"
    userSearch="(mail={0})"
    userSubtree="true"
    roleBase="o=company.com"
    roleSubtree="true"
    roleSearch="(member={0})"
    roleName="cn"/>
  3. Ouvrez le fichier répertoire_installation_Jazz/server/tomcat/webapps/nom_app/WEB-INF/web.xml pour le modifier, où nom_app est l'application installée, telle que jts, ccm, qm ou rm.
  4. Dans le fichier que vous avez ouvert, liez et mappez les références de rôles de sécurité aux rôles de sécurité :
    <web-app id="WebApp">
    <servlet id="bridge">
    <servlet-name>equinoxbridgeservlet</servlet-name>
    <display-name>Equinox Bridge Servlet</display-name>
    <description>Equinox Bridge Servlet</description>
    <servlet-class>org.eclipse.equinox.servletbridge.BridgeServlet</servlet-class>
    <init-param><!-- ... --></init-param>
    <!-- ... -->
    <load-on-startup>1</load-on-startup>
    
    <!-- Annexe
    Si les noms de vos groupes LDAP correspondent aux rôles Jazz par défaut,
    vous n'avez pas besoin d'ajouter les balises suivantes
    -->
    <security-role-ref>
    <role-name>JazzAdmins</role-name>
    <role-link>[Groupe LDAP pour administrateurs Jazz]</role-link>
    </security-role-ref>
    
    <security-role-ref>
    <role-name>JazzDWAdmins</role-name>
    <role-link>[Groupe LDAP pour administrateurs d'entrepôt de données]</role-link>
    </security-role-ref>
    
    <security-role-ref>
    <role-name>JazzGuests</role-name>
    <role-link>[Groupe LDAP pour invités Jazz]</role-link>
    </security-role-ref>
    
    <security-role-ref>
    <role-name>JazzUsers</role-name>
    <role-link>[Groupe LDAP pour utilisateurs Jazz]</role-link>
    </security-role-ref>
    
    <security-role-ref>
    <role-name>JazzProjectAdmins</role-name>
    <role-link>[Groupe LDAP pour administrateurs de projets Jazz]</role-link>
    </security-role-ref>
    
    </servlet>
    <!-- ... -->
    </web-app>
    Utilisez les balises suivantes pour déclarer les groupes LDAP comme rôles de sécurité :
    <web-app id="WebApp">
    <servlet id="bridge">
    <!-- ... -->
    <security-role>
    <role-name>JazzAdmins</role-name>
    <role-name>JazzDWAdmins</role-name>
    <role-name>JazzGuests</role-name>
    <role-name>JazzUsers</role-name>
    <role-name>JazzProjectAdmins</role-name>
    
    <!-- Annexe
    Si les noms de vos groupes LDAP correspondent aux rôles Jazz par défaut,
    vous n'avez pas besoin d'ajouter les balises suivantes
    -->
    <role-name>[Groupe LDAP pour administrateurs Jazz]</role-name>
    <role-name>[Groupe LDAP pour administrateurs Jazz Data Warehouse]</role-name>
    <role-name>[Groupe LDAP pour invités Jazz]</role-name>
    <role-name>[Groupe LDAP pour utilisateurs Jazz]</role-name>
    <role-name>[Groupe LDAP pour administrateurs de projets Jazz]</role-name>
    <!-- Fin de l'annexe -->
    </security-role>
    <!-- ... -->
    </web-app>
    Utilisez les balises suivantes pour mettre à jour la section security-constraint :
    <web-app id="WebApp">
    <!-- ... -->
    <security-constraint>
    <web-resource-collection>
    <web-resource-name>secure</web-resource-name>
    <url-pattern>/*</url-pattern>
    </web-resource-collection>
    
    <auth-constraint>
    <role-name>JazzUsers</role-name>
    <role-name>JazzAdmins</role-name>
    <role-name>JazzGuests</role-name>
    <role-name>JazzDWAdmins</role-name>
    <role-name>JazzProjectAdmins</role-name>
    
    <!-- Annexe
    Si les noms de vos groupes LDAP correspondent aux rôles Jazz par défaut,
    vous n'avez pas besoin d'ajouter les balises suivantes
    -->
    
    <role-name>[Groupe LDAP pour administrateurs Jazz]</role-name>
    <role-name>[Groupe LDAP pour administrateurs Jazz Data Warehouse]</role-name>
    <role-name>[Groupe LDAP pour invités Jazz]</role-name>
    <role-name>[Groupe LDAP pour utilisateurs Jazz]</role-name>
    <role-name>[Groupe LDAP pour administrateurs de projets Jazz]</role-name>
    <!-- Fin de l'annexe -->
    
    </auth-constraint>
    
    <user-data-constarint>
    <transport-guarantee>CONFIDENTIAL</transport-guarantee>
    </user-data-constraint>
    </security-constraint>
    <!-- ... -->
    </web-app>
    Répétez le même ajout sur chaque élément security-constraint en référençant un groupe Jazz :
    <web-app id="WebApp">
    <!-- ... -->
    <security-constraint>
    <web-resource-collection>
    <web-resource-name>adminsecure</web-resource-name>
    <url-pattern>/admin/cmd/*</url-pattern>
    </web-resource-collection>
    <auth-constraint>
    <role-name>JazzAdmins</role-name>
    <!-- Annexe -->
    <role-name>[Groupe LDAP pour administrateurs Jazz]</role-name>
    <!-- Fin de l'annexe -->
    </auth-constraint>
    <user-data-constraint>
    <transport-guarantee>CONFIDENTIAL</transport-guarantee>
    </user-data-constraint>
    </security-constraint>
    <!-- ... -->
    </web-app>

Commentaires