Entity (IP, URL, FileHash, Account, Host) Enrichment - OpenCTI

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

↑ Back to Content Index

This playbook search in OpenCTI for indicatoes based on the entities (Account, Host, IP, FileHash, URL) present in Microsoft Sentinel incident. If it presnts in OpenCTI, information will be added to incident comment.

Attribute Value
Type Playbook
Solution OpenCTI
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 6
OpenCTICustomConnector Custom 1 6
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 —
Entities_-_Get_FileHashes post /entities/filehash —
Entities_-_Get_Hosts post /entities/host —
Entities_-_Get_IPs post /entities/ip —
Entities_-_Get_URLs post /entities/url —

OpenCTICustomConnector (Custom)

Action Method Endpoint Other
Run_GraphQL_Query_to_get_indicator_info_-_Accounts post /graphql —
Run_GraphQL_Query_to_get_indicator_info_-_FileHash post /graphql —
Run_GraphQL_Query_to_get_indicator_info_-_Host post /graphql —
Run_GraphQL_Query_to_get_indicator_info_-_IP post /graphql —
Run_GraphQL_Query_to_get_indicator_info_-_URLs post /graphql —
Run_Sample_GraphQL_Query_to_check_Auth_ post /graphql —

Additional Documentation

📄 Source: OpenCTIPlaybooks/OpenCTI-EnrichIncident/readme.md

OpenCTI-Enrich Incident With OpenCTI Indicators Info Playbook

Summary

When a new Microsoft Sentinel incident is created, this playbook gets triggered and performs below actions

  1. For each Entity (Accounts, Host, IP Address, FileHash, URL) available in Sentinel incident, it searches for a match in in OpenCTI indicators list
  2. If it finds the match, this playbook adds a rich comment to the incident with all the collected information Comment example

Playbook Designer view

Prerequisites

  1. OpenCTI Custom Connector needs to be deployed prior to the deployment of this playbook under the same subscription.
  2. API key. To get API Key, login into your OpenCTI instance dashboard and navigate to User profile page --> API Access.

Deployment instructions

  1. Deploy the playbook by clicking on "Deploy to Azure" button. This will take you to deplyoing an ARM Template wizard. Deploy to Azure Deploy to Azure Gov

  2. Fill in the required paramteres:

    • Playbook Name: Enter the playbook name here (Ex: OpenCTI-GetIndicatorInfo)
    • Custom Connector Name: Enter the OpenCTI custom connector name here (Ex: OpenCTICustomConnector)

Post-Deployment instructions

a. Authorize connections

Once deployment is complete, you will need to authorize each connection.

  1. Click the Microsoft Sentinel connection resource
  2. Click edit API connection
  3. Click Authorize
  4. Sign in
  5. Click Save
  6. Repeat steps for OpenCTI Api Connection (For authorizing the OpenCTI API connection, API Key needs to be provided)

b. Configurations in Sentinel

  1. In Microsoft sentinel analytical rules should be configured to trigger an incident with risky user account or host or URL or FileHash or IP Address.
  2. Configure the automation rules to trigger this playbook

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

↑ Back to Playbooks · Back to OpenCTI