Skip to main content

​
Ce aduce această integrare

Netskope poate furniza activitate normalizată web, cloud, de autentificare, de protecție a datelor și legată de amenințări. Exemplele analizate includ:
  • web.ai.visited — site web de inteligență artificială vizitat
  • data.bulk.uploaded — încărcare în masă de date
  • geo.impossible — deplasare imposibilă între autentificări
Conexiunea actuală utilizează REST API v2; pentru clienții existenți poate apărea o variantă REST legacy. Consultați cum devin datele din integrări Semnale.

​
De ce are nevoie Living Security

Acces necesar la endpointuri: Rol necesar: Tenant Admin sau un rol echivalent cu acces la Settings → Tools
Această integrare necesită un token API v2, nu un token v1. Tokenurile v1 utilizează autentificarea prin parametru de interogare și nu vor funcționa cu endpointul API v2.

​
Cerințe preliminare

  • Trebuie să aveți acces Tenant Admin în Netskope pentru a gestiona tokenurile REST API.

​
Partea A — În Netskope

Acești pași sunt efectuați de administratorul dumneavoastră Netskope.
1

Accesați gestionarea tokenurilor REST API v2

  1. Autentificați-vă în consola de administrare Netskope la https://<tenant>.goskope.com.
  2. În navigarea din stânga, faceți clic pe Settings.
  3. Sub Tools, selectați REST API v2.
2

Creați un token nou

  1. Faceți clic pe New Token.
  2. Introduceți un nume descriptiv (de ex., Living Security Platform).
  3. Sub accesul la endpointuri, activați accesul la:
Acordați acces la ambele endpointuri. Acestea alimentează două fluxuri separate — alerts și events — iar un token limitat la unul singur se conectează totuși cu succes. Fluxul aferent endpointului lipsă nu va returna apoi nimic, fără nicio eroare care să indice motivul.
Acestea două sunt singurele endpointuri de care are nevoie Living Security. Dacă nu acordați nimic în plus, respectați principiul privilegiului minim.
  1. Faceți clic pe Salvați (sau Generate Token).
3

Copiați și salvați tokenul

Copiați imediat tokenul și stocați-l în siguranță.
Netskope afișează valoarea tokenului o singură dată, la creare. Dacă părăsiți pagina fără să o copiați, trebuie să ștergeți tokenul și să creați unul nou.
4

Configurați lista de adrese IP permise (dacă este cazul)

Dacă tenantul dumneavoastră Netskope are activată lista de adrese IP permise, trebuie să adăugați intervalele de adrese IP de ieșire ale Living Security.
  1. În consola de administrare Netskope, accesați Settings → Administration → IP Allowlist.
  2. Dacă lista de adrese IP permise este activată, adăugați fiecare adresă IP de ieșire a Living Security în lista Custom IP.
Dacă lista de adrese IP permise este activată, dialogul de conectare va reuși, dar sincronizările de date vor eșua cu 401 Unauthorized până când sunt adăugate adresele IP corecte.
5

Identificați subdomeniul tenantului

Subdomeniul tenantului este prefixul URL-ului consolei de administrare Netskope.Dacă URL-ul consolei dumneavoastră este https://acme.goskope.com, subdomeniul este acme.Introduceți numai subdomeniul simplu — fără https://, fără .goskope.com, fără bară oblică la final.
Dialogul de conectare acceptă mai multe forme de introducere (subdomeniu simplu, nume complet de gazdă sau URL complet) și le normalizează automat. Totuși, se recomandă introducerea subdomeniului simplu.

​
Partea B — În Living Security Platform

Acest pas este efectuat de proprietarul programului sau de administratorul de sistem, dacă se utilizează configurarea delegată.
Acum sunteți conectat la Netskope (v2 API).

​
Depanare

Cauze frecvente:
  1. Token revocat sau expirat — generați un token nou
  2. Utilizarea unui token v1 — tokenurile v1 se autentifică prin parametru de interogare și nu funcționează cu endpointurile v2. Generați un token v2 nou din Settings → Tools → REST API v2
  3. Lista de adrese IP permise blochează solicitările — dacă tenantul dumneavoastră are activată lista de adrese IP permise, verificați că toate cele patru adrese IP de ieșire ale Living Security se află în lista de adrese permise
Tokenul a fost creat fără acces la /api/v2/events/data/alert sau /api/v2/events/data/page. Permisiunile tokenului pentru endpointuri nu pot fi modificate după creare — creați un token nou cu acces de citire la ambele și reconectați.
Tokenului îi lipsește unul dintre cele două endpointuri necesare. Un token limitat doar la /api/v2/events/data/alert sau doar la /api/v2/events/data/page se conectează totuși, iar fluxul aferent endpointului lipsă rămâne gol, fără nicio notificare.Permisiunile pentru endpointuri nu pot fi modificate după crearea tokenului — generați un token nou cu acces de citire la ambele, apoi reconectați.
Dacă lista de adrese IP permise este activată, este posibil ca adresele IP de ieșire ale Living Security să se fi schimbat. Consultați Configurarea adreselor IP de ieșire pentru integrări și actualizați lista Custom IP în consecință.
Tokenurile v1 și v2 folosesc mecanisme de autentificare diferite:
  • v1: parametru de interogare (token=...)
  • v2: antet (Netskope-Api-Token: ...)
Living Security utilizează autentificarea v2. Generați un token nou din Settings → Tools → REST API v2 (nu din pagina veche de tokenuri v1).