Online Help

Configuring alerts for Google Mail with OAuth

Introduced in 2023.1

This article will guide you through the process of configuring automated outgoing alert notifications using Google Mail's OAuth authentication.

Before you begin:

All e-mail notifications are sent by the Inventory Server, so make sure that the Inventory Server is configured and started. For details, see Inventory Server Manager.

To configure e-mail settings:

  1. Mandatory: Go to Services > E-mail Settings and choose Google Mail (SMTP + OAuth) from the drop-down list.

  2. Optional: Specify additional message options in the Services > E-mail Settings section.

    • Type the default sender's e-mail address in the 'From' e-mail address field. This address will appear in the From header of outgoing e-mail notifications.

    • TIP: You can overwrite this default address later when you configure individual E-mail Notifications for your workflow. For details, see Configuring E-mail Notifications.

    • To send messages in plain text format, select the Send all e-mail messages in plain text format check box.

    • To limit the allowed size of file attachments, select the Limit the total size of attachments to check box and specify the limit in megabytes.

      NOTE: Notifications with attachments exceeding the specified size limit will not be added to the Notification Queue and, correspondingly, will not be sent. During the execution of a workflow Action resulting in such a notification, Alloy Discovery displays an error to the user who initiated the Action.

  3. Specify the following settings under Services > E-mail Settings:

    1. Make sure that the name of Google's SMTP server and port number 465 are pre-populated.

    2. Enter the Client ID and Client Secret that you obtained while configuring Google Mail settings with OAuth for the Mail Connector.

    3. Click the Sign in hyperlink to sign in to your Gmail account.

  4. To verify your settings, click Test Settings. Alloy Discovery will send a test message using the specified parameters to confirm the ability to communicate with the mail server. When the Send Test Message window opens, enter a valid e-mail address to send the test message to, choose the Inventory Server instance (if you have more than one), and click OK.

  5. Click Save on the toolbar.

In order to send an alert notification, the Inventory Server connects to the specified outgoing mail server, and the outgoing mail server will send out the message. Make sure the Inventory Server is configured and started. For details, see Inventory Server Manager.

NOTE: In case you configure the e-mail settings after audit data has been uploaded, the alert record appears in the Alert Log (for details, see Viewing Alert Log) but the alert notifications can not be sent out.