Page tree
Skip to end of metadata
Go to start of metadata

To ensure that your Crowd server can be used by legitimate applications only, Crowd will allow applications to log in only from known addresses. This means that you need to specify the IP address(es) and/or hostname(s) of each application.

When you add a new application, you will specify the application's IP address. After adding the application, you can update the IP address if necessary, as described below. In some cases, you may need to add the applicable host name as well as the IP address.

IP address and/or host name?

You should always specify the application's IP address. In addition, you may need to give a host name as well as the IP address. Some application servers may pass the host name to Crowd, instead of the IP address. If this happens, Crowd will not grant the application's authorisation request unless Crowd recognises the host name.

To specify an application's IP address or hostname,

  1. Log in to the Crowd Administration Console.
  2. Click the 'Applications' tab in the top navigation bar.
  3. The Application Browser will appear. Click the link on the name of the application you wish to update.
  4. The 'View Application' screen will appear. Click the 'Remote Addresses' tab.
  5. You will see a list of IP addresses and hostnames that are currently mapped to the application. Type the new IP address or hostname into the 'Address' field and click the 'Add' button. Possible values are:
    • A full IP address, e.g.
    • A wildcard IP range, using CIDR notation, e.g. For more information, see the introduction to CIDR notation on Wikipedia and RFC 4632.
    • A host name, e.g.
      (info) Note: If an application running on the same server needs to access Crowd, you may need to add 'localhost' as well as '' to the list of IP addresses and hostnames.
  6. The new address will be added to the bottom of the list.

Screenshot: Application addresses


  • A common problem: Application not connecting with Crowd. For an application to be able to use Crowd, the application's address must be valid and the application must be active. Ensure the 'Active' check box is ticked on the application 'Details' tab.

Crowd Documentation