Encrypt Password page - Platform - BlueCat Gateway - 24.1

Gateway Administration Guide

Locale
English
Product name
BlueCat Gateway
Version
24.1

The Encrypt Password page lets you create encrypted password files that you can use with the Mail and MongoDB features. These features require you to specify a password for Gateway to use when working with those features. You can either enter the password directly, or upload an encrypted password file. The Encrypt Password page is a tool that lets you create that file.

By default, the Encrypt Password tool uses the secret key for the local Gateway instance, as specified in the Certificates section of General Configuration (see Configuring Certificates settings). If you want, you can enter a custom secret key instead. Custom secret keys are useful when creating password files for other Gateway instances with a different secret key.

Note: Best security practices recommend that passwords never be stored in plaintext (without encryption). Even if you enter a password directly, when storing that password, Gateway will still first encrypt it using the secret key of the local Gateway instance.

To create an encrypted password file:

  1. Open the Encrypt Password window. (Click the Navigator button if necessary, then click Configurations > Encrypt Password.)

  2. In Password path, enter the path and file name for the encrypted password file.

    You will retrieve this file later, so make sure it is a folder both you and Gateway can access.

  3. Specify the secret key that you want to use to encrypt the entered password

    • If you want to use the secret key for the local Gateway instance, make sure the Use custom key checkbox is cleared.

      Tip: To specify the local Gateway, go to the Certificates section of General Configuration (see Configuring Certificates settings).
    • If you want to use a custom key, click to select the Use custom key checkbox, then enter the custom key in Custom key.

      This option is useful when creating password files for other Gateway instances, which likely have a different secret key.

  4. When you're done, click Encrypt Password. Gateway encrypts the password and saves it as the file at the path you specified.

    To cancel the operation, click Cancel instead.

  5. Outside of Gateway, navigate to and retrieve the file at the specified path.