Configuring the Email Service

The user self-service feature lets you send confirmation emails via AM's SMTP Email Service to users who are registering at your site or resetting forgotten passwords. If you choose to send confirmation emails, you can configure the Email Service by realm or globally.

If the user enters an invalid username, invalid firstname/surname, or invalid email address during the username or password reset flows, AM presents them with a message similar to An email has been sent to the address you entered. Click the link in that email to proceed, and but does not actually send an email.

If the user enters an existing username while registering, AM presents them with a message similar to An email has been sent to the address you entered. Click the link in that email to proceed, and then sends an email with a registration link to the address that the user entered. Clicking on the link sends the user to the registration page again, and AM shows a message similar to One or more user account values are invalid.

This is to protect the service against account enumeration attacks.

Important

Each individual user must have a unique email address to use the email features of user self-service.

To Configure the Email Service

Perform the following steps to configure the Email Service:

  1. Log in to the AM console as the administrator.

  2. Navigate to Realms > Realm Name > Services.

  3. Select Add a Service and choose Email Service from the list of available services.

  4. Configure the Email Service:

    1. In the Mail Server Host Name field, enter the hostname of the mail server. If you are using the Google SMTP server, you must also configure the Google Mail settings to enable access for less secure applications.

    2. In the Mail Server Authentication Username field, enter the username to authenticate to the mail server. If you are testing on a Google account, you can enter a known Gmail address.

    3. In the Mail Server Authentication Password field, enter the password corresponding to the username used to authenticate to the mail server.

    4. In the Email From Address field, enter the email address from which to send the email notifications. For example, no-reply@example.com.

    5. Select Create.

    6. (Optional) Configure additional properties in the Email Service as needed.

      For more information about the different configuration properties, see "Email Service".

Read a different version of :