Generate SMTP Credentials for a User

Simple Mail Transfer Protocol (SMTP) credentials are necessary to send email through Email Delivery. Each user is limited to a maximum of two SMTP credentials. If more than two are required, SMTP credentials must be generated on other existing users or more users must be created.

A security best practice is to generate SMTP credentials for a new user instead of your Console user that already has permissions assigned to it. For detailed instructions on creating a user, see Adding Users. The new user must be assigned to a group with permissions to manage the email-family resources. For example:

Allow group <senders group name> to use email-family in compartment <compartment name>

Where <senders group name> is the group this new user has been assigned to and <compartment name> is the name of the compartment which contains the approved senders that will use these credentials for sending. The policy to use email-family ensures that the user has the necessary access to all Email resources and not just approved senders. When attempting to send email, the SMTP error "535 Authorization failed: Envelope From address <approved-sender> not authorized" indicates that either the approved sender does not exist, the "use email-family" policy does not specify the compartment containing the approved sender, or the user with the SMTP credentials is not in a group with the "use email-family" policy.

Using the Console

To generate SMTP credentials for a user

  1. Open the navigation menu and click Identity & Security. Under Identity, click Users. Locate the user in the list that has permissions to manage email, and then click the user's name to view the details.
    Tip

    If your user does not have permissions to view or create users, you can create SMTP credentials under your user.

    Open the Profile menu (User menu icon) and click User Settings.

  2. Click SMTP Credentials.
  3. Click Generate SMTP Credentials.
  4. Enter a Description of the SMTP Credentials in the dialog box.
  5. Click Generate SMTP Credentials. A user name and password is displayed.
  6. Copy the user name and password for your records and click Close.