Configurando Manualmente o Contêiner da Web do Apache Tomcat para Usar LDAP

Se você usou o assistente de configuração do Jazz Team Server para criar os arquivos de configuração do Tomcat, este procedimento foi concluído automaticamente e você não necessita configurar o contêiner da web.

Sobre Esta Tarefa

Se você preferir configurar manualmente o contêiner da web para LDAP no Apache Tomcat, siga estas etapas:

Procedimento

  1. Abra o arquivo JazzInstallDir/server/tomcat/conf/server.xml para edição e coloque a seguinte tag em um comentário:
    <Realm className="org.apache.catalina.realm.UserDatabaseRealm"
                 resourceName="UserDatabase" 
                 digest="SHA-1"
                 digestEncoding="UTF-8"/>
  2. Dependendo do diretório que usar, inclua uma das seguintes tags:
    Inclua a seguinte identificação para o Oracle Internet Directory (OID) e altere as informações para corresponder com sua configuração:
    <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})"/>
    Inclua a seguinte identificação para Microsoft Active Directory e altere as informações para corresponder com sua configuração:
    <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"/>
    Inclua a seguinte tag para o Tivoli Directory Server e altere as informações para corresponderem a sua configuração:
    <RealmclassName="org.apache.catalina.realm.JNDIRealm"
    debug="9"
    connectionURL="ldap://Máquina onde o TDS está instalado>:389"
    userBase="o=company.com"
    userSearch="(mail={0})"
    userSubtree="true"
    roleBase="o=company.com"
    roleSubtree="true"
    roleSearch="(member={0})"
    roleName="cn"/>
  3. Abra JazzInstallDir/server/tomcat/webapps/app name/WEB-INF/web.xml para edição, em que app name é o aplicativo instalado, como jts, ccm, qm ou rm.
  4. No arquivo aberto, vincule e mapeie as referências das funções de segurança às funções de segurança:
    <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>
    
    <!-- Anexo
    Se os nomes de seus Grupos LDAP forem os mesmos que as funções Jazz padrão,
    não será necessário incluir as tags a seguir
    -->
    <security-role-ref>
    <role-name>JazzAdmins</role-name>
    <role-link>[Grupo LDAP para admins do Jazz]</role-link>
    </security-role-ref>
    
    <security-role-ref>
    <role-name>JazzDWAdmins</role-name>
    <role-link>[Grupo LDAP para admins do armazém de dados do Jazz]</role-link>
    </security-role-ref>
    
    <security-role-ref>
    <role-name>JazzGuests</role-name>
    <role-link>[Grupo LDAP para convidados do Jazz]</role-link>
    </security-role-ref>
    
    <security-role-ref>
    <role-name>JazzUsers</role-name>
    <role-link>[Grupo LDAP para usuários do Jazz]</role-link>
    </security-role-ref>
    
    <security-role-ref>
    <role-name>JazzProjectAdmins</role-name>
    <role-link>[Grupo LDAP para admins do projeto do Jazz]</role-link>
    </security-role-ref>
    
    </servlet>
    <!-- ... -->
    </web-app>
    Use as tags a seguir para declarar os grupos de LDAP como funções de segurança:
    <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>
    
    <!-- Anexo
    Se os nomes de seus Grupos LDAP forem os mesmos que as funções Jazz padrão,
    não será necessário incluir as tags a seguir
    -->
    <role-name>[Grupo LDAP para Jazz Admins]</role-name>
    <role-name>[Grupo LDAP para Jazz Data Warehouse Admins]</role-name>
    <role-name>[Grupo LDAP para Jazz Guests]</role-name>
    <role-name>[Grupo LDAP para Usuários do Jazz]</role-name>
    <role-name>[Grupo LDAP para Jazz Project Admins]</role-name>
    <!-- Final do Anexo -->
    </security-role>
    <!-- ... -->
    </web-app>
    Use as seguintes tags para atualizar a seção de restrição de segurança:
    <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>
    
    <!-- Anexo
    Se os nomes de seus Grupos LDAP forem os mesmos que as funções Jazz padrão,
    não será necessário incluir as tags a seguir
    -->
    
    <role-name>[Grupo LDAP para Jazz Admins]</role-name>
    <role-name>[Grupo LDAP para Jazz Data Warehouse Admins]</role-name>
    <role-name>[Grupo LDAP para Jazz Guests]</role-name>
    <role-name>[Grupo LDAP para Usuários do Jazz]</role-name>
    <role-name>[Grupo LDAP para Jazz Project Admins]</role-name>
    <!-- Final do Anexo -->
    
    </auth-constraint>
    
    <user-data-constarint>
    <transport-guarantee>CONFIDENTIAL</transport-guarantee>
    </user-data-constraint>
    </security-constraint>
    <!-- ... -->
    </web-app>
    Repita o mesmo anexo em cada security-constraint referenciando um grupo do 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>
    <!-- Anexo -->
    <role-name>[Grupo LDAP para Jazz Admins]</role-name>
    <!-- Fim do anexo -->
    </auth-constraint>
    <user-data-constraint>
    <transport-guarantee>CONFIDENTIAL</transport-guarantee>
    </user-data-constraint>
    </security-constraint>
    <!-- ... -->
    </web-app>

Feedback