You can change the AdminServer authentication method by updating the activemqs.ini configuration file. Enabling INI‑based authentication involves configuring a credentials matcher to validate the encrypted password and switching the authentication realm from $osRealm to $iniRealm.

To enable INI authentication for the AdminServer, perform the following steps:

  1. Navigate to the directory where the activemqs.ini file is placed.
    • On Windows, go to: %DLC%\properties\activemqs.ini
    • On Linux, go to: $DLC/properties/activemqs.ini
  2. Open the configuration file using a text editor.
  3. Configure a credentials matcher to validate the encrypted password by adding the following entry: 
    # Use a CredentialsMatcher for validating stored credentials
credentialsMatcher = org.apache.shiro.authc.credential.PasswordMatcher
    Note: Add this entry before the INI realm entries in the file.
  4. Associate the INI realm with the credentials matcher.
    • Locate the existing INI realm entries. For example:
      
# Properties file–based realm
iniRealm = org.apache.shiro.realm.text.IniRealm
iniRealm.resourcePath = <path-to-activemqsRealm.properties>
    • Add the following entry after the existing INI realm entries:
      iniRealm.credentialsMatcher = $credentialsMatcher
  5. Change the authentication to INI authentication.
    1. Locate the securityManager.realms property. By default, the value of this property is $osRealm.
    2. Update the value of the securityManager.realms property to $iniRealm.
      securityManager.realms = $iniRealm
  6. Save the changes.