Guillaume BOURGEOIS
86e7f11227
Netskope REST API v2, 6 commands: list/get URL lists, replace URL list (block list), deploy URL lists, list users. API-token auth, stdlib-only. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
76 lines
2.5 KiB
YAML
76 lines
2.5 KiB
YAML
id: netskope
|
|
name: Netskope
|
|
version: 1.0.0
|
|
description: "Netskope (SASE/CASB REST API v2) — web/cloud containment: list and read URL lists, replace a URL list (block list) and deploy it, and list enrolled users/clients. API-token authentication; stdlib-only, no extra Python dependencies."
|
|
changelog: "1.0.0 — Initial release: list/get URL lists, replace URL list, deploy URL lists, list users."
|
|
category: network
|
|
|
|
# Per-instance configuration. The token is sent as the 'Netskope-Api-Token' header.
|
|
config_schema:
|
|
properties:
|
|
base_url:
|
|
type: string
|
|
description: "Netskope tenant URL (e.g. https://yourtenant.goskope.com)"
|
|
api_token:
|
|
type: string
|
|
description: "Netskope API v2 token"
|
|
x-soar-sensitive: true
|
|
required:
|
|
- base_url
|
|
- api_token
|
|
|
|
commands:
|
|
- id: list_url_lists
|
|
name: netskope-list-url-lists
|
|
description: "List URL lists."
|
|
risk: read
|
|
inputs_schema:
|
|
properties: {}
|
|
required: []
|
|
outputs_schema: { properties: {} }
|
|
- id: get_url_list
|
|
name: netskope-get-url-list
|
|
description: "Get a single URL list by ID."
|
|
risk: read
|
|
inputs_schema:
|
|
properties:
|
|
list_id: { type: string, description: "URL list ID" }
|
|
required: [list_id]
|
|
outputs_schema: { properties: {} }
|
|
- id: replace_url_list
|
|
name: netskope-replace-url-list
|
|
description: "Replace the URLs of a URL list (e.g. update a block list)."
|
|
inputs_schema:
|
|
properties:
|
|
list_id: { type: string, description: "URL list ID" }
|
|
name: { type: string, description: "URL list name" }
|
|
urls: { type: string, description: "Comma-separated URLs/domains that become the list" }
|
|
list_type: { type: string, description: "exact or regex (default exact)" }
|
|
required: [list_id, name, urls]
|
|
outputs_schema: { properties: {} }
|
|
- id: deploy_url_lists
|
|
name: netskope-deploy-url-lists
|
|
description: "Deploy pending URL-list changes so they take effect."
|
|
inputs_schema:
|
|
properties: {}
|
|
required: []
|
|
outputs_schema: { properties: {} }
|
|
- id: list_users
|
|
name: netskope-list-users
|
|
description: "List enrolled users (SCIM)."
|
|
risk: read
|
|
inputs_schema:
|
|
properties:
|
|
limit: { type: number, description: "Max users (default 50)" }
|
|
required: []
|
|
outputs_schema: { properties: {} }
|
|
|
|
- id: test_connection
|
|
name: netskope-test-connection
|
|
description: "Verify connectivity and the API token (used by the Test button)."
|
|
risk: read
|
|
inputs_schema:
|
|
properties: {}
|
|
required: []
|
|
outputs_schema: { properties: {} }
|