Skip to content

Commit d1ecb5b

Browse files
committed
Merge branch 'docs-1210-knowledge-agent-beta' of github.com:SumoLogic/sumologic-documentation into docs-1210-knowledge-agent-beta
2 parents a520b23 + 4dcceac commit d1ecb5b

File tree

5 files changed

+36
-15
lines changed

5 files changed

+36
-15
lines changed

docs/platform-services/automation-service/app-central/integrations/netskope-v2.md

Lines changed: 35 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -22,19 +22,39 @@ Netskope provides unrivaled visibility and real-time data and threat protection
2222
* **Netskope Get Alert List Daemon** *(Daemon)* - Daemon to extract alerts generated by Netskope.
2323
* **Netskope Get Event List Daemon** *(Daemon)* - Daemon to events alerts generated by Netskope.
2424

25-
## Neskope V2 configuration
26-
27-
[Netskope REST APIs](https://docs.netskope.com/en/rest-api-v2-overview-312207/) use an auth token to make authorized calls to the API. Netskope REST APIs provide access to resources via URI paths. The token must be used in every REST API call for the tenant. The token can be created for use with specified APIs in the Netskope UI by going to **Settings > Tools > Rest API v2**.
28-
29-
1. On the REST API v2 page, click **New Token**.
30-
1. Enter a token name, the token expiration time, and then click **Add Endpoint** to select the API endpoints to use with the token.
31-
1. Specify the privileges for each of the endpoints added. Read privileges include GET, and Read+Write privileges include GET, PUT, POST, PATCH, and DELETE. Endpoint privileges vary. Some endpoints, like alert and audit (and others) only have the Read privilege; whereas, the URL list/file endpoint only has Read+Write privileges. For this Integration following endpoints are required:<br/><img src={useBaseUrl('/img/platform-services/automation-service/app-central/integrations/netskope-v2/netskope-v2-2.png')} style={{border:'1px solid gray'}} alt="netskope-v2" width="600"/>
32-
1. When finished, click **Save**.
33-
1. A confirmation box opens showing whether the token creation was a success. If so, click **Copy Token** to save it for later use in your API requests.
34-
35-
**Important** - The only opportunity to copy the token is immediately after you create it. The token is required in your API requests.<br/><img src={useBaseUrl('/img/platform-services/automation-service/app-central/integrations/netskope-v2/netskope-v2-3.png')} style={{border:'1px solid gray'}} alt="netskope-v2" width="400"/>
36-
37-
When finished, click **OK**. After being created, tokens can be managed by clicking the adjacent **...** icon for the token and selecting one of these options: <br/><img src={useBaseUrl('/img/platform-services/automation-service/app-central/integrations/netskope-v2/netskope-v2-4.png')} style={{border:'1px solid gray'}} alt="netskope-v2" width="200"/>
25+
## Neskope RBACv3 token configuration
26+
27+
[Netskope RBACv3 configuration](https://docs.netskope.com/en/netskope-rbac-v3-overview) use an auth token to make authorized calls to the API. Netskope REST APIs provide access to resources via URI paths. The token must be used in every REST API call for the tenant. The token can be created for use with specified APIs in the Netskope UI by going to **Settings &gt; Administration &gt; Administrators & Roles**.
28+
29+
### Netskope role and service account setup
30+
31+
Follow the steps below to create a role with the required function scope and obtain a service account token for use in the Netskope Data Connector tile.
32+
33+
1. Create role with required function scope:
34+
1. In the Netskope console, go to **Settings > Administration > Administrators & Roles**.
35+
1. Navigate to the **Roles** tab.
36+
1. Click **Create Role** (or edit an existing one).
37+
1. Under **Function scope**, add the following:
38+
- Infrastructure
39+
- Infrastructure Log(View)
40+
- Skope IT
41+
- Alerts(View)
42+
- Application Events(View)
43+
- Network Events(View)
44+
- Page Events(View)
45+
- Administration
46+
- Audit Log(View)
47+
- Objects
48+
- URL List(Manage)<br/><img src={useBaseUrl('/img/platform-services/automation-service/app-central/integrations/netskope-v2/Netskope_Role_Configuration.png')} style={{border:'1px solid gray'}} alt="netskope-v2" width="700"/>
49+
1. Click **Save**.
50+
1. Create or access a service account:
51+
1. In the same section, click on the **Administrators** tab.
52+
1. Select **Service Account**.
53+
1. Select the **Role** created in the last step.<br/><img src={useBaseUrl('/img/platform-services/automation-service/app-central/integrations/netskope-v2/Netskope_ServiceAccount_Creation.png')} style={{border:'1px solid gray'}} alt="netskope-v2" width="600"/>
54+
1. Copy the generate service account token.<br/><img src={useBaseUrl('/img/platform-services/automation-service/app-central/integrations/netskope-v2/Netskope_API_Token.png')} style={{border:'1px solid gray'}} alt="netskope-v2" width="400"/>
55+
:::warning Important
56+
Keep this token secure.
57+
:::
3858

3959
## Configure Netskope V2 in Automation Service and Cloud SOAR
4060

@@ -49,7 +69,7 @@ import IntegrationTimeout from '../../../../reuse/automation-service/integration
4969
* <IntegrationLabel/>
5070
* **Server URL**. Enter the URL for API V2 REST API in the format `https://<tenant-name>.goskope.com`
5171

52-
* **Tenant API Token**. Enter the [API token](https://docs.netskope.com/en/api-tokens-2/) you [copied earlier](#neskope-v2-configuration).
72+
* **Tenant API Token**. Enter the [API token](https://docs.netskope.com/en/api-tokens-2/) you [copied earlier](#netskope-role-and-service-account-setup).
5373

5474
* **Event Type**. Select the [event type](https://docs.netskope.com/en/skope-it-query-language/#event-types) (additionally, if you need to, you can populate the query daemons):
5575
* **Application**
@@ -62,7 +82,7 @@ import IntegrationTimeout from '../../../../reuse/automation-service/integration
6282

6383
<img src={useBaseUrl('/img/platform-services/automation-service/app-central/integrations/netskope-v2/netskope-v2-11.png')} style={{border:'1px solid gray'}} alt="netskope-v2" width="400"/>
6484

65-
For information about Netskope V2, see [Netskope V2 documentation](https://docs.netskope.com/en/rest-api-v2-overview-312207/).
85+
For information about Netskope RBACv3, see [Netskope RBACv3 configuration](https://docs.netskope.com/en/netskope-rbac-v3-overview).
6686

6787
## Change Log
6888

src/pages/index.tsx

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -38,6 +38,7 @@ export const Home = () => {
3838
</Typography>
3939
{/* Header */}
4040
<Typography
41+
component="div"
4142
bgcolor='#0045BE'
4243
color='#e3e3e3'
4344
fontFamily='Lab Grotesque'
44.3 KB
Loading
325 KB
Loading
102 KB
Loading

0 commit comments

Comments
 (0)