Palo Alto Networks IoT 3rd Party Deprecated
Deprecated. Use the following link instead. To get the latest Palo Alto Networks IoT 3rd Party Integrations content pack, visit: https://docs.paloaltonetworks.com/iot/iot-security-integration/get-started-with-iot-security-integrations/third-party-integrations-using-a-full-featured-xsoar-server
Network Security · IoT 3rd Party Integrations by Palo Alto Networks (Deprecated)
Details
| ID | Palo Alto Networks IoT 3rd Party |
|---|---|
| Provider | Palo Alto Networks |
| Category | Network Security |
| From Version | 6.0.0 |
| Docker Image | demisto/python3:3.10.13.72123 |
| Supported Modules | Agentix |
README
Use the Palo Alto Networks IoT 3rd Party integration to get devices, alerts, and vulnerabilities from PANW IoT Cloud.
Configure Palo Alto Networks IoT 3rd Party in Cortex
| Parameter | Description | Required |
|---|---|---|
| URL | Palo Alto Networks IoT Security Portal URL (e.g. https://example.iot.paloaltonetworks.com) | True |
| Customer ID | Tenant ID | True |
| Key ID | Access Key ID | True |
| Access Key | Secret Access Key | True |
| isFetch | Fetch incidents | False |
Commands
You 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.
panw-iot-3rd-party-report-status-to-panw
PANW IoT 3rd Party Report Status to PANW command - Sends a status message back to PANW IOT cloud.
Base Command
panw-iot-3rd-party-report-status-to-panw
Input
| Argument Name | Description | Required |
|---|---|---|
| status | Message to be sent to PANW IoT Cloud | Required |
| message | Message to be sent to PANW IoT Cloud | Required |
| integration_name | Name of PANW IoT 3rd Party Integration | Required |
| playbook_name | Name of the playbook | Required |
| asset_type | Type of asset associated with the status report | Required |
Context Output
There is no context output for this command.
Command Example
!panw-iot-3rd-party-report-status-to-panw status=success message="successfully updated 100 devices" integration_name=ise playbook_name="Increment Export to Cisco ISE - PANW IoT 3rd Party Integration" asset_type=device
Human Readable Output
Reporting Status
| integration_name | ise |
| iot_cloud_response | received: yes |
| message | successfully updated 100 devices |
| playbook_name | Increment Export to Cisco ISE - PANW IoT 3rd Party Integration |
| status | success |
| timestamp | 1606106283993 |
| type | device |
panw-iot-3rd-party-get-single-asset
PANW IoT 3rd Party get single Asset - For a given a asset ID (alert-id, vulnerability-id or mac-address) returns the asset details.
Base Command
panw-iot-3rd-party-get-single-asset
Input
| Argument Name | Description | Required |
|---|---|---|
| asset_type | Type of Asset | Required |
| asset_id | Asset ID. MacAddress for device, zb_ticketid for alert and vulnerability | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| PanwIot3rdParty.SingleAsset | unknown | Asset Details |
Command Example
!panw-iot-3rd-party-get-single-asset asset_type="Device" asset_id="00:e0:4c:68:09:16"
Human Readable Output
Successfully pulled Device (00:e0:4c:68:09:16) from PANW IoT Cloud
panw-iot-3rd-party-get-asset-list
PANW IoT 3rd Party get asset list - Returns a list of assets for the specified asset type.
Base Command
panw-iot-3rd-party-get-asset-list
Input
| Argument Name | Description | Required |
|---|---|---|
| asset_type | Type of Asset | Required |
| increment_time | Increment time in minutes. Example: Increment Time = 15 mins will return input type assets modified or discovered within the last 15 minutes. A Null value will return full inventory (1000 MAX) | Optional |
| offset | Offset for paging: Null value will accumulate all results by default | Optional |
| page_length | Page size for paging: Null value will accumulate all results by default | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| PanwIot3rdParty.Devices | unknown | List of Devices |
| PanwIot3rdParty.Alerts | unknown | List of Alerts |
| PanwIot3rdParty.Vulnerabilities | unknown | List of Vulnerabilities |
Command Example
!panw-iot-3rd-party-get-asset-list asset_type="device" increment_time="2"
Human Readable Output
Asset import summary
| asset type | Device |
| assets pulled | 11 |
panw-iot-3rd-party-convert-assets-to-external-format
PANW IoT 3rd Party convert assets to external foramt - For a given asset (alert, device, vuln) converts it to 3rd party format.
Base Command
panw-iot-3rd-party-convert-assets-to-external-format
Input
| Argument Name | Description | Required |
|---|---|---|
| asset_type | Input asset type | Required |
| output_format | Desired output format | Required |
| asset_list | List of input assets | Required |
| servicenow_map | ServiceNow ID and deviceid mapping | Optional |
| incident | incident triggered by PANW IoT cloud API | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| PanwIot3rdParty.VulnerabilityCEFSyslogs | unknown | List of CEF formatted vulnerability syslogs for SIEM |
| PanwIot3rdParty.AlertCEFSyslogs | unknown | List of CEF formatted alert syslogs for SIEM |
| PanwIot3rdParty.DeviceCEFSyslogs | unknown | List of CEF formatted device syslogs for SIEM |
| PanwIot3rdParty.CiscoISEAttributes | unknown | List of Cisco ISE attribute dicts/maps |
| PanwIot3rdParty.AlertServiceNow | unknown | Single SN formatted alert string |
| PanwIot3rdParty.VulnerabilityServiceNow | unknown | Single SN formatted vulnerability string |
| PanwIot3rdParty.DeviceServiceNow | unknown | List of upsert ready formatted device for SN |
Command Example
!panw-iot-3rd-party-convert-assets-to-external-format asset_type=device output_format=siem asset_list=[a list of 221 device maps]
Human Readable Output
Converted 221 Device to SIEM
Configuration parameters
url— Server URL (required)Customer ID— Customer IDAccess Key— Access KeyKey ID— Key IDcredentials— Key ID
Commands (4)
-
panw-iot-3rd-party-convert-assets-to-external-formatConverts the passed asset (alert, device, or vulnerability) to a 3rd party data format.
-
panw-iot-3rd-party-get-asset-listReturns a list of assets for the specified asset type.
-
panw-iot-3rd-party-get-single-assetReturns details for the passed asset ID. Can be an alert-id, vulnerability-id, mac-address.
-
panw-iot-3rd-party-report-status-to-panwSends a status message to PANW IOT cloud.
category: Network Security provider: Palo Alto Networks commonfields: id: Palo Alto Networks IoT 3rd Party version: -1 deprecated: true configuration: - display: Server URL name: url required: true type: 0 - display: Customer ID name: Customer ID type: 0 required: false - display: Access Key name: Access Key type: 4 hidden: true required: false - display: Key ID hidden: true name: Key ID type: 4 required: false - display: Key ID displaypassword: Access Key name: credentials type: 9 required: false description: "Deprecated. Use the following link instead. To get the latest Palo Alto Networks IoT 3rd Party Integrations content pack, visit: https://docs.paloaltonetworks.com/iot/iot-security-integration/get-started-with-iot-security-integrations/third-party-integrations-using-a-full-featured-xsoar-server" display: Palo Alto Networks IoT 3rd Party (Deprecated) name: Palo Alto Networks IoT 3rd Party script: commands: - arguments: - auto: PREDEFINED description: Type of Asset. name: asset_type predefined: - device - alert - vulnerability required: true - description: 'Increment time (in minutes) for which to return input type assets that modified or discovered. For example, if Increment Time = 15 mins, will return input type assets modified or discovered within the last 15 minutes. A Null value will return the full inventory. The maximum input type assets per call is 1,000.' name: increment_time - description: 'Offset for paging. By default, a Null value will accumulate all results.' name: offset - description: 'Page size for paging. By default, a Null value will accumulate all results.' name: page_length description: Returns a list of assets for the specified asset type. name: panw-iot-3rd-party-get-asset-list outputs: - contextPath: PanwIot3rdParty.Devices description: List of devices. - contextPath: PanwIot3rdParty.Alerts description: List of Alerts. - contextPath: PanwIot3rdParty.Vulnerabilities description: List of Vulnerabilities. - arguments: - auto: PREDEFINED description: Type of asset. Can be "device", "alert", or "vulnerability". name: asset_type predefined: - device - alert - vulnerability required: true - description: Asset ID. MacAddress for device, zb_ticketid for alert and vulnerability. name: asset_id required: true description: Returns details for the passed asset ID. Can be an alert-id, vulnerability-id, mac-address. name: panw-iot-3rd-party-get-single-asset outputs: - contextPath: PanwIot3rdParty.SingleAsset description: Asset details. - arguments: - auto: PREDEFINED description: Message status to report to PANW IoT Cloud. Can be "error", "success", or "disabled". name: status predefined: - error - success - disabled required: true - description: The message to send to PANW IoT Cloud. name: message required: true - auto: PREDEFINED description: Name of PANW IoT 3rd Party integration. Can be "siem", "ise", or "sericenow". name: integration_name predefined: - siem - ise - servicenow required: true - description: Name of the playbook. name: playbook_name required: true - auto: PREDEFINED description: Type of asset associated with the status report. Can be "device", "alert", or "vulnerability". name: asset_type predefined: - device - alert - vulnerability required: true description: Sends a status message to PANW IOT cloud. name: panw-iot-3rd-party-report-status-to-panw - arguments: - auto: PREDEFINED description: Input asset type. Can be "device", "alert", or "vulnerability". name: asset_type predefined: - device - alert - vulnerability required: true - auto: PREDEFINED description: The output format to convert the asset to. Can be "CiscoISECustomAttributes", "SIEM", or "ServiceNow". name: output_format predefined: - CiscoISECustomAttributes - SIEM - ServiceNow required: true - description: A comma-separated list of input assets. isArray: true name: asset_list - description: ServiceNow ID and deviceid mapping. isArray: true name: servicenow_map - description: Incident triggered by PANW IoT cloud API. name: incident description: Converts the passed asset (alert, device, or vulnerability) to a 3rd party data format. name: panw-iot-3rd-party-convert-assets-to-external-format outputs: - contextPath: PanwIot3rdParty.VulnerabilityCEFSyslogs description: List of CEF formatted vulnerability syslogs for the SIEM. - contextPath: PanwIot3rdParty.AlertCEFSyslogs description: List of CEF formatted alert syslogs for the SIEM. - contextPath: PanwIot3rdParty.DeviceCEFSyslogs description: List CEF formatted device syslogs for the SIEM. - contextPath: PanwIot3rdParty.CiscoISEAttributes description: List of Cisco ISE attribute dicts/maps. - contextPath: PanwIot3rdParty.AlertServiceNow description: Single SN formatted alert string. - contextPath: PanwIot3rdParty.VulnerabilityServiceNow description: Single SN formatted vulnerability string. - contextPath: PanwIot3rdParty.DeviceServiceNow description: List of upsert ready formatted devices for SN. dockerimage: demisto/python3:3.10.13.72123 script: '' subtype: python3 type: python fromversion: 6.0.0 tests: - No tests (auto formatted)