Email server settings

The email server settings have to be configured for you to receive product notifications via email. Follow the steps below to specify the email server details:

1. Log in to ADManager Plus and select the Admin tab.
2. In the left pane, under General Settings, click Server Settings.
3. Navigate to the Email Server/SMS Gateway tab.
4. Select Email Server to configure the email server settings.
5. Specify the following:
   • Email Server: Enter the email server's hostname or IP address.
     Note: Ensure you enter the appropriate hostname based on your region for proper configuration. For example, use outlook.office365.us for Azure US Government.
   • Email Port: Specify the port number used by the email server.
   • Click the Authentication link to secure your email server from anonymous logins. In the pop-up that opens, select the desired Authentication Type.

     If you select Basic Authentication as the Authentication Type:

     • Enter the username and password of an account with administrator privileges for the email server.
     • Choose a communication protocol using which the email server can be accessed.
     • Click Configure.

     If you select OAuth Authentication as the Authentication Type:

     • Select your Mail Provider from the options provided: Microsoft or Google. If your email provider is Microsoft, enter the Username, Tenant ID, Client ID, and Client Secret in the respective fields, and click Configure. Azure Cloud is the default Azure environment. You can select the Azure environment of your choice by clicking Choose the appropriate Azure environment.
     • If your email provider is Google, enter the Username, Client ID, and Client Secret in the respective fields, and click Configure. Learn how to find these values in the Google Developer Console.
     Note: When you are redirected to Microsoft 365 during OAuth authentication, authorize using the same username given during the configuration. It is mandatory to use a username associated with a mailbox. Find more information regarding OAuth authentication troubleshooting here.
   • From Address: Enter the email address from which you would like to receive notifications.
   • Administartor's Email Address: Enter the email address at which you would like to receive notifications.
6. Click Save Changes.

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

1. Log in to the Azure Portal.
2. Click Azure Active Directory.
3. Under Manage, click App Registrations.
4. Click +New Registration.
5. Enter a suitable name for the application and specify who can access this application in Supported Account Types (leave it as the default selection).
6. In the Redirect URI field, select Web from the drop-down list and choose one of the following:
   • Paste the following link:
     https://identitymanager.manageengine.com/api/public/v1/oauth/redirect
   • Add the localhost redirect API in the following syntax:
     protocol://localhost:port_number/context_if_any/RestAPI/WC/OAuthSetting For example, http://localhost:8082/RestAPI/WC/OAuthSetting.
     Note: If you have only added localhost as the Redirect URI, you must access the product using localhost to configure the email server.
   • Click Register.
   • Copy the Client ID and Tenant ID displayed on the registration overview page.
   • In the left pane, click Certificates & Secrets > Client Secrets.
   • Click New Client Secret, provide a description and secret expiration value, and click Add.
   • Copy the key value.

Paste the copied Client ID, Tenant ID, and Client Secret during email server configuration.

Steps to find your Google Workspace Client ID and Client Secret:

1. Log in to the Google Developer Console.
2. Select an existing project or click Create a Project to create a new project.
3. Enter a project name and description and in the Location field, click Browse, and select your organization.
4. Click Create.
5. In the left pane under API & Services, click Library.
6. From the list of available APIs, select Gmail API and click Enable.
7. In the left pane under API & Services, click OAuth Consent Screen.
8. Select the User Type. If you don't have a Google Workspace account, select External as the user type and click Create.
9. Provide the Application Name, App Logo, Support email of your help desk, and Developer contact information, and click Save & Continue.
10. Click Add or Remove Scopes, choose Gmail API (https://mail.google.com/), and click Update. Then click Save & Continue.
11. In the left pane, click Credentials > Create Credentials > OAuth Client ID.
12. Select Web Application as the Application Type and enter a suitable name for the client.
13. In the Authorized Redirect URIs, choose one of the following:

    In the Authorized Redirect URIs, choose one of the following:
    https://identitymanager.manageengine.com/api/public/v1/oauth/redirect

    • Add the localhost redirect API in the following syntax:
      protocol://localhost:port_number/context_if_any/RestAPI/WC/OAuthSetting For example, http://localhost:8082/RestAPI/WC/OAuthSetting.
      Note: If you have only added localhost as the redirect URI, you must access the product using localhost to configure the email server.
14. Click Create.
15. Click DOWNLOAD JSON to download the file containing the authorization server details. Copy the Client ID and Client Secret displayed on the screen.

Paste the copied Client ID and Client Secret during email server configuration.