配置 Tomcat LDAPLocalGroup 域

本主题提供有关如何配置 Tomcat 应用程序服务器和 Jazz 应用程序,以使用 LDAP 目录中所包含的信息(用于认证)和本地文件(用于管理授权和组成员资格)的指示信息。

关于此任务

如果要支持使用 LDAP 的认证和使用本地文件内信息的授权,那么必须配置 LDAPLocalGroup 用户注册表类型。请利用下列步骤,来使用 LDAP 目录中所包含的用户信息进行认证,并使用本地组映射文件中所包含的信息进行授权。

过程

  1. 配置 Tomcat 以使用 Jazz JNDI 域,而不使用缺省的 JNDI 域。打开 <JazzInstallDir>/server/tomcat/conf/server.xml 以进行编辑,取消注释 com.ibm.team.repository.localgroups.realm.LocalMappingJNDIRealm 部分并注释掉 org.apache.catalina.realm.UserDatabaseRealm 部分。请将 connectionURL、userBase 和 userSearch 中的值替换为 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. 在 GlobalNamingResources 下面,取消注释 "LocalRoleMap" 部分并注释掉 "UserDatabase" 部分。 GlobalNamingResources 会定义服务器的全局 JNDI 资源。将路径名属性设置为文件系统中的映射文件(CSV 格式)。
    <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>
    这是 mapping.csv 的示例。 Tomcat 将使用该映射文件来确定与用户相关联的角色。
    user1,JazzUsers
    user2,[JazzAdmins; JazzDWAdmins]
    user3,JazzProjectAdmins
    user4,JazzGuests
    在上面的示例中,user1 具有 JazzUsers 角色,而 user2 具有 JazzAdmins 和 JazzDWAdmins 角色。
  3. 将下列条目添加到 <JazzInstallDir>/server/tomcat/conf/Catalina/localhost/jts.xml 中,以允许 Jazz 应用程序访问全局 JNDI 资源。
    <Context>
       <ResourceLink name="LocalRoleMap"
    			global="LocalRoleMap"
    			type="com.ibm.team.repository.localgroups.IUserRoleMap" />
    ...
    </Context>
    上面列示的变更允许 Tomcat 应用程序服务器使用 LDAP 目录进行认证,并使用 mapping.csv 文件中显示的信息进行授权。
  4. 如果服务器支持 LDAP 同步,那么必须变更 Jazz 应用程序中的注册表类型和设置,才能导入用户、同步用户和查看用户的组成员资格。 登录到服务器管理 (https://hostname.example.com:9443/jts/admin)。
  5. 单击服务器 > 高级属性。
  6. 在 com.ibm.team.repository.service.jts.internal.userregistry.ExternalUserRegistryInternalService 下面,单击编辑并将用户注册表类型变更为 LDAPLocalGroup。
    LDAPLocalGroup 用户注册表类型
  7. 在 com.ibm.team.repository.userregistry.provider.ldaplocalgroup.LDAPLocalGroupRegistryProvider 下面,单击编辑并设置 LDAPLocalGroup 注册表位置、基本用户 DN 和用户属性映射信息。
    注: 这些配置属性与 LDAP 用户注册表提供程序的配置属性不同。
    LDAP 本地组注册表提供程序

反馈