Configurando a Região LDAPLocalGroup Tomcat

Este tópico fornece instruções sobre como configurar o servidor de aplicativos Tomcat e o aplicativo do Jazz para usarem as informações contidas no diretório LDAP para autenticação e um arquivo local para gerenciamento de autorização e associação ao grupo.

Sobre Esta Tarefa

Para suportar autenticação usando LDAP e autorização usando as informações em um arquivo local, você deve configurar o tipo de registro do usuário LDAPLocalGroup. Use as etapas a seguir para autenticar usando as informações sobre o usuário contidas no diretório LDAP e autorizar o uso das informações contidas no arquivo de mapeamento de grupos locais.

Procedimento

  1. Configure o Tomcat para usar a região JNDI do Jazz em vez da região JNDI padrão. Abra <JazzInstallDir>/server/tomcat/conf/server.xml para edição, remova o comentário da seção com.ibm.team.repository.localgroups.realm.LocalMappingJNDIRealm e comente a seção org.apache.catalina.realm.UserDatabaseRealm. Substitua os valores em connectionURL, userBase e userSearch pelos valores de seu diretório 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. Em GlobalNamingResources, remova o comentário da seção "LocalRoleMap" e comente a seção "UserDatabase". O GlobalNamingResources define os recursos JNDI globais para o servidor. Defina o atributo de nome do caminho para um arquivo de mapeamento (formato CSV) no sistema de arquivos.
    <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>
    Aqui há um exemplo de mapping.csv. O arquivo de mapeamento será usado pelo Tomcat para determinar as funções associadas aos usuários.
    user1,JazzUsers
    user2,[JazzAdmins; JazzDWAdmins]
    user3,JazzProjectAdmins
    user4,JazzGuests
    No exemplo acima, user1 tem a função JazzUsers, enquanto user2 tem as funções JazzAdmins e JazzDWAdmins.
  3. Inclua a seguinte entrada em <JazzInstallDir>/server/tomcat/conf/Catalina/localhost/jts.xml para permitir que o aplicativo Jazz obtenha acesso ao recurso JNDI global.
    <Context>
       <ResourceLink name="LocalRoleMap"
    			global="LocalRoleMap"
    			type="com.ibm.team.repository.localgroups.IUserRoleMap" />
    ...
    </Context>
    As mudanças listadas acima permitem que o servidor de aplicativos do Tomcat autentique usando o diretório LDAP e autorize usando as informações presentes no arquivo mapping.csv.
  4. Se o servidor suportar sincronização LDAP, o tipo de registro e as configurações devem ser alteradas no aplicativo Jazz para importar usuários, sincronizar usuários e visualizar a associação ao grupo de um usuário. Efetue logon na Administração do Servidor (https://hostname.example.com:9443/jts/admin).
  5. Clique em Servidor > Propriedades Avançadas.
  6. Em com.ibm.team.repository.service.jts.internal.userregistry.ExternalUserRegistryInternalService, clique em Editar e altere o tipo de registro do usuário para LDAPLocalGroup.
    Tipo de Registro de Usuário LDAPLocalGroup
  7. Em com.ibm.team.repository.userregistry.provider.ldaplocalgroup.LDAPLocalGroupRegistryProvider, clique em Editar e configure o local do registro LDAPLocalGroup, o DN do usuário base e as informações de mapeamento de atributos do usuário.
    Nota: Essas propriedades de configuração têm formas diferentes das propriedades para o provedor de registro do usuário LDAP.
    Provedor de registro de grupo local LDAP

Feedback