Skip to main content
Matrix42 Self-Service Help Center

Email settings: Gmail Configuration for Google Workspace Service Connection

Overview

This page provides a step-by-step guide on how to configure email sending in  Administration application via Google Workspace, involving modern authentication (OAuth 2.0) and Service Connections. 

This configuration is available starting from DWP v.11.0.1 or higher. 

Email configuration belongs to the basic settings of the DWP, therefore no extra subscriptions (DWP Subscription) or licenses are required.

Pperequisites 

  • Digital Workspace Platform v.11.0.1 or higher
  • An active and available mailbox that is the same as the one registered for your Google Workspace

Configuration

Use this video tutorial as a reference:

Configuration steps:

  1. New Service Connection using Google Workspace Service with Google Gmail capabilities;
  2. Emails settings in DWP Administration area.

Service Connection 

Log in to the Administration area of the Digital Workspace Platform, proceed to Integration navigation Item → Service Connections → choose Connections.

  1. To start configuration, click Add Service Connection action:
    01_1.png
  2. Fill out the required fields:
    02.png
  3. In the Service field, select Microsoft 365 Exchange object, which is available by default in the system:
    04_gmail1.png
  4. The name for your Service Connection is auto-generated, but you can modify it if necessary:
    05_gmail1.png
  5. In the Tenant field, proceed with creating a new tenant. Fill out the name:
    06_gmail.png
  6. In the Service field choose Google Workspace with OAuth Authentication Type:07_gmail1.png
  7. For Client ID and Client Secret, login to Microsoft Azure porta go to Google Cloud Platform:
    08_gmail1.png
  8. On the home page of the  Google Cloud Platform,  create a New Project:
    09_gmail1.png
  9. Provide a project name. Leave the default configuration in the Location settings:
    10_gmail1.png
  10. In the Notifications area, click Select Project:
    11_gmail1.png
  11. In the search bar, find and enable Gmail API:
    12_gmail1.png

    Enabled Gmail API is shown in the APIs & Services Dashboard as follows:
    13_gmail1.png
  12. In the OAuth consent screen, choose External User Type and click Create:
    14_gmail.png
  13. Follow the suggested steps and fill out the necessary information:
    • OAuth consent screen: enter the App name and User support mail:15_gmail.png
    • Scroll down to Authorized domains section and add the necessary domains:
      16_gmail1.png
      Add Developer contact information and click Save and continue.
  14. Scopes: define the permissions you request users to authorize for your app and allow your project to access specific types of private user data from their Google Account. Choose necessary options from the suggested list or add the scopes manually, for instance:
  15. Scroll down and click Save and continue. Proceed without changes to the Summary page to save your configuration. 
  16. Go Back to Dashboard → OAuth consent screen → Publishing status → click Publish App → Confirm:
    19_gmail1.png
  17. Go to Credentials → click + Create Credentials → choose OAuth client ID:
    20_OAuth_client_id.png
  18. In Application type, choose Web application:
    21_gmail.png
  19. Enter the name and add Authorized redirect URIs. Modify the Authorized redirect URIs according to the example:
    https://{hostname}/wm/externalAuth/exchange

    22_gmail1.png
    Click Create to save the configuration.
  20. Use the generated credentials for the Google Workspace Tenant configuration in Service Connections:
    23_gmail1.png
    Google Cloud Platform: Client ID and Client Secret values for Service Connections Tenant configuration
    24_gmail1.png
    Digital Workspace PlatformClient ID and Client Secret values for Service Connections Tenant configuration
  21. To finalize the Service Connection configuration, in the Administration area click Setup Authentication:
    25_gmail1.png
  22. Sign in with your Google account.
  23. Accept the requested permissions:
    27_gmail1.png
  24. When Service Connection Authentication has been successfully fulfilled, click Done:
    26_gmail_2.png

Emails settings 

To finalize the emailing configuration, in the Administration area, open Settings → Edit Global System Settings

28_gmail.png

In the Emails view:

  • Enabled: select the checkbox to enable emailing
  • Specify SMPT server according to the email server configuration
  • Verify the Default Sender
  • Enable SMTP Authentication
  • Enable Use SSL option
  • Select Modern Authentication (OAuth 2.0) property
    • Mailbox Email Address: enter an address of an active and available mailbox that is the same as the one registered for your Gmail Workspace Account
    • Service Connection: choose a previously created Service Connection

29_gmail.png

Click Done to finalize the configuration and save changes.

Now your Digital Workspace Platform emailing is working.