Mail service - BlueCat Integrity - 9.5.0

Address Manager Administration Guide

ft:locale
en-US
Product name
BlueCat Integrity
Version
9.5.0

Users can configure the Address Manager mail service to send email to a particular SMTP host. If the server has been upgraded to Address Manager v9.5.4, users can also enable SMTP TLS encryption (SMTP with STARTTLS) to send secure SMTP traffic over port 587.

Users can configure the Address Manager mail service in the following ways:
  • SMTP with TLS encryption disabled (Default): Set an SMTP host, sender address, and optionally a username and password for authentication. SMTP messages are sent over port 25.
  • SMTP with TLS encryption enabled (SMTP with STARTTLS): Set an SMTP host, sender address, username, password, and enable SMTP TLS encryption. SMTP messages are sent over port 587. The server must be upgraded to Address Manager v9.5.4 to use SMTP with TLS encyption.
SMTP TLS encryption is disabled by default, and must be enabled in the CLI to send secure SMTP traffic over port 587.
Note: This section describes how to configure the SMTP host, sender address, optional username and password, and enable/disable TLS encryption. To start the email notification service and subscribe to events, set up a notification group as detailed in Managing notification groups. The email address associated with the user in the notification group is the mail service destination address. To configure user accounts, refer to Managing Address Manager users.
Note: When database replication is configured, the mail service can be configured on the secondary Address Manager server, however notifications will not be sent from the secondary server until database replication failover is performed to promote the secondary server to primary.

Users can view current mail settings and modify them as needed. To view current mail settings, enter show mail from Main Session mode, or enter mail service configuration mode with configure mail, then enter show.

show mail with no authentication configured and TLS encryption disabled:

Proteus> show mail
Sender address: jsmith@examplehost.exampledomain.com
SMTP host: smtp.examplehost.exampledomain.com
SMTP port: 25
SMTP TLS Encyption: disabled

show mail with authentication configured and TLS encryption enabled:

Proteus> show mail
Sender address: jsmith@examplehost.exampledomain.com
SMTP host: smtp.examplehost.exampledomain.com
SMTP port: 587
SMTP TLS Encyption: enabled
Username: jsmith@examplehost.exampledomain.com
Password has been set
When in mail service configuration mode, press Tab to view a shortlist of available commands, or type help to view a description of each available item. The following commands are available:
  • set—set mail service properties.
    • set sender-address <example.examplehost.exampledomain.com>: set the SMTP sender address
    • set smtp-tls-encryption: enable/disable the SMTP with TLS encryption
    • set smtp-host <example@example.com>: set the SMTP host for handling outgoing mail
    • set smtp-credentials: open the SMTP username and password configuration prompt
  • remove smtp-credentials—remove the current SMTP username and password.
  • exit—exit mail service configuration mode.
  • help—display help information.
  • history—display the current session’s command line history.
  • show—display the current mail service configuration.