By default, the AdminServer, whether running locally or remotely, uses Operating System (OS) authentication for establishing its connection with OpenEdge Management. To improve performance, authenticated OS credentials are cached for a configurable duration, reducing repeated authentication requests for the same user. You can configure the cache duration by updating the activemqs.ini file.

As an alternative to OS-based authentication, you can 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 fathom command-line 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.

Modify the cache duration for Operating System-based authentication

By default, the AdminServer caches Operating System (OS) authentication credentials for 600 seconds (10 minutes). This caching improves performance by reducing repeated authentication requests for the same user. You can modify the cache duration by updating the cacheMemoryCacheFactory.ttlSeconds property in the activemqs.ini file.

To modify the cache duration for OS-based authentication, perform the following steps:
  1. Stop the AdminServer. For details, see Stop the AdminServer.
  2. Open the activemqs.ini file.
    • On Windows, go to %DLC%\properties\activemqs.ini
    • On Linux, go to $DLC/properties/activemqs.ini
  3. Locate the cacheMemoryCacheFactory.ttlSeconds property.
    cacheMemoryCacheFactory.ttlSeconds=600
  4. Set the property value as required. This value determines how long, in seconds, the authenticated OS credentials remain in the cache before they expire.
    Value Description
    0 Specifies that the cached credentials never expire.
    600 (default) Specifies that the cached credentials expire after 10 minutes.
    Any other positive integer Specifies that the cached credentials expire after the specified number of seconds.
    Note:
    • If you set the property to a negative value, or remove the property from the file, the value is reset to the default value of 600.
    • If you set the property to an invalid value (for example, a non-numeric or alphanumeric), the value is reset to 0.
  5. Save the file.
  6. Restart the AdminServer. For details, see Start the AdminServer

Configure INI authentication using default credentials

Use this procedure when you want to configure INI authentication using default credentials in the activemqsRealm 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 configuration settings 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 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 fathom command-line utility and place the encrypted password in the activemqsRealm file. For details, see Generate and apply Shiro-encrypted password for INI authentication.
  3. Change OS authentication to INI authentication in the activemqs configuration settings 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.