Iguana stores passwords in a hashed format in the configuration file called ‘IguanaConfiguration.xml‘. These instructions explain how to reset the admin user password to “password”.
Note: To change passwords for other users, use Iguana Settings > Change Password in Iguana Settings.
Tip: When Iguana is installed it automatically fills in the admin password in the logon screen. To change this behaviour simply change the admin password.
This behaviour has two purposes: Convenience by allowing you to logon with one click on a development server and security as it reminds you to change the admin password on a production server.
To reset your admin password
- Stop the Iguana Service:
- On Windows use the “Administrative Tools > Services” to stop the iNTERFACEWARE Iguana service
- On Mac OSX, Linux, or Unix you must stop the iguana_service daemon
- Make a backup copy of the IguanaConfiguration.xml file:
- This file is stored in the Iguana install directory
- Windows default is C:\Program Files\iNTERFACEWARE\Iguana
- Mac OSX, Linux or Unix the default install is in <your home directory>/iNTERFACEWARE-Iguana
- Open the IguanaConfiguration.xml file in Notepad, or another text editor.
- Locate the entry for the admin user, which should look something like this:
<user name="admin" email_address="" password="40C38F8D22DC8EF630AFD8C4F1A0904F"> <group name="test group"/> </user>
- Change the password attribute to the following:
password="E3274BE5C857FB42AB72D786E281B4B8"This will reset the admin password to “password”.
- Save your changes.
- Restart the Iguana service.
- Log onto Iguana as admin using a password of “password”.
- Change the admin password to something that follows your security guidelines.
Note: The Iguana admin user has full access to everything in Iguana. We recommend that you use a secure password, particularly for production systems.