Documentation for Crowd 2.8. Documentation for earlier versions of Crowd is available too.

Skip to end of metadata
Go to start of metadata

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


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:

Using Crowd's 'Add Application' Wizard


  1. Log in to the Crowd Administration Console.
  2. Consider whether you need to add any directories, users and groups. If so, see the detailed instructions for your application.
  3. Click Applications in the top navigation bar.
  4. Click Add Application in the left-hand menu to display the first screen for the 'Add Application' wizard for Crowd.
  5. Complete the form:



    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.


    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.


    A short description of the application. Note: A URL is often helpful.


    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.


  6. Click Next.

  7. Enter the connection details for your application, as described in the table below.




    The URL of your application. For example this may be Remember to include the port, if you are not using a proxy.
    After entering the URL for the application, you can click Resolve IP Address. 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 Resolve IP Address once you have entered a URL.

  8. Click Next.

  9. Now select one or more directories that this application can use for authentication and authorisation:

  10. Click Next.

  11. In the 'Authorisation' step you specify the users who are authorised to access the application. 

    For each directory, you should do one of the following:
    • 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.
      (info) To remove a group from the list after adding it, click remove next to the authorised groups' names.

  12. Click Next.

  13. 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 Add Application.
  14. After completing the 'Add Application' wizard, remember to configure the application as described in the detailed instructions:

Community application connectors

You may also be interested in the Crowd plugins created by community developers. (Please check under 'Plugin Details' for each plugin to see if the plugin is supported by Atlassian.)


Crowd Documentation