feat(cortex-xdr): full command coverage (50 commands) — endpoints, scripts, exclusions, tags, audits, RBAC, distributions
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Guillaume BOURGEOIS
@@ -1,8 +1,8 @@
|
||||
id: cortex_xdr
|
||||
name: Cortex XDR
|
||||
version: 1.0.0
|
||||
description: "Palo Alto Cortex XDR (public API v1) — incident ingestion, endpoint isolation, RTR scripts, hash block/allow lists, file quarantine/restore, scans and alert retrieval."
|
||||
changelog: "1.0.0 — Initial release: incident ingestion (get_incidents) with OCSF mapper, endpoints, isolate/unisolate, scan, hash blocklist/allowlist, quarantine/restore, run script + results, alerts retrieval, distributions and action status. Standard or Advanced API authentication."
|
||||
version: 1.1.0
|
||||
description: "Palo Alto Cortex XDR (public API v1) — incident ingestion, endpoint isolation/scan/delete/tagging, RTR scripts, hash block/allow lists, file quarantine/restore/retrieval, alert exclusions, device-control violations, audits, distributions and RBAC/risk."
|
||||
changelog: "1.1.0 — Full command coverage: added delete/alias/tag endpoints, abort scan, original alerts, script metadata/code/snippet/exec-status, file retrieval (+details), alert exclusions, device-control violations, audits, distribution url/status/create and RBAC (users, roles, groups, risk score, risky users/hosts). 1.0.0 — Initial release: incident ingestion (get_incidents) with OCSF mapper, endpoints, isolate/unisolate, scan, hash blocklist/allowlist, quarantine/restore, run script + results, alerts retrieval, distributions and action status. Standard or Advanced API authentication."
|
||||
category: endpoint
|
||||
|
||||
# Per-instance configuration. The base URL is the tenant API root, e.g.
|
||||
@@ -260,6 +260,279 @@ commands:
|
||||
required: []
|
||||
outputs_schema: { properties: {} }
|
||||
|
||||
- id: delete_endpoints
|
||||
name: cortex-xdr-delete-endpoints
|
||||
description: "Delete endpoints (agents) by ID."
|
||||
inputs_schema:
|
||||
properties:
|
||||
endpoint_ids: { type: string, description: "Comma-separated endpoint IDs to delete" }
|
||||
required: [endpoint_ids]
|
||||
outputs_schema: { properties: {} }
|
||||
- id: set_endpoint_alias
|
||||
name: cortex-xdr-set-endpoint-alias
|
||||
description: "Set the alias name on endpoints."
|
||||
inputs_schema:
|
||||
properties:
|
||||
endpoint_ids: { type: string, description: "Comma-separated endpoint IDs" }
|
||||
alias: { type: string, description: "New alias name (empty to clear)" }
|
||||
required: [endpoint_ids]
|
||||
outputs_schema: { properties: {} }
|
||||
- id: abort_scan
|
||||
name: cortex-xdr-abort-scan
|
||||
description: "Abort a running malware scan on endpoints matching the filters (or all)."
|
||||
inputs_schema:
|
||||
properties:
|
||||
endpoint_id_list: { type: string, description: "Comma-separated endpoint IDs (omit to abort all)" }
|
||||
incident_id: { type: string, description: "Optional incident ID" }
|
||||
required: []
|
||||
outputs_schema: { properties: {} }
|
||||
- id: get_original_alerts
|
||||
name: cortex-xdr-get-original-alerts
|
||||
description: "Get the original raw alert events by alert ID."
|
||||
risk: read
|
||||
inputs_schema:
|
||||
properties:
|
||||
alert_id_list: { type: string, description: "Comma-separated alert IDs" }
|
||||
required: [alert_id_list]
|
||||
outputs_schema: { properties: {} }
|
||||
- id: get_script_metadata
|
||||
name: cortex-xdr-get-script-metadata
|
||||
description: "Get metadata for a script by UID."
|
||||
risk: read
|
||||
inputs_schema:
|
||||
properties:
|
||||
script_uid: { type: string, description: "Script UID" }
|
||||
required: [script_uid]
|
||||
outputs_schema: { properties: {} }
|
||||
- id: get_script_code
|
||||
name: cortex-xdr-get-script-code
|
||||
description: "Get the source code of a script by UID."
|
||||
risk: read
|
||||
inputs_schema:
|
||||
properties:
|
||||
script_uid: { type: string, description: "Script UID" }
|
||||
required: [script_uid]
|
||||
outputs_schema: { properties: {} }
|
||||
- id: run_snippet_code_script
|
||||
name: cortex-xdr-run-snippet-code-script
|
||||
description: "Run an arbitrary code snippet on endpoints."
|
||||
inputs_schema:
|
||||
properties:
|
||||
snippet_code: { type: string, description: "Code snippet to run" }
|
||||
endpoint_ids: { type: string, description: "Comma-separated endpoint IDs" }
|
||||
incident_id: { type: string, description: "Optional incident ID" }
|
||||
required: [snippet_code, endpoint_ids]
|
||||
outputs_schema: { properties: {} }
|
||||
- id: get_script_execution_status
|
||||
name: cortex-xdr-get-script-execution-status
|
||||
description: "Get the status of a script execution by action ID."
|
||||
risk: read
|
||||
inputs_schema:
|
||||
properties:
|
||||
action_id: { type: string, description: "Action ID" }
|
||||
required: [action_id]
|
||||
outputs_schema: { properties: {} }
|
||||
- id: retrieve_file
|
||||
name: cortex-xdr-retrieve-file
|
||||
description: "Retrieve files from endpoints by OS-specific path lists."
|
||||
inputs_schema:
|
||||
properties:
|
||||
endpoint_ids: { type: string, description: "Comma-separated endpoint IDs" }
|
||||
windows: { type: string, description: "Comma-separated Windows file paths" }
|
||||
linux: { type: string, description: "Comma-separated Linux file paths" }
|
||||
macos: { type: string, description: "Comma-separated macOS file paths" }
|
||||
incident_id: { type: string, description: "Optional incident ID" }
|
||||
required: [endpoint_ids]
|
||||
outputs_schema: { properties: {} }
|
||||
- id: retrieve_file_details
|
||||
name: cortex-xdr-retrieve-file-details
|
||||
description: "Get the download details of a file-retrieval action."
|
||||
risk: read
|
||||
inputs_schema:
|
||||
properties:
|
||||
action_id: { type: string, description: "Group action ID from retrieve_file" }
|
||||
required: [action_id]
|
||||
outputs_schema: { properties: {} }
|
||||
- id: add_exclusion
|
||||
name: cortex-xdr-add-exclusion
|
||||
description: "Add an alert exclusion."
|
||||
inputs_schema:
|
||||
properties:
|
||||
name: { type: string, description: "Exclusion name" }
|
||||
indicator: { type: string, description: "JSON indicator object for the exclusion filter" }
|
||||
status: { type: string, description: "ENABLED or DISABLED (default ENABLED)" }
|
||||
required: [name, indicator]
|
||||
outputs_schema: { properties: {} }
|
||||
- id: delete_exclusion
|
||||
name: cortex-xdr-delete-exclusion
|
||||
description: "Delete an alert exclusion by ID."
|
||||
inputs_schema:
|
||||
properties:
|
||||
alert_exclusion_id: { type: number, description: "Exclusion ID" }
|
||||
required: [alert_exclusion_id]
|
||||
outputs_schema: { properties: {} }
|
||||
- id: get_exclusion
|
||||
name: cortex-xdr-get-exclusion
|
||||
description: "List alert exclusions."
|
||||
risk: read
|
||||
inputs_schema:
|
||||
properties:
|
||||
tenant_id: { type: string, description: "Optional tenant ID" }
|
||||
required: []
|
||||
outputs_schema: { properties: {} }
|
||||
- id: add_tag_endpoint
|
||||
name: cortex-xdr-add-tag-endpoint
|
||||
description: "Add a tag to endpoints."
|
||||
inputs_schema:
|
||||
properties:
|
||||
endpoint_ids: { type: string, description: "Comma-separated endpoint IDs" }
|
||||
tag: { type: string, description: "Tag to add" }
|
||||
required: [endpoint_ids, tag]
|
||||
outputs_schema: { properties: {} }
|
||||
- id: remove_tag_endpoint
|
||||
name: cortex-xdr-remove-tag-endpoint
|
||||
description: "Remove a tag from endpoints."
|
||||
inputs_schema:
|
||||
properties:
|
||||
endpoint_ids: { type: string, description: "Comma-separated endpoint IDs" }
|
||||
tag: { type: string, description: "Tag to remove" }
|
||||
required: [endpoint_ids, tag]
|
||||
outputs_schema: { properties: {} }
|
||||
- id: get_device_control_violations
|
||||
name: cortex-xdr-get-device-control-violations
|
||||
description: "List device control (USB) violations."
|
||||
risk: read
|
||||
inputs_schema:
|
||||
properties:
|
||||
endpoint_ids: { type: string, description: "Comma-separated endpoint IDs" }
|
||||
type: { type: string, description: "Comma-separated violation types" }
|
||||
timestamp_gte: { type: string, description: "Lower bound timestamp (ISO8601 or epoch ms)" }
|
||||
required: []
|
||||
outputs_schema: { properties: {} }
|
||||
- id: list_users
|
||||
name: cortex-xdr-list-users
|
||||
description: "List Cortex XDR users."
|
||||
risk: read
|
||||
inputs_schema:
|
||||
properties: {}
|
||||
required: []
|
||||
outputs_schema: { properties: {} }
|
||||
- id: get_risk_score
|
||||
name: cortex-xdr-get-risk-score
|
||||
description: "Get the risk score of a user or host by ID."
|
||||
risk: read
|
||||
inputs_schema:
|
||||
properties:
|
||||
id: { type: string, description: "User or host identifier" }
|
||||
required: [id]
|
||||
outputs_schema: { properties: {} }
|
||||
- id: list_risky_users
|
||||
name: cortex-xdr-list-risky-users
|
||||
description: "List risky users."
|
||||
risk: read
|
||||
inputs_schema:
|
||||
properties: {}
|
||||
required: []
|
||||
outputs_schema: { properties: {} }
|
||||
- id: list_risky_hosts
|
||||
name: cortex-xdr-list-risky-hosts
|
||||
description: "List risky hosts."
|
||||
risk: read
|
||||
inputs_schema:
|
||||
properties: {}
|
||||
required: []
|
||||
outputs_schema: { properties: {} }
|
||||
- id: list_user_groups
|
||||
name: cortex-xdr-list-user-groups
|
||||
description: "Get user groups by name."
|
||||
risk: read
|
||||
inputs_schema:
|
||||
properties:
|
||||
group_names: { type: string, description: "Comma-separated group names" }
|
||||
required: []
|
||||
outputs_schema: { properties: {} }
|
||||
- id: list_roles
|
||||
name: cortex-xdr-list-roles
|
||||
description: "Get roles by name."
|
||||
risk: read
|
||||
inputs_schema:
|
||||
properties:
|
||||
role_names: { type: string, description: "Comma-separated role names" }
|
||||
required: []
|
||||
outputs_schema: { properties: {} }
|
||||
- id: set_user_role
|
||||
name: cortex-xdr-set-user-role
|
||||
description: "Assign a role to users."
|
||||
inputs_schema:
|
||||
properties:
|
||||
user_emails: { type: string, description: "Comma-separated user emails" }
|
||||
role_name: { type: string, description: "Role name to assign" }
|
||||
required: [user_emails, role_name]
|
||||
outputs_schema: { properties: {} }
|
||||
- id: remove_user_role
|
||||
name: cortex-xdr-remove-user-role
|
||||
description: "Remove the role assignment from users."
|
||||
inputs_schema:
|
||||
properties:
|
||||
user_emails: { type: string, description: "Comma-separated user emails" }
|
||||
required: [user_emails]
|
||||
outputs_schema: { properties: {} }
|
||||
- id: audit_management_logs
|
||||
name: cortex-xdr-audit-management-logs
|
||||
description: "Retrieve management audit logs."
|
||||
risk: read
|
||||
inputs_schema:
|
||||
properties:
|
||||
email: { type: string, description: "Comma-separated emails" }
|
||||
type: { type: string, description: "Comma-separated log types" }
|
||||
timestamp_gte: { type: string, description: "Lower bound timestamp (ISO8601 or epoch ms)" }
|
||||
limit: { type: number, description: "Max records (default 100)" }
|
||||
required: []
|
||||
outputs_schema: { properties: {} }
|
||||
- id: get_audit_agent_reports
|
||||
name: cortex-xdr-get-audit-agent-reports
|
||||
description: "Retrieve agent audit reports."
|
||||
risk: read
|
||||
inputs_schema:
|
||||
properties:
|
||||
endpoint_ids: { type: string, description: "Comma-separated endpoint IDs" }
|
||||
type: { type: string, description: "Comma-separated report types" }
|
||||
timestamp_gte: { type: string, description: "Lower bound timestamp (ISO8601 or epoch ms)" }
|
||||
limit: { type: number, description: "Max records (default 100)" }
|
||||
required: []
|
||||
outputs_schema: { properties: {} }
|
||||
- id: get_distribution_url
|
||||
name: cortex-xdr-get-distribution-url
|
||||
description: "Get the download URL of an agent installer distribution."
|
||||
risk: read
|
||||
inputs_schema:
|
||||
properties:
|
||||
distribution_id: { type: string, description: "Distribution ID" }
|
||||
package_type: { type: string, description: "Package type (sh, rpm, deb, pkg, x86, x64, ...)" }
|
||||
required: [distribution_id, package_type]
|
||||
outputs_schema: { properties: {} }
|
||||
- id: get_distribution_status
|
||||
name: cortex-xdr-get-distribution-status
|
||||
description: "Get the build status of an agent installer distribution."
|
||||
risk: read
|
||||
inputs_schema:
|
||||
properties:
|
||||
distribution_id: { type: string, description: "Distribution ID" }
|
||||
required: [distribution_id]
|
||||
outputs_schema: { properties: {} }
|
||||
- id: create_distribution
|
||||
name: cortex-xdr-create-distribution
|
||||
description: "Create an agent installer distribution."
|
||||
inputs_schema:
|
||||
properties:
|
||||
name: { type: string, description: "Distribution name" }
|
||||
platform: { type: string, description: "Platform (windows, linux, macos, android)" }
|
||||
package_type: { type: string, description: "standalone or upgrade (default standalone)" }
|
||||
agent_version: { type: string, description: "Agent version" }
|
||||
description: { type: string, description: "Optional description" }
|
||||
required: [name, platform]
|
||||
outputs_schema: { properties: {} }
|
||||
|
||||
- id: test_connection
|
||||
name: cortex-xdr-test-connection
|
||||
description: "Verify connectivity and credentials (used by the Test button)."
|
||||
|
||||
Reference in New Issue
Block a user