EnrichIP-GeoInfo-Neustar

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

↑ Back to Content Index

When a new sentinel incident is created, this playbook gets triggered and performs the following actions: 1. Gets IP Addresses from incident. 2. Gets Geographical location information from Neustart IP GeoPoint API. 3. Summarize the details and add as a comment to the incident.

Attribute Value
Type Playbook
Solution Neustar IP GeoPoint
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
function Built-in 0 1
Action parameters (URLs, paths, function IDs)

azuresentinel (Managed)

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

function (Built-in)

Action Method Endpoint Other
GetIPGeoInfo GET — functionId=[concat(variables('NeustarIPGeoPointFuntionAppId'), '/functions/GetIPGeoInfo')]

Additional Documentation

📄 Source: Neustar-GetIPGeoInfo/readme.md

Neustar-GetIPGeoInfo

Summary

When a new sentinel incident is created, this playbook gets triggered and performs the following actions:

  1. Gets IP Addresses from incident.
  2. Gets Geographical location information from Neustart IP GeoPoint API
  3. Summarize the details and add as a comment to the incident.



Prerequisites

  1. Prior to the deployment of this playbook, Neustar IP GeoPoint API Function App Connector needs to be deployed under the same subscription.
  2. Refer to Neustar IP GeoPoint API Function App Connector documentation to obtain Neustar IP GeoPoint API Key and Shared Secret.

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 parameters:
    • Playbook Name

Deploy to Azure Deploy to Azure

Post-Deployment instructions

a. Authorize connections

Once deployment is complete, 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 other connections

b. Configurations in Sentinel

  1. In Microsoft sentinel, analytical rules should be configured to trigger an incident that contains IP Addresses. In the Entity maping section of the analytics rule creation workflow, IP Address should be mapped to Address identitfier of the IP 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.

c. Function App Settings Update Instrunction

Refer to Neustar IP GeoPoint API Function App Connector documentation for Function App Application Settings (API Url, Key and Secret) update instruction.

References

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

↑ Back to Playbooks · Back to Neustar IP GeoPoint