Skip to main content

Vad den här integrationen bidrar med

Netskope kan bidra med normaliserad aktivitet gällande webb, moln, autentisering, dataskydd och hot. Granskade exempel är bland annat:
  • web.ai.visited — besök på AI-webbplats
  • data.bulk.uploaded — massuppladdning av data
  • geo.impossible — omöjlig förflyttning mellan inloggningar
Den nuvarande anslutningen använder REST API v2. En äldre REST-variant kan förekomma för befintliga kunder. Se hur integrationsdata blir signaler.

Vad Living Security behöver

Nödvändig åtkomst till slutpunkter: Nödvändig roll: Tenant Admin eller motsvarande med åtkomst till Inställningar → Tools
Den här integrationen kräver en v2 API-token, inte en v1-token. V1-token använder autentisering via frågeparameter och fungerar inte med slutpunkten i v2 API.

Förutsättningar

  • Du måste ha Tenant Admin-behörighet i Netskope för att kunna hantera REST API-token.

Del A — I Netskope

Din Netskope-administratör utför dessa steg.
1

Gå till hanteringen av REST API v2-token

  1. Logga in i Netskopes administratörskonsol på https://<tenant>.goskope.com.
  2. Klicka på Inställningar i vänstermenyn.
  3. Välj REST API v2 under Tools.
2

Skapa en ny token

  1. Klicka på New Token.
  2. Ange ett beskrivande namn (t.ex. Living Security Platform).
  3. Aktivera åtkomst till följande under slutpunktsåtkomst:
Ge åtkomst till båda slutpunkterna. De matar två separata flöden — alerts och events — och en token som är begränsad till endast en av dem ansluter ändå utan problem. Flödet bakom den saknade slutpunkten returnerar då ingenting, utan något fel som förklarar varför.
Dessa två är de enda slutpunkter som Living Security kräver. Att inte ge åtkomst till något utöver dem följer principen om minsta möjliga behörighet.
  1. Klicka på Spara (eller Generate Token).
3

Kopiera och spara din token

Kopiera token direkt och förvara den säkert.
Netskope visar tokenvärdet endast en gång när den skapas. Om du lämnar sidan utan att kopiera den måste du ta bort token och skapa en ny.
4

Konfigurera IP-tillåtelselista (om tillämpligt)

Om IP-tillåtelselista är aktiverad för din Netskope-tenant måste du lägga till Living Securitys IP-intervall för utgående trafik.
  1. Gå till Inställningar → Administration → IP Allowlist i Netskopes administratörskonsol.
  2. Om IP-tillåtelselista är aktiverad lägger du till varje utgående IP-adress för Living Security i listan Custom IP.
Om IP-tillåtelselista är aktiverad lyckas anslutningsdialogen, men datasynkroniseringarna misslyckas med 401 Unauthorized tills rätt IP-adresser har lagts till.
5

Identifiera din tenants underdomän

Din tenants underdomän är prefixet i webbadressen till din Netskope-administratörskonsol.Om webbadressen till din konsol är https://acme.goskope.com är din underdomän acme.Ange endast själva underdomänen — inget https://, inget .goskope.com och inget avslutande snedstreck.
Anslutningsdialogen godtar flera inmatningsformer (enbart underdomän, fullständigt värdnamn eller fullständig webbadress) och normaliserar dem automatiskt. Vi rekommenderar dock att du anger enbart underdomänen.

Del B — I Living Security Platform

Programansvarig utför det här steget, eller systemadministratören om delegerad konfiguration används.
Nu är du ansluten till Netskope (v2 API).

Felsökning

Vanliga orsaker:
  1. Token har återkallats eller gått ut — generera en ny token
  2. En v1-token används — v1-token autentiserar via frågeparameter och fungerar inte med v2-slutpunkter. Generera en ny v2-token under Inställningar → Tools → REST API v2
  3. IP-tillåtelselistan blockerar begäranden — om IP-tillåtelselista är aktiverad för din tenant ska du kontrollera att alla fyra utgående IP-adresser för Living Security finns i tillåtelselistan
Token skapades utan åtkomst till /api/v2/events/data/alert eller /api/v2/events/data/page. Behörigheterna för en tokens slutpunkter kan inte ändras efter att den har skapats — skapa en ny token med läsbehörighet till båda och anslut igen.
Token saknar en av de två nödvändiga slutpunkterna. En token som är begränsad till endast /api/v2/events/data/alert eller endast /api/v2/events/data/page ansluter ändå, och flödet bakom den saknade slutpunkten förblir tyst och tomt.Slutpunktsbehörigheter kan inte ändras efter att en token har skapats — generera en ny token med läsbehörighet till båda och anslut sedan igen.
Om IP-tillåtelselista är aktiverad kan Living Securitys utgående IP-adresser ha ändrats. Kontrollera Konfigurera utgående IP-adresser för integrationer och uppdatera listan Custom IP så att den stämmer överens.
V1- och v2-token använder olika autentiseringsmekanismer:
  • v1: Frågeparameter (token=...)
  • v2: Header (Netskope-Api-Token: ...)
Living Security använder v2-autentisering. Generera en ny token under Inställningar → Tools → REST API v2 (inte på sidan för den äldre v1-token).