3.2 Adding an Application

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

Step 1. Configure Crowd to talk to the application — that is, add the application to Crowd via the Crowd Administration Console (see below). The application will then 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. Please see details for your specific application:

To add an application to Crowd,

Log in to the Crowd Administration Console.
Click the 'Applications link in the top navigation bar.
This will display the Application Browser. Click the 'Add Application' link.
This will display the 'Add Application' screen (see screenshot). Complete the fields as described in the table below. Note that you will need to select a suitable directory to contain the application's users.
Click the 'Create' button to create the application. A number of tabs will now be displayed
To choose which users within the directory may authenticate against the application, either:
- Click the 'Groups' tab and select one or more groups of users, then click the 'Add' button;
  OR
- Click the 'Directories' tab and change 'Allow all to authenticate' to 'True' (the default is 'False').
Click the 'Remote Addresses' tab and specify the IP address or hostname of the application (the default is 'localhost').
Click the 'Update' button to save your changes.
If you wish, you can click the 'Config Test' tab and verify that a user can log in to the application.

Screenshot 1: 'Application Browser'

Screenshot 2: 'Add Application'

Attribute	Description
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 web URL is often helpful.
Active	Only deselect this if you wish to prevent all users (from all directories) from accessing this application.
Password	The password which the application will use when it authenticates against the Crowd framework as a client.
Default Directory	A directory that contains relevant users. Note: Additional directories can be added later.