Netskope (API v2)

Details

ID	`Netskope (API v2)`
Provider	Netskope
Category	Network Security
From Version	6.0.0
Docker Image	`demisto/python3:3.12.8.3296088`
Supported Modules	Agentix XSIAM

README

Block URLs, domains and file hashes.
This integration was integrated and tested with version 91.0.6.575 of Netskope (API v2) for contribution to marketplace

Configure Netskope (API v2) for contribution to marketplace in Cortex

Parameter	Required
URL of Netskope Tenant (e.g. https://tenant.goskope.com)	True
API Key	False
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.

netskopev2-add-url

Add URLs to the Netskope URL block list

Base Command

netskopev2-add-url

Input

Argument Name	Description	Required
list_name	Name of the URL list.	Required
url	URLs to add to the list.	Required

Context Output

Path	Type	Description
Netskope.URLList.id	number	URL List ID
Netskope.URLList.name	string	URL List name
Netskope.URLList.data	unknown	URL List contents
Netskope.URLList.data.urls	unknown	List of URLs in URL List
Netskope.URLList.data.type	string	URL List type (‘exact’ or ‘regex’)
Netskope.URLList.modify_by	string	User which last modified URL List
Netskope.URLList.modify_time	date	Time which URL List was last modified
Netskope.URLList.modify_type	string	URL List modification type (‘Created’, ‘Edited’ or ‘Deleted’)
Netskope.URLList.pending	number	URL List pending status (‘1’ if pending, ‘0’ if not)

Command Example


#### Human Readable Output

### netskopev2-remove-url

***
Remove URLs from the Netskope URL block list

#### Base Command

`netskopev2-remove-url`

#### Input

| **Argument Name** | **Description** | **Required** |
| --- | --- | --- |
| list_name | Name of the URL list. | Required |
| url | URLs to remove from the list. | Required |

#### Context Output

| **Path** | **Type** | **Description** |
| --- | --- | --- |
| Netskope.URLList.id | number | URL List ID |
| Netskope.URLList.name | string | URL List name |
| Netskope.URLList.data | unknown | URL List contents |
| Netskope.URLList.data.urls | unknown | List of URLs in URL List |
| Netskope.URLList.data.type | string | URL List type ('exact' or 'regex') |
| Netskope.URLList.modify_by | string | User which last modified URL List |
| Netskope.URLList.modify_time | date | Time which URL List was last modified |
| Netskope.URLList.modify_type | string | URL List modification type ('Created', 'Edited' or 'Deleted') |
| Netskope.URLList.pending | number | URL List pending status ('1' if pending, '0' if not) |

#### Command Example

Human Readable Output

netskopev2-get-lists

Get all applied and pending URL lists

Base Command

netskopev2-get-lists

Input

| Argument Name | Description | Required |
| — | — | — |

Context Output

Path	Type	Description
Netskope.List.id	number	URL List ID
Netskope.List.name	string	URL List name
Netskope.List.data	unknown	URL List contents
Netskope.List.data.urls	unknown	List of URLs in URL List
Netskope.List.data.type	string	URL List type (‘exact’ or ‘regex’)
Netskope.List.modify_by	string	User which last modified URL List
Netskope.List.modify_time	date	Time which URL List was last modified
Netskope.List.modify_type	string	URL List modification type (‘Created’, ‘Edited’ or ‘Deleted’)
Netskope.List.pending	number	URL List pending status (‘1’ if pending, ‘0’ if not)

Command Example


#### Human Readable Output

### netskopev2-get-list

***
Get URL list by ID

#### Base Command

`netskopev2-get-list`

#### Input

| **Argument Name** | **Description** | **Required** |
| --- | --- | --- |
| list_name | Name of the URL list. | Required |

#### Context Output

| **Path** | **Type** | **Description** |
| --- | --- | --- |
| Netskope.List.id | number | URL List ID |
| Netskope.List.name | string | URL List name |
| Netskope.List.data | unknown | URL List contents |
| Netskope.List.data.urls | unknown | List of URLs in URL List |
| Netskope.List.data.type | string | URL List type ('exact' or 'regex') |
| Netskope.List.modify_by | string | User which last modified URL List |
| Netskope.List.modify_time | date | Time which URL List was last modified |
| Netskope.List.modify_type | string | URL List modification type ('Created', 'Edited' or 'Deleted') |
| Netskope.List.pending | number | URL List pending status ('1' if pending, '0' if not) |

#### Command Example

Human Readable Output

Configuration parameters

url — URL of Netskope Tenant (e.g. https://tenant.goskope.com) (required)
api_key — API Key
api_key_credentials —
insecure — Trust any certificate (not secure)
proxy — Use system proxy settings

Commands (4)

netskopev2-add-url
Add URLs to the Netskope URL block list.
netskopev2-get-list
Get URL list by ID.
netskopev2-get-lists
Get all applied and pending URL lists.
netskopev2-remove-url
Remove URLs from the Netskope URL block list.

Source

NetskopeV2.py NetskopeV2.yml NetskopeV2_description.md

Download History Raw

category: Network Security
provider: Netskope
commonfields:
  id: Netskope (API v2)
  version: -1
configuration:
- display: URL of Netskope Tenant (e.g. https://tenant.goskope.com)
  name: url
  required: true
  type: 0
- display: API Key
  name: api_key
  required: false
  type: 4
  hidden: true
- name: api_key_credentials
  type: 9
  required: false
  displaypassword: API Key
  hiddenusername: true
- display: Trust any certificate (not secure)
  name: insecure
  type: 8
  required: false
- display: Use system proxy settings
  name: proxy
  required: false
  type: 8
description: Block URLs, domains and file hashes.
display: Netskope (API v2)
name: Netskope (API v2)
script:
  commands:
  - arguments:
    - description: Name of the URL list.
      name: list_name
      required: true
    - description: URLs to add to the list.
      isArray: true
      name: url
      required: true
    description: Add URLs to the Netskope URL block list.
    name: netskopev2-add-url
    outputs:
    - contextPath: Netskope.URLList.id
      description: URL List ID.
      type: number
    - contextPath: Netskope.URLList.name
      description: URL List name.
      type: string
    - contextPath: Netskope.URLList.data
      description: URL List contents.
    - contextPath: Netskope.URLList.data.urls
      description: List of URLs in URL List.
    - contextPath: Netskope.URLList.data.type
      description: URL List type ('exact' or 'regex').
      type: string
    - contextPath: Netskope.URLList.modify_by
      description: User which last modified URL List.
      type: string
    - contextPath: Netskope.URLList.modify_time
      description: Time which URL List was last modified.
      type: date
    - contextPath: Netskope.URLList.modify_type
      description: URL List modification type ('Created', 'Edited' or 'Deleted').
      type: string
    - contextPath: Netskope.URLList.pending
      description: URL List pending status ('1' if pending, '0' if not).
      type: number
  - arguments:
    - description: Name of the URL list.
      name: list_name
      required: true
    - description: URLs to remove from the list.
      isArray: true
      name: url
      required: true
    description: Remove URLs from the Netskope URL block list.
    name: netskopev2-remove-url
    outputs:
    - contextPath: Netskope.URLList.id
      description: URL List ID.
      type: number
    - contextPath: Netskope.URLList.name
      description: URL List name.
      type: string
    - contextPath: Netskope.URLList.data
      description: URL List contents.
    - contextPath: Netskope.URLList.data.urls
      description: List of URLs in URL List.
    - contextPath: Netskope.URLList.data.type
      description: URL List type ('exact' or 'regex').
      type: string
    - contextPath: Netskope.URLList.modify_by
      description: User which last modified URL List.
      type: string
    - contextPath: Netskope.URLList.modify_time
      description: Time which URL List was last modified.
      type: date
    - contextPath: Netskope.URLList.modify_type
      description: URL List modification type ('Created', 'Edited' or 'Deleted').
      type: string
    - contextPath: Netskope.URLList.pending
      description: URL List pending status ('1' if pending, '0' if not).
      type: number
  - arguments: []
    description: Get all applied and pending URL lists.
    name: netskopev2-get-lists
    outputs:
    - contextPath: Netskope.List.id
      description: URL List ID.
      type: number
    - contextPath: Netskope.List.name
      description: URL List name.
      type: string
    - contextPath: Netskope.List.data
      description: URL List contents.
    - contextPath: Netskope.List.data.urls
      description: List of URLs in URL List.
    - contextPath: Netskope.List.data.type
      description: URL List type ('exact' or 'regex').
      type: string
    - contextPath: Netskope.List.modify_by
      description: User which last modified URL List.
      type: string
    - contextPath: Netskope.List.modify_time
      description: Time which URL List was last modified.
      type: date
    - contextPath: Netskope.List.modify_type
      description: URL List modification type ('Created', 'Edited' or 'Deleted').
      type: string
    - contextPath: Netskope.List.pending
      description: URL List pending status ('1' if pending, '0' if not).
      type: number
  - arguments:
    - description: Name of the URL list.
      name: list_name
      required: true
    description: Get URL list by ID.
    name: netskopev2-get-list
    outputs:
    - contextPath: Netskope.List.id
      description: URL List ID.
      type: number
    - contextPath: Netskope.List.name
      description: URL List name.
      type: string
    - contextPath: Netskope.List.data
      description: URL List contents.
    - contextPath: Netskope.List.data.urls
      description: List of URLs in URL List.
    - contextPath: Netskope.List.data.type
      description: URL List type ('exact' or 'regex').
      type: string
    - contextPath: Netskope.List.modify_by
      description: User which last modified URL List.
      type: string
    - contextPath: Netskope.List.modify_time
      description: Time which URL List was last modified.
      type: date
    - contextPath: Netskope.List.modify_type
      description: URL List modification type ('Created', 'Edited' or 'Deleted').
      type: string
    - contextPath: Netskope.List.pending
      description: URL List pending status ('1' if pending, '0' if not).
      type: number
  dockerimage: demisto/python3:3.12.8.3296088
  runonce: false
  script: ''
  subtype: python3
  type: python
fromversion: 6.0.0
tests:
- No tests (auto formatted)