Howto16r1:Configure OAuth2 E-Mail: Difference between revisions

Revision as of 08:33, 3 October 2025

FIXME: This product is in the beta phase and is not yet finished

innovaphone PBX and apps can be configured to send E-Mails for various subjects and purposes. Major E-Mail providers intent to discontinue the username/password authentication schemes in favour of OAuth2. PBX and Apps version 16r1 does support OAuth2 authentication for SMTP. Here is a step by step guide how to set up OAuth2 support in Microsoft 365 through the Azure Portal and how to set it up on a Google Gmail account in the Google Cloud Console.

Microsoft 365

Log in to Microsoft Azure Portal (https://portal.azure.com) and go to Microsoft Entra ID.

Add a new app registration to create client credentials.

Register the application and maybe already fill in the redirect URI for Web based application type to path OAUTH2-CLIENT/auth.htm at the PBX.

App registration is complete. Client ID and tenant needs to be configured at the PBX and every app that will be sending e-mails.

Create a client secret.

Copy the client secret. It also needs to be configured at the PBX and every app that will be sending e-mails.

Add permissions located in APIs my organization uses.

/AzureAddApiPermissionMyOrganization.png

More precisely located in Office 365 Exchange Online.

And there in the application permissions.

Namely SMTP Mail.Send.

Grant admin permission for Mail.Send.

API permissions are now granted.

Tell all redirect URIs that the PBX and the apps will be using during interactive authorization.

Allow public client flows of OAuth2. Resource Owner Password Credentials Flow has the advantage that it doesn't need interactive authorization.

Log in to the Microsoft 365 admin center (https://admin.cloud.microsoft).

Make sure that Microsoft 365 licenses are assigned to your user.

Set your user active.

Locate the Mail tab of your user.

Allow authenticated SMTP.

Login to the Exchange admin center (https://admin.exchange.microsoft.com).

Remove deactivation of the SMTP AUTH protocol.

With this Microsoft setup the OAuth2 configuration for the resource owner password credentials flow can be filled in as follows.

/OAuth2ResourceOwnerPasswordCredentials.png

For interactive authorization this is the OAuth2 configuration. Authorize e-mail access one time and send a test mail to verify everything went well.

Gmail

Login to the Google Cloud Console (https://console.cloud.google.com), select a project, New project.

Create the project.

Client credentials will be created in this project.

From the library specify the APIs needed to access.

These are in the Gmail API.

Choose the Gmail API and enable it.

Credentials need to be created.

Invoke the help me choose wizard.

/GoogleCreateCredentialsHelpMeChoose.png

User data access is needed.

Configure the consent screen of the interactive authorization.

Specify the permissions that need to be authorized by the user.

Its mail.google.com in general.

And its to send email on the users behalf.

These are the scopes needed.

Ask client credentials for Web type application.

9

1

2

3

4

5

6

7

8

@@ Line 59: / Line 59: @@
 [[File:GoogleProjectCreated.png|none|thumb|600x600px|/GoogleProjectCreated.png|/GoogleProjectCreated.png]]
 From the library specify the APIs needed to access.
-[[File:GoogleApisServicesFromLibrary.png|none|thumb|600x600px]]
+[[File:GoogleApisServicesFromLibrary.png|none|thumb|600x600px|/GoogleApisServicesFromLibrary.png]]
 These are in the Gmail API.
 [[File:GoogleApisServicesApiLibrary.png|none|thumb|600x600px|/GoogleApisServicesApiLibrary.png|/GoogleApisServicesApiLibrary.png]]
@@ Line 68: / Line 68: @@
 Invoke the help me choose wizard.
 [[File:GoogleCreateCredentialsHelpMeChoose.png|none|thumb|600x600px|/GoogleCreateCredentialsHelpMeChoose.png|/GoogleCreateCredentialsHelpMeChoose.png]]
-Access is needed with interactive authorization and user data access.
+User data access is needed.
 [[File:GoogleCredentialsUserData.png|none|thumb|600x600px|/GoogleCredentialsUserData.png|/GoogleCredentialsUserData.png]]
+Configure the consent screen of the interactive authorization.
 [[File:GoogleOAuthConsentScreen.png|none|thumb|600x600px|/GoogleOAuthConsentScreen.png|/GoogleOAuthConsentScreen.png]]
+Specify the permissions that need to be authorized by the user.
 [[File:GoogleOAuthScopes.png|none|thumb|600x600px|/GoogleOAuthScopes.png|/GoogleOAuthScopes.png]]
+Its mail.google.com in general.
 [[File:GoogleScopeMailGoogleCom.png|none|thumb|600x600px|/GoogleScopeMailGoogleCom.png|/GoogleScopeMailGoogleCom.png]]
+And its to send email on the users behalf.
 [[File:GoogleScopeAuthGmailSend.png|none|thumb|600x600px|/GoogleScopeAuthGmailSend.png|/GoogleScopeAuthGmailSend.png]]
+These are the scopes needed.
 [[File:GoogleScopes.png|none|thumb|600x600px|/GoogleScopes.png|/GoogleScopes.png]]
+Ask client credentials for Web type application.
 [[File:GoogleOAuthClientID.png|none|thumb|600x600px|/GoogleOAuthClientID.png|/GoogleOAuthClientID.png]]

Howto16r1:Configure OAuth2 E-Mail: Difference between revisions

Revision as of 08:33, 3 October 2025

Microsoft 365

Gmail

Navigation menu

Search