Confluence 与Active Directory(LDAP)的集成

深碍√TFBOYSˉ_ 2021-11-11 15:40 296阅读 0赞

1. 按照说明安装Confluence，并创建缺省的管理员帐号admin  
2. 下载[hibernate\_osuser\_atlassianUserContext.xml][hibernate_osuser_atlassianUserContext.xml], 并改名为atlassianUserContext.xml,然后覆盖confluence/WEB-INF/classes目录下的同名文件(记得先备份旧文件!).  
3. 将confluence/WEB-INF/classes/upgradeSubsystemContext.xml内对**osuserMigrationBean**部分的注解去掉  
4. 重起confluence, 并用admin登录后访问[http://host.com/admin/osuser2atluser.jsp][http_host.com_admin_osuser2atluser.jsp] (假设你的服务器基础路径为http://host.com/)  
5. 点击 **Begin migration** 按钮  
6.  如果顺利的话你会看到:

![None.gif][] Migrating users ![dot.gif][] Users migrated successfully!  
![None.gif][]Migrating propertyset data ![dot.gif][] Propertyset data migrated successfully!  
![None.gif][]Migrating groups ![dot.gif][] Groups migrated successfully!

7. 停掉confluence, 并把刚才去掉了注解的 **osuserMigrationBean**重新注解起来  
8. 下载 [ldap\_hibernate\_cache\_atlassianUserContext.xml][ldap_hibernate_cache_atlassianUserContext.xml] 文件，并重命名为 atlassianUserContext.xml,然后覆盖confluence/WEB-INF/classes目录下的同名文件  
**下面是最麻烦的部分，就是设置ldap相关的属性  
9.**在你的active directory里创建一个用来访问目录服务的用户，假设叫wikiuser,密码为123456。你的windows域为abc.com  
10. 修改atlassianUserContext.xml内<property name="connectionProperties">部分，使confluence可以访问你的ldap服务:

![None.gif][]          < property  name ="connectionProperties" >   
![None.gif][]             < props >   
![None.gif][]                 < prop  key ="host" >192.168.1.1 </ prop >   
![None.gif][]                 < prop  key ="port" > 389 </ prop >   
![None.gif][]                 < prop  key ="securityPrincipal" >wikiuser@abc.com </ prop >   
![None.gif][]                 < prop  key ="securityCredential" >123456 </ prop >   
![None.gif][]                 < prop  key ="securityProtocol" > plain </ prop >   
![None.gif][]                 < prop  key ="securityAuthentication" > simple </ prop >   
![None.gif][]                 < prop  key ="baseContext" > dc=abc,dc=com </ prop >   
![None.gif][]                 < prop  key ="initialContextFactory" > com.sun.jndi.ldap.LdapCtxFactory </ prop >   
![None.gif][]                 < prop  key ="batchSize" > 100 </ prop >   
![None.gif][]                 < prop  key ="timeToLive" > 0 </ prop >   
![None.gif][]             </ props >   
![None.gif][]         </ property >

其中绿色字部分是需要你根据你的环境进行修改的部分, 其他部分如果内容和我给出的不一样，则按我这里给出的改。  
11. 修改 修改atlassianUserContext.xml内<property name="schemaMappingsProperties">令confluence可以将相关的设置和你的ldap服务关联起来.

![None.gif][]          < property  name ="schemaMappingsProperties" >   
![None.gif][]             < props >   
![None.gif][]                 < prop  key ="baseUserNamespace" > dc=abc,dc=com </ prop >   
![None.gif][]                 < prop  key ="baseGroupNamespace" > ou=Special Groups,dc=abc,dc=com </ prop >   
![None.gif][]                 < prop  key ="usernameAttribute" > sAMAccountName </ prop >   
![None.gif][]                 < prop  key ="userSearchFilter" > (objectClass=user) </ prop >   
![None.gif][]                 < prop  key ="firstnameAttribute" > givenName </ prop >   
![None.gif][]                 < prop  key ="surnameAttribute" > sn </ prop >   
![None.gif][]                 < prop  key ="emailAttribute" > mail </ prop >   
![None.gif][]                 < prop  key ="groupnameAttribute" > cn </ prop >   
![None.gif][]                 < prop  key ="groupSearchFilter" > (objectClass=group) </ prop >   
![None.gif][]                 < prop  key ="membershipAttribute" > member </ prop >   
![None.gif][]                 < prop  key ="userSearchAllDepths" > true </ prop >   
![None.gif][]                 < prop  key ="groupSearchAllDepths" > true </ prop >   
![None.gif][]             </ props >   
![None.gif][]         </ property >   
![None.gif][]

这里有几个地方需要注意：  
a) "baseGroupNamespace"这里，我假设你将所有需要用来管理权限的Group都放在"Special Groups"这个OU下了。一开始的时候你可以先把"ou=Special Groups，"这部分去掉。等搞清楚confluence和ldap的集成原理后再自己根据情况加上去。  
b) "usernameAttribute" 如果我使用了"sAMAccountName"这个AD的特殊属性，好处是你在登录的时候可以直接使用abc这样的用户ID来登录，坏处是在confluence的Group manange里无法列出group里的用户。你可以改为使用"cn", 这样的话就可以列出用户，但是登录的时候可能需要使用完整的用户名进行登录,例如"Rayman Zhang"。  
  
**12.** 保存修改后重新启动confluence. 并用admin登录  
**13.** 去到Administration > Global Permissions页面，在Groups点Edit permission,然后增加你需要允许其使用confluence的Group. 同理修改"Individual Users"  
  
大功告成，你现在可以用ldap里的用户进行登录了!

转载于:https://www.cnblogs.com/raymanzhang/archive/2006/04/24/383544.html

[hibernate_osuser_atlassianUserContext.xml]: http://confluence.atlassian.com/download/attachments/148171/hibernate_osuser_atlassianUserContext.xml?version=1
[http_host.com_admin_osuser2atluser.jsp]: http://host.com/admin/osuser2atluser.jsp
[None.gif]: 
[dot.gif]: /images/20211109/11250d852de843a0b09e689f211b67d9.png
[ldap_hibernate_cache_atlassianUserContext.xml]: http://confluence.atlassian.com/download/attachments/148171/ldap_hibernate_cache_atlassianUserContext.xml?version=1