RunZero
RunZero Pack.#
This Integration is part of theSupported versions
Supported Cortex XSOAR versions: 6.5.0 and later.
RunZero is a network discovery and asset inventory platform that uncovers every network in use and identifies every device connected โ without credentials. Scan your network and build your asset inventory in minutes. This integration was integrated and tested with version 3.3.0 of RunZero
#
Configure RunZero in CortexParameter | Description | Required |
---|---|---|
Server URL | True | |
API Key | The API Key to use for connection. | True |
Trust any certificate (not secure) | False | |
Use system proxy settings | False |
#
CommandsYou can execute these commands from the CLI, as part of an automation, or in a playbook. After you successfully execute a command, a DBot message appears in the War Room with the command details.
#
runzero-asset-searchGet assets.
#
Base Commandrunzero-asset-search
#
InputArgument Name | Description | Required |
---|---|---|
asset_ids | A comma-separated list of asset IDs. | Optional |
search | The query by which to search. For information on the syntax, see: https://www.runzero.com/docs/runzero-manual.pdf page 288. | Optional |
ips | A comma-separated list of IP addresses. | Optional |
hostnames | A comma-separated list of hostnames. | Optional |
display_attributes | Whether to include the attributes section in the returned result. Possible values are: True, False. | Optional |
display_services | Whether to include a services section in the returned result. Possible values are: True, False. | Optional |
limit | Limit the number of assets returned. Default is 50. | Optional |
#
Context OutputPath | Type | Description |
---|---|---|
RunZero.Asset.ID | UUID | Asset service ID. |
RunZero.Asset.Addresses | Array | Asset addresses. |
RunZero.Asset.Asset_Status | Boolean | Asset status. |
RunZero.Asset.Hostname | Array | Asset hostname. |
RunZero.Asset.OS | String | Operating system version. |
RunZero.Asset.Type | String | Asset type. |
RunZero.Asset.Hardware | String | Asset hardware. |
RunZero.Asset.Outlier | String | Asset outlier score. |
RunZero.Asset.MAC_Vendor | String | Asset vendor MAC address is allocated to. |
RunZero.Asset.MAC_Age | Integer | Asset date MAC address was allocated. |
RunZero.Asset.MAC | UUID | Asset MAC address. |
RunZero.Asset.OS_EOL | String | Asset operating system end-of-life date. |
RunZero.Asset.Sources | String | Asset data sources. |
RunZero.Asset.Comments | String | Comments attached to the asset. |
RunZero.Asset.Tags | Array | Tags attached to the asset. |
RunZero.Asset.Svcs | Integer | Number of total service count. |
RunZero.Asset.TCP | Integer | Asset TCP service count. |
RunZero.Asset.UDP | Integer | Asset UDP service count. |
RunZero.Asset.ICMP | Integer | Asset ICMP response. |
RunZero.Asset.ARP | Integer | Asset ARP response. |
RunZero.Asset.SW | Integer | Asset identified software. |
RunZero.Asset.Vulns | Integer | Asset identified vulnerability count. |
RunZero.Asset.RTT/ms | Integer | Asset round-trip time latency. |
RunZero.Asset.Hops | Integer | Asset estimated hop count from scanner. |
RunZero.Asset.Detected | String | Asset method of detection. |
RunZero.Asset.First_Seen | String | Datetime of when the asset was first seen. |
RunZero.Asset.Last_Seen | String | Datetime of when the asset was last seen. |
RunZero.Asset.Explorer | String | Name of the RunZero explorer which most recently found the asset. |
RunZero.Asset.Hosted_Zone | String | Asset hosted zone. |
RunZero.Asset.Site | String | Asset site name. |
#
Command example!runzero-asset-search
#
Context Example#
Human Readable Output#
Asset
ARP Addresses Asset_Status Comments Detected Explorer First_Seen Hardware Hops Hostname ICMP ID Last_Seen MAC MAC_Vendor OS OS_EOL Outlier RTT/ms SW Site Sources Svcs TCP Tags Type UDP Vulns 1 192.168.1.91,
fe80::250:56ff:fe89:b0e1true integration comment arp RHEL85.LOCALDOMAIN 2022-12-25T22:28:29.000Z VMware VM 0 RHEL85,
RHEL85.LOCALDOMAIN1 bf707048-7ce9-4249-a58c-0aaa257d69f0 2022-12-25T22:41:58.000Z 00:50:56:89:b0:e1 VMware, Inc. Red Hat Enterprise Linux 8.5 0 0 0.84 2 Primary runZero 11 3 ThisTag: Value
ThisTag-ThisTag2:
ThisTag2: Value
try: value
try3: value3Server 4 0
#
Command example!runzero-asset-search hostnames=RHEL85
#
Context Example#
Human Readable Output#
Asset
ARP Addresses Asset_Status Comments Detected Explorer First_Seen Hardware Hops Hostname ICMP ID Last_Seen MAC MAC_Vendor OS OS_EOL Outlier RTT/ms SW Site Sources Svcs TCP Tags Type UDP Vulns 1 192.168.1.91,
fe80::250:56ff:fe89:b0e1true integration comment arp RHEL85.LOCALDOMAIN 2022-12-25T22:28:29.000Z VMware VM 0 RHEL85,
RHEL85.LOCALDOMAIN1 bf707048-7ce9-4249-a58c-0aaa257d69f0 2022-12-25T22:41:58.000Z 00:50:56:89:b0:e1 VMware, Inc. Red Hat Enterprise Linux 8.5 0 0 0.84 2 Primary runZero 11 3 ThisTag: Value
ThisTag-ThisTag2:
ThisTag2: Value
try: value
try3: value3Server 4 0
#
Command example!runzero-asset-search ips=192.168.1.91,192.168.1.1
#
Context Example#
Human Readable Output#
Asset
ARP Addresses Asset_Status Comments Detected Explorer First_Seen Hardware Hops Hostname ICMP ID Last_Seen MAC MAC_Vendor OS OS_EOL Outlier RTT/ms SW Site Sources Svcs TCP Tags Type UDP Vulns 1 192.168.1.91,
fe80::250:56ff:fe89:b0e1true integration comment arp RHEL85.LOCALDOMAIN 2022-12-25T22:28:29.000Z VMware VM 0 RHEL85,
RHEL85.LOCALDOMAIN1 bf707048-7ce9-4249-a58c-0aaa257d69f0 2022-12-25T22:41:58.000Z 00:50:56:89:b0:e1 VMware, Inc. Red Hat Enterprise Linux 8.5 0 0 0.84 2 Primary runZero 11 3 ThisTag: Value
ThisTag-ThisTag2:
ThisTag2: Value
try: value
try3: value3Server 4 0
#
Command example!runzero-asset-search search=os:Windows
#
Human Readable Output#
AssetNo entries.
#
runzero-asset-deleteBulk delete assets.
#
Base Commandrunzero-asset-delete
#
InputArgument Name | Description | Required |
---|---|---|
asset_ids | A comma-separated list of UUIDs of the asset to delete. | Required |
#
Context OutputThere is no context output for this command.
#
runzero-service-searchGet services.
#
Base Commandrunzero-service-search
#
InputArgument Name | Description | Required |
---|---|---|
service_id | UUID of the service to retrieve. | Optional |
search | The query by which to search. For information on the syntax, see: https://www.runzero.com/docs/runzero-manual.pdf page 288. | Optional |
service_addresses | A comma-separated list of services by addresses. | Optional |
display_attributes | Whether to include an attributes section in the returned result. Possible values are: True, False. | Optional |
limit | Limit the number of assets returned. Default is 50. | Optional |
#
Context OutputPath | Type | Description |
---|---|---|
RunZero.Service.ID | UUID | Service ID. |
RunZero.Service.Address | String | Service addresses. |
RunZero.Service.Asset_Status | Boolean | Service asset status. |
RunZero.Service.Hostname | Array | Service hostname. |
RunZero.Service.Transport | String | Service transport. |
RunZero.Service.Port | Integer | Service port. |
RunZero.Service.Protocol | Array | Service protocol. |
RunZero.Service.VHost | Array | Service virtual host. |
RunZero.Service.Summary | Array | Service summary. |
RunZero.Service.Hostname | Array | Service hostname. |
RunZero.Service.OS | String | Service operating system version. |
RunZero.Service.Type | String | Service type. |
RunZero.Service.Hardware | String | Service hardware. |
RunZero.Service.Outlier | String | Service outlier score. |
RunZero.Service.MAC_Vendor | String | Service vendor MAC address is allocated to. |
RunZero.Service.MAC_Age | Integer | Service date MAC address was allocated. |
RunZero.Service.MAC | UUID | Service MAC address. |
RunZero.Service.OS_EOL | String | Service operating system end-of-life. |
RunZero.Service.Comments | String | Comments attached to the service. |
RunZero.Service.Tags | Array | Tags attached to the service. |
RunZero.Service.Svcs | Integer | Total service count. |
RunZero.Service.TCP | Integer | TCP service count. |
RunZero.Service.UDP | Integer | UDP service count. |
RunZero.Service.ICMP | Integer | ICMP response. |
RunZero.Service.ARP | Integer | ARP response. |
RunZero.Service.SW | Integer | Identified software. |
RunZero.Service.Vulns | Integer | Identified vulnerabilities. |
RunZero.Service.RTT/ms | Integer | Service round-trip time latency. |
RunZero.Service.Hops | Integer | Estimated hop count from scanner. |
RunZero.Service.Detected | String | Method of detection. |
RunZero.Service.First_Seen | String | Datetime of when the service was first seen. |
RunZero.Service.Last_Seen | String | Datetime of when the service was last seen. |
RunZero.Service.Explorer | String | Name of the RunZero explorer which most recently found the asset. |
RunZero.Service.Hosted_Zone | String | Service hosted zone. |
RunZero.Service.Site | String | Service site name. |
#
Command example!runzero-service-search
#
Context Example#
Human Readable Output#
Service
ARP Address Asset_Status Comments Detected Explorer First_Seen Hardware Hops Hostname ICMP ID Last_Seen MAC MAC_Vendor OS OS_EOL Outlier Port Protocol RTT/ms SW Site Summary Svcs TCP Tags Transport Type UDP Vulns 1 fe80::250:56ff:fe89:b0e1 true integration comment arp RHEL85.LOCALDOMAIN 2022-12-25T22:28:29.000Z VMware VM 0 RHEL85,
RHEL85.LOCALDOMAIN1 04d60ddf-8d28-494c-8186-8cd514e5b9cb 2022-12-25T22:41:58.000Z 00:50:56:89:b0:e1 VMware, Inc. Red Hat Enterprise Linux 8.5 0 0 111 rpcbind,
sunrpc0.84 2 Primary 11 3 ThisTag: Value
ThisTag-ThisTag2:
ThisTag2: Value
try: value
try3: value3udp Server 4 0 1 fe80::250:56ff:fe89:b0e1 true integration comment arp RHEL85.LOCALDOMAIN 2022-12-25T22:28:29.000Z VMware VM 0 RHEL85,
RHEL85.LOCALDOMAIN1 10f9e421-d80a-47d6-9643-d3e0c423a0f7 2022-12-25T22:41:58.000Z 00:50:56:89:b0:e1 VMware, Inc. Red Hat Enterprise Linux 8.5 0 0 0 0.84 2 Primary 11 3 ThisTag: Value
ThisTag-ThisTag2:
ThisTag2: Value
try: value
try3: value3icmp Server 4 0 1 192.168.1.91 true integration comment arp RHEL85.LOCALDOMAIN 2022-12-25T22:28:29.000Z VMware VM 0 RHEL85,
RHEL85.LOCALDOMAIN1 4cdaab83-a513-42e1-8ff1-ba1d70c64cc3 2022-12-25T22:41:58.000Z 00:50:56:89:b0:e1 VMware, Inc. Red Hat Enterprise Linux 8.5 0 0 22 ssh 0.84 2 Primary SSH-2.0-OpenSSH_8.0 11 3 ThisTag: Value
ThisTag-ThisTag2:
ThisTag2: Value
try: value
try3: value3tcp Server 4 0 1 192.168.1.91 true integration comment arp RHEL85.LOCALDOMAIN 2022-12-25T22:28:29.000Z VMware VM 0 RHEL85,
RHEL85.LOCALDOMAIN1 89308b21-7c53-4a06-8e65-616f2dea019e 2022-12-25T22:41:58.000Z 00:50:56:89:b0:e1 VMware, Inc. Red Hat Enterprise Linux 8.5 0 0 5353 mdns 0.84 2 Primary 11 3 ThisTag: Value
ThisTag-ThisTag2:
ThisTag2: Value
try: value
try3: value3udp Server 4 0 1 192.168.1.91 true integration comment arp RHEL85.LOCALDOMAIN 2022-12-25T22:28:29.000Z VMware VM 0 RHEL85,
RHEL85.LOCALDOMAIN1 9b65b530-1540-47fb-9638-1f49081b2a09 2022-12-25T22:41:58.000Z 00:50:56:89:b0:e1 VMware, Inc. Red Hat Enterprise Linux 8.5 0 0 111 rpcbind,
sunrpc0.84 2 Primary 11 3 ThisTag: Value
ThisTag-ThisTag2:
ThisTag2: Value
try: value
try3: value3udp Server 4 0 1 fe80::250:56ff:fe89:b0e1 true integration comment arp RHEL85.LOCALDOMAIN 2022-12-25T22:28:29.000Z VMware VM 0 RHEL85,
RHEL85.LOCALDOMAIN1 a0dafbdd-e56d-4d01-be51-99dbbaaa8322 2022-12-25T22:41:58.000Z 00:50:56:89:b0:e1 VMware, Inc. Red Hat Enterprise Linux 8.5 0 0 0 0.84 2 Primary 11 3 ThisTag: Value
ThisTag-ThisTag2:
ThisTag2: Value
try: value
try3: value3arp Server 4 0 1 192.168.1.91 true integration comment arp RHEL85.LOCALDOMAIN 2022-12-25T22:28:29.000Z VMware VM 0 RHEL85,
RHEL85.LOCALDOMAIN1 b3760c57-934f-4e45-ad9b-3aef27a9825a 2022-12-25T22:41:58.000Z 00:50:56:89:b0:e1 VMware, Inc. Red Hat Enterprise Linux 8.5 0 0 0 0.84 2 Primary 11 3 ThisTag: Value
ThisTag-ThisTag2:
ThisTag2: Value
try: value
try3: value3icmp Server 4 0 1 fe80::250:56ff:fe89:b0e1 true integration comment arp RHEL85.LOCALDOMAIN 2022-12-25T22:28:29.000Z VMware VM 0 RHEL85,
RHEL85.LOCALDOMAIN1 c807c93b-3b63-4937-89f5-c3d89eb36003 2022-12-25T22:41:58.000Z 00:50:56:89:b0:e1 VMware, Inc. Red Hat Enterprise Linux 8.5 0 0 5353 mdns 0.84 2 Primary 11 3 ThisTag: Value
ThisTag-ThisTag2:
ThisTag2: Value
try: value
try3: value3udp Server 4 0 1 192.168.1.91 true integration comment arp RHEL85.LOCALDOMAIN 2022-12-25T22:28:29.000Z VMware VM 0 RHEL85,
RHEL85.LOCALDOMAIN1 d2972ca1-4bbc-45b5-a5fb-a4019d9c3f0b 2022-12-25T22:41:58.000Z 00:50:56:89:b0:e1 VMware, Inc. Red Hat Enterprise Linux 8.5 0 0 0 0.84 2 Primary 11 3 ThisTag: Value
ThisTag-ThisTag2:
ThisTag2: Value
try: value
try3: value3arp Server 4 0 1 192.168.1.91 true integration comment arp RHEL85.LOCALDOMAIN 2022-12-25T22:28:29.000Z VMware VM 0 RHEL85,
RHEL85.LOCALDOMAIN1 e9e37c0a-a952-40b2-880d-077df0434794 2022-12-25T22:41:58.000Z 00:50:56:89:b0:e1 VMware, Inc. Red Hat Enterprise Linux 8.5 0 0 9090 http,
tls0.84 2 Primary HTTP/1.1 301 Moved Permanently
Content-Type: text/html
Location: https://192.168.1.91:9090/
Content-Length: 73
X-DNS-Prefetch-Control: off
Referrer-Policy: no-referrer
X-Content-Type-Options: nosniff
Cross-Origin-Resource-Policy: same-originMoved Please use TLS11 3 ThisTag: Value
ThisTag-ThisTag2:
ThisTag2: Value
try: value
try3: value3tcp Server 4 0 1 192.168.1.91 true integration comment arp RHEL85.LOCALDOMAIN 2022-12-25T22:28:29.000Z VMware VM 0 RHEL85,
RHEL85.LOCALDOMAIN1 f9917aca-cc6b-4c49-96fa-4cd00e748719 2022-12-25T22:41:58.000Z 00:50:56:89:b0:e1 VMware, Inc. Red Hat Enterprise Linux 8.5 0 0 111 sunrpc 0.84 2 Primary 11 3 ThisTag: Value
ThisTag-ThisTag2:
ThisTag2: Value
try: value
try3: value3tcp Server 4 0
#
Command example!runzero-service-search service_addresses=192.168.1.2,192.168.1.91 limit=3 display_attributes=True
#
Context Example#
Human Readable Output#
Service
ARP Address Asset_Status Comments Detected Explorer First_Seen Hardware Hops Hostname ICMP ID Last_Seen MAC MAC_Vendor OS OS_EOL Outlier Port Protocol RTT/ms SW Site Summary Svcs TCP Tags Transport Type UDP Vulns 1 192.168.1.91 true integration comment arp RHEL85.LOCALDOMAIN 2022-12-25T22:28:29.000Z VMware VM 0 RHEL85,
RHEL85.LOCALDOMAIN1 4cdaab83-a513-42e1-8ff1-ba1d70c64cc3 2022-12-25T22:41:58.000Z 00:50:56:89:b0:e1 VMware, Inc. Red Hat Enterprise Linux 8.5 0 0 22 ssh 0.84 2 Primary SSH-2.0-OpenSSH_8.0 11 3 ThisTag: Value
ThisTag-ThisTag2:
ThisTag2: Value
try: value
try3: value3tcp Server 4 0 1 192.168.1.91 true integration comment arp RHEL85.LOCALDOMAIN 2022-12-25T22:28:29.000Z VMware VM 0 RHEL85,
RHEL85.LOCALDOMAIN1 89308b21-7c53-4a06-8e65-616f2dea019e 2022-12-25T22:41:58.000Z 00:50:56:89:b0:e1 VMware, Inc. Red Hat Enterprise Linux 8.5 0 0 5353 mdns 0.84 2 Primary 11 3 ThisTag: Value
ThisTag-ThisTag2:
ThisTag2: Value
try: value
try3: value3udp Server 4 0 1 192.168.1.91 true integration comment arp RHEL85.LOCALDOMAIN 2022-12-25T22:28:29.000Z VMware VM 0 RHEL85,
RHEL85.LOCALDOMAIN1 9b65b530-1540-47fb-9638-1f49081b2a09 2022-12-25T22:41:58.000Z 00:50:56:89:b0:e1 VMware, Inc. Red Hat Enterprise Linux 8.5 0 0 111 rpcbind,
sunrpc0.84 2 Primary 11 3 ThisTag: Value
ThisTag-ThisTag2:
ThisTag2: Value
try: value
try3: value3udp Server 4 0
#
Command example!runzero-service-search search=os:Windows
#
Human Readable Output#
ServiceNo entries.
#
runzero-service-deleteDelete a service.
#
Base Commandrunzero-service-delete
#
InputArgument Name | Description | Required |
---|---|---|
service_id | UUID of the service to delete. | Required |
#
Context OutputThere is no context output for this command.
#
runzero-comment-addAdd a comment or override an existing asset comment.
#
Base Commandrunzero-comment-add
#
InputArgument Name | Description | Required |
---|---|---|
asset_id | Asset ID. | Required |
comment | Comment to add. | Required |
#
Context OutputThere is no context output for this command.
#
runzero-tag-addAdd tag or tags to the asset.
#
Base Commandrunzero-tag-add
#
InputArgument Name | Description | Required |
---|---|---|
asset_id | Asset ID. | Required |
tags | Tags to add to the asset. | Required |
#
Context OutputThere is no context output for this command.
#
runzero-quota-getGet information about the API key used. Type, Limit, usage etc.
#
Base Commandrunzero-quota-get
#
InputThere are no input arguments for this command.
#
Context OutputPath | Type | Description |
---|---|---|
RunZero.Quota.id | UUID | API key ID. |
RunZero.Quota.client_id | UUID | Client ID. |
RunZero.Quota.organization_id | UUID | Organization ID. |
RunZero.Quota.created_at | Integer | Time the API was created. |
RunZero.Quota.comment | String | API key comment. |
RunZero.Quota.last_used_at | Integer | The time when the API key was last seen. |
RunZero.Quota.last_used_ip | String | The IP address last used by the API key. |
RunZero.Quota.last_used_ua | String | The user agent last used by the API key. |
RunZero.Quota.counter | Integer | The API key usage counter. |
RunZero.Quota.usage_today | Integer | The API key usage today. |
RunZero.Quota.usage_limit | Integer | The API key usage limit. |
RunZero.Quota.token | String | The API key. |
RunZero.Quota.inactive | String | Whether the API key is inactive. |
RunZero.Quota.type | String | API key type (org, etc.). |
#
Command example!runzero-quota-get
#
Context Example#
Human Readable Output#
Quota
counter usage_limit usage_today 454 1672325319 25
#
runzero-tag-deleteDelete tags for specific asset.
#
Base Commandrunzero-tag-delete
#
InputArgument Name | Description | Required |
---|---|---|
asset_id | Asset ID from which to remove specified tags. | Required |
tags | A comma separated list of tags to delete. | Required |
#
Context OutputThere is no context output for this command.
#
runzero-wireless-lan-searchGet all wireless LANs.
#
Base Commandrunzero-wireless-lan-search
#
InputArgument Name | Description | Required |
---|---|---|
wireless_id | The wireless LAN ID. | Optional |
search | The query by which to search. For information on the syntax, see: https://www.runzero.com/docs/runzero-manual.pdf page 288. | Optional |
limit | Limit the number of wireless LAN returned. Default is 50. | Optional |
#
Context OutputPath | Type | Description |
---|---|---|
RunZero.WirelessLAN.ID | UUID | Wireless LAN ID. |
RunZero.WirelessLAN.ESSID | String | Wireless LAN extended service set identifier (ESSID). |
RunZero.WirelessLAN.BSSID | String | Wireless LAN basic service set identifier (BSSID). |
RunZero.WirelessLAN.Vendor | String | Wireless LAN vendor. |
RunZero.WirelessLAN.Family | String | Wireless LAN family. |
RunZero.WirelessLAN.Type | String | Wireless LAN type. |
RunZero.WirelessLAN.Auth | String | Wireless LAN auth. |
RunZero.WirelessLAN.Enc | String | Wireless LAN encryption. |
RunZero.WirelessLAN.Sig | Integer | WirelessLAN signal strength. |
RunZero.WirelessLAN.Int | String | Wireless LAN interface. |
RunZero.WirelessLAN.Additional | Array | Wireless LAN additional information. |
RunZero.WirelessLAN.First_seen | String | Datetime of when the wireless LAN was first seen. |
RunZero.WirelessLAN.Last_seen | String | Datetime of when the wireless LAN was last seen. |
RunZero.WirelessLAN.Site | String | Wireless LAN site name. |
#
runzero-wireless-lan-deleteRemove a wireless LAN.
#
Base Commandrunzero-wireless-lan-delete
#
InputArgument Name | Description | Required |
---|---|---|
wireless_id | UUID of the wireless LAN to remove. | Required |
#
Context OutputThere is no context output for this command.