Generate and apply Shiro-encrypted password for INI authentication
- Last Updated: June 3, 2026
- 1 minute read
- OpenEdge
- Version 13.1
- 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.
- 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
- Run the following fathom command:
proenv> fathom -inipassword - 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$VUwL1KSug4MWuvMybwHMo16RJqbganXVgC8cxhBsN2UNote:- 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.
- Launch a Proenv shell.
- Add the encrypted password in the activemqsRealm properties file.
- Navigate to the directory where the activemqsRealm file is placed.
- On Windows, go to: %DLC%\properties\activemqsRealm
- On Linux, go to: $DLC/properties/activemqsRealm
- 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 file is placed.
- Save the changes.