这个页面描述了如果在 Confluence 中定义了多个目录服务器将会发生什么样的情况。例如你可能会有一个内部目录服务器同时你还可能有连接一个 LDAP 外部服务器或者使用多种类型的其他用户目录。当你在系统中定义了多个目录服务器的时候，你需要在系统中指定不同目录服务器的载入顺序（directory order）。 避免跨目录的多个用户名：如果你连接了超过一个的目录服务器，我们建议你需要确定你的用户名在目录服务器中是唯一的。例如：我们不建议你定义一个用户同时在'Directory1' 和 'Directory2' 中都定义 jsmith 这个用户。这样要求的原因是避免在系统中导致混乱，尤其是在你对目录服务器进行切换的时候。修改目录服务器的排列顺序也会修改用户名的引用顺序。   https://www.cwiki.us/display/CONFLUENCEWIKI/Managing+Multiple+Directories

当你打算合并的外部目录服务器（Crowd 或 Jira 应用）有大量的用户到 Confluence 数据库中的时候，请使用这个选项。你需要有基本的 SQL 知识才能完成这个任务。 下面的 SQL 命令假设你使用的数据库为 MySQL 数据库。如果你使用的数据库不是 MySQL 数据库的话，你需要针对你使用的数据库对你的脚本进行一些修改后才能执行。 第 1 步. 创建备份 创建备份是在你对系统进行操作时候出现错误后恢复的唯一办法。 从 Confluence 中，你可以创建一个完整的 XML 站点备份包括所有的附件。 停止 Confluence。 将你服务器上的  Confluence home 和 安装目录中的所有文件和目录拷贝到系统的其他地方备份。 针对你的外部应用程序，重复上面的步骤。 从你的 MySQL 数据库管理工具中，为 Crowd/Jira 和 Confluence 都创建一个备份。 第 2 步. 替换 Confluence 用户管理 使用下面的 SQL 脚本备份外部应用程序中的用户和用户组到 Confluence 表中。下面的脚本是针对 MySQL 数据库设计运行的，如果你使用其他的数据库，你需要对脚本进行修改。 找到你目录使用的 ID 运行下面的脚本，然后对返回的结果数进行记录，这个 ID 将会在后面的 <Confluence Internal ID> 参数中引用。 select id from cwd_directory where directory_name='Confluence Internal Directory'; 针对用户目录关里界面，找到你希望移动的用户，用户组名字。运行下面的脚本，然后对返回的结果数进行记录，这个 ID 将会在后面的 <External Application ID> 参数中引用。 select id from cwd_directory where directory_name='<External Directory Name>'; 移动用户组到 Confluence 在你的内部目录中，外部目录的名字是相同情况是被允许的，希望找到这些名字，请运行下面的脚本： select distinct a.id, a.directory_id, a.group_name, d.directory_name from cwd_group a join cwd_group b on a.group_name=b.group_name join cwd_directory d on d.id=a.directory_id where a.directory_id != b.directory_id; 如果上面的脚本有返回插件结果，针对每一条记录表明的是名字出现了重复，在 Confluence 的内部目录中找到这些重复名字的 ID（<internal group id>）和外部应用（<external group id>）。运行下面的脚本： update cwd_group_attribute set group_id=<internal group id>, directory_id=<Confluence Internal Id> where group_id=<external group id>; update cwd_membership set child_group_id=<internal group id> where child_group_id=<external group id>; update cwd_membership set parent_id=<internal group id> where parent_id=<external group id>; delete from cwd_group where id=<external group id>; 移动所有外部应用中的所有组到 Confluence 内部目录中。 update cwd_group set directory_id=<Confluence Internal ID> where directory_id=<External Application ID>; 移动用户到 Confluence 在内部目录中是允许有多个相同的用户名的，如果这些用户组在不同的外部应用目录中的话。找到这些用户，运行： select distinct a.id, a.directory_id, a.user_name, d.directory_name from cwd_user a join cwd_user b on a.user_name=b.user_name join cwd_directory d on d.id=a.directory_id where a.directory_id != b.directory_id; 如果上面的脚本返回了多条记录的话，表明的是你的系统中有多个用户具有相同的用户名在不同的外部目录中。在 Confluence 的内部目录中找到这些重复名字的 ID（(<internal user id>）和外部应用（<external user id>）。运行下面的脚本： update cwd_membership set child_user_id=<internal user id> where child_user_id=<external user id>; update cwd_user_credential_record set user_id=<internal user id> where user_id=<external user id>; update cwd_user_attribute set user_id=<internal user id>, directory_id=<Confluence Internal ID> where user_id=<external user id>; delete from cwd_user where id=<external user id>; 移动所有外部应用中的所有用户到 Confluence 内部目录中。 update cwd_user set directory_id=<Confluence Internal ID> where directory_id=<External Application ID>; 删除外部应用目录…

当你只有少量的用户和用户组的时候，使用这个方法。 使用 Confluence 的系统管理员登录 Confluence。 进入用户目录管理界面，然后移动 内部目录（internal directory）到系统中所有目录的列表的最顶部，通过单击目录前方排序的箭头。 请确定在内部目录中，你至少有一个用户属于confluence-users 和 confluence-administrators 用户组。 请确定你有一个用户在内部目录中具有 Confluence 系统管理员权限（Confluence system administrator permissions）。 如果你不具有上面描述的 2 个用户，添加一个然后退出系统。 使用添加的用户重新登录 Confluence，然后进入目录管理界面。 禁用 Atlassian Crowd 目录。 手动添加需要添加的用户和用户组到 Confluence中。这些用户将会添加到系统目录中，因为你将系统目录已经移动到系统的用户目录序列的最顶端。 如果你在 Jira 系统中已经为这些用户指派了用户组，你必须要手动在 Confluence 中为这些用户创建一个名字相同的用户组。 如果在你 Jira 中的用户已经在 Confluence 创建类内容或者已经为他们指派了全系，你必须要在 Confluence 重新创建这些用户。 添加用户到你希望的用户组中。   https://www.cwiki.us/display/CONFLUENCEWIKI/Reverting+from+Crowd+or+JIRA+applications+to+Internal+User+Management

如果你的 Confluence 站点当前使用的是 Crowd 或者 Jira 应用程序管理你的用的话，你可以按照下面的步骤切换使用回内部目录管理你的用户。 如果你的 Confluence 站点只有少量的用户的话，在 Confluence 中手动重建用户和用户组就比较简单。如果你有很多的用户的话，整合用户和用户组到 Confluence 内部目录中就会比较简单有效。 下面的两个选项都会重置用户的密码。当下面的2 个选项完成操作的时候，请提醒你的用户使用重置我的密码（Reset My Password）链接来重置你的用户的密码。这个链接在用户尝试登录的界面上。 https://www.cwiki.us/display/CONFLUENCEWIKI/Reverting+from+Crowd+or+JIRA+applications+to+Internal+User+Management

下面是可能会发生的一些错误信息。如果你的系统中出现了下面的一些提示，你应该调整你的日志错误级别到 WARN，然后查看具体的错误原因。请参考：Configuring Logging。 error.jirabaseurl.connection.refused Connection refused. Check if an instance of Jira is running on the given url 可能导致的原因是： Jira url 不正确 Jira 实例没有在指定的 URL 下运行。 Jira  实例在指定的 URL 下运行，但是可能实例不是 4.3 及后续版本。 error.applicationlink.connection.refused Failed to establish application link between Jira server and Confluence server. 在 Jira 和 Confluence 之间不能创建应用连接。可能的原因是： Confluence 或 Jira url 不正确 2 个应用的实例没有在指定的 URL 下运行 连接用户名或者密码不正确 请参考 Confluence 的日志文件来获得更多的信息。 error.jirabaseurl.not.valid This is not a valid url for a Jira application. 一个运行时异常被捕获到了。请参考 Confluence 的日志文件来确定异常发生的原因错误内容。   https://www.cwiki.us/display/CONFLUENCEWIKI/Connecting+to+Crowd+or+Jira+for+User+Management

启用嵌套用户组（Enable Nested Groups） 为嵌套组启用或禁用支持。  在启用嵌套用户组之前，你需要检查你在 JIRA 服务器中的嵌套用户组是否启用了。当嵌套用户组启用成功后，你可以将一根用户组定义为另外一个用户组的成员。 如果你使用的是用户组来对权限进行管理，你可以使用嵌套用户组来允许一个用户组的权限继承上级用户组，使系统的权限配置变得简单。 同步时间（分钟）（Synchronisation Interval (minutes)） 同步指的是应用程序从目录服务器上更新自己用户和用户组上的信息的时间间隔。这个参数表示的是你的应用服务器将会在 x 分钟发送一个请求到你的目录服务器上。 默认的配置是 60 分钟。   https://www.cwiki.us/display/CONFLUENCEWIKI/Connecting+to+Crowd+or+Jira+for+User+Management

只读（Read Only） 从你 JIRA 应用服务器上取得的用户，用户组和用户组成员。这些用户的信息只能通过你的 JIRA 服务器进行修改。   https://www.cwiki.us/display/CONFLUENCEWIKI/Connecting+to+Crowd+or+Jira+for+User+Management

名字（Name） 输入一个有意义的服务器名字，会让你在 JIRA 服务器中更好的识别你的目录服务器： Jira Service Desk Server My Company Jira 服务器URL（Server URL） 你 Jira 服务器的 Web 访问地址。例如： http://www.example.com:8080 http://jira.example.com 应用程序名（Application Name） 当用户作为用户管理员访问你 Jira 应用服务器的时候使用的用户名。 请注意，你还需要在 Jira 中定义的应用。通过在 'Users, Groups & Roles' section of the 'Administration' 菜单下的其他应用（Other Applications）进行查看。 应用程序密码（Application Password） 当用户作为用户管理员访问你 Jira 应用服务器的时候使用的密码。   https://www.cwiki.us/display/CONFLUENCEWIKI/Connecting+to+Crowd+or+Jira+for+User+Management

请注意，在使用这个功能的时候，你的 Jira 应用许可证数量和 Confluence 的许可证数量不需要完全等同。例如，你可以通过 Jira 管理一个 50 个用户的 Confluence 许可证，尽管你的 Jira 软件只有 25 个用户许可证。 基于一些限制，你可以连接一系列 Atlassian 应用程序到 JIRA 应用程序中，以便于你使用 JIRA 集中管理你的用户。 什么时候使用这个功能：你可以连接一个运行 JIRA 4.3 及后续版本的服务器，JIRA 4.3 及后续版本, JIRA Software 7.0 及后续版本, JIRA Core 7.0 及后续版本，或者 JIRA Service Desk 3.0 及后续版本。针对简单的配置和用户的的限制，你可以考虑使用 Atlassian Crowdor。 希望连接 Confluence 到一个 Jira 应用： 在你的 Jira 应用中，进入  > 用户管理（User Management） > Jira 用户服务器（Jira User Server）。 （针对 Jira 6.4 及早期版本，通过Jira administration screen then 用户（User Management） > Jira 用户服务器（Jira User Server）进入）。 单击 添加应用（Add Application）。 输入 Confluence 用于访问 Jira 的应用程序名称（application name）和密码（password ） 。 输入你 Confluence  服务器的 IP 地址或者地址。 有效的值，请参考： A full IP address, e.g. 192.168.10.12. A wildcard IP range, using CIDR notation, e.g. 192.168.10.1/16. For more information, see the introduction to CIDR notation on Wikipedia and RFC 4632.   保存（Save）为新的应用程序。 在 Confluence 中设置 Jira 用户目录： 在屏幕的右上角单击 控制台按钮 ，然后选择 General Configuration 链接。 在左侧边栏中单击 用户目录（User Directories）。 添加（Add）一个目录，然后选择类型 Atlassian Jira。 输入下面描述的设置。当设置中询问应用名称（application name）和 密码（password）的时候，输入在 Jira 中定义 Confluence 连锁需要的用户名和密码。 保存目录设置。 在下一步完成之前，不要修改你的目录读取顺序。否则有可能将你自己锁定到 Confluence 系统之外（你不能登录 Confluence 系统）。 为了可以使用 Confluence，用户必须是 confluence-users 用户组的成员，或者具有 Confluence 的可以使用（can use）的权限。下面的步骤是在你的 Jira 应用中配置 Confluence 用户组的步骤： 在你的 JIRA 应用中添加 confluence-users 和 confluence-administrators 用户组。 在上面的用户组中添加你自己的用户名来作为一个组成员。 选择下面的方法来让你 JIRA 中的用户能够访问 Confluence： 方法 1：在你的 JIRA 应用中，找到这些用户所属的用户组，然后将这个用户组添加为上面 2 个 Confluence 用户组的成员。这里等于用户组嵌套的关系。 方法 2：使用你的 JIRA 账号登录 Confluence，然后进入 Confluence 的 管理员控制台（Administration Console）界面。单击 全局属性（Global Permissions），然后将 可以使用（can use）权限指派给你 JIRA 中希望使用 Confluence 的用户组。 在 用户目录（User Directories）界面中，通过单击目录前面的上下移动按钮，定义目录序列（directory order）。 这里是有关目录顺序如何影响处理流程： 目录中的顺序是被用来如何查找用户和组的顺序。 修改用户和用户组将会仅仅应用到应用程序具有修改权限的第一个目录中。 有关的更多细节，请参考页面：Managing Multiple Directories 请确定你已经添加了你的 Confluence 应用的 URL 到 Jira 的白名单列表中了。请访问：Jira Administration >> System >> Security >> Whitelist 来确定你的白名单已经正确添加了。例如：https://confluence.atlassian.com/ 或者请参考下面的指南：Configuring the whitelist。   https://www.cwiki.us/display/CONFLUENCEWIKI/Connecting+to+Crowd+or+Jira+for+User+Management

启用嵌套用户组（Enable Nested Groups） 为嵌套组启用或禁用支持。  在启用嵌套用户组之前，你需要检查你在 Crowd 中定义的目录能够支持嵌套用户组。当嵌套用户组启用成功后，你可以将一根用户组定义为另外一个用户组的成员。 如果你使用的是用户组来对权限进行管理，你可以使用嵌套用户组来允许一个用户组的权限继承上级用户组，使系统的权限配置变得简单。 同步时间（分钟）（Synchronisation Interval (minutes)） 同步指的是应用程序从目录服务器上更新自己用户和用户组上的信息的时间间隔。这个参数表示的是你的应用服务器将会在 x 分钟发送一个请求到你的目录服务器上。 默认的配置是 60 分钟。   https://www.cwiki.us/display/CONFLUENCEWIKI/Connecting+to+Crowd+or+Jira+for+User+Management