Google Directory - Enrich Incident With User Info

Browse: 🏠 · Solutions · Connectors · Methods · Tables · Content · Parsers · ASIM Parsers · ASIM Products · Logic Apps · 📊

↑ Back to Content Index

Once a new Microsoft Sentinel incident is created, this playbook gets triggered and performs the following actions: 1. Gets users from the incident. 2. Obtains information about user. 3. Enriches the incident with the obtained info.

Attribute Value
Type Playbook
Solution GoogleDirectory
Source View on GitHub

Logic App Connectors

This playbook uses 2 Logic App connectors / built-in actions:

Connector / Action Type Connections Actions
azuresentinel Managed 1 2
GoogleDirectory Custom 1 1
Action parameters (URLs, paths, function IDs)

azuresentinel (Managed)

Action Method Endpoint Other
Add_comment_to_incident_(V3) post /Incidents/Comment —
Entities_-_Get_Accounts post /entities/account —

GoogleDirectory (Custom)

Action Method Endpoint Other
Get_User get /admin/directory/v1/users/@{encodeURIComponent(outputs('get_user_email'))} —

Additional Documentation

📄 Source: Playbooks/Google-EnrichIncidentWithUserInfo/readme.md

Google-EnrichIncidentWithUserInfo

Summary

Once a new Microsoft Sentinel incident is created, this playbook gets triggered and performs the following actions:

  1. Gets users from the incident.
  2. Obtains information about user.
  3. Enriches the incident with the obtained info.


Prerequisites

  1. Google Directory Custom API Connector has to be deployed prior to the deployment of this playbook under the same subscription.
  2. Google Directory API credentials are required. Refer to the Google Directory Custom Connector documentation.

Deployment instructions

  1. To deploy the Playbook, click the Deploy to Azure button. This will launch the ARM Template deployment wizard.
  2. Fill in the required paramteres:
    • Playbook Name: Enter the playbook name here
    • Google Directory Connector Name: Logic App Connector Name

Deploy to Azure Deploy to Azure

Post-Deployment instructions

a. Authorize connections

Once deployment is complete, authorize each connection.

  1. Click the Azure Sentinel connection resource
  2. Click edit API connection
  3. Click Authorize
  4. Sign in
  5. Click Save
  6. Repeat steps for GoogleDirectory connector API Connection.

b. Configurations in Sentinel

  1. In Microsoft sentinel, analytical rules should be configured to trigger an incident that contains Accounts. In the Entity maping section of the analytics rule creation workflow, user email should be mapped to FullName identitfier of the Account entity type. Check the documentation to learn more about mapping entities.
  2. Configure the automation rules to trigger the playbook. Check the documentation to learn more about automation rules.

Browse: 🏠 · Solutions · Connectors · Methods · Tables · Content · Parsers · ASIM Parsers · ASIM Products · Logic Apps · 📊

↑ Back to Playbooks · Back to GoogleDirectory