Skip to end of metadata
Go to start of metadata

中文标题【使用 LDAP 授权连接一个内部目录】

你可以为你的 Confluence 连接 LDAP 服务器使用使用委托认证。这个意思是 Confluence 将会设置一个内部目录,这个目录仅被用来处理 LDAP 的授权。

这个设置将会为尝试登录系统的用户在本创建一个用户名。

概述


一个使用 LDAP 认证的内部目录,通常是一个让你能通过 LDAP 存储和检查用户密码的配置。请注意使用 LDAP 授权内部目录(internal directory with LDAP authentication)与系统的内部目录是分开存储的。在所有的 LDAP 目录上,不检查用户的登录授权。LDAP 的连接是只读的。所有使用 LDAP 授权内部目录的用户必须映射到 LDAP 目录上,否则这些用户将不能登录系统。

什么时候使用这个选项:如果你希望为你的应用程序配置用户和用户组来适应你应用程序的配置选项。这个选项将会从 LDAP 上检查用户的登录密码。这个选项将会避免从 LDAP 服务器上下载大量用户和用户组导致的性能问题。


本页中的内容:

相关页面:

Configuring User Directories

使用 LDAP 授权连接到 Confluence 内部目录

希望连接一个内部目录但是使用 LDAP 检查登录授权:

  1. 在屏幕的右上角单击 控制台按钮 ,然后选择 基本配置(General Configuration 链接。
  2. 单击左侧面板上面的 用户目录(User Directories)。
  3. 添加(Add一个目录,然后选择 内部目录使用 LDAP 授权(Internal with LDAP Authentication
  4. 输入上面描述的所有配置字段。
  5. 保存你的目录服务器配置。
  6. 如果你希望你的 LDAP 用户替换掉系统中已经存在的用户。移动 'Internal with LDAP Authentication' 选择到最前面的列表中。你通过在用户目录(User Directories)界面单击目录前面的上下移动按钮操作可以定义 目录选项(directory order)。这里是有关目录顺序如何影响系统的摘要信息:
    • 当应用程序允许对 LDAP 进行信息修改的时候,用户在系统中修改的信息只会影响到第一个目录。
    • 目录的顺序是对用户和用户组查找的时候的搜索顺序(通过在所有目录中对 Confluence 默认的用户组聚集,所以目录的顺序将不会影响成员)。
    有关更多的配置信息,请参考Managing Multiple Directories
  7. 在 Confluence 中添加你的用户和用户组。请查看 Add and Invite UsersManaging Site-Wide Permissions and Groups 界面中的信息

服务器设置

设置

描述

名字(Name)

名字的描述将会帮助你在目录中识别。例如:

  • Internal directory with LDAP Authentication
  • Corporate LDAP for Authentication Only

目录类型(Directory Type)

选择你希望连接的 LDAP 目录类型。如果你添加一个新的 LDAP 目录连接,有关这个目录的连接参数将会根据你选择的连接类型的不同而分别显示:

  • Microsoft Active Directory
  • OpenDS
  • And more

主机名(Hostname)

你目录服务器的名字。例如:

端口(Port)

你希望连接的目录服务器的监听端口。例如:

  • 389
  • 10389
  • 636(for example, for SSL)

使用 SSL(Use SSL)

如果你连接的目录服务器使用了 SSL(Secure Sockets Layer),请选择这个。请注意,你需要配置 SSL 证书才能让 SSL 正常连接。

用户名(Username)

连接目录服务器需要使用的登录用户名。例如:

  • cn=administrator,cn=users,dc=ad,dc=example,dc=com
  • cn=user,dc=domain,dc=name
  • [email protected]

密码(Password)

登录目录服务器使用的登录密码。

拷贝用户到登录

设置

描述

在登录时拷贝用户(Copy User on Login)

这个选项在用户尝试登录的时候将会被触发。如果这个选择框被选择的话,当用户使用 LDAP 授权的用户名和密码登录系统的时候,用户将会在内部目录自动创建,用户的信息将会在每次用户登录的时候同步过来。如果这个选择框不选择的话,当用户没有在本地目录创建的话,用户的登录将会失败。

如果你选择这个选择框,下面的一些配置将会在屏幕中出现,下面对这些配置进行一些描述:

  • Default Group Memberships
  • Synchronize Group Memberships
  • User Schema Settings(在本页面的其他章节中详细描述)

在登录时更新用户特性(Update User attributes on Login)

当你的用户在系统中进行授权的话,这些用户的属性信息将会从 LDAP 服务器上自动同步到本地。当你选择这个属性的时候,你不能再应用中直接对用户进行删除。

  • 如果你希望对用户进行修改,请在 LDAP 服务器上操作。用户的信息将会在登录成功后更新到本地。
  • 如果你希望对用户进行删除,请在 LDAP 服务器上操作,同时也需要在本地引用中进行删除。如果你从 LDAP 服务器上进行删除的话,用户将会拒绝登录本地系统。但是不会将这个用户设置为非激活用户,这个设置将会计算你用户的许可证数量,占用你的用户许可证。你需要在登录中更新用户属性(Update User attributes on Login)中删除,然后再重新启用他们。

默认用户组成员(Default Group Memberships)

当你选择 拷贝用户登录( Copy User on Login)选择框选择后将会出现。如果你希望用户自动被添加到用户组,请在这里选择希望添加到的用户组名称,你可以在这里选择多用户组。

希望指定一个或者多个用户组,在用户组名字之间使用英文逗号进行分割。每次用户登录系统,用户所属的用户组信息将会被检查校验,如果用户不属于这里的用户组,用户将会在每次登录后自动添加到用户组中。

如果这里的用户组值不制定的话,这个用户将会添加到使用 LDAP 授权的内部目录中。


请注意,如果你错误的输入了用户组的名字的话,用户的授权将会返回失败信息。用户将不能访问应用程序或者基于用户组的的用户组功能。

示例:

  • confluence-users
  • bamboo-users,jira-administrators,jira-core-users

同步用户组成员(Synchronize Group Memberships)

当你选择 拷贝用户登录( Copy User on Login)选择框选择后将会出现。如果这个对话框被选择的话,在你每次登录系统的时候,在你 LDAP 中的用户组成员将会自动同步到内部目录中。

你可以你选择了下面的一些更多的配置信息,有关名字和描述如下:

  • Group Schema Settings(在下面的章节中详细描述)
  • Membership Schema Settings(在下面的章节中详细描述)

注意: 'Copy Users on Login' 必须被启用,如果你希望使用 change usernames 功能的话。

Schema 设置

设置

描述

基本 DN(Base DN)

根专有名称(DN),这个名称在你对目录服务器上进行查询的时候使用。例如:

  • o=example,c=com
  • cn=users,dc=ad,dc=example,dc=com
  • 针对 Microsoft Active Directory 目录服务器,指定 专有 DN 请按照下面的格式: dc=domain1,dc=local。你需要将 domain1 和 local 替换掉你自己的配置。Microsoft Server 提供了一个称为 ldp.exe 的工具,这个工具对你在 LDAP 服务器上对用户配置和查找非常有用。

用户名属性(User Name Attribute)

这个属性将会在你载入用户名的时候使用。例如:

  • cn
  • sAMAccountName

高级设置

设置

说明

Enable Nested Groups

为嵌套组启用或禁用支持。 


一些目录服务器能够允许你在一个组中定义另外一个组。在这种结构下的用户组称为用户组嵌套。嵌套组的配置能够让子用户组继承上级用户组的权限,使系统的权限配置变得简单。


结果分页(Use Paged Results)

启用或者禁用使用 LDAP 为查询结果进行简单的分页。如果分页功能被启用,查询功能将会返回一部分查询的结果而不是所有的查询结果

输入希望分页的页面大小——这样将会返回在一次查询中最大允许返回的记录数量,默认这个值为 1000。

转移引荐(Follow Referrals)

选择启用这个功能的话,将会运行目录服务器将请求转移到其他的服务器上。这个选项使用的是节点转移(JNDI lookup java.naming.referral)配置设置。

这个配置通常需要 Active Directory 配置正确的 DNS 来避免在操作的时候出现 'javax.naming.PartialResultException: Unprocessed Continuation Reference(s)' 异常。

用户 Schema 设置

请注意:这部分仅在拷贝用户登录(Copy User on Login)功能被启用后可见。

设置

描述

其他用户 DN(Additional User DN)

这个值被用在进行用户查找和载入的时候来针对 base DN 配置一些扩展信息。如果你没有为这个字段提供任何值,那么子树的查找将会从 base DN 上开始查找。例如:

  • ou=Users

用户对象类(User Object Class)

这个是在 LDAP  用户对象中对用户分类的名字。例如:

  • user

用户对象过滤器(User Object Filter)

当对用户对象进行搜索的时候使用的过滤器。例如:

  • (&(objectCategory=Person)(sAMAccountName=*))

用户全名 RDN 属性(User Name RDN Attribute)

RDN(相对区分的名字)在载入用户名的时候会被使用。针对每一个 LDAP  实例,DN 将会被区分为2 个部分:RDN 和 LDAP 目录服务器记录的位置。RDN 是你 DN 的一部分,这部分将不会关联到目录树结构。例如:

  • cn

用户名属性(User First Name Attribute)

这个特性将会在用户名载入的时候被使用。例如:

  • givenName
用户姓属性(User Last Name Attribute)

这个特性将会在用户姓载入的时候被使用。例如:

  • sn

用户显示名属性(User Display Name Attribute)

这个特性将会在用户全名载入的时候被使用。例如:

  • displayName

用户邮件属性(User Email Attribute)

这个特性将会在用户电子邮件地址载入的时候被使用。例如:

  • mail

用户组 Schema 设置

请注意:这部分仅在拷贝用户登录(Copy User on Login)和 同步组成员(Synchronize Group Memberships)被启用后可见。

设置

描述

其他用户组 DN(Additional Group DN)

这个值被用在进行用户组查找和载入的时候来针对 base DN 配置一些扩展信息。如果你没有为这个字段提供任何值,那么子树的查找将会从 base DN 上开始查找。例如:

  • ou=Groups

用户组对象类(Group Object Class)

这是在 LDAP 用户组对象中使用的类的名字。例如:

  • groupOfUniqueNames
  • group

用户组对象过滤器(Group Object Filter)

这个过滤器将会在查找用户组对象的时候被使用。例如:

  • (objectCategory=Group)

用户组名字属性(Group Name Attribute)

当载入用户组名字的时候,这个字段将会被使用。例如:

  • cn

用户组描述属性(Group Description Attribute)

当载入用户组描述的时候,这个字段将会被使用。例如:

  • description

成员 Schema 设置

请注意:这部分仅在拷贝用户登录(Copy User on Login)和 同步组成员(Synchronize Group Memberships)被启用后可见。

设置

描述

用户组成员属性(Group Members Attribute)

这个属性字段将在载入用户组成员的时候使用。例如:

  • member

用户成员属性(User Membership Attribute)

这个属性字段将在载入用户组的时候使用。例如:

  • memberOf

当找到一个用户组成员的时候,使用用户成员属性(Use the User Membership Attribute, when finding the members of a group)

如果你的目录服务器在用户组中支持用户成员属性的话,你可以选择这个(在默认的情况下,这个是 'member' 属性)。

  • 如果这个选择框被选择的话,你的应用程序在使用  retrieving the members of a given group 的时候,将会使用组成员属性。这个会带来更高效的检索效率。
  • 如果这个选择框没有被选择的话,你的应用程序在查找的时候将会使用在用户组中使用成员属性(默认是 'member' )。

图表和可能的配置

Confluence with LDAP Auth Only

上面的图:Confluence 连接 LDAP 服务器仅用做授权

Gliffy-Confluence-LDAP-Copy-On-First-Login

上面的图:Confluence 连接到一个 LDAP 目录只用作授权,当用户登录 Confluence 的时候,使用 LDAP 授权并且将用户信息同步到本地路服务器上。


  • No labels