Configuration du domaine Tomcat LDAPLocalGroup

Cette rubrique fournit des instructions sur la manière de configurer le serveur d'application Tomcat et l'application Jazz pour utiliser des informations contenues dans le répertoire LDAP pour l'authentification et un fichier local pour la gestion des autorisations et de l'appartenance au groupe.

Pourquoi et quand exécuter cette tâche

Pour prendre en charge l'authentification à l'aide du protocole LDAP et l'autorisation à l'aide des informations contenues dans un fichier local, vous devez configurer le type de registre utilisateur LDAPLocalGroup. Exécutez les étapes suivantes pour effectuer l'authentification à l'aide des informations utilisateur contenues dans le répertoire LDAP et pour effectuer l'autorisation à l'aide des informations contenues dans le fichier de mappage de groupes local.

Procédure

  1. Configurez Tomcat pour utiliser le domaine Jazz JNDI à la place du domaine JNDI par défaut. Ouvrez <RépInstallJazz>/server/tomcat/conf/server.xml pour édition, supprimez la mise en commentaire de la section com.ibm.team.repository.localgroups.realm.LocalMappingJNDIRealm et mettez en commentaire la section org.apache.catalina.realm.UserDatabaseRealm. Remplacez les valeurs dans connectionURL, userBase et userSearch par celles de votre annuaire LDAP.
    <Realm className="com.ibm.team.repository.localgroups.realm.LocalMappingJNDIRealm"
                   connectionURL="ldap://ldapserver.example.com:389"
                   userBase="ou=users,dc=jazz,dc=net"
                   userSearch="(uid={0})"
                   userSubtree="true"
                   roleBase="ou=people,dc=xxx"
                   roleSubtree="false"
                   roleSearch="(memberNotAvailablexxx={0})"
                   roleName="cn"
    />
  2. Sous GlobalNamingResources, supprimez la mise en commentaire de la section "LocalRoleMap" et mettez en commentaire la section "UserDatabase". GlobalNamingResources définit les ressources JNDI globales pour le serveur. Définissez l'attribut du nom de chemin sur un fichier de mappage (format csv) dans le système de fichiers.
    <GlobalNameingResources>
    ...
    <Resource name="LocalRoleMap" auth="Container"
            type="com.ibm.team.repository.localgroups.IUserRoleMap"
            descripion="Role mapping file"
            factory="com.ibm.team.repository.localgroups.realm.RoleMappingResourceFactory"
            pathname="/opt/JazzTeamServer/server/mapping.csv" />
    </GlobalNamingResources>
    Exemple de fichier mapping.csv. Le fichier de mappage sera utilisé par Tomcat pour déterminer les rôles associés aux utilisateurs.
    user1,JazzUsers
    user2,[JazzAdmins; JazzDWAdmins]
    user3,JazzProjectAdmins
    user4,JazzGuests
    Dans l'exemple ci-dessus, l'utilisateur1 a le rôle JazzUsers alors que l'utilisateur2 a les rôles JazzAdmins et JazzDWAdmins.
  3. Ajoutez l'entrée suivante à <RépInstallJazz>/server/tomcat/conf/Catalina/localhost/jts.xml pour permettre à l'application Jazz d'avoir accès à la ressource JNDI globale.
    <Context>
       <ResourceLink name="LocalRoleMap"
    			global="LocalRoleMap"
    			type="com.ibm.team.repository.localgroups.IUserRoleMap" />
    ...
    </Context>
    Les modifications répertoriées ci-dessus permettent au serveur d'application Tomcat de procéder à une authentification à l'aide d'un répertoire LDAP et à une autorisation à l'aide des informations présentes dans le fichier mapping.csv.
  4. Si le serveur prend en charge la synchronisation LDAP, le type de registre et les paramètres doivent être modifiés dans l'application Jazz pour importer des utilisateurs, synchroniser des utilisateurs et afficher l'appartenance au groupe d'un utilisateur. Connectez-vous à Server Administration (https://nom_hôte.exemple.com:9443/jts/admin).
  5. Cliquez sur Serveur > Propriétés avancées.
  6. Sous com.ibm.team.repository.service.jts.internal.userregistry.ExternalUserRegistryInternalService, cliquez sur Editer et changez le type de registre d'utilisateur pour LDAPLocalGroup.
    Type de registre d'utilisateurs LDAPLocalGroup
  7. Sous com.ibm.team.repository.userregistry.provider.ldaplocalgroup.LDAPLocalGroupRegistryProvider, cliquez sur Editer et définissez l'emplacement du registre LDAPLocalGroup, le nom distinctif de l'utilisateur de base et les informations de mappage de l'attribut utilisateur.
    Remarque : Ces propriétés de configuration sont différentes de celles du fournisseur de registre d'utilisateurs LDAP.
    Fournisseur du registre de groupes local LDAP

Commentaires