Skip to main content

​
Co tato integrace poskytuje

Netskope může poskytovat normalizovaná data o webové a cloudové aktivitě, autentizaci, ochraně dat a hrozbách. Mezi prověřené příklady patří:
  • web.ai.visited — návštěva webu s umělou inteligencí
  • data.bulk.uploaded — hromadné nahrávání dat
  • geo.impossible — nemožný přesun mezi přihlášeními
Aktuální připojení používá REST API v2; stávajícím zákazníkům se může zobrazit starší varianta REST. Viz jak se data z integrací stávají signály.

​
Co Living Security potřebuje

Požadovaný přístup ke koncovým bodům: Požadovaná role: Tenant Admin nebo ekvivalentní role s přístupem k Settings → Tools
Tato integrace vyžaduje token API v2, nikoli token v1. Tokeny v1 používají autentizaci pomocí parametru dotazu a s koncovým bodem API v2 nebudou fungovat.

​
Předpoklady

  • K správě tokenů REST API musíte mít v Netskope přístup Tenant Admin.

​
Část A — V Netskope

Tyto kroky provede váš administrátor Netskope.
1

Přejděte do správy tokenů REST API v2

  1. Přihlaste se do administrátorské konzole Netskope na adrese https://<tenant>.goskope.com.
  2. V levé navigaci klikněte na Settings.
  3. V části Tools vyberte REST API v2.
2

Vytvořte nový token

  1. Klikněte na New Token.
  2. Zadejte popisný název (např. Living Security Platform).
  3. V části přístupu ke koncovým bodům povolte přístup k:
Udělte přístup k oběma koncovým bodům. Napájejí dva samostatné datové toky — alerts a events — a token omezený jen na jeden z nich se přesto úspěšně připojí. Datový tok, jehož koncový bod chybí, pak nevrací žádná data a žádná chyba vám neprozradí proč.
Tyto dva koncové body jsou jediné, které Living Security vyžaduje. Neudělením žádných dalších oprávnění dodržíte princip nejnižších oprávnění.
  1. Klikněte na Uložit (nebo Generate Token).
3

Zkopírujte a uložte token

Token ihned zkopírujte a bezpečně uložte.
Netskope zobrazí hodnotu tokenu pouze jednou, při jeho vytvoření. Pokud stránku opustíte, aniž byste token zkopírovali, musíte token odstranit a vytvořit nový.
4

Nakonfigurujte seznam povolených IP adres (pokud je relevantní)

Pokud má váš tenant Netskope zapnutý seznam povolených IP adres, musíte do něj přidat rozsahy odchozích IP adres Living Security.
  1. V administrátorské konzoli Netskope přejděte do Settings → Administration → IP Allowlist.
  2. Pokud je seznam povolených IP adres zapnutý, přidejte každou odchozí IP adresu Living Security do seznamu Custom IP.
Pokud je seznam povolených IP adres zapnutý, dialog připojení proběhne úspěšně, ale synchronizace dat selže s chybou 401 Unauthorized, dokud nebudou přidány správné IP adresy.
5

Zjistěte subdoménu svého tenantu

Subdoména tenantu je předpona adresy URL vaší administrátorské konzole Netskope.Pokud je adresa URL vaší konzole https://acme.goskope.com, vaše subdoména je acme.Zadejte pouze samotnou subdoménu — bez https://, bez .goskope.com, bez koncového lomítka.
Dialog připojení přijímá několik podob zadání (samotnou subdoménu, celý název hostitele nebo celou adresu URL) a automaticky je normalizuje. Doporučujeme však zadat pouze samotnou subdoménu.

​
Část B — V Living Security Platform

Tento krok provede vlastník programu, případně správce systému, pokud se používá delegované nastavení.
Nyní jste připojeni k Netskope (v2 API).

​
Řešení potíží

Časté příčiny:
  1. Token byl odvolán nebo mu vypršela platnost — vygenerujte nový token
  2. Používáte token v1 — tokeny v1 se autentizují pomocí parametru dotazu a s koncovými body v2 nebudou fungovat. Vygenerujte nový token v2 v Settings → Tools → REST API v2
  3. Požadavky blokuje seznam povolených IP adres — pokud má váš tenant zapnutý seznam povolených IP adres, ověřte, že jsou v něm všechny čtyři odchozí IP adresy Living Security
Token byl vytvořen bez přístupu k /api/v2/events/data/alert nebo /api/v2/events/data/page. Oprávnění tokenu ke koncovým bodům nelze po vytvoření změnit — vytvořte nový token s oprávněním ke čtení obou koncových bodů a znovu se připojte.
Tokenu chybí jeden ze dvou požadovaných koncových bodů. Token omezený pouze na /api/v2/events/data/alert nebo pouze na /api/v2/events/data/page se přesto připojí a datový tok, jehož koncový bod chybí, zůstává nenápadně prázdný.Oprávnění ke koncovým bodům nelze po vytvoření tokenu změnit — vygenerujte nový token s oprávněním ke čtení obou koncových bodů a poté se znovu připojte.
Pokud je zapnutý seznam povolených IP adres, odchozí IP adresy Living Security se mohly změnit. Zkontrolujte Konfiguraci odchozích IP adres integrací a aktualizujte seznam Custom IP podle nich.
Tokeny v1 a v2 používají odlišné mechanismy autentizace:
  • v1: parametr dotazu (token=...)
  • v2: hlavička (Netskope-Api-Token: ...)
Living Security používá autentizaci v2. Vygenerujte nový token v Settings → Tools → REST API v2 (nikoli na stránce starších tokenů v1).