Adding an Application

This page gives an overview of the process for adding an application to Crowd, and refers to the application-specific pages for detailed instructions.

Overview

There are two main steps to integrating an application with Crowd:

• Step 1. Configure Crowd to talk to your application — that is, set up a directory in Crowd containing your users and groups, and then add the application to Crowd using the 'Add Application' wizard, as described below. The application will now be allowed to authenticate against Crowd.
• Step 2. Configure the application to talk to Crowd — that is, install the Crowd client into the application and configure the application to forward users' authentication and security requests to Crowd.

Detailed Instructions

Please refer to the details for your specific application:

• Integrating Crowd with Atlassian Bamboo
• Integrating Crowd with Atlassian Confluence
• Integrating Crowd with Atlassian CrowdID
• Integrating Crowd with Atlassian Crucible
• Integrating Crowd with Atlassian FishEye
• Integrating Crowd with Atlassian JIRA
• Integrating Crowd with Atlassian Stash
• Integrating Crowd with Acegi Security
• Integrating Crowd with Apache
• Integrating Crowd with Jive Forums
• Integrating Crowd with Spring Security
• Integrating Crowd with Subversion
• Integrating Crowd with a Custom Application

Using Crowd's 'Add Application' Wizard

1. Log in to the Crowd Administration Console.
2. Click the 'Applications' tab in the top navigation bar.
3. This will display the Application Browser. Click 'Add Application' in the left-hand menu.
4. This will display the first screen for the 'Add Application' wizard for Crowd. Complete the fields as described in the table below.
   
   
   
   

   Attribute	Description
   Application Type	This is used to define the type of application you are adding to Crowd. If you cannot see a matching application type, please choose the 'Generic Application' option.
   Name	The username which the application will use when it authenticates against the Crowd framework as a client. This value must be unique, i.e. it cannot be used by more than one application client.
   Description	A short description of the application. Note: A URL is often helpful.
   Password	The password which the application will use when it authenticates against the Crowd framework as a client.
   Confirm Password	Retype the same password as above, to confirm it.

   
   After completing this form, click the 'Next' button to go to the 'Connection' step.
   
   
5. Enter the connection details for your application, as described in the table below.
   
   
   
   

   Attribute	Description
   URL	The URL of your application. For example this may be http://jira.atlassian.com. Remember to include the port, if you are not using a proxy. After entering the URL for the application, you can click the 'Resolve IP Address' button. Crowd will attempt to resolve the IP address for your application.
   Remote IP Address	This is the IP address of the server where your application exists. To help you work this out, you can click the 'Resolve IP Address' button once you have entered a URL.

   
   After completing this form, click the 'Next' button to go to the 'Directories' step.
   
   
6. Now select the directories that this application can use for authentication and authorisation:
   
   
   
   Click the relevant checkbox(es) to select one or more directories.
   After completing this form, click the 'Next' button to go to the 'Authorisation' step.
   
   
7. In the 'Authorisation' step you will determine the users who are authorised to access the application.
   
   
   
   For each directory, you should do one of the following:
   • Either select 'Allow all users to authenticate', to grant application access to all users defined in the directory.
   • Or select one or more groups you wish to have access, and click 'Add Group' to add each group to the list. The 'Add Group' button appears when you select a group.
     To remove a group from the list after adding it, click the 'remove' link that will appear next to the authorised groups' names.
     
     After completing this form, click the 'Next' button to go to the 'Confirmation' step.
     
     
8. Now confirm the details for your application.
   
   
   
   Check the details of your application.
   • If you need to change anything, you can click the tabs to go back to one of the steps in the 'Add Application' wizard.
   • When you are happy with the details, click the 'Add Application' button
     
     You will now be on the 'View Application' page where you can adjust most of the options you have selected during the creation process.
     
     
9. After completing the 'Add Application' wizard, remember to configure the application as described in the detailed instructions:
   • Integrating Crowd with Atlassian Bamboo
   • Integrating Crowd with Atlassian Confluence
   • Integrating Crowd with Atlassian CrowdID
   • Integrating Crowd with Atlassian Crucible
   • Integrating Crowd with Atlassian FishEye
   • Integrating Crowd with Atlassian JIRA
   • Integrating Crowd with Atlassian Stash
   • Integrating Crowd with Acegi Security
   • Integrating Crowd with Apache
   • Integrating Crowd with Jive Forums
   • Integrating Crowd with Spring Security
   • Integrating Crowd with Subversion
   • Integrating Crowd with a Custom Application

RELATED TOPICS

• Using the Application Browser
• Adding an Application
• Configuring the Google Apps Connector
• Mapping a Directory to an Application
• Specifying an Application's Address or Hostname
• Testing a User's Login to an Application
• Enforcing Lower-Case Usernames and Groups for an Application
• Managing an Application's Session
• Deleting or Deactivating an Application
• Configuring Caching for an Application
• Overview of SSO
• Configuring Options for an Application

Crowd Documentation