Generate and apply Shiro-encrypted password for INI authentication
- Last Updated: February 23, 2026
- 1 minute read
- OpenEdge
- Version 13.0
- Documentation
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:
- Generate the encrypted password.
- Navigate to the directory where the jars file is placed.
- On Windows, go to: %oemgmt%\jars
- On Linux, go to: $oemgmt/jars
- Run the shiro-hasher utility:
java -jar $oemgmt/jars/shiro-tools-hasher-<version number>-cli.jar -p - 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/4umsuXmg9b9KaZYNote:- 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.
- Navigate to the directory where the jars file is placed.
- Add the encrypted password in the activemqsRealm.properties file.
- 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
- Open the file using a text editor and locate the
userssection.[users] # user = password, role admin = admin, PSCAdmin - 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
- Navigate to the directory where the
activemqsRealm.properties file is placed.
- Save the changes.