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 (12)
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/policy/npa/policygroupshttps://{tenantName}.goskope.com/api/v2/policy/npa/ruleshttps://{tenantName}.goskope.com/api/v2/policy/urllisthttps://{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 (3)
Per-Step Breakdown
Detailed authorization requirements for each ingestion step.
Show all steps (13)
| Step | Endpoints |
|---|---|
| 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 |
|---|---|---|
| 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 |
| 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_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_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_user | HAS | netskope_user_configuration |
netskope_user | HAS | netskope_dlp_incident |
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). |
Netskope Oauth App
netskope_oauth_app inherits from Application, NHI
| Property | Type | Description | Specifications |
|---|---|---|---|
appDisplayName | string | Human-readable name of the OAuth application. | |
appId | string | Netskope identifier for the app. Mirrored on clientId to maximise the AIASM nhiAi enricher match surface. | |
clientId | string | OAuth client identifier of the application. | |
lastActivityOn | number | Epoch (ms) of the last observed activity. | |
scopes | array of strings | OAuth scopes granted to the application. | |
status | string | Status of the OAuth application. |
Netskope Private App
netskope_private_app inherits from Application
| Property | Type | Description | Specifications |
|---|---|---|---|
appTags | array of strings | Tag names applied to the private app. | |
host | string | Reachability target of the app (FQDN, wildcard, IP, or subnet). | |
isClientlessAccess | boolean | Whether clientless (browser) access is enabled. | |
isReachable | boolean | Whether Netskope last reported the app as reachable via a publisher. | |
ports | array of strings | Transport:port pairs exposed by the app (e.g. tcp:80). | |
privateAppProtocol | string | Application-layer protocol (e.g. http, https). | |
protocols | array of strings | Transport protocols exposed by the app (e.g. tcp, udp). | |
publicHost | string | Public proxy host assigned for clientless access. | |
steeringConfigs | array of strings | Steering configurations the app is included in. |
Netskope Publisher
netskope_publisher inherits from Gateway
| Property | Type | Description | Specifications |
|---|---|---|---|
appsCount | number | Number of private apps served by the publisher. | |
commonName | string | Common name presented by the publisher certificate. | |
connectedApps | array of strings | Names of the private apps the publisher serves. | |
ipAddress | string | IP address of the publisher host. | |
isLbrokerConnect | boolean | Whether the publisher connects via a local broker. | |
isRegistered | boolean | Whether the publisher has completed registration. | |
publisherStatus | string | Connection status (e.g. connected, disconnected, not registered). | |
version | string | Publisher software version. |
Netskope Publisher Upgrade Profile
netskope_publisher_upgrade_profile inherits from Configuration
| Property | Type | Description | Specifications |
|---|---|---|---|
dockerTag | string | Docker image tag the profile upgrades publishers to. | |
externalId | number | Stable external identifier of the profile (referenced by publishers). | |
frequency | string | Cron expression describing the upgrade schedule. | |
isEnabled | boolean | Whether the upgrade profile is enabled. | |
nextUpdateOn | number | Epoch (ms) of the next scheduled upgrade. | |
numAssociatedPublisher | number | Number of publishers associated with the profile. | |
releaseType | string | Release channel the profile upgrades to (e.g. Latest). | |
timezone | string | Timezone the upgrade schedule is evaluated in. |
Netskope Tenant
netskope_tenant inherits from Account, Organization
| Property | Type | Description | Specifications |
|---|---|---|---|
region | string | Region suffix of the tenant host (e.g. "eu" for a <tenant>.eu.goskope.com host). |
Netskope Url List
netskope_url_list inherits from Configuration
| Property | Type | Description | Specifications |
|---|---|---|---|
isPending | boolean | Whether the list has pending (not yet applied) modifications. | |
listType | string | How entries are matched (e.g. exact, regex). | |
urlCount | number | Number of entries in the list. | |
urls | array of strings | URL/host/IP entries in the list. |
Netskope User
netskope_user inherits from User
| Property | Type | Description | Specifications |
|---|---|---|---|
userAddedTime | number | Epoch (seconds) when the user was added in Netskope. | |
userSource | string | Source that provisioned the user (e.g. Manual, SCIM, IdP). |
Netskope User Configuration
netskope_user_configuration inherits from Configuration
| Property | Type | Description | Specifications |
|---|---|---|---|
addonCheckerHost | string | Addon checker host for the client. | |
addonCheckerResponseCode | string | Expected addon checker response code. | |
addonManagerHost | string | Addon manager host for the client. | |
email | string | Email address the configuration belongs to. | |
orgName | string | Netskope organization name. | |
SFCheckerHost | string | Steering-forward checker host. | |
SFCheckerIP | string | Steering-forward checker IP. |
Release Notes
- 2026-07-10 — Added API v2 support with new entity types including private applications, publishers, URL lists, network access policies and policy groups, discovered applications, and OAuth applications (disabled by default).
- 2026-04-08 — Improved OS name accuracy for Netskope client device entities, using human-readable names for Windows, macOS, Linux, iOS, Android, and ChromeOS devices.