Manage mail servers

The Mail Server setting allows you to use your own SMTP mail server to send emails. By default, email messages are sent from the Identity as a Service built-in mail server. When you configure a custom SMTP server, all messages sent from Identity as a Service are sent from the custom SMTP server.

For Basic authentication you provide the SMTP username and password directly in IDaaS. For OAuth authentication, you do not provide the username and password for authorization in IDaaS. The username is retrieved after signing in to the OAuth application as long as you have the required ID token.

For example, if you want to set up Gmail as your SMTP server, you would use the following:

For example, if you want to set up Google as your SMTP server, you would use the following:

● The required scopes: https://mail.google.com https://www.googleapis.com/auth/userinfo.email

Configure a custom mail server using basic authentication

1. Click > Configuration > Mail Server. The Mail Server page appears.

2. Select Custom Mail Server to set a custom mail server. The Mail Server page appears.

3. Select the Basic Authentication Method.

4. Select the Protocol used by your mail server to secure your emails.

5. In the SMTP Server field, enter the hostname of the SMTP server (your outgoing mail). For example, smtp.mailprovider.com.

6. In the SMTP Username field, enter the SMTP username. This is the email address associated with the mail server (for example, example@yourdomain.com).

7. In the SMTP Password field, enter the SMTP password of the SMTP username.

8. Optional. In the From Name field, enter the name of the user that sends the emails.

9. In the From Address, enter the email address that sends the email message.

10. In the Reply To Address, enter the email address that receives replies. Leave this field blank to disable the ability to send replies.

11. Click Save.

12. Click Send Test Email to test the settings.

Configure a custom mail server to use OAuth authentication

1. Click > Configuration > Mail Server. The Mail Server page appears.

2. Select Custom Mail Server to set a custom mail server. The Mail Server page appears.

3. Select the OAUTH Authentication Method.

4. Select the Protocol used by your mail server to secure your emails.

5. If applicable, enter the Issuer URL used to by your server to send outgoing mail. For example, https://accounts.mailprovider.com.

6. Click Fetch Configuration. If available, this button fetches the Authorization Endpoint and the Token Endpoint. If the Fetch Configuration option is not available for your SMTP mail server, refer to your mail server provider documentation and interface for the Authorization Endpoint and Token Endpoint and then enter the information in the corresponding fields.

7. If needed to configure your OAuth mail server, copy the Redirect URI and paste it where required in your mail server configuration page.

8. Enter the Client ID of the application configured on the mail server.

9. Enter the Client Secret of the application configured on the mail server.

10. Enter the Scopes needed for the application. These permissions the users have when using the mail server, for example

● Read, write, send, and delete emails

● Link users to their personal information on the mail server.

● See primary account email address

If there are multiple scopes, separate them with a space.

Example: https://mail.mailprovider.com https://mailproviderapis.com/auth/userinfo.email

Note: The offline_access scope is not required for GMAIL OAUTH. If added, it causes an error.

11. Click Authorize. You are redirected to your OAuth application to sign in.

12. Enter your application username and password. If you receive a message that your OAuth application has not yet been approved app access, you must provide the consent for IDaaS to have access to your OAuth account.

13. Click Continue. A verification page appears. Optionally, click the link to view the email Services that IDaaS will be able to access. these are the scopes that your defined in step 8.

14. Click Continue again to return to the IDaaS Mail Server page. The SMTP Username and the From Address fields are populated from the OAuth log in information.

Note: If there is no ID Token, you must manually enter the SMTP username.

15. If required, copy the Redirect URI. You need this to configure Microsoft or Gmail email OAuth servers.

16. In the SMTP Server field, enter the hostname of the SMTP server (your outgoing mail). For example, smtp.mailprovider.com.

17. Optionally:

a. In the From Address, enter the email address that sends the email message.

b. In the Reply To Address, enter the email address that receives replies. Leave this field blank to disable the ability to send replies.

18. Click Save.

19. Click Send Test Email to test the settings.