3.2.2 Integrating Crowd with Atlassian Bamboo

Atlassian's Bamboo integration server can quickly be configured to use the atlassian-user libraries to link in single or multiple directory servers through Crowd.

To configure the atlassian-user framework, perform the following:

1. Copy the Crowd integration libraries and configuration files as described in the 3.2.7 Integrating Crowd with a Custom Application documentation.
2. Edit the \bamboo\webapp\WEB-INF\classes\atlassian-user.xml file to add the following repository:
   

   <repository key="crowd" class="com.atlassian.crowd.integration.atlassianuser.CrowdRepository">
   	<classes>
   		<processor>com.atlassian.crowd.integration.atlassianuser.CrowdRepositoryProcessor</processor>
   		<userManager>com.atlassian.crowd.integration.atlassianuser.CrowdUserManager</userManager>
   		<groupManager>com.atlassian.crowd.integration.atlassianuser.CrowdGroupManager</groupManager>
   		<authenticator>com.atlassian.crowd.integration.atlassianuser.CrowdAuthenticator</authenticator>
   		<propertySetFactory>com.atlassian.crowd.integration.atlassianuser.CrowdPropertySetFactory</propertySetFactory>
   		<entityQueryParser>com.atlassian.crowd.integration.atlassianuser.CrowdEntityQueryParser</entityQueryParser>
   	</classes>
   </repository>
   

   
   You will need to comment out the Hibernate repository key
   

   <!-- <hibernate name="Hibernate Repository" key="hibernateRepository" description="Hibernate Repository"/> -->
   

3. This step is only necessary if you wish to enable single sign-on:
   

   Enabling Single Sign-On

   Single sign-on (SSO) is optional when integrating Bamboo and other Atlassian products. To use centralised authentication do not configure Seraph based authentication.

   Edit the \bamboo\webapp\WEB-INF\classes\seraph-config.xml, changing the authenticator node to read:

   <authenticator class="com.atlassian.crowd.integration.seraph.BambooAuthenticator"/>
   

Bamboo's authentication and access request calls will now be performed using the atlassian-user Crowd plugin.

When utilising the atlassian-user and Crowd framework together with Bamboo, it is highly recommended that caching be enabled. Multiple redundant calls to the atlassian-user framework are made on any given request. These results can be stored locally between calls by enabling caching in the Crowd 'Options' menu. In doing so, Bamboo will obtain all necessary information for the period specified by the cache in minutes. If a security change or addition occurs in Crowd, these changes will not be visible in Confluence until the item cache expires.

Additional configuration steps:

• Create the 'bamboo' application via the Crowd Administration Console — for details on adding an application, see 3.2 Adding an Application. Make sure that you use the same password as configured in the crowd.properties file. 
  • You will need to make sure you add the IP address of the client address, in this case Bamboo's IP address, to the list of authorised addresses — see 3.5 Specifying an Application's Address or Hostname.
• Create a group bamboo-admin, through the Crowd console or directly in your directory server.
  • You will need to assign the bamboo-admin group to the newly configured 'bamboo' application (see 3.4 Specifying which Groups can access an Application) or authentication attempts will fail.

    For more information please refer to the Bamboo documentation.

    
    

関連トピック  

• 3.1 Using the Application Browser
• 3.2 Adding an Application
  • 3.2.1 Integrating Crowd with Apache
  • 3.2.2 Integrating Crowd with Atlassian Bamboo
  • 3.2.3 Integrating Crowd with Atlassian Confluence
  • 3.2.4 Integrating Crowd with Atlassian JIRA
  • 3.2.5 Integrating Crowd with Cenqua FishEye
  • 3.2.6 Integrating Crowd with Jive Forums
    • 3.2.6.1 Jive SSO
  • 3.2.7 Integrating Crowd with a Custom Application
• 3.3 Mapping a Directory to an Application
  • 3.3.1 Specifying the Directory Order for an Application
• 3.4 Specifying which Groups can access an Application
• 3.5 Specifying an Application's Address or Hostname
• 3.6 Managing an Application's Session
• 3.7 Deleting or Deactivating an Application

Crowd 1.0 Documentation