Configuring SMTP Connections

You can choose to set up and use your own Simple Mail Transfer Protocol (SMTP) servers (with basic authentication) or use the Oracle Cloud Infrastructure Email Delivery service for e-mail delivery.

If using your own SMTP Server:

  • The SMTP server must have a public DNS name (we advise against using an IP address).

  • The SMTP server must have a valid SSL certificate signed by a trusted Certificate Authority.

  • The SMTP server must enforce TLS.

  • An outbound allowlist entry must be set up for the SMTP FQDN and port. For more information, See Configuring Outbound Domain Allow Listings.

  • If the SMTP server implements IP based allow-listing, contact Oracle support to obtain the Oracle IP address for the region.

If using the Oracle Cloud Infrastructure Email Delivery service, you must set up a Sender Policy Framework (SPF) record to detect email spoofing and send emails securely.

Once setup, you can select an SMTP configuration for each email delivery method. For more information, see Configuring Delivery Management.

About SPF

Sender Policy Framework (SPF) is used by email receivers to detect email spoofing. Using SPF, an email receiver can check if the Internet Protocol (IP) is explicitly authorized to send for that domain. SPF is implemented by publishing a special TXT record to a domain's DNS records. The TXT record declares which hosts are allowed to send mail on behalf of this domain. Receiving mail servers check the SPF records of sending domains to verify that the email's source IP address is authorized to send from that domain. Without SPF, a spam or phishing email can be “spoofed” to appear that the email comes from a legitimate domain. Domains that implement SPF are much more likely to block emails attempting to spoof your domain. For an overview of how SPF works, see Sender Policy Framework. For details on SPF record syntax, see SPF Record Syntax.  Also see Doc ID: DOC6575.

Adding SMTP Configuration

In multi-property operations, you can configure SMTP connections as global (all properties) or property-specific. Your chain role must be granted the Global SMTP Configuration task to add a Global entry.

  1. From the Toolbox menu, select System Setup, then select SMTP Configuration.

  2. Click New and complete the following:

    1. Context: Select a value from the list.

      1. Global: Select to define a chain-level SMTP configuration available to all properties.

      2. Property: Select to define a property-specific SMTP configuration.

        1. Property: Select a property from the list.

    2. Server Name: Enter the SMTP Server address

    3. Port: Enter the SMTP Server port.

    4. Username: Enter the username for SMTP authentication.

    5. Password: Enter the password for SMTP authentication.

    6. Click Save.

Editing SMTP Configuration

  1. From the Toolbox menu, select System Setup, then select SMTP Configuration.

  2. Enter search criteria and click Search.

  3. Select the SMTP server in search result, click the vertical ellipsis Actions menu and select Edit.

    1. Update configuration.

    2. Inactive: Select checkbox to set the SMTP connection inactive. Deselect the checkbox to activate.

  4. Click Save.

Deleting SMTP Configuration

  1. From the Toolbox menu, select System Setup, then select SMTP Configuration.

  2. Enter search criteria and click Search.

  3. Select the SMTP server in search result, click the vertical ellipsis Actions menu and select Delete.

  4. Click Delete to confirm.