Generate a Shiro‑standard encrypted password and add it to the activemqsRealm.properties file to ensure the credentials remain secure.

To generate a Shiro‑standard encrypted password and add it to the activemqsRealm.properties file, perform the following steps:

  1. Generate the encrypted password.
    1. Navigate to the directory where the jars file is placed.
      • On Windows, go to: %oemgmt%\jars
      • On Linux, go to: $oemgmt/jars
    2. Run the shiro-hasher utility:
      java -jar $oemgmt/jars/shiro-tools-hasher-<version number>-cli.jar -p
    3. When prompted, enter the plain-text password and confirm it. The tool then displays the generated Shiro-standard encrypted password, as shown in the following sample output:
      Password to hash:
Password to hash (confirm):
$shiro2$argon2id$v=19$t=1,m=65536,p=4$tSkih9l4FlssnH72hvva8Q$QrdWGh4FyZp6WPvPwbnTeNw3MkM/4umsuXmg9b9KaZY
      Note:
      • Keep a record of the plain-text password you enter. This plain-text password is required to add or update the AdminServer configuration in OpenEdge Management.
      • The shiro-hasher utility uses the Argon2 algorithm to generate the encrypted password. Only Argon2 is supported for hashing the plain‑text password. Other hashing algorithms are not supported.
  2. Add the encrypted password in the activemqsRealm.properties file.
    1. Navigate to the directory where the activemqsRealm.properties file is placed.
      • On Windows, go to: %DLC%\properties\activemqsRealm.properties
      • On Linux, go to: $DLC/properties/activemqsRealm.properties
    2. Open the file using a text editor and locate the users section.
      [users]
# user = password, role
admin = admin, PSCAdmin
    3. Add or update the user entry in the [users] section with the encrypted password enclosed in double quotes.
      • If you are updating the existing user credentials, replace the plain-text password with the encrypted password.
      • If you are adding a new user, specify the username, the encrypted password, and role.
      For example:
      [users]
# user = password, role
admin = admin, PSCAdmin
admin2= "$shiro2$argon2id$v=19$t=1,m=65536,
p=4$tSkih9l4FlssnH72hvva8Q$QrdWGh4FyZp6WPvPwbnTeNw3MkM/
4umsuXmg9b9KaZY", PSCAdmin
  3. Save the changes.