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

IDPalo Alto Networks IoT 3rd Party
ProviderPalo Alto Networks
CategoryNetwork Security
From Version6.0.0
Docker Imagedemisto/python3:3.10.13.72123
Supported ModulesAgentix

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 ID
  • Access Key — Access Key
  • Key ID — Key ID
  • credentials — Key ID

Commands (4)

  • panw-iot-3rd-party-convert-assets-to-external-format

    Converts the passed asset (alert, device, or vulnerability) to a 3rd party data format.

  • panw-iot-3rd-party-get-asset-list

    Returns a list of assets for the specified asset type.

  • panw-iot-3rd-party-get-single-asset

    Returns details for the passed asset ID. Can be an alert-id, vulnerability-id, mac-address.

  • panw-iot-3rd-party-report-status-to-panw

    Sends 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)