By default, the AdminServer, whether running locally or remotely, uses Operating System (OS) authentication for establishing its connection with OpenEdge Management. You can alternatively configure INI authentication using either the default credentials or custom credentials defined in the activemqsRealm.properties file. The INI authentication lets you control who can access the AdminServer without depending on OS user accounts.

The procedure to configure INI authentication depends on whether you use the default or custom credentials. Choose the appropriate procedure below for configuring INI authentication.
Note: The activemqsRealm.properties file no longer supports plain‑text passwords. Irrespective of whether you use default or custom credentials for INI authentication, you must generate a Shiro‑encrypted password using the shiro-hasher utility and place it in the file.
To configure INI authentication for communication between AdminServer and OpenEdge Management using either default or custom credentials, complete the following steps:
  1. Stop the AdminServer. For details, see Stop the AdminServer.
  2. Generate an encrypted version of your plain-text password using the shiro-hasher utility and place the encrypted password in the activemqsRealm.properties file. For details, see Generate and apply Shiro-encrypted password for INI authentication.
  3. Change OS authentication to INI authentication in the activemqs.ini file. For details, see Enable INI authentication for the AdminServer.
  4. Start the AdminServer. For details, see Start the AdminServer.
  5. Add or update AdminServer credentials in OpenEdge Management. For details, see Add or update the AdminServer credentials in OpenEdge Management.