IP Enrichment - External - Generic v2
This Playbook is part of the Common Playbooks Pack.#
Enriches IP addresses using one or more integrations.
- Resolve IP addresses to hostnames (DNS)
- Provide threat information
- Separate internal and external addresses
Dependencies#
This playbook uses the following sub-playbooks, integrations, and scripts.
Sub-playbooks#
This playbook does not use any sub-playbooks.
Integrations#
- VirusTotal - Private API
Scripts#
- IPToHost
- IsIPInRanges
Commands#
- threat-crowd-ip
- vt-private-get-ip-report
Playbook Inputs#
| Name | Description | Default Value | Source | Required |
|---|---|---|---|---|
| IP | The IP address to enrich. | Address | IP | Optional |
| InternalRange | A CSV list of IP address ranges (in CIDR notation). Use this list to check if an IP address is found within a set of IP address ranges. For example: "172.16.0.0/12,10.0.0.0/8,192.168.0.0/16" (without quotes). If a list is not provided, will use default list provided in the IsIPInRanges script (the known IPv4 private address ranges). | inputs.InternalRange | - | Optional |
| ResolveIP | Whether to convert the IP address to a hostname using a DNS query (True/False). | None | inputs.ResolveIP | Required |
Playbook Outputs#
| Path | Description | Type |
|---|---|---|
| IP | The IP address objects. | unknown |
| DBotScore | The Indicator, Score, Type, and Vendor. | unknown |
| Endpoint | The Endpoint's object. | unknown |
| Endpoint.Hostname | The hostname to enrich. | string |
| Endpoint.OS | The Endpoint operating system. | string |
| Endpoint.IP | A list of Endpoint IP addresses. | unknown |
| Endpoint.MAC | A list of Endpoint MAC addresses. | unknown |
| Endpoint.Domain | The Endpoint domain name. | string |
Playbook Image#
