Configure Control Room for Active Directory: manual mode

Configure the Control Room to authenticate users using Active Directory by manually adding the Lightweight Directory Access Protocol (LDAP) URLs.

Note: Active Directory integration is irreversible and you cannot modify the configuration after it has been established.

To configure the Control Room when you start it for the first time, do the following:

Procedure

  1. Open the Control Room URL that is sent by your system administrator in your browser.
  2. Type the repository path.
    This is the location where the uploaded automation files, for example, IQ Bots, and Task Bots are stored. For example, C:\ProgramData\AutomationAnywhere\Server Files.
  3. Enter the access URL.
    This is the URL for accessing your installation of Control Room.
  4. Click Save and continue.
    Important: The back button of your web browser is automatically disabled after you click Save and continue. This ensures that the Credential Vault Master Key that generates matches the repository path and Control Room access URL.

    To return to the Configure Control Room settings page, press Ctrl plus F5 and restart.

    The Credential Vault settings page appears.
  5. Select from the following options:
    • Express mode: The system stores your Master Key to connect to the Credential Vault. This option is not recommended for a production environment.
    • Manual mode: You store the Master Key on your own, and then provide the Master Key when the Credential Vault is locked. Users use the Master Key to connect to the Credential Vault to secure their credentials and access them when creating and running Task Bots.
      Important: If you lose the Master Key, you will not be able to access the Control Room.
  6. Click Save and continue.
    Important: The back button of the web browser is automatically disabled after you click Save and continue. No further changes to the Control Room configuration or Credential Vault settings are allowed.

    To make changes, reinstall the Control Room.

    The Authentication type for Control Room users page appears.
  7. Select Active Directory.
    Automation Anywhere supports Active Directory Multi-Forest authentication for the Control Room. Before providing the Authentication Type, ensure the following:
    • One-way or two-way trust is set up between all forests. For a one-way trust, this is from the Enterprise Client forest to the Control Room forest (Control Room forest must always be the trusting forest).
    • Two-way trust is set up for every domain in a forest.
    • The root certificate of the LDAP server is imported using the provided CertMgr tool through the command.
    • The provided LDAP URLs per forest cannot be behind a load balancer. Also, all LDAP URLs must point to the root (main) domain controllers.
    • The node that runs the Control Room is in the same domain network where the Active Directory runs.
    • The user is in the parent domain and the URL points to the parent.

      This ensures that when there are two or more forests, and one of the forest has a subdomain with a different name space, a user from the other forests does not have permission to access that subdomain.

  8. Type the Global Catalog URL.

    For example, ldap://server01.domain.com.

    For failsafe authentication, click the plus option to provide additional LDAP URLs.

    Note: For users and groups from one or more Active Directory domains, to access the Control Room, use a fully qualified host name of the Global Catalog (GC) server, listening on port 3268 (3269 if SSL).

    When adding LDAP URLs, ensure that you provide a fully qualified host name like ldap://server01.ldap.com.

    Provide URLs of multiple Global Catalogs per forest so that if one Global Catalog in a forest goes down, the other can serve. This feature does not provide support for the load-balanced URL.

    You must enter the Domain username and password and click Manually add connections to enter the LDAP URLs.

  9. Provide service account credentials

    Ensure that the username provided is a user in the Domain Users group and ideally and be set up in Active Directory with a password never expires option. If otherwise, there will be some downtime in RPA authentication as the service account password is reset. Provide the username in a User Principal Name (UPN) in the username@domain.com format and password.

  10. Click Check connection.

    If Control Room is unable to connect to the Active Directory database, an error message appears.

  11. Click Next.
    The Control Room first administrator page appears.
  12. Select the Active Directory domain from the drop-down list and type the Control Room administrator username.
  13. Click Check name in Active Directory.
    If the username is in the Active Directory the following user details are shown:
    • First name
    • Last name
    • Email

    You can edit these prepopulated fields.

  14. Click Save and log in.
    You are logged in to the Control Room as an administrator. You can now configure and manage the overall RPA environment with Control Room and clients.

Next steps

After configuring the Control Room, install product licenses.