Google Chat for Workspace

What is the Google Chat for Workspace webhook?

The Google Chat for Workspace webhook sends detections and recommendations from Identity Security Insights directly to a specified Google Chat space.

How is it useful?

With a configured Google Chat for Workspace webhook, you and others in your organization can view your detections and recommendations, making it easier to collaborate on improvements to your security posture.

Prerequisites

BeyondTrust

You must have:

• access to an Insights tenant
• an Insights account with the Administrator role

Google Chat for Workspace

You must have:

• an active Google Workspace administrator account
• Space Manager access to a dedicated space in Google Chat for Workspace
• a registered Google Chat webhook for Insights

⚠️

Important

Third-party documentation is subject to change. Updates might not be reflected in BeyondTrust documentation. For the most up-to-date information, check Google Chat for Workspace for Admin Help Center.

Configure Google Chat for Workspace webhook

1. Ensure you have:

   • an active Google Workspace administrator account
   • Space Manager access to a dedicated space in Google Chat for Workspace

2. In Google Chat, create the webhook.

   ℹ️

   Note

   We recommend you enter a human-readable webhook name (for example, BeyondTrust Identity Security Insights).

3. Copy the Google Chat webhook URL.

4. In Insights, click > Insights > Integrations.
   The Integrations page displays.

5. Click Webhooks.
   The Summary page displays.

6. Click Create Integration.
   The Create page displays.

7. Enter the following information:

   • Webhook Name: a human-readable name (for example, Google Chat)

   • Webhook URL: the URL you copied above from the Incoming webhooks page in Google Chat for Workspace.

   • Authorization Type: leave unselected

   • Webhook template: Copy and paste the following template:

     {
     
     "text"
     
     "Severity:%%severity%%\nWhen:%%timestamp%%\nSummary:%%definitionSummary%%\nSource:%%source%%\nLocation:%%location%%\nEntity Type:%%entityType%%\nEntity Name:%%entityName%%"
     
     }
     

8. Optionally, add additional variables as listed in Insights to the template.

9. Select Send detections automatically.

10. Click Save Integration.
    The Google Chat for Workspace webhook is configured.

Test the Google Chat for Workspace webhook

1. In Insights, click > Insights > Integrations.
   The Integrations page displays.
2. Click Webhooks.
   The Summary page displays.
3. Locate your webhook from the list and click it.
   The webhook Configuration page displays.
4. At the bottom of the page, click Test Connection.
   A confirmation message displays.
   • If the test is successful, you can view the generated message in your dedicated Google Chat space.
   • If the test is unsuccessful, there was an error while attempting to send a request to the configured webhook destination. Review all entries to ensure they are correct both in Insights and in Google Chat for Workspace, then retry the test.