Netskope
Visualize Netskope devices, users, and app instances, map Netskope users to employee entities, and monitor changes through queries and alerts.
- Installation
- Authorization
- Data Model
- Types
- Release Notes
Prerequisites
The Netskope integration authenticates with two separate tokens:
- API V1 Token (required) — grants access to devices, users, and app instances.
- API V2 Token (optional) — unlocks additional data types including NPA private apps, publishers, NPA policies, URL lists, discovered/shadow-AI apps, DLP incidents, and SCIM users.
Generate an API V1 Token
- Log in to the Netskope admin console.
- Navigate to Settings > Tools > REST API v1.
- Click New Token, give it a name, and click Generate.
- Copy the token value — you will not be able to view it again.
Generate an API V2 Token (optional)
The V2 token uses RBAC V3 service-account credentials. Grant it read access to the API domains you want to ingest.
- Navigate to Settings > Administration > Administrators.
- Select the Service Accounts tab.
- Click New Service Account, enter a name, and select Read access for each API domain you want to enable (for example: Steering, Infrastructure, Policy, Events, SCIM).
- Click Save, then copy the generated token.
For more information see the Netskope REST API v1 overview and REST API v2 token management.
Configuration in JupiterOne
To install the Netskope integration in JupiterOne, navigate to the Integrations tab and select Netskope. Click New Instance to begin configuring your integration.
- Enter an Account Name to identify this Netskope integration instance in JupiterOne. Ingested entities will have this value stored in
tag.AccountNamewhen the toggle is enabled. - (Optional) Enter a Description to help identify the instance.
- Set a Polling Interval for automatic data refresh, or leave it as
DISABLEDto run manually. - Enter your Tenant Name — the subdomain portion of your Netskope tenant URL (
examplefromexample.goskope.com). - Enter your API V1 Token.
- (Optional) Enter your API V2 Token to enable additional data ingestion (NPA private apps, publishers, NPA policies, URL lists, discovered apps, and DLP incidents).
Click Create to save the instance.
Data Volume Configuration
Control how much data is ingested from Netskope to manage storage and processing.
Ingestion Windows
| Field | Description | Default | Options |
|---|---|---|---|
| Event Lookback (days) | Rolling lookback window for event-derived steps (DLP incidents and discovered/shadow-AI apps). Longer windows increase the number of events ingested. | 7 days | 7 days, 30 days, 90 days |
Next steps
Now that your integration instance has been configured, it will begin running on the polling interval you provided, populating data within JupiterOne. Continue on to our Instance management guide to learn more about working with and editing integration instances.
Endpoints
API endpoints that the integration makes requests to.
Show Endpoints (14)
https://{tenantName}.goskope.com/api/v1/app_instanceshttps://{tenantName}.goskope.com/api/v1/clientshttps://{tenantName}.goskope.com/api/v1/userconfighttps://{tenantName}.goskope.com/api/v2/events/datasearch/applicationhttps://{tenantName}.goskope.com/api/v2/events/datasearch/incidenthttps://{tenantName}.goskope.com/api/v2/infrastructure/publishershttps://{tenantName}.goskope.com/api/v2/infrastructure/publisherupgradeprofileshttps://{tenantName}.goskope.com/api/v2/platform/administration/scim/Usershttps://{tenantName}.goskope.com/api/v2/policy/npa/policygroupshttps://{tenantName}.goskope.com/api/v2/policy/npa/ruleshttps://{tenantName}.goskope.com/api/v2/policy/urllisthttps://{tenantName}.goskope.com/api/v2/rbac/roleshttps://{tenantName}.goskope.com/api/v2/scim/Usershttps://{tenantName}.goskope.com/api/v2/steering/apps/private
Documentation Links
Links to provider documentation relevant to setup and configuration.
Show Documentation Links (5)
- https://docs.netskope.com/en/administrators-rbac-v3/
- https://docs.netskope.com/en/netskope-help/rest-api-v1-overview/
- https://docs.netskope.com/en/netskope-help/rest-api-v2-overview-312207/
- https://docs.netskope.com/en/netskope-help/rest-api-v2-overview-312207/rest-api-v2-token-management-312226/
- https://docs.netskope.com/en/netskope-rbac-v3-overview/
Per-Step Breakdown
Detailed authorization requirements for each ingestion step.
Show all steps (15)
| Step | Endpoints |
|---|---|
| Fetch Admin Roles | https://{tenantName}.goskope.com/api/v2/rbac/roles |
| Fetch Admins | https://{tenantName}.goskope.com/api/v2/platform/administration/scim/Users |
| Fetch and Build User Configuration | https://{tenantName}.goskope.com/api/v1/userconfig |
| Fetch App Instances | https://{tenantName}.goskope.com/api/v1/app_instances |
| Fetch Devices | https://{tenantName}.goskope.com/api/v1/clients |
| Fetch Discovered Apps | https://{tenantName}.goskope.com/api/v2/events/datasearch/application |
| Fetch DLP Incidents | https://{tenantName}.goskope.com/api/v2/events/datasearch/incident |
| Fetch NPA Policies | https://{tenantName}.goskope.com/api/v2/policy/npa/rules |
| Fetch NPA Policy Groups | https://{tenantName}.goskope.com/api/v2/policy/npa/policygroups |
| Fetch OAuth Apps (SSPM) | - |
| Fetch Private Apps | https://{tenantName}.goskope.com/api/v2/steering/apps/private |
| Fetch Publisher Upgrade Profiles | https://{tenantName}.goskope.com/api/v2/infrastructure/publisherupgradeprofiles |
| Fetch Publishers | https://{tenantName}.goskope.com/api/v2/infrastructure/publishers |
| Fetch URL Lists | https://{tenantName}.goskope.com/api/v2/policy/urllist |
| Fetch Users and Build Device Relationships | https://{tenantName}.goskope.com/api/v2/scim/Users |
Entities
The following entities are created:
| Resources | Entity _type | Entity _class |
|---|---|---|
| Admin | netskope_admin | User |
| Admin Role | netskope_admin_role | AccessRole |
| App Instance | netskope_app_instance | Application |
| Device | netskope_device | Device |
| Discovered App | netskope_discovered_app | Application |
| DLP Incident | netskope_dlp_incident | Incident |
| NPA Policy | netskope_npa_policy | AccessPolicy |
| NPA Policy Group | netskope_npa_policy_group | Group |
| OAuth App | netskope_oauth_app | Application, NHI |
| Private App | netskope_private_app | Application |
| Publisher | netskope_publisher | Gateway |
| Publisher Upgrade Profile | netskope_publisher_upgrade_profile | Configuration |
| Service Account | netskope_service_account | User, NHI |
| Tenant | netskope_tenant | Account, Organization |
| URL List | netskope_url_list | Configuration |
| User | netskope_user | User |
| User Configuration | netskope_user_configuration | Configuration |
Relationships
The following relationships are created:
Source Entity _type | Relationship _class | Target Entity _type |
|---|---|---|
netskope_admin | ASSIGNED | netskope_admin_role |
netskope_device | HAS | netskope_user |
netskope_device | HAS | netskope_dlp_incident |
netskope_npa_policy | PROTECTS | netskope_private_app |
netskope_publisher | CONNECTS | netskope_private_app |
netskope_publisher | USES | netskope_publisher_upgrade_profile |
netskope_service_account | ASSIGNED | netskope_admin_role |
netskope_tenant | HAS | netskope_device |
netskope_tenant | HAS | netskope_app_instance |
netskope_tenant | HAS | netskope_private_app |
netskope_tenant | HAS | netskope_publisher |
netskope_tenant | HAS | netskope_npa_policy |
netskope_tenant | HAS | netskope_npa_policy_group |
netskope_tenant | HAS | netskope_url_list |
netskope_tenant | HAS | netskope_discovered_app |
netskope_tenant | HAS | netskope_oauth_app |
netskope_tenant | HAS | netskope_admin_role |
netskope_tenant | HAS | netskope_admin |
netskope_tenant | HAS | netskope_service_account |
netskope_user | HAS | netskope_user_configuration |
netskope_user | HAS | netskope_dlp_incident |
Netskope Admin
netskope_admin inherits from User
| Property | Type | Description | Specifications |
|---|---|---|---|
authType | string | Authentication method configured for the administrator (e.g. API_KEY). | |
isLocked | boolean | Whether the administrator account is locked out. | |
isPasswordResetPending | boolean | Whether a password reset is outstanding for the account. | |
isVerified | boolean | Whether the administrator has accepted their invitation and verified the account. | |
lastLoginOn | number | Epoch (ms) of the last console login. | |
provisionedBy | string | How the administrator was created in Netskope: LOCAL, SAML or SCIM. |
Netskope Admin Role
netskope_admin_role inherits from AccessRole
| Property | Type | Description | Specifications |
|---|---|---|---|
isObfuscated | boolean | Whether the role obfuscates sensitive data (e.g. user identifiers) from its holders. | |
isScoped | boolean | Whether the role restricts its holders to a subset of objects (Label Based Access Control). | |
userCount | number | Number of administrators currently holding the role. |
Netskope App Instance
netskope_app_instance inherits from Application
| Property | Type | Description | Specifications |
|---|---|---|---|
app | string | Name of the application this is an instance of. | |
appId | string | Netskope application identifier. | |
instanceTags | array of strings | Tags applied to the instance (e.g. Sanctioned, Untagged). | |
lastModifiedOn | number | Epoch (ms) when the instance was last modified. | |
type | string | Instance type (e.g. Custom, Sanctioned). |
Netskope Device
netskope_device inherits from Device
| Property | Type | Description | Specifications |
|---|---|---|---|
asn | string | Autonomous system number of the device connection. | |
asName | string | Autonomous system name of the device connection. | |
city | string | City geolocated from the connection. | |
clientConfig | string | Name of the client configuration applied to the device. | |
clientInstallTime | number | Epoch (seconds) when the Netskope client was installed. | |
clientVersion | string | Version of the installed Netskope client. | |
continent | string | Continent geolocated from the connection. | |
country | string | Country code geolocated from the connection. | |
deviceClassificationStatus | string | Netskope device classification status (e.g. Managed, Unmanaged). | |
isp | string | Internet service provider of the device connection. | |
lastConnectedFromPrivateIp | string | Private IP the device last connected from. | |
lastConnectedFromPublicIp | string | Public IP the device last connected from. | |
lastEvent | string | The device's most recent client event name. | |
lastEventActor | string | Actor that triggered the most recent client event. | |
lastEventNpaStatus | string | Netskope Private Access status reported with the most recent event. | |
lastEventOccurredOn | number | Epoch (ms) when the most recent client event occurred. | |
lastEventStatus | string | Status reported with the most recent client event. | |
latitude | number | Latitude geolocated from the connection. | |
longitude | number | Longitude geolocated from the connection. | |
managementId | string | Device management identifier reported by the client. | |
netskopePop | string | Netskope point of presence the device connected through. | |
organizationUnit | string | Organization unit of the device user. | |
os | string | Raw operating system value as reported by Netskope. | |
region | string | Region/state geolocated from the connection. | |
steeringConfig | string | Name of the steering configuration applied to the device. | |
userGroups | array of strings | Groups of the users associated with the device. | |
username | string | Primary username associated with the device. |
Netskope Discovered App
netskope_discovered_app inherits from Application
| Property | Type | Description | Specifications |
|---|---|---|---|
appCategory | string | Netskope application category (e.g. Generative AI, Collaboration). | |
cci | number | Cloud Confidence Index score (0-100). | |
ccl | string | Cloud Confidence Level (poor, low, medium, high, excellent). | |
isGenAI | boolean | Whether the app is categorised as Generative AI by Netskope. | |
usesAI | boolean | Whether the app is an AI/GenAI application. |
Netskope Dlp Incident
netskope_dlp_incident inherits from Incident
| Property | Type | Description | Specifications |
|---|---|---|---|
accessMethod | string | Access method used (e.g. Client, Clientless, CASB API). | |
activity | string | Activity that triggered the incident (e.g. Upload). | |
app | string | Application the incident occurred in. | |
appCategory | string | Category of the application the incident occurred in (e.g. Generative AI). | |
assignee | string | Assignee of the incident. | |
dlpPolicies | array of strings | DLP policy names that matched. | |
dlpProfiles | array of strings | DLP profile names that matched. | |
dlpRules | array of strings | DLP rule names that matched. | |
fileSize | number | Size of the object in bytes. | |
fileType | string | MIME/file type of the object involved. | |
incidentId | string | Netskope DLP incident identifier. | |
md5 | string | MD5 hash of the object. | |
objectName | string | Name of the file/object involved in the incident. | |
objectType | string | Type of the object involved (e.g. File). | |
occurredOn | number | Epoch (ms) when the incident occurred. | |
sha256 | string | SHA-256 hash of the object. | |
status | string | Incident status (e.g. new, in-progress, closed). | |
url | string | URL associated with the incident. |
Netskope Npa Policy
netskope_npa_policy inherits from AccessPolicy
| Property | Type | Description | Specifications |
|---|---|---|---|
accessMethod | array of strings | Access methods the rule applies to (Client, Clientless). | |
action | string | Action taken when the rule matches (e.g. allow, block). | |
isEnabled | boolean | Whether the policy rule is enabled. | |
policyType | string | Policy type (e.g. private-app). | |
privateApps | array of strings | Names of the private apps referenced by the rule (a PROTECTS relationship is created for each ingested app). | |
users | array of strings | User or group identifiers the rule targets. | |
userType | string | Subject type the rule targets (e.g. user, group). |
Netskope Npa Policy Group
netskope_npa_policy_group inherits from Group
| Property | Type | Description | Specifications |
|---|---|---|---|
createdBy | string | Identifier of the admin that created the group. | |
groupType | string | Group type identifier reported by Netskope. | |
isEditableDeletable | boolean | Whether the group can be edited or deleted (false for system-managed groups). |