Google Workspace - Send Direct Message to a User

Google Workspace - Send Message to a User posts a message to a Google Workspace user for:

Assets returned by the selected query or assets selected on the relevant asset page.

See Creating Enforcement Sets to learn more about adding Enforcement Actions to Enforcement Sets.

📘
Note:

Not all asset types are supported for all Enforcement Actions.

See Actions supported for Activity Logs, Adapters Fetch History, and Asset Investigation modules.

See Actions supported for Vulnerabilities.

See Actions supported for Software.

Required Fields

These fields must be configured to run the Enforcement Set.

Action name - The name of this Enforcement Action. The system sets a default name. You can change the name.
Configure Dynamic Values - Toggle on to enter a Dynamic Value statement. See Creating Enforcement Action Dynamic Value Statements to learn more about Dynamic Value statement syntax.

Use stored credentials from Google Workspace (G Suite) Adapter - Select this option to use credentials from the adapter connection. By default, the first connection is selected.
- When you select this option, the Select Adapter Connection drop-down becomes available. Select the adapter connection to use for this Enforcement Action.

📘
Note
To use this option, you must successfully configure a Google Workspace (G Suite) adapter connection.

Space ID - The ID of the Google Workspace to which to send the message.
Compute Node - The Axonius node to use when connecting to the specified host. For more details, see Working with Axonius Compute Nodes.

Additional Fields

Chat Header (default: Axonius Action Center) - The header of the chat.
Chat Text - The text to send to the user.

💡
Connection and Credentials

When Use stored credentials from the adapter is toggled off, some of the connection fields below are required to create the connection, while other fields are optional.

Email of an admin account to impersonate - The email of your Google Workspace admin.

Account Profile Name - Google user name for retrieving SaaS data.

JSON Key pair for the service account - Upload the JSON file you have created for your service account. For more details, refer to Google Workspace adapter.

Gateway Name - Select the Gateway through which to connect to perform the action.

API

Axonius uses the Method: spaces.messages.create | Google Chat | Google for Developers API.

Required Permissions

The stored credentials, or those provided in Connection and Credentials, must have the following permission(s) to perform this Enforcement Action:

https://www.googleapis.com/auth/chat.messages.create
https://www.googleapis.com/auth/chat.admin.spaces

For more details about other Enforcement Actions available, see Action Library.

Updated about 14 hours ago