Mail server settings

You can configure SMTP mail server settings in ADSelfService Plus to send reports, notifications, and alerts via email.

Configuring a mail server

1. Navigate to Admin > Product Settings > Mail / SMS Settings
2. Click the Mail Settings tab.



3. Enter your mail server's Server Name or IP and Port Number in the respective fields.
4. In the From Address field, enter the email address that will be used to send out notifications, reports, and alerts from ADSelfService Plus.
5. In the Admin Mail Address field, enter the email address(es) to receive notifications for the emails sent from ADSelfService Plus.
6. From the Secure Connection (SSL/TLS) drop-down, choose an option supported by the email server.
7. Next to Authentication Type, choose either Basic Authentication or OAuth Authentication.

Basic authentication



1. Enter the Username and Password to access the mail server.
2. If your mail server does not require authentication, leave the fields empty.

OAuth Authentication



Select your mail provider from the available options: Microsoft or Google.

If your mail provider is Microsoft, provide the Username, Tenant ID, Client ID, and Client Secret in the respective fields. In ADSelfService Plus, Azure Cloud is considered the default Azure environment. To modify the Azure environment setting, click the Azure Environment drop-down.

Note: To learn how to find your Azure Tenant ID, Client ID, and Client Secret, please refer to the Steps to find your Azure Tenant ID, Client ID, and Client Secret section below.

If your mail provider is Google, provide the Username, Client ID, and Client Secret in the respective fields.

Note: To learn how to find your Google Client ID and Client Secret, please refer to this section titled Steps to find your Google Workspace Client ID and Client Secret below.

8. Click Save Settings to save your mail server configuration.

Note: Once the mail server settings are successfully saved, a test email will be sent to the email address entered in the Admin Email Address field.

Notification Settings

1. Select Enable License Expiry Notification to alert admins when:
• There are a specified number of days until the ADSelfService Plus license expires.
• There are a specified number of available ADSelfService Plus licenses.
• An ADSelfService Plus license expires.
2. Select Enable Downtime Notification to receive an email when the server is down.
3. Select Enable Product Release Notification to receive alerts on the latest feature updates.
4. Select Enable Events and Workshop Notification to receive alerts on events and workshops conducted by ManageEngine.
5. To send alerts to all of the users' secondary email addresses, select Enable Notifications for All End-Users' Secondary Email Addresses.
6. To send alerts to all of the users' secondary mobile numbers, select Enable Notifications for All Secondary Mobile Numbers.
7. Click Save Settings.

Steps to find your Azure Tenant ID, Client ID, and Client Secret

1. Log in to portal.azure.com.
2. Under Azure services, click App registrations > New registration.
3. Provide a Name of your choice and select Supported Account Types, leaving it in its default setting.
4. In the Redirect URI field, paste the redirect URI in the following syntax:
https://server_name:port_number/context_if_any/RestAPI/WC/OAuthSetting
For example: https://localhost:8082/RestAPI/WC/OAuthSetting.

Note: To ensure security, Microsoft Azure requires non-localhost redirect URIs to begin with the HTTPS scheme. This may require ADSelfService Plus to run on the HTTPS protocol. Please find the steps to enable HTTPS in this guide.

5. On the next page, you will find the application details. Copy the Client ID and Tenant ID.
6. From the left pane, click Certificates & secrets > New client secret.
7. Provide a Description for the client secret, and in the Expires field, choose the validity of the client secret and click Add.
8. The client secret will be generated. Copy the string displayed under Value.
9. Click Save Settings and complete the authorization prompt.

Steps to find your Google Workspace Client ID and Client Secret

1. Log in to console.developers.google.com.
2. From the dashboard, click Create to create a new project if there is no existing project, or select any existing project and click New Project.
3. Enter the Project Name. In the Location field, click Browse and select the Parent Organization.
4. Click Create.
5. In the left pane of the displayed project details page, click APIs & Services > Library.
6. From the available list of APIs, select Gmail API and click Enable. You can use the search option to find the API quickly.
7. In the left pane, click OAuth consent screen and choose the User Type. If you don't have a Google workspace account, choose External User.
8. Provide the Application Name, Application Logo, and the Support Email of your help desk, Developer Information, and click Save & Continue.
9. Click Add or Remove Scopes, choose Gmail API (https://mail.google.com/), and click Update. Then click Save & Continue.
10. Add a test user and click Save & continue.
11. In the left pane, click Credentials > Create Credentials > OAuth Client ID.
12. Select the application type as Web Application. Provide a name of your choice.
13. In the Redirect URI field, paste the redirect URI in the following syntax:
https://server_name:port_number/context_if_any/RestAPI/WC/OAuthSetting
For example: https://localhost:8082/RestAPI/WC/OAuthSetting.

Note: To ensure security, Google Identity requires non-localhost redirect URIs to begin with the HTTPS scheme. This may require ADSelfService Plus to run on the HTTPS protocol. Please find the steps to enable HTTPS in this guide.

14. Click Save.
15. Click DOWNLOAD JSON to download the file containing the authorization server details. Copy the Client ID and Client Secret displayed on the screen.
16. Click Save Settings and complete the authorization prompt.