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. Launch a Proenv shell.
      • On Windows, select Start > Programs (or All Programs) > Progress > OpenEdge , then right-click Proenv and choose Run as administrator.
      • On Linux, run the following command:
        [installation-path]/bin/proenv
    2. Run the following fathom command:
      proenv> fathom -inipassword
    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:
      Enter Password:
      Confirm Password:
      $shiro2$argon2id$v=19$t=1,m=65536,p=4$ZpgVvaW1Ejk/9pj+IkUD7w$VUwL1KSug4MWuvMybwHMo16RJqbganXVgC8cxhBsN2U
      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 fathom command-line 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 file is placed.
      • On Windows, go to: %DLC%\properties\activemqsRealm
      • On Linux, go to: $DLC/properties/activemqsRealm
    2. Open the file using a text editor and locate the users section.
      [users]
      # user = password, role
      admin = admin, PSCAdmin
      
    3. Add the encrypted password by updating the user entry in the [users] section, and make sure to wrap the password in double quotes.
      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.