Password Encryption

Password encryption allows HCL Enterprise Integrator (HEI) users to encrypt password information using their own encryption keys. The HEI server is always able to read the passwords. Password encryption in HEI pertains specifically to the password as stored in the Notes® database and as seen on the screen, not for communicating to the external system database. When data is sent to the external system database, encryption is removed.

Note: Password encryption is not available for all connection documents.

As the author of a connection document, you can encrypt passwords using Notes® encryption keys. All encryption keys used to encrypt connections must be added to the HEI server's Notes® user ID.

Once you have created encryption keys, you can enable encryption for a connection document by clicking the Password not Encrypted button in the connection document and then selecting the encryption key to use. This process is described as follows.

Creating and Using Password Encryption Keys

This process attaches an encryption key on the HEI server ID. The encryption key is not for your Notes® ID, it is for the Notes® ID used by the HEI server.

  1. Open a connection document.
  2. Click File -- Security -- User Security from the Notes® menu.
  3. Enter your Notes® password when prompted.
  4. Click the Notes® Data tab and then the Documents tab.
  5. Click New Secret Key.
  6. Enter a new encryption key in the resultant data entry field, for example abx459. Optionally add comments in the data entry field provided for comments.
  7. Click OK.
  8. The new encryption key, in this example abx459, appears in the Encryption keys field on the resultant User ID menu.
  9. Click Export.
  10. Specify a file name on the Domino® server in which to store the new encryption key.
  11. Shut down the Domino® server where HEI is installed.
  12. Select File -- Tools -- Switch ID and enter the Notes® ID used on that Domino® server.
  13. Click the Notes® Data tab and then the Documents tab.
  14. Click Other Options and then select "Import Secret Key."
  15. Select the encryption key created previously, in this example abx459.
  16. Restart the Domino® server where HEI is installed.
    Note: See the Password Encryption section of the Notes® online help for more information.
  17. Create or open your connection document in Edit mode.
  18. Click the Password Not Encrypted button on the connection document.
  19. Click Yes in response to the password encryption prompt.
  20. Click the key tab on the resultant Document property sheet.
  21. Select the desired key, in this example abx459, from the Secrete Encryption keys field.
  22. Save the connection document.

You are now ready to run an HEI activity with the connection document containing the encrypted key.