Administration Console

9.2.7 SP 1
- 9.2.7
- 9.2.6
- 9.2.5
- 9.2.4.6

Back Next

Configuring Email Service with OAuth 2.0 Authentication

Complete the following steps to register an application and configure permissions for sending emails using OAuth 2.0 in ActiveVOS:

Step 1. Register the Application

Registering for Gmail

Go to Google Cloud Console.

Create a new project or select an existing one.

Enable the

Gmail API

Go to

APIs & Services

Credentials

Go to

Create Credentials

OAuth client ID

Configure the OAuth consent screen with app name and scopes.

Set redirect URIs. For example: https://yourapp.com/activevos/oauth2callback.

Save the Client ID and Client Secret from your OAuth 2.0 Client.

Use the following endpoints for authorizing users and requesting access tokens:

Authorization URL:

https://accounts.google.com/o/oauth2/auth

Token Request URL:

https://oauth2.googleapis.com/token

Registering for Microsoft Outlook

Go to

Azure Portal

Go to

Azure Active Directory

App registrations

Select

New Registration

Enter the app name and specify redirect URI.

Complete registration and note down the Application client ID and Directory tenant ID.

Under

Certificates & secrets

, create a client secret.

Under

API permissions

, add the relevant Microsoft Graph API permissions:

Mail.Send

Mail.ReadWrite

offline_access

(to enable refresh tokens)

Note the Authorization URL (OAuth 2.0 authorization endpoint v2) and Token URL (OAuth 2.0 token endpoint v2) for later OAuth configuration.

Step 2. Whitelist Required Hosts

To ensure proper OAuth functionality, add all required hosts to the whitelist configuration.

Tomcat
:

<Tomcat folder>\webapps\active-bpel\WEB-INF\classes\aeEngineConfig.xml

JBoss
:

<JBoss folder>\standalone\deployments\ave_jboss.ear\active-bpel.war\active-bpel.war\WEB-INF\classes\aeEngineConfig.xml

Verify that the following URLs are included in the whitelistHosts property:

Authorization URL

Token URL

Email service host. For example: outlook.office365.com or smtp.gmail.com.

Step 3: Configure Email Service in ActiveVOS

After the OAuth 2.0 configuration completes, make sure to note the following values:

Authorization URL

Token URL

Client ID

Client Secret

ActiveVOS Console

Go to

Admin Page

Configuration Services

Email Service

In the Authentication Type
list, select OAuth
.The following image displays the Email Service configuration in ActiveVOS: Configuring email service in ActiveVOS

Configure the following settings:

Host
:

For Microsoft: Enter host as outlook.office365.com

For Google: Enter host as smtp.gmail.com

Contact your email provider administrator to confirm the correct host.

Port
:

Enter the port as

587

for both Microsoft and Google.

Contact your email provider administrator to confirm the correct host.

The following image displays the OAuth configuration details:

Enter the following OAuth Credentials:

Sender email address

Client ID

Client Secret

Authorization and Token URLs

Click Authorize
.

The screen redirects to the respective email provider’s authorization page. Enter your credentials or passcode to complete the authorization process.

To validate the email service configuration after successful authorization, click Update and Test
.

Rename Saved Search

Table of Contents

Administration Console

Administration Console

Configuring Email Service with OAuth 2.0 Authentication

Configuring Email Service with OAuth 2.0 Authentication

Step 1. Register the Application

Step 2. Whitelist Required Hosts

Step 3: Configure Email Service in ActiveVOS