Skip to main content

​
Cosa apporta questa integrazione

Netskope può fornire attività normalizzate di web, cloud, autenticazione, protezione dei dati e minacce. Tra gli esempi verificati figurano:
  • web.ai.visited — sito web di intelligenza artificiale visitato
  • data.bulk.uploaded — caricamento massivo di dati
  • geo.impossible — viaggio impossibile tra un accesso e l’altro
La connessione attuale utilizza REST API v2; per i clienti esistenti può essere presente una variante REST legacy. Consultate come i dati delle integrazioni diventano Segnali.

​
Cosa richiede Living Security

Accesso agli endpoint richiesto: Ruolo richiesto: Tenant Admin o equivalente con accesso a Impostazioni → Tools
Questa integrazione richiede un token API v2, non un token v1. I token v1 utilizzano l’autenticazione tramite parametro di query e non funzionano con l’endpoint dell’API v2.

​
Prerequisiti

  • Per gestire i token REST API in Netskope è necessario disporre dell’accesso Tenant Admin.

​
Parte A — In Netskope

Questi passaggi vengono eseguiti dall’amministratore di Netskope.
1

Accedere alla gestione dei token REST API v2

  1. Accedete alla console di amministrazione di Netskope all’indirizzo https://<tenant>.goskope.com.
  2. Nella navigazione a sinistra, fate clic su Impostazioni.
  3. In Tools, selezionate REST API v2.
2

Creare un nuovo token

  1. Fate clic su New Token.
  2. Inserite un nome descrittivo (ad es. Living Security Platform).
  3. In corrispondenza dell’accesso agli endpoint, abilitate l’accesso a:
Concedete l’accesso a entrambi gli endpoint. Alimentano due flussi distinti — alerts e events — e un token limitato a uno solo dei due si connette comunque correttamente. Il flusso associato all’endpoint mancante non restituisce quindi alcun dato, senza alcun errore che ne indichi il motivo.
Questi due sono gli unici endpoint richiesti da Living Security. Non concedere nulla oltre a questi è conforme al principio del privilegio minimo.
  1. Fate clic su Salva (oppure Generate Token).
3

Copiare e salvare il token

Copiate subito il token e conservatelo in modo sicuro.
Netskope mostra il valore del token una sola volta, al momento della creazione. Se abbandonate la pagina senza averlo copiato, dovrete eliminare il token e crearne uno nuovo.
4

Configurare l'elenco di indirizzi IP consentiti (se applicabile)

Se nel vostro tenant Netskope è attivo l’elenco di indirizzi IP consentiti, è necessario aggiungere gli intervalli IP di uscita di Living Security.
  1. Nella console di amministrazione di Netskope, andate a Impostazioni → Amministrazione → IP Allowlist.
  2. Se l’elenco di indirizzi IP consentiti è attivo, aggiungete ciascun indirizzo IP di uscita di Living Security all’elenco Custom IP.
Se l’elenco di indirizzi IP consentiti è attivo, la finestra di connessione avrà esito positivo, ma le sincronizzazioni dei dati non riusciranno con l’errore 401 Unauthorized finché non verranno aggiunti gli indirizzi IP corretti.
5

Individuare il sottodominio del tenant

Il sottodominio del tenant è il prefisso dell’URL della console di amministrazione di Netskope.Se l’URL della console è https://acme.goskope.com, il sottodominio è acme.Inserite solo il sottodominio semplice — senza https://, senza .goskope.com, senza barra finale.
La finestra di connessione accetta diverse forme di input (sottodominio semplice, nome host completo o URL completo) e le normalizza automaticamente. Si consiglia tuttavia di inserire il solo sottodominio.

​
Parte B — In Living Security Platform

Questo passaggio viene eseguito dal responsabile del programma o, in caso di configurazione delegata, dall’amministratore di sistema.
La connessione a Netskope (v2 API) è ora attiva.

​
Risoluzione dei problemi

Cause comuni:
  1. Token revocato o scaduto — generate un nuovo token
  2. Utilizzo di un token v1 — i token v1 si autenticano tramite parametro di query e non funzionano con gli endpoint v2. Generate un nuovo token v2 da Impostazioni → Tools → REST API v2
  3. Richieste bloccate dall’elenco di indirizzi IP consentiti — se nel vostro tenant è attivo l’elenco di indirizzi IP consentiti, verificate che tutti e quattro gli indirizzi IP di uscita di Living Security siano presenti nell’elenco
Il token è stato creato senza accesso a /api/v2/events/data/alert o a /api/v2/events/data/page. Le autorizzazioni degli endpoint di un token non possono essere modificate dopo la creazione — create un nuovo token con accesso in lettura a entrambi e ripetete la connessione.
Al token manca uno dei due endpoint richiesti. Un token limitato al solo /api/v2/events/data/alert o al solo /api/v2/events/data/page si connette comunque, e il flusso associato all’endpoint mancante rimane vuoto senza alcuna segnalazione.Le autorizzazioni degli endpoint non possono essere modificate dopo la creazione del token — generate un nuovo token con accesso in lettura a entrambi, quindi ripetete la connessione.
Se l’elenco di indirizzi IP consentiti è attivo, gli indirizzi IP di uscita di Living Security potrebbero essere cambiati. Consultate Configurazione degli indirizzi IP di uscita delle integrazioni e aggiornate l’elenco Custom IP di conseguenza.
I token v1 e v2 utilizzano meccanismi di autenticazione diversi:
  • v1: parametro di query (token=...)
  • v2: intestazione (Netskope-Api-Token: ...)
Living Security utilizza l’autenticazione v2. Generate un nuovo token da Impostazioni → Tools → REST API v2 (non dalla pagina del token v1 legacy).