Integration with Hashicorp Vault

Email SMTP server

Before you start

Goal

• Use credentials from Vault for SMTP authentication.

Prerequisites

• Complete the initial install.
• Complete the Vault configuration.

To configure Hub to use Vault authentication credentials when it is making connections to the email SMTP server, it is necessary to set the mail.vaultSecretPath to the path of the secret from which the credentials should be fetched. It is expected that the secret have values called username, password.

Note that only the static KV secrets engine is supported for SMTP authentication.

Verification

Verify emails can be sent

• run the hubctl verify email command.
• run the hubctl testemail command.

The hubctl command can be used to verify the settings, and to send a test email to verify the mail configuration settings.

To verify email settings, use the command:

hubctl verify email

To send a test email, use the command:

hubctl testemail me@example.com

This will send a test email to the given email address, and print out any error that occurs.