Netskope V2
App Vendor: Netskope
App Category: IT Services
Connector Version: 1.1.0
API Version: v2
About App
Netskope V2 app offers cloud-native solutions to businesses for data protection and defense against threats in cloud applications, cloud infrastructure, and the web.
Netskope V2 app is configured with Orchestrate to perform the following actions.
Action Name | Description |
|---|---|
Create URL List | This action creates a new URL list. |
Fetch URL List Details | The action retrieves the details of a URL list. |
Fetch URL Lists | The action retrieves a list of URLs from the Netskope environment. |
Update URL List | The action updates a URL list. |
Add URL to List | This action adds a URL to a list. If the URL already exists in a list, then it returns success. |
Remove URL from List | This action removes a URL from a list. If the URL is not found in a list, then it returns success. |
Deploy | This action deploys pending URL list changes. |
Configuration Parameters
The following configuration parameters are required for the Netskope V2 app to communicate with the Netskope V2 enterprise application. The parameters can be configured by creating instances in the app.
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
Tenant Name | Enter the name of the tenant. Example: "alliance" | Text | Required | |
API Token | Enter the API token to authenticate with the Netskope application. Example: "aT1xxxx5rzs" | Password | Required |
Action: Create URL List
This action creates a URL list.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
Name | Enter the name of the URL list. Example: "sample_url_list" | Text | Required | |
URL List | Enter the list of URLs that you need to store in the list. Example: $LIST[sampleurl.com, example.org] | List | Required | |
Match Type | Enter the match type that you need to use to compare URLs. Example: "exact" | Text | Optional | Allowed values:
Default values: exact For more information on the match type and its allowed values, see Match Type. |
Example Request
[
{
"name": "sample_url_list",
"url_list": ["sampleurl.com", "example.org"],
"match_type": "exact"
}
]Action: Fetch URL List Details
The action retrieves a URL list.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
List ID | Enter the ID of a URL list to retrieve the details. Example: 18 | Integer | Required | You can retrieve List ID using the action Fetch URL Lists. |
Example Request
[
{
"list_id": 18
}
]Action: Fetch URL Lists
The action retrieves the URL lists present in the Netskope environment
Action Input Parameters
This action does not require any input parameter.
Action: Update URL List
The action updates the URL list.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
List ID | Enter the ID of a URL list that you need to update. Example: 18 | Integer | Required | You can retrieve List ID using the action Fetch URL Lists. |
URL List | Enter the list of URLs that you need to append to the existing URL list. Example: $LIST[sampleurl.com, example.org] | List | Required |
|
New Name | Enter the new name of the URL list. Example: "new_url_list" | Text | Optional |
|
Match Type | Enter the match type that you need to use to compare URLs. Example: "exact" | Text | Optional | Allowed values:
Default value: exact For more information on the match type and its allowed values, see Match Type. |
Replace Existing URLs | Choose to replace the existing URL list instead of appending new URLs to it. Example: false | Boolean | Optional | Default value: false Allowed values:
|
Example Request
[
{
"list_id": 18,
"url_list": ["test.com", "test.org"]
"new_name": "new_url_list",
"match_type": exact,
"replace_existing": false
}
]Action: Add URL to List
This action adds a URL to a list. If the URL already exists in a list, then it will not be added and the action returns success.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
List ID | Enter the list ID Example: 237 | Integer | Required | You can retrieve List ID using the action Fetch URL Lists. |
URL to Add | Enter the URL that you need to add to a list. Example: "http://sampleurl.com" | Text | Required |
Example Request
[
{
"list_id": 237,
"url_to_add": "http://sampleurl.com"
}
]Action: Remove URL from List
This action removes a URL from a list. If the URL is not found in a list, then it returns success.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
List ID | Enter the list ID. Example: 237 | Integer | Required | You can retrieve List ID using the action Fetch URL Lists. |
URL to Remove | Enter the URL that you need to remove from a list. Example: "http://sampleurl.com" | Text | Required |
Example Request
[
{
"list_id": 237,
"url_to_remove": "http://sampleurl.com"
}
]Action: Deploy
This action deploys pending URL list changes.
Action Input Parameters
This action does not require action input parameter.