Configuring SMTP Connections

You can choose to set up and use your own Simple Mail Transfer Protocol (SMTP) servers 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.
Password or oAUTH authentication are supported.

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.

From the Toolbox menu, select System Setup, then select SMTP Configuration.
Click New and complete the following:
1. Select the Context.
  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. Select the Authentication Method.
  1. Password
    1. Username: Enter the username for SMTP authentication.
    2. Password: Enter the password for SMTP authentication.
  2. oAuth (access token)
    1. oAuth Token URL: Enter the URL used to exchange access and refresh tokens.
    2. Client Key: Enter the secret key generated for Client ID
    3. Client ID: Enter the application identifier issued by your email provider when you register OPERA Cloud.
    4. Tenant ID: Enter your the Oracle Hospitality Tenant ID (optional).
    5. Scope: Enter the permissions required. Example: mail.send (send emails).
4. Port: Enter the SMTP Server port.
5. Username: Enter the username for SMTP authentication.
6. Password: Enter the password for SMTP authentication.
7. Click Save.

Editing SMTP Configuration

From the Toolbox menu, select System Setup, then select SMTP Configuration.
Enter search criteria and click Search.
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.
Click Save.

Deleting SMTP Configuration

From the Toolbox menu, select System Setup, then select SMTP Configuration.
Enter search criteria and click Search.
Select the SMTP server in search result, click the vertical ellipsis Actions menu and select Delete.
Click Delete to confirm.