Handle Expanse Incident

Supported versions

Supported Cortex XSOAR versions: 6.0.0 and later.

Main Playbook to Handle Expanse Incidents.

There are several phases:

  1. Enrichment: all the related information from the incident is extracted and related Indicators (types IP, CIDR, Domain, DomainGlob, Certificate) are created and enriched.
  2. Validation: the found IP and FQDN are correlated with the information available in other products:
  • Risky or non-compliant communications to and from the IP with external IPs as flagged in Expanse's Behavior
  • Firewall logs from Cortex Data Lake, Panorama and Splunk
  • User information from Active Directory
  • Public IP address from AWS/GCP/Azure public IP feeds to identify the Public Cloud region and Service (i.e. us-west-1 on AWS EC2)
  • IP and FQDN from Prisma Cloud inventory
  1. Shadow IT check: based on the information found, the playbook can suggest whether the discovered issue corresponds to an asset that is known to the InfoSec team (i.e. there are firewall logs present, or the asset is protected by Prisma Cloud, or is part of an IP range associated to the Company).
  2. Attribution: based on the information collected above, the Analyst is prompted to assign this issue to an Organization Unit, that is a group within the Company with a specific owner. The Analyst can choose from existing Organization Units (stored in an XSOAR list) or define a new one.
  3. Response: depending on the issue type, several remediation actions can be automatically and manually performed, such as:
    • Tagging the asset in Expanse with a specific Organization Unit tag
    • Blocking the service on PAN-OS (if a Firewall is deployed in front of the service)
    • Creating a new Shadow IT issue (if the asset is detected to be Shadow IT and the Analyst confirms it)
    • Adding the service to a Vulnerability Management system
    • Linking the incident to a related Prisma Cloud alert for the asset (if the asset is found under Prisma Cloud inventory)


This playbook uses the following sub-playbooks, integrations, and scripts.


  • PAN-OS - Block Destination Service on Panorama
  • Expanse Enrich Cloud Assets
  • Extract and Enrich Expanse Indicators
  • Prisma Cloud Correlate Alerts
  • PAN-OS - Block Destination Service on Firewall
  • Expanse Load-Create List
  • Expanse Attribution


  • ExpanseV2


  • CopyNotesToIncident
  • ExpansePrintSuggestions
  • ExpanseRefreshIssueAssets
  • AddKeyToList
  • Set
  • SetAndHandleEmpty
  • ToTable


  • expanse-assign-tags-to-asset
  • expanse-get-issue-comments
  • expanse-get-risky-flows
  • expanse-update-issue
  • closeInvestigation
  • setIncident
  • panorama-show-device-version
  • linkIncidents
  • createNewIncident
  • getList
  • send-mail
  • expanse-create-tag

Playbook Inputs#

NameDescriptionDefault ValueRequired
MinPriorityForAutoRemediationMinimum Incident Priority for Auto Remediation:
1 - Low
2 - Medium
3 - High
4 - Critical
5 - Disable AutoRemediation
FirewallTagListNameName of XSOAR List that contains the mapping between Expanse tags and XSOAR PANOS Instances.ExpanseTagsToPANOSDeviceGroupOptional
TagPrefixPrefix for XSOAR related Expanse tagsxsoar-Optional
LogForwardingPAN-OS Log Forwarding Profile NameOptional
AutoCommitPanorama Auto Commit:
True - enable AutoCommit
False - disable AutoCommit
IPRangeLowConfidenceTagListComma separated list of tags to be used to identify IP ranges attributed with low confidencelow confidenceOptional
InvalidTagTag to be used for Expanse assets that do not belong to org (set when the Analyst selects Invalid in the OU data collection)xsoar-invalidOptional
WriteToExpanseWrite data back to Expanse?TrueOptional
OwnerNotificationSubjectSubject of the email to send to the OU Owner.New security issue on a public service owned by your teamOptional
OwnerNotificationBodyBody of the email to send to the OU Owner.Infosec identified a security issue on a service owned by your team and exposed on Internet. Please get in touch with your Infosec team to define proper remediation access.Optional
UseBehaviorEnrich flows using Expanse Behavior.TrueOptional
ShadowITIncidentTypeIf set, specifies the type of Incident that gets automatically created during the Shadow IT flow. If not set, the Incident is to be created manually.Shadow ITOptional
OrganizationUnitsToOwnerNameName of XSOAR List that contains the mapping between OU and OwnersExpanseOrganizationUnitsToOwnerOptional
OrganizationUnitsToTagNameName of XSOAR List that contains the mapping between OU and Tag namesExpanseOrganizationUnitsToTagOptional
NumberOfDaysInThePastHow many days to go back in time when searching logs7Optional

Playbook Outputs#

There are no outputs for this playbook.

Playbook Image#

Handle Expanse Incident