Palo Alto Networks - Strata Cloud Manager

This Integration is part of the Palo Alto Networks - Strata Cloud Manager Pack.#

Supported versions

Supported Cortex XSOAR versions: 6.5.0 and later.

Provides commands for interaction with Prisma SASE API. This integration was integrated and tested with version v1 of Palo Alto Networks - Prisma SASE

Configure Palo Alto Networks - Strata Cloud Manager in Cortex#

Parameter	Description	Required
Server URL		True
API Client ID		True
API Client Secret		True
Tenant Services Group ID	Default Tenant Services Group ID to use for API calls. Example: 1234567890.	True
Trust any certificate (not secure)		False
Use system proxy settings		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.

prisma-sase-security-rule-create#

Create a new security rule.

Base Command#

prisma-sase-security-rule-create

Input#

Argument Name	Description	Required
folder	The configuration folder group setting. Possible values are: Shared, Mobile Users, Remote Networks, Service Connections, Mobile Users Container, Mobile Users Explicit Proxy. Default is Shared.	Optional
position	Rule position. Possible values are: pre, post. Default is pre.	Optional
name	The name of the security rule.	Required
action	Rule action. Possible values are: deny, allow, drop, reset-client, reset-server, reset-both.	Required
description	The security rule's description.	Optional
log_setting	Rule log setting.	Optional
application	A comma-separated list of applications. Default is any.	Optional
category	A comma-separated list of categories. You can get category values by running the prisma-sase-custom-url-category-list command. Default is any.	Optional
destination	A comma-separated list of destination networks. Default is any.	Optional
destination_hip	A comma-separated list of destination HIPs.	Optional
profile_setting	Security profiles to apply to the traffic.	Optional
service	Services the rule applies to. Default is any.	Optional
source	A comma-separated list of source networks. Default is any.	Optional
source_hip	A comma-separated list of source HIPs.	Optional
source_user	A semi-colon (;) separated list of source users or groups. Default is any.	Optional
tag	A comma-separated list of rule tags.	Optional
from	A comma-separated list of source zones. Default is any.	Optional
to	A comma-separated list of destination zones. Default is any.	Optional
disabled	Whether the rule is disabled.	Optional
negate_source	Negate the source.	Optional
negate_destination	Negate the destination.	Optional
tsg_id	Tenant services group ID. If not provided, the tsg_id integration parameter will be used as the default.	Optional

Context Output#

Path	Type	Description
PrismaSase.SecurityRule	String	Created security rule.
PrismaSase.SecurityRule.action	String	Security rule action.
PrismaSase.SecurityRule.application	String	Security rule application.
PrismaSase.SecurityRule.category	String	Security rule category.
PrismaSase.SecurityRule.description	String	Security rule description.
PrismaSase.SecurityRule.destination	String	Security rule destination.
PrismaSase.SecurityRule.folder	String	Security rule folder.
PrismaSase.SecurityRule.from	String	Security rule from field (source zone(s)).
PrismaSase.SecurityRule.id	String	Security rule ID.
PrismaSase.SecurityRule.name	String	Security rule name.
PrismaSase.SecurityRule.position	String	Security rule position.
PrismaSase.SecurityRule.profile_setting.group	String	Security rule group.
PrismaSase.SecurityRule.service	String	Security rule service.
PrismaSase.SecurityRule.source	String	Security rule source.
PrismaSase.SecurityRule.source_user	String	Security rule source user.
PrismaSase.SecurityRule.to	String	Security rule to field (destination zone(s)).

Command example#

!prisma-sase-security-rule-create name="somename11" action="allow"

Context Example#

{
    "PrismaSase": {
        "SecurityRule": {
            "action": "allow",
            "application": [
                "any"
            ],
            "category": [
                "any"
            ],
            "destination": [
                "any"
            ],
            "folder": "Shared",
            "from": [
                "any"
            ],
            "id": "Id",
            "name": "somename11",
            "position": "pre",
            "service": [
                "any"
            ],
            "source": [
                "any"
            ],
            "source_user": [
                "any"
            ],
            "to": [
                "any"
            ]
        }
    }
}

Human Readable Output#

Security Rule Created#
Action Application Category Destination Folder From Id Name Position Service Source Source User To
allow any any any Shared any Id somename11 pre any any any any

Action	Application	Category	Destination	Folder	From	Id	Name	Position	Service	Source	Source User	To
allow	any	any	any	Shared	any	Id	somename11	pre	any	any	any	any

prisma-sase-security-rule-list#

Lists all security rules.

Base Command#

prisma-sase-security-rule-list

Input#

Argument Name	Description	Required
folder	The configuration folder group setting. Possible values are: Shared, Mobile Users, Remote Networks, Service Connections, Mobile Users Container, Mobile Users Explicit Proxy. Default is Shared.	Optional
position	Security rule position. Possible values are: pre, post. Default is pre.	Optional
limit	The maximum number of results to return. Default is 50.	Optional
page	Page number you would like to view. Each page contains page_size values. Must be used along with page_size.	Optional
page_size	Number of results per page to display.	Optional
rule_id	A specific security rule to return. If not specified, all security rules will be returned.	Optional
tsg_id	Tenant services group ID. If not provided, the tsg_id integration parameter will be used as the default.	Optional

Context Output#

Path	Type	Description
PrismaSase.SecurityRule	String	Found security rule.
PrismaSase.SecurityRule.action	String	Security rule action.
PrismaSase.SecurityRule.application	String	Security rule application.
PrismaSase.SecurityRule.category	String	Security rule category.
PrismaSase.SecurityRule.description	String	Security rule description.
PrismaSase.SecurityRule.destination	String	Security rule destination.
PrismaSase.SecurityRule.folder	String	Security rule folder.
PrismaSase.SecurityRule.from	String	Security rule from field (source zone(s)).
PrismaSase.SecurityRule.id	String	Security rule ID.
PrismaSase.SecurityRule.log_setting	String	Security rule log setting.
PrismaSase.SecurityRule.name	String	Security rule name.
PrismaSase.SecurityRule.position	String	Security rule position.
PrismaSase.SecurityRule.service	String	Security rule service.
PrismaSase.SecurityRule.source	String	Security rule source.
PrismaSase.SecurityRule.source_user	String	Security rule source user.
PrismaSase.SecurityRule.tag	String	Security rule tag.
PrismaSase.SecurityRule.to	String	Security rule to field (destination zone(s)).
PrismaSase.SecurityRule.negate_destination	Boolean	Security rule negate destination.

Command example#

!prisma-sase-security-rule-list limit=1

Context Example#

{
    "PrismaSase": {
        "SecurityRule": {
            "action": "drop",
            "application": [
                "any"
            ],
            "category": [
                "any"
            ],
            "description": "Rule to block",
            "destination": [
                "panw-highrisk-ip-list"
            ],
            "folder": "Shared",
            "from": [
                "any"
            ],
            "id": "Id",
            "log_setting": "Cortex Data Lake",
            "name": "name",
            "negate_destination": false,
            "position": "pre",
            "service": [
                "any"
            ],
            "source": [
                "any"
            ],
            "source_user": [
                "any"
            ],
            "tag": [
                "best-practice"
            ],
            "to": [
                "any"
            ]
        }
    }
}

Human Readable Output#

Security Rules#
Id Name Description Action Destination Folder
Id Name Rule to block drop panw-highrisk-ip-list Shared

Id	Name	Description	Action	Destination	Folder
Id	Name	Rule to block	drop	panw-highrisk-ip-list	Shared

prisma-sase-candidate-config-push#

Push the candidate configuration.

Base Command#

prisma-sase-candidate-config-push

Input#

Argument Name	Description	Required
folders	Comma-separated list of targets (Remote Networks, Mobile Users, Service Connections).	Required
description	Configuration push job description.	Optional
interval_in_seconds	interval for polling command. Default is 30.	Optional
tsg_id	Tenant services group ID. If not provided, the tsg_id integration parameter will be used as the default.	Optional

Context Output#

Path	Type	Description
PrismaSase.CandidateConfig.job_id	String	Configuration job ID.
PrismaSase.CandidateConfig.result	String	The configuration push result, e.g. OK, FAIL.
PrismaSase.CandidateConfig.details	String	The configuration push details.

Command example#

!prisma-sase-candidate-config-push folders="Mobile Users"

Human Readable Output#

Waiting for all data to push for job id 201

prisma-sase-security-rule-update#

Update an existing security rule.

Base Command#

prisma-sase-security-rule-update

Input#

Argument Name	Description	Required
rule_id	ID of the rule to be changed.	Required
folder	The configuration folder group setting. Possible values are: Shared, Mobile Users, Remote Networks, Service Connections, Mobile Users Container, Mobile Users Explicit Proxy. Default is Shared.	Optional
position	Security rule position. Possible values are: pre, post. Default is pre.	Optional
action	Rule action. Possible values are: deny, allow, drop, reset-client, reset-server, reset-both.	Optional
description	The security rule's description.	Optional
log_setting	Rule log setting.	Optional
application	A comma-separated list of applications.	Optional
category	A comma-separated list of categories.	Optional
destination	A comma-separated list of destination networks.	Optional
destination_hip	A comma-separated list of destination HIPs.	Optional
profile_setting	Security profiles to apply to the traffic.	Optional
service	Services the rule applies to.	Optional
source	A comma-separated list of source networks.	Optional
source_hip	A comma-separated list of source HIPs.	Optional
source_user	A semi-colon (;) separated list of source user(s).	Optional
tag	A comma-separated list of rule tags.	Optional
from	A comma-separated list of source zones.	Optional
to	A comma-separated list of destination zones.	Optional
disabled	Whether the rule is disabled.	Optional
negate_source	Negate source.	Optional
negate_destination	Negate the destination.	Optional
overwrite	Whether to overwrite the original rule values. Possible values are: true, false. Default is false.	Optional
tsg_id	Tenant services group ID. If not provided, the tsg_id integration parameter will be used as the default.	Optional

Context Output#

Path	Type	Description
PrismaSase.SecurityRule	String	Edited security rule.
PrismaSase.SecurityRule.action	String	Security rule action.
PrismaSase.SecurityRule.application	String	Security rule application.
PrismaSase.SecurityRule.category	String	Security rule category.
PrismaSase.SecurityRule.description	String	Security rule description.
PrismaSase.SecurityRule.destination	String	Security rule destination.
PrismaSase.SecurityRule.folder	String	Security rule folder.
PrismaSase.SecurityRule.from	String	Security rule from field (source zone(s)).
PrismaSase.SecurityRule.id	String	Security rule ID.
PrismaSase.SecurityRule.name	String	Security rule name.
PrismaSase.SecurityRule.profile_setting.group	String	Security rule profile setting.
PrismaSase.SecurityRule.service	String	Security rule service.
PrismaSase.SecurityRule.source	String	Security rule source.
PrismaSase.SecurityRule.source_user	String	Security rule source user.
PrismaSase.SecurityRule.to	String	Security rule to field (destination zone(s)).

Command example#

!prisma-sase-security-rule-update rule_id="Id" position="pre" action="deny"

Context Example#

{
    "PrismaSase": {
        "SecurityRule": {
            "action": "deny",
            "application": [
                "any"
            ],
            "category": [
                "test"
            ],
            "description": "test",
            "destination": [
                "any"
            ],
            "folder": "Shared",
            "from": [
                "any"
            ],
            "id": "Id",
            "name": "somename",
            "position": "pre",
            "service": [
                "any"
            ],
            "source": [
                "any"
            ],
            "source_user": [
                "any"
            ],
            "to": [
                "any"
            ]
        }
    }
}

Human Readable Output#

Security Rule Updated#
Action Application Category Description Destination Folder From Id Name Position Service Source Source User To
deny any test test any Shared any Id name pre any any any any

Action	Application	Category	Description	Destination	Folder	From	Id	Name	Position	Service	Source	Source User	To
deny	any	test	test	any	Shared	any	Id	name	pre	any	any	any	any

prisma-sase-address-object-update#

Update an existing address object.

Base Command#

prisma-sase-address-object-update

Input#

Argument Name	Description	Required
object_id	ID of the address object to edit.	Required
folder	The configuration folder group setting. Possible values are: Shared, Mobile Users, Remote Networks, Service Connections, Mobile Users Container, Mobile Users Explicit Proxy. Default is Shared.	Optional
description	The address object's description.	Optional
type	The type of the address. Possible values are: ip_netmask, ip_range, ip_wildcard, fqdn.	Optional
address_value	The address value (should match the type).	Required
tag	A comma-separated list of address object tags.	Optional
tsg_id	Tenant services group ID. If not provided, the tsg_id integration parameter will be used as the default.	Optional

Context Output#

Path	Type	Description
PrismaSase.Address.description	String	Address description.
PrismaSase.Address.folder	String	Address folder.
PrismaSase.Address.id	String	Address ID.
PrismaSase.Address.address_value	String	Address value.
PrismaSase.Address.type	String	Address type.
PrismaSase.Address.name	String	Address name.

Command example#

!prisma-sase-address-object-update object_id="Id" address_value="8.8.8.4/32"

Context Example#

{
    "PrismaSase": {
        "Address": {
            "address_value": "8.8.8.4/32",
            "folder": "Shared",
            "id": "Id",
            "name": "name",
            "type": "ip_netmask"
        }
    }
}

Human Readable Output#

Address Object updated#
Address Value Folder Id Name Type
8.8.8.4/32 Shared Id name ip_netmask

Address Value	Folder	Id	Name	Type
8.8.8.4/32	Shared	Id	name	ip_netmask

prisma-sase-config-job-list#

Lists all configuration jobs.

Base Command#

prisma-sase-config-job-list

Input#

Argument Name	Description	Required
job_id	A specific config job to return. If not specified, all config jobs will be returned.	Optional
limit	The maximum number of results to return. Default is 50.	Optional
page	Page number you would like to view. Each page contains page_size values. Must be used along with page_size.	Optional
page_size	Number of results per page to display.	Optional
tsg_id	Tenant services group ID. If not provided, the tsg_id integration parameter will be used as the default.	Optional

Context Output#

Path	Type	Description
PrismaSase.ConfigJob.description	String	Configuration job description.
PrismaSase.ConfigJob.end_ts	Date	Configuration job end timestamp.
PrismaSase.ConfigJob.id	String	Configuration job ID.
PrismaSase.ConfigJob.job_result	String	Configuration job result.
PrismaSase.ConfigJob.job_status	String	Configuration job status.
PrismaSase.ConfigJob.job_type	String	Configuration job type.
PrismaSase.ConfigJob.parent_id	String	Configuration job parent ID.
PrismaSase.ConfigJob.percent	String	Configuration job percent.
PrismaSase.ConfigJob.result_str	String	Configuration job result string.
PrismaSase.ConfigJob.start_ts	Date	Configuration job start timestamp.
PrismaSase.ConfigJob.status_str	String	Configuration job status string.
PrismaSase.ConfigJob.summary	String	Configuration job summary.
PrismaSase.ConfigJob.type_str	String	Configuration job type string.
PrismaSase.ConfigJob.uname	String	Configuration job uname.

prisma-sase-security-rule-delete#

Delete a specific security rule.

Base Command#

prisma-sase-security-rule-delete

Input#

Argument Name	Description	Required
rule_id	Rule ID of the rule to be deleted.	Required
tsg_id	Tenant services group ID. If not provided, the tsg_id integration parameter will be used as the default.	Optional

Context Output#

There is no context output for this command.

Command example#

!prisma-sase-security-rule-delete rule_id="Id"

Human Readable Output#

Security Rule object with id Id and name name was deleted successfully

prisma-sase-address-object-create#

Create a new address object.

Base Command#

prisma-sase-address-object-create

Input#

Argument Name	Description	Required
folder	The configuration folder group setting. Possible values are: Shared, Mobile Users, Remote Networks, Service Connections, Mobile Users Container, Mobile Users Explicit Proxy. Default is Shared.	Optional
name	The name of the address object.	Required
description	The address object's description.	Optional
type	The type of the address. Possible values are: ip_netmask, ip_range, ip_wildcard, fqdn.	Required
tag	A comma-separated list of address object tags.	Optional
address_value	The address value (should match the type).	Required
tsg_id	Tenant services group ID. If not provided, the tsg_id integration parameter will be used as the default.	Optional

Context Output#

Path	Type	Description
PrismaSase.Address	String	Created address object.
PrismaSase.Address.description	String	Address description.
PrismaSase.Address.folder	String	Address folder.
PrismaSase.Address.id	String	Address ID.
PrismaSase.Address.type	String	Address type.
PrismaSase.Address.address_value	String	Address value.
PrismaSase.Address.name	String	Address name.

Command example#

!prisma-sase-address-object-create name="somename11" type="ip_netmask" address_value="8.8.8.8/32"

Context Example#

{
    "PrismaSase": {
        "Address": {
            "address_value": "8.8.8.8/32",
            "folder": "Shared",
            "id": "id",
            "name": "somename11",
            "type": "ip_netmask"
        }
    }
}

Human Readable Output#

Address Object Created#
Address Value Folder Id Name Type
8.8.8.8/32 Shared Id somename11 ip_netmask

Address Value	Folder	Id	Name	Type
8.8.8.8/32	Shared	Id	somename11	ip_netmask

prisma-sase-address-object-delete#

Delete a specific address object.

Base Command#

prisma-sase-address-object-delete

Input#

Argument Name	Description	Required
object_id	ID of the address object to delete.	Required
tsg_id	Tenant services group ID. If not provided, the tsg_id integration parameter will be used as the default.	Optional

Context Output#

There is no context output for this command.

Command example#

!prisma-sase-address-object-delete object_id="Id"

Human Readable Output#

Address object with id Id and name name was deleted successfully

prisma-sase-address-object-list#

Lists all addresses objects.

Base Command#

prisma-sase-address-object-list

Input#

Argument Name	Description	Required
object_id	The specific address object to return. If not specified, all addresses will be returned.	Optional
folder	The configuration folder group setting. Possible values are: Shared, Mobile Users, Remote Networks, Service Connections, Mobile Users Container, Mobile Users Explicit Proxy. Default is Shared.	Optional
limit	The maximum number of results to return. Default is 50.	Optional
page	Page number you would like to view. Each page contains page_size values. Must be used along with page_size.	Optional
page_size	Number of results per page to display.	Optional
tsg_id	Tenant services group ID. If not provided, the tsg_id integration parameter will be used as the default.	Optional

Context Output#

Path	Type	Description
PrismaSase.Address.description	String	Address description.
PrismaSase.Address.folder	String	Address folder.
PrismaSase.Address.id	String	Address ID.
PrismaSase.Address.name	String	Address name.
PrismaSase.Address.address_value	String	Address value.
PrismaSase.Address.type	String	Address type.

Command example#

!prisma-sase-address-object-list limit=1

Context Example#

{
    "PrismaSase": {
        "Address": {
            "address_value": "test.com",
            "description": "description",
            "folder": "Shared",
            "id": "Id",
            "name": "name",
            "type": "fqdn"
        }
    }
}

Human Readable Output#

Address Objects#
Id Name Description Type Address Value Tag
Id Palo Alto Networks Sinkhole Palo Alto Networks fqdn test.com

Id	Name	Description	Type	Address Value	Tag
Id	Palo Alto Networks Sinkhole	Palo Alto Networks	fqdn	test.com

prisma-sase-tag-list#

Lists all tags.

Base Command#

prisma-sase-tag-list

Input#

Argument Name	Description	Required
tag_id	A specific tag to return. If not specified, all tags will be returned.	Optional
folder	The configuration folder group setting. Possible values are: Shared, Mobile Users, Remote Networks, Service Connections, Mobile Users Container, Mobile Users Explicit Proxy. Default is Shared.	Optional
limit	The maximum number of results to return. Default is 50.	Optional
page	Page number you would like to view. Each page contains page_size values. Must be used along with page_size.	Optional
page_size	Number of results per page to display.	Optional
tsg_id	Tenant services group ID. If not provided, the tsg_id integration parameter will be used as the default.	Optional

Context Output#

Path	Type	Description
PrismaSase.Tag.id	String	Tag ID.
PrismaSase.Tag.name	String	Tag name.
PrismaSase.Tag.folder	String	Tag folder.
PrismaSase.Tag.comments	String	Tag comments.
PrismaSase.Tag.color	String	The tag color.

Command example#

!prisma-sase-tag-list limit=1

Context Example#

{
    "PrismaSase": {
        "Tag": {
            "color": "Olive",
            "folder": "predefined",
            "name": "Sanctioned"
        }
    }
}

Human Readable Output#

Tags#
Id Name Folder Color Comments
Id test predefined Olive

Id	Name	Folder	Color	Comments
Id	test	predefined	Olive

prisma-sase-tag-create#

Create a new tag.

Base Command#

prisma-sase-tag-create

Input#

Argument Name	Description	Required
folder	The configuration folder group setting. Possible values are: Shared, Mobile Users, Remote Networks, Service Connections, Mobile Users Container, Mobile Users Explicit Proxy. Default is Shared.	Optional
name	The tag unique name.	Required
color	Tag color. Possible values are: Red, Green, Blue, Yellow, Copper, Orange, Purple, Gray, Light Green, Cyan, Light Gray, Blue Gray, Lime, Black, Gold, Brown, Olive, Maroon, Red-Orange, Yellow-Orange, Forest Green, Turquoise Blue, Azure Blue, Cerulean Blue, Midnight Blue, Medium Blue, Cobalt Blue, Violet Blue, Blue Violet, Medium Violet, Medium Rose, Lavender, Orchid, Thistle, Peach, Salmon, Magenta, Red Violet, Mahogany, Burnt Sienna, Chestnut.	Optional
comments	Tag comments.	Optional
tsg_id	Tenant services group ID. If not provided, the tsg_id integration parameter will be used as the default.	Optional

Context Output#

Path	Type	Description
PrismaSase.Tag.id	String	The tag ID.
PrismaSase.Tag.name	String	The tag name.
PrismaSase.Tag.folder	String	The tag folder.
PrismaSase.Tag.color	String	The tag color.
PrismaSase.Tag.comments	String	The tag comments.

Command example#

!prisma-sase-tag-create name="somename11" color="Azure Blue"

Context Example#

{
    "PrismaSase": {
        "Tag": {
            "color": "Azure Blue",
            "folder": "Shared",
            "id": "Id",
            "name": "somename11"
        }
    }
}

Human Readable Output#

Address Object Created#
Color Folder Id Name
Azure Blue Shared Id somename11

Color	Folder	Id	Name
Azure Blue	Shared	Id	somename11

prisma-sase-tag-update#

Update an existing tag.

Base Command#

prisma-sase-tag-update

Input#

Argument Name	Description	Required
folder	The configuration folder group setting. Possible values are: Shared, Mobile Users, Remote Networks, Service Connections, Mobile Users Container, Mobile Users Explicit Proxy. Default is Shared.	Optional
tag_id	The tag ID.	Required
color	Tag color. Possible values are: Red, Green, Blue, Yellow, Copper, Orange, Purple, Gray, Light Green, Cyan, Light Gray, Blue Gray, Lime, Black, Gold, Brown, Olive, Maroon, Red-Orange, Yellow-Orange, Forest Green, Turquoise Blue, Azure Blue, Cerulean Blue, Midnight Blue, Medium Blue, Cobalt Blue, Violet Blue, Blue Violet, Medium Violet, Medium Rose, Lavender, Orchid, Thistle, Peach, Salmon, Magenta, Red Violet, Mahogany, Burnt Sienna, Chestnut.	Optional
comments	Tag comments.	Optional
tsg_id	Tenant services group ID. If not provided, the tsg_id integration parameter will be used as the default.	Optional

Context Output#

Path	Type	Description
PrismaSase.Tag.id	String	The tag ID.
PrismaSase.Tag.name	String	The tag name.
PrismaSase.Tag.folder	String	The tag folder.
PrismaSase.Tag.color	String	The tag color.
PrismaSase.Tag.comments	String	The tag comments.

Command example#

!prisma-sase-tag-update tag_id="Id" color="Black"

Context Example#

{
    "PrismaSase": {
        "Tag": {
            "color": "Black",
            "folder": "Shared",
            "id": "Id",
            "name": "somename"
        }
    }
}

Human Readable Output#

Tag Edited#
Color Folder Id Name
Black Shared Id somename

Color	Folder	Id	Name
Black	Shared	Id	somename

prisma-sase-tag-delete#

Delete a specific tag.

Base Command#

prisma-sase-tag-delete

Input#

Argument Name	Description	Required
tag_id	The specific tag to delete.	Required
tsg_id	Tenant services group ID. If not provided, the tsg_id integration parameter will be used as the default.	Optional

Context Output#

There is no context output for this command.

Command example#

!prisma-sase-tag-delete tag_id="Id"

Human Readable Output#

Tag with id Id and name somename was deleted successfully

prisma-sase-address-group-list#

Lists all address groups.

Base Command#

prisma-sase-address-group-list

Input#

Argument Name	Description	Required
group_id	A specific address group to return. If not specified, all address groups will be returned.	Optional
folder	The configuration folder group setting. Possible values are: Shared, Mobile Users, Remote Networks, Service Connections, Mobile Users Container, Mobile Users Explicit Proxy. Default is Shared.	Optional
limit	The maximum number of results to return. Default is 50.	Optional
page	Page number you would like to view. Each page contains page_size values. Must be used along with page_size.	Optional
page_size	Number of results per page to display.	Optional
tsg_id	Tenant services group ID. If not provided, the tsg_id integration parameter will be used as the default.	Optional

Context Output#

Path	Type	Description
PrismaSase.AddressGroup.id	String	The address group ID.
PrismaSase.AddressGroup.name	String	The address group name.
PrismaSase.AddressGroup.description	String	The address group description.
PrismaSase.AddressGroup.addresses	String	The address group addresses.
PrismaSase.AddressGroup.dynamic_filter	String	The address group filter.

Command example#

!prisma-sase-address-group-list limit=1

Context Example#

{
    "PrismaSase": {
        "AddressGroup": {
            "description": "test",
            "dynamic_filter": "'test' or 'test1' and 'best-practice'",
            "folder": "Shared",
            "id": "Id",
            "name": "Test"
        }
    }
}

Human Readable Output#

Address Groups#
Id Name Description Addresses Dynamic Filter
Id Moishy_Test test 'test' or 'test1' and 'best-practice'

Id	Name	Description	Addresses	Dynamic Filter
Id	Moishy_Test	test		'test' or 'test1' and 'best-practice'

prisma-sase-address-group-create#

Create a new address group.

Base Command#

prisma-sase-address-group-create

Input#

Argument Name	Description	Required
folder	The configuration folder group setting. Possible values are: Shared, Mobile Users, Remote Networks, Service Connections, Mobile Users Container, Mobile Users Explicit Proxy. Default is Shared.	Optional
type	The address group type. Possible values are: static, dynamic.	Required
static_addresses	Static addresses for the address group. If the type is static, a value must be provided.	Optional
dynamic_filter	Dynamic filter for the address group. If the type is dynamic, a value must be provided.	Optional
description	The address group's description.	Optional
name	The name of the address group.	Required
tsg_id	Tenant services group ID. If not provided, the tsg_id integration parameter will be used as the default.	Optional

Context Output#

Path	Type	Description
PrismaSase.AddressGroup.id	String	The address group ID.
PrismaSase.AddressGroup.name	String	The address group name.
PrismaSase.AddressGroup.folder	String	The address group folder.
PrismaSase.AddressGroup.description	String	The address group description.
PrismaSase.AddressGroup.addresses	String	The address group addresses.
PrismaSase.AddressGroup.dynamic_filter	String	The address group filter.

Command example#

!prisma-sase-address-group-create name="somename" dynamic_filter="test" overwrite="false"

Context Example#

{
    "PrismaSase": {
        "AddressGroup": {
            "dynamic_filter": "test",
            "folder": "Shared",
            "id": "Id",
            "name": "somename"
        }
    }
}

Human Readable Output#

Address Group created#
Dynamic Filter Folder Id Name
test Shared Id somename

Dynamic Filter	Folder	Id	Name
test	Shared	Id	somename

prisma-sase-address-group-update#

Update an existing address group.

Base Command#

prisma-sase-address-group-update

Input#

Argument Name	Description	Required
group_id	The id of the address group.	Required
folder	The configuration folder group setting. Possible values are: Shared, Mobile Users, Remote Networks, Service Connections, Mobile Users Container, Mobile Users Explicit Proxy. Default is Shared.	Optional
static_addresses	Static addresses for the address group. If the type is static, a value must be provided.	Optional
dynamic_filter	Dynamic filter for the address group. If the type is dynamic, a value must be provided.	Optional
overwrite	Whether to overwrite the original address group values. Possible values are: true, false. Default is false.	Optional
description	The address group's description.	Optional
type	The address group type. Possible values are: dynamic, static.	Optional
tsg_id	Tenant services group ID. If not provided, the tsg_id integration parameter will be used as the default.	Optional

Context Output#

Path	Type	Description
PrismaSase.AddressGroup.id	String	The address group ID.
PrismaSase.AddressGroup.name	String	The address group name.
PrismaSase.AddressGroup.folder	String	The address group folder.
PrismaSase.AddressGroup.description	String	The address group description.
PrismaSase.AddressGroup.addresses	String	The address group addresses.
PrismaSase.AddressGroup.dynamic_filter	String	The address group filter.

Command example#

!prisma-sase-address-group-update group_id="Id" dynamic_filter="and 'test2'" overwrite="false"

Context Example#

{
    "PrismaSase": {
        "AddressGroup": {
            "dynamic_filter": "test and test2",
            "folder": "Shared",
            "id": "Id",
            "name": "somename"
        }
    }
}

Human Readable Output#

Address Group updated#
Dynamic Filter Folder Id Name
test and test2 Shared Id somename

Dynamic Filter	Folder	Id	Name
test and test2	Shared	Id	somename

prisma-sase-address-group-delete#

Delete a specific address group.

Base Command#

prisma-sase-address-group-delete

Input#

Argument Name	Description	Required
group_id	The name of the address group.	Required
tsg_id	Tenant services group ID. If not provided, the tsg_id integration parameter will be used as the default.	Optional

Context Output#

There is no context output for this command.

Command example#

!prisma-sase-address-group-delete group_id="Id"

Human Readable Output#

Address group with id Id and name somename was deleted successfully

prisma-sase-custom-url-category-list#

Lists all custom URL categories.

Base Command#

prisma-sase-custom-url-category-list

Input#

Argument Name	Description	Required
id	A specific url category to return. If not specified, all url categories will be returned.	Optional
folder	The configuration folder group setting. Possible values are: Shared, Mobile Users, Remote Networks, Service Connections, Mobile Users Container, Mobile Users Explicit Proxy. Default is Shared.	Optional
limit	The maximum number of results to return. Default is 50.	Optional
page	Page number you would like to view. Each page contains page_size values. Must be used along with page_size.	Optional
page_size	Number of results per page to display.	Optional
tsg_id	Tenant services group ID. If not provided, the tsg_id integration parameter will be used as the default.	Optional

Context Output#

Path	Type	Description
PrismaSase.CustomURLCategory.id	String	The URL category ID.
PrismaSase.CustomURLCategory.name	String	The URL category name.
PrismaSase.CustomURLCategory.folder	String	The URL category folder.
PrismaSase.CustomURLCategory.type	String	The URL category type.
PrismaSase.CustomURLCategory.list	String	The URL category match list.
PrismaSase.CustomURLCategory.description	String	The URL category description.

Command example#

!prisma-sase-custom-url-category-list limit=1

Context Example#

{
    "PrismaSase": {
        "CustomURLCategory": {
            "folder": "Shared",
            "id": "Id",
            "list": [
                "www.test.com",
                "www.test2.com"
            ],
            "name": "name",
            "type": "URL List"
        }
    }
}

Human Readable Output#

Custom Url Categories#
Id Name Folder Type List
Id name Shared URL List www.test2.com,
www.test.com

Id	Name	Folder	Type	List
Id	name	Shared	URL List	www.test2.com, www.test.com

prisma-sase-custom-url-category-create#

Create a new URL category.

Base Command#

prisma-sase-custom-url-category-create

Input#

Argument Name	Description	Required
folder	The configuration folder group setting. Possible values are: Shared, Mobile Users, Remote Networks, Service Connections, Mobile Users Container, Mobile Users Explicit Proxy. Default is Shared.	Optional
type	The custom URL category's type. Possible values are: URL List, Category Match.	Required
value	If the type is URL List, the value will be a comma-separated array of URL addresses. If the type is Category Match, the value will be a comma-separated array of category names. You can get the names by running the prisma-sase-url-access-profile-list command.	Required
description	The custom URL category's description.	Optional
name	The name of the custom URL category.	Required
tsg_id	Tenant services group ID. If not provided, the tsg_id integration parameter will be used as the default.	Optional

Context Output#

Path	Type	Description
PrismaSase.CustomURLCategory.id	String	The URL category ID.
PrismaSase.CustomURLCategory.name	String	The URL category name.
PrismaSase.CustomURLCategory.folder	String	The URL category folder.
PrismaSase.CustomURLCategory.type	String	The URL category type.
PrismaSase.CustomURLCategory.list	String	The URL category match list.
PrismaSase.CustomURLCategory.description	String	The URL category description.

Command example#

!prisma-sase-custom-url-category-create type="Category Match" value="low-risk" name="somename11"

Context Example#

{
    "PrismaSase": {
        "CustomURLCategory": {
            "folder": "Shared",
            "id": "id",
            "list": [
                "low-risk"
            ],
            "name": "somename11",
            "type": "Category Match"
        }
    }
}

Human Readable Output#

Custom URrl Category Created#
Folder Id List Name Type
Shared Id low-risk somename11 Category Match

prisma-sase-custom-url-category-update#

Update an existing url category.

Base Command#

prisma-sase-custom-url-category-update

Input#

Argument Name	Description	Required
id	The custom URL category id.	Required
folder	The configuration folder group setting. Possible values are: Shared, Mobile Users, Remote Networks, Service Connections, Mobile Users Container, Mobile Users Explicit Proxy. Default is Shared.	Optional
value	The custom URL category's value.	Optional
overwrite	Whether to overwrite the original custom URL category values. Possible values are: true, false. Default is false.	Optional
description	The custom URL category's description.	Optional
type	The custom URL category's type. Possible values are: URL List, Category Match.	Optional
tsg_id	Tenant services group ID. If not provided, the tsg_id integration parameter will be used as the default.	Optional

Context Output#

Path	Type	Description
PrismaSase.CustomURLCategory.id	String	The URL category ID.
PrismaSase.CustomURLCategory.name	String	The URL category name.
PrismaSase.CustomURLCategory.folder	String	The URL category folder.
PrismaSase.CustomURLCategory.type	String	The URL category type.
PrismaSase.CustomURLCategory.list	String	The URL category match list.
PrismaSase.CustomURLCategory.description	String	The URL category description.

Command example#

!prisma-sase-custom-url-category-update id="Id" value="high-risk" overwrite="false"

Context Example#

{
    "PrismaSase": {
        "CustomURLCategory": {
            "folder": "Shared",
            "id": "Id",
            "list": [
                "low-risk",
                "high-risk"
            ],
            "name": "somename",
            "type": "Category Match"
        }
    }
}

Human Readable Output#

Custom Url Category updated#
Folder Id List Name Type
Shared Id low-risk,
high-risk somename Category Match

prisma-sase-custom-url-category-delete#

Delete a specific url category.

Base Command#

prisma-sase-custom-url-category-delete

Input#

Argument Name	Description	Required
id	The custom URL category id.	Required
tsg_id	Tenant services group ID. If not provided, the tsg_id integration parameter will be used as the default.	Optional

Context Output#

There is no context output for this command.

Command example#

!prisma-sase-custom-url-category-delete id="Id"

Human Readable Output#

Custom Url Category with id Id and name somename was deleted successfully

prisma-sase-external-dynamic-list-list#

Lists all external dynamic lists.

Base Command#

prisma-sase-external-dynamic-list-list

Input#

Argument Name	Description	Required
id	A specific external dynamic list to return. If not specified, all external dynamic lists will be returned.	Optional
folder	The configuration folder group setting. Possible values are: Shared, Mobile Users, Remote Networks, Service Connections, Mobile Users Container, Mobile Users Explicit Proxy. Default is Shared.	Optional
limit	The maximum number of results to return. Default is 50.	Optional
page	Page number you would like to view. Each page contains page_size values. Must be used along with page_size.	Optional
page_size	Number of results per page to display.	Optional
tsg_id	Tenant services group ID. If not provided, the tsg_id integration parameter will be used as the default.	Optional

Context Output#

Path	Type	Description
PrismaSase.ExternalDynamicList.id	String	The external dynamic list ID.
PrismaSase.ExternalDynamicList.name	String	The external dynamic list name.
PrismaSase.ExternalDynamicList.folder	String	The external dynamic list folder.
PrismaSase.ExternalDynamicList.description	String	The external dynamic list description.
PrismaSase.ExternalDynamicList.type	String	The external dynamic list type.
PrismaSase.ExternalDynamicList.source	String	The external dynamic list source.
PrismaSase.ExternalDynamicList.frequency	String	The external dynamic list frequency.

Command example#

!prisma-sase-external-dynamic-list-list limit=1

Context Example#

{
    "PrismaSase": {
        "ExternalDynamicList": {
            "description": "description",
            "display_name": "display name",
            "folder": "predefined",
            "name": "panw-known-ip-list",
            "source": "predefined",
            "type": "predefined"
        }
    }
}

Human Readable Output#

External Dynamic Lists#
Id Name Type Folder Description Source Frequency
panw-known-ip-list predefined predefined description predefined

prisma-sase-external-dynamic-list-create#

Create a new dynamic list.

Base Command#

prisma-sase-external-dynamic-list-create

Input#

Argument Name	Description	Required
name	The external dynamic list name.	Required
folder	The configuration folder group setting. Possible values are: Shared, Mobile Users, Remote Networks, Service Connections, Mobile Users Container, Mobile Users Explicit Proxy. Default is Shared.	Optional
description	The dynamic list's description.	Optional
type	The dynamic list's type. Possible values are: predefined_ip, predefined_url, ip, domain, url.	Required
predefined_ip_list	The predefined IP list. If the type is predefined_ip, a value must be provided. Possible values are: panw-torexit-ip-list, panw-bulletproof-ip-list, panw-highrisk-ip-list, panw-known-ip-list.	Optional
predefined_url_list	The predefined URL list. If the type is predefined_url, a value must be provided. Possible values are: panw–auth-portal-exclude-list.	Optional
source_url	The source URL. If the type is ip, url or domain, a value must be provided.	Optional
frequency	Frequency to check for updates. Possible values are: five_minute, hourly, daily, weekly, monthly.	Optional
frequency_hour	The frequency hour. If the frequency argument is daily, weekly or monthly, value must be provided. Possible values are 00-23.	Optional
day_of_week	The day of the week. If the frequency argument is weekly or monthly, a value must be provided. Possible values are: monday, tuesday, wednesday, thursday, friday, saturday, sunday.	Optional
day_of_month	The day of the month. If the frequency argument is monthly, a value must be provided. Possible values are between 1 and 31.	Optional
exception_list	The user can exclude certain addresses from the list depending on the type of list.	Optional
tsg_id	Tenant services group ID. If not provided, the tsg_id integration parameter will be used as the default.	Optional

Context Output#

Path	Type	Description
PrismaSase.ExternalDynamicList.id	String	The external dynamic list ID.
PrismaSase.ExternalDynamicList.name	String	The external dynamic list name.
PrismaSase.ExternalDynamicList.folder	String	The external dynamic list folder.
PrismaSase.ExternalDynamicList.description	String	The external dynamic list description.
PrismaSase.ExternalDynamicList.type	String	The external dynamic list type.
PrismaSase.ExternalDynamicList.source	String	The external dynamic list source.
PrismaSase.ExternalDynamicList.frequency	String	The external dynamic list frequency.

Command example#

!prisma-sase-external-dynamic-list-create name="somename11" folder="Shared" type="predefined_ip" predefined_ip_list="panw-highrisk-ip-list"

Context Example#

{
    "PrismaSase": {
        "ExternalDynamicList": {
            "description": null,
            "exception_list": null,
            "folder": "Shared",
            "frequency": null,
            "id": "Id",
            "name": "somename11",
            "source": "panw-highrisk-ip-list",
            "type": "predefined_ip"
        }
    }
}

Human Readable Output#

External Dynamic List Created#
Id Name Type Folder Description Source Frequency
Id somename11 predefined_ip Shared panw-highrisk-ip-list

Command example#

!prisma-sase-external-dynamic-list-create name="somename111" folder="Shared" type="domain" source_url="test.com" frequency="monthly" frequency_hour="09" day_of_month="1"

Context Example#

{
    "PrismaSase": {
        "ExternalDynamicList": {
            "description": null,
            "exception_list": null,
            "folder": "Shared",
            "frequency": {
                "monthly": {
                    "at": "09",
                    "day_of_month": 1
                }
            },
            "id": "Id",
            "name": "somename111",
            "source": "test.com",
            "type": "domain"
        }
    }
}

Human Readable Output#

External Dynamic List Created#
Id Name Type Folder Description Source Frequency
Id somename111 domain Shared test.com monthly:
at: 09
day_of_month: 1

prisma-sase-external-dynamic-list-update#

Update an existing dynamic list.

Base Command#

prisma-sase-external-dynamic-list-update

Input#

Argument Name	Description	Required
id	The external dynamic list id.	Required
folder	The configuration folder group setting. Possible values are: Shared, Mobile Users, Remote Networks, Service Connections, Mobile Users Container, Mobile Users Explicit Proxy. Default is Shared.	Optional
overwrite	Whether to overwrite the external dynamic list values. Possible values are: true, false. Default is false.	Optional
description	The dynamic list's description.	Optional
type	The dynamic list's type. Possible values are: predefined_ip, predefined_url, ip, domain, url.	Optional
predefined_ip_list	The predefined ip list. If the type is predefined_ip, a value must be provided. Possible values are: panw-torexit-ip-list, panw-bulletproof-ip-list, panw-highrisk-ip-list, panw-known-ip-list.	Optional
predefined_url_list	The predefined URL list. If the type is predefined_url, a value must be provided. Possible values are: panw–auth-portal-exclude-list.	Optional
source_url	The source URL. If the type is ip, url or domain, a value must be provided.	Optional
frequency	Frequency to check for updates. Possible values are: five_minute, hourly, daily, weekly, monthly.	Optional
frequency_hour	The frequency hour.	Optional
day_of_week	The day of the week. Possible values are: monday, tuesday, wednesday, thursday, friday, saturday, sunday.	Optional
day_of_month	The day of the month. Possible values are between 1 and 31.	Optional
exception_list	The user can exclude certain addresses from the list depending on the type of list.	Optional
tsg_id	Tenant services group ID. If not provided, the tsg_id integration parameter will be used as the default.	Optional

Context Output#

Path	Type	Description
PrismaSase.ExternalDynamicList.id	String	The external dynamic list ID.
PrismaSase.ExternalDynamicList.name	String	The external dynamic list name.
PrismaSase.ExternalDynamicList.folder	String	The external dynamic list folder.
PrismaSase.ExternalDynamicList.description	String	The external dynamic list description.
PrismaSase.ExternalDynamicList.type	String	The external dynamic list type.
PrismaSase.ExternalDynamicList.source	String	The external dynamic list source.
PrismaSase.ExternalDynamicList.frequency	String	The external dynamic list frequency.

Command example#

!prisma-sase-external-dynamic-list-update id'"Id"" predefined_ip_list="panw-lowrisk-ip-list"

Context Example#

{
    "PrismaSase": {
        "ExternalDynamicList": {
            "description": null,
            "exception_list": null,
            "folder": "Shared",
            "frequency": null,
            "id": "Id",
            "name": "somename11",
            "source": "panw-lowrisk-ip-list",
            "type": "predefined_ip"
        }
    }
}

Human Readable Output#

External Dynamic List Updated#
Id Name Type Folder Description Source Frequency
Id somename11 predefined_ip Shared panw-lowrisk-ip-list

prisma-sase-external-dynamic-list-delete#

Delete a specific dynamic list.

Base Command#

prisma-sase-external-dynamic-list-delete

Input#

Argument Name	Description	Required
id	The external dynamic list id.	Required
tsg_id	Tenant services group ID. If not provided, the tsg_id integration parameter will be used as the default.	Optional

Context Output#

There is no context output for this command.

Command example#

!prisma-sase-external-dynamic-list-delete id="Id"

Human Readable Output#

External Dynamic List with id Id and name name was deleted successfully

prisma-sase-url-category-list#

Get all predefined URL categories.

Base Command#

prisma-sase-url-category-list

Input#

Argument Name	Description	Required
folder	The configuration folder group setting. Possible values are: Shared, Mobile Users, Remote Networks, Service Connections, Mobile Users Container, Mobile Users Explicit Proxy. Default is Shared.	Optional
tsg_id	Tenant services group ID. If not provided, the tsg_id integration parameter will be used as the default.	Optional

Context Output#

There is no context output for this command.

Command example#

!prisma-sase-url-category-list limit=1

Human Readable Output#

URL categories#
alert allow block continue override
recreation-and-hobbies,
educational-institutions,
real-estate,
web-advertisements,
health-and-medicine,
stock-advice-and-tools,
travel,
computer-and-internet-info,
personal-sites-and-blogs,
swimsuits-and-intimate-apparel,
social-networking,
religion,
medium-risk,
business-and-economy,
private-ip-addresses,
web-hosting,
entertainment-and-arts,
streaming-media,
abortion,
translation,
internet-portals,
online-storage-and-backup,
job-search,
motor-vehicles,
web-based-email,
nudity,
sports,
training-and-tools,
government,
shareware-and-freeware,
legal,
shopping,
alcohol-and-tobacco,
low-risk,
auctions,
high-risk,
search-engines,
cryptocurrency,
not-resolved,
society,
financial-services,
military,
news,
philosophy-and-political-advocacy,
content-delivery-networks,
internet-communications-and-telephony,
music,
home-and-garden,
hunting-and-fishing,
reference-and-research,
dating,
sex-education,
games hacking,
extremism,
weapons,
command-and-control,
ransomware,
copyright-infringement,
dynamic-dns,
parked,
phishing,
medium-risk,
unknown,
abused-drugs,
insufficient-content,
adult,
newly-registered-domain,
grayware,
high-risk,
gambling,
malware,
peer-to-peer,
proxy-avoidance-and-anonymizers,
questionable

prisma-sase-quarantine-host#

Quarantine a host.

Base Command#

prisma-sase-quarantine-host

Input#

Argument Name	Description	Required
tsg_id	Tenant services group ID. If not provided, the tsg_id integration parameter will be used as the default.	Optional
host_id	The host ID.	Required

Context Output#

There is no context output for this command.

Command example#

!prisma-sase-quarantine-host host_id="host_id"

Human Readable Output#

Host Quarantined#
host_id
test_host