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. If you use custom credentials for INI authentication, you must generate a Shiro‑encrypted password using the shiro-hasher utility and place it in the file. If you use default credentials for INI authentication, no update is required because the default password is automatically encrypted in the activemqsRealm.properties file.

Configure INI authentication using default credentials

Use this procedure when you want to configure INI authentication using default credentials in the activemqsRealm.properties properties file.

To configure INI authentication for communication between AdminServer and OpenEdge Management using default credentials, complete the following steps:
  1. Stop the AdminServer. For details, see Stop the AdminServer.
  2. Change OS authentication to INI authentication in the activemqs.ini file. For details, see Enable INI authentication for the AdminServer.
  3. Start the AdminServer. For details, see Start the AdminServer.
  4. Add or update AdminServer credentials in OpenEdge Management. For details, see Add or update the AdminServer credentials in OpenEdge Management.

Configure INI authentication using custom credentials

Use this procedure when you want to configure INI authentication using custom credentials in the activemqsRealm.properties properties file.

To configure INI authentication for communication between AdminServer and OpenEdge Management using 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 custom 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.