Added in Iguana version 6.1 for Enterprise and Professional tiers only.
You must initialize (unlock) the locker using the Log Locker Password each time the Iguana Server is started. This will enable Iguana to access the log encryption key. If the initialization process fails Iguana will not be able to encrypt or unencrypt the logs.
Locker Initialization Methods [top]
There are two approved ways to initialize the locker file for production servers:
- Enter the password manually using the Iguana GUI:
- Each time the Iguana Server is started you will need to enter the Log Locker Password
- The Initialize Log Encryption Locker screen opens so you can enter the password
- You cannot leave this screen until the correct password has been entered
- Use the Auto-Unlock feature to enter the password automatically:
- When Auto-Unlock is enabled Iguana automatically applies the user password on startup
- This option can be enabled/disabled in the Log Encryption settings
- Iguana encrypts and stores your password in a proprietary auto-unlocker file
- Each time Iguana starts up it extracts and decrypts the password from the auto-unlocker file
Note: You can also supply the password by using the log_encryption_password argument for the Iguana executable. This may be used for some development environments, however in most cases using Auto-Unlock is preferred.
Because the password is supplied as plain text this method is not approved for use with production servers.
Initialization Examples [top]
And this is how to use the various initialization options:
- Enter the Log Locker Password manually on startup using the Iguana GUI:
- First you will need to login to Iguana
- The Initialize Log Encryption Locker screen will open
- Enter the password and press the Unlock button:
- Enable the Auto-Unlock feature to enter the password automatically:
- Open the Settings>Log Encryption
- Click the Enable button:
- Enter the Log Locker Password and click Enable: