General Inbound and Outbound Email Settings

This section describes the global settings in SL1 that allow SL1 to receive and send email messages. You must configure SL1 as described in this section before defining policies for events from email, tickets from email, or email round-trip policies.

Use the following menu options to navigate the SL1 user interface:

To view a pop-out list of menu options, click the menu icon ().
To view a page containing all of the menu options, click the Advanced menu icon ().

Configuring System Email Settings

To configure the system settings for email:

Go to the Email Settings page (System > Settings > Email).
To define settings for inbound email, provide values in the following field:

Authorized Email Domains. Type the SMTP domains that SL1 will use to receive incoming mail. The list of domains should include:

All domains used for loopback addresses in email round-trip monitoring policies.
All domains used to generate tickets from emails.
All domains used to receive event messages from third-party monitoring systems.
Each entry in this field must be a fully-qualified email domain and cannot exceed 64 characters. If you include a list of domains, separate the list with commas.
Each domain in this field must be managed by the Database Server or All-In-One Appliance. This means that a DNS MX record must already exist or be created that maps each domain specified in this field to the Database Server or All-In-One Appliance. When creating the DNS MX record, use the fully qualified name of the Database Server or All-In-One Appliance as the name of the email server.

The other fields on this page pertain to outbound email and are not required to configure inbound email. However, if you want to define settings for outbound email, provide values in the following fields:

System From Email Address. Type the default email address that SL1 should use to send outbound emails.

Some outbound email servers, such as Gmail, might overwrite the System From Email Address value and instead use the email address of the authenticated user.

Email Formal Name. Type the name that will appear in the from field in email messages sent from SL1.
Email Gateway. Type the IP address or fully qualified name of the SMTP relay server used by SL1. Examples of when SL1 sends outgoing email messages are:

Automatically in response to Tickets from Email policies.
Automatically in response to changes in a ticket (ticket is assigned, edited, or resolved).
Automatically based on Ticket Escalation policies.
Automatically when executing Email Round-Trip Monitoring policies.
Automatically when executing Run Book policies that include email actions.
Automatically based on Report Jobs policies.
Manually, when a user selects the Send Message page from the ticket panel pages.

To use the email server that is built in to SL1, type the IP address or fully qualified name of the Database Server or All-In-One Appliance in the Email Gateway field. If SL1 cannot use its built-in SMTP relay server to route email messages directly to their destination server (for example, due to firewall rules or DNS limitations), SL1 can use another relay server. If you do so, make sure you have configured your network to allow the Database Server or All-In-One Appliance to access this SMTP Relay server.

The Email Gateway field must be configured to use the appropriate port number to use, which is designated by a preceding colon. When no port number is specified, SL1 uses the default SMTP port (25).

Email Gateway Alt. Type the IP address or fully qualified name of the SMTP relay server SL1 should use if the primary email gateway is unavailable.
Escalation Notify Subject. Type the subject line that SL1 will use when sending ticket escalation notification emails.

The Escalation Notify Subject field can include one or more variables. For a list of the variables you can include, see the section on Global Settings for Inbound Email and Outbound Email.

Click Save. If the settings were saved successfully, the message "Email Settings Saved" is displayed at the top of the page.

System Settings that Affect Inbound Email

To define global settings that affect all inbound email, perform the following steps:

Go to the Behavior Settings page (System > Settings > Behavior):
To define settings for inbound email, provide the following values in the following field:

Strip FQDN From Inbound Email Device Name. In Events from Email policies, specifies how SL1 will match the regular expression for device name. Choices are:

Enabled. SL1 will search the text string in the incoming email and match all characters up to the first period that appears in the text string. If multiple devices in SL1 match the characters up to the first period (for example, my_device.1 and my_device.2), SL1 will align the event with the matching device with the highest Device ID.
Disabled. SL1 will search the text string in the incoming email for a match for the device name. The text string must include an exact match to the regular expression (defined in the Events from Email policy), including any text following a period in the device name. If SL1 does not find an exact match in the incoming email, SL1 creates an entry in the system log.

Inbound Email Alert Message. In each event policy, the First Match String and Second Match String fields specify the string or regular expression used to correlate the event with a log message. To trigger an event, the text of a log message must match the value in the First Match String and Second Match String fields in that event's policy. For Events from Email policies, this field specifies whether only the email message body will be written to the device log or whether both the email message subject and email message body will be written to the device log. Choices are:

Email Message Body Only. Only the email message body is written to the device log. The First Match String and Second Match String fields can examine and match only the email message body.
Email Message Subject and Body. Both the email message body and the email message subject are written to the device log. The First Match String and Second Match String fields can examine and match against both the email message body.

The global setting Inbound Email Alert Message affects how events are triggered. This field does not affect the Regex Pattern field in the Event from Email policy. The Regex Pattern field in an Event from Email policy specifies the device log to which the alert should be written.

Click the Save button.