Documentation for Crowd 2.7. 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, 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:

Using Crowd's 'Add Application' Wizard

Before you start

Icon

Before adding the application, consider whether you need to add your directories, users and groups. See the detailed instructions for your application.

  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.
      (info) 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:

Community application connectors

Icon

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.)

RELATED TOPICS

Crowd Documentation