Skip to main content

​
Co wnosi ta integracja

Netskope może dostarczać znormalizowane dane o aktywności w sieci web, chmurze, uwierzytelnianiu, ochronie danych i zagrożeniach. Sprawdzone przykłady obejmują:
  • web.ai.visited — odwiedzenie witryny AI
  • data.bulk.uploaded — zbiorcze przesyłanie danych
  • geo.impossible — niemożliwa podróż między logowaniami
Bieżące połączenie korzysta z REST API v2; w przypadku dotychczasowych klientów może być widoczny starszy wariant REST. Zobacz jak dane z integracji stają się sygnałami.

​
Czego potrzebuje Living Security

Wymagany dostęp do punktów końcowych: Wymagana rola: Tenant Admin lub równoważna z dostępem do Settings → Tools
Ta integracja wymaga tokenu API v2, a nie tokenu v1. Tokeny v1 używają uwierzytelniania za pomocą parametru zapytania i nie będą działać z punktem końcowym API v2.

​
Wymagania wstępne

  • Musisz mieć dostęp Tenant Admin w Netskope, aby zarządzać tokenami REST API.

​
Część A — W Netskope

Poniższe kroki wykonuje administrator Netskope.
1

Przejdź do zarządzania tokenami REST API v2

  1. Zaloguj się do konsoli administracyjnej Netskope pod adresem https://<tenant>.goskope.com.
  2. W nawigacji po lewej stronie kliknij Settings.
  3. W sekcji Tools wybierz REST API v2.
2

Utwórz nowy token

  1. Kliknij New Token.
  2. Wprowadź opisową nazwę (np. Living Security Platform).
  3. W sekcji dostępu do punktów końcowych włącz dostęp do:
Przyznaj dostęp do obu punktów końcowych. Zasilają one dwa oddzielne strumienie — alerts i events — a token ograniczony tylko do jednego z nich nadal łączy się pomyślnie. Strumień powiązany z brakującym punktem końcowym nie zwraca wtedy żadnych danych, bez błędu wskazującego przyczynę.
Te dwa punkty końcowe są jedynymi, których wymaga Living Security. Nieprzyznawanie dodatkowych uprawnień jest zgodne z zasadą najmniejszych uprawnień.
  1. Kliknij Zapisz (lub Generate Token).
3

Skopiuj i zapisz token

Skopiuj token natychmiast i przechowuj go w bezpiecznym miejscu.
Netskope wyświetla wartość tokenu tylko raz podczas tworzenia. Jeśli opuścisz stronę bez skopiowania tokenu, musisz go usunąć i utworzyć nowy.
4

Skonfiguruj listę dozwolonych adresów IP (jeśli dotyczy)

Jeśli w Twojej dzierżawie Netskope włączono listę dozwolonych adresów IP, musisz dodać zakresy adresów IP ruchu wychodzącego Living Security.
  1. W konsoli administracyjnej Netskope przejdź do Settings → Administration → IP Allowlist.
  2. Jeśli lista dozwolonych adresów IP jest włączona, dodaj każdy adres IP ruchu wychodzącego Living Security do listy Custom IP.
Jeśli lista dozwolonych adresów IP jest włączona, okno połączenia zakończy się powodzeniem, ale synchronizacje danych będą kończyć się błędem 401 Unauthorized do czasu dodania właściwych adresów IP.
5

Ustal subdomenę dzierżawy

Subdomena dzierżawy to przedrostek adresu URL konsoli administracyjnej Netskope.Jeśli adres URL konsoli to https://acme.goskope.com, Twoja subdomena to acme.Wprowadź wyłącznie samą subdomenę — bez https://, bez .goskope.com, bez końcowego ukośnika.
Okno połączenia akceptuje kilka form danych wejściowych (samą subdomenę, pełną nazwę hosta lub pełny adres URL) i automatycznie je normalizuje. Zalecane jest jednak wprowadzenie samej subdomeny.

​
Część B — W Living Security Platform

Ten krok wykonuje właściciel programu lub administrator systemu, jeśli stosowana jest konfiguracja delegowana.
Połączenie z Netskope (v2 API) zostało nawiązane.

​
Rozwiązywanie problemów

Typowe przyczyny:
  1. Token został unieważniony lub wygasł — wygeneruj nowy token
  2. Użycie tokenu v1 — tokeny v1 uwierzytelniają się za pomocą parametru zapytania i nie działają z punktami końcowymi v2. Wygeneruj nowy token v2 w Settings → Tools → REST API v2
  3. Lista dozwolonych adresów IP blokuje żądania — jeśli w Twojej dzierżawie włączono listę dozwolonych adresów IP, sprawdź, czy wszystkie cztery adresy IP ruchu wychodzącego Living Security znajdują się na liście dozwolonych
Token został utworzony bez dostępu do /api/v2/events/data/alert lub /api/v2/events/data/page. Uprawnień tokenu do punktów końcowych nie można zmienić po jego utworzeniu — utwórz nowy token z dostępem do odczytu obu punktów końcowych i połącz ponownie.
W tokenie brakuje jednego z dwóch wymaganych punktów końcowych. Token ograniczony tylko do /api/v2/events/data/alert lub tylko do /api/v2/events/data/page nadal się łączy, a strumień powiązany z brakującym punktem końcowym pozostaje po cichu pusty.Uprawnień do punktów końcowych nie można zmienić po utworzeniu tokenu — wygeneruj nowy token z dostępem do odczytu obu punktów końcowych, a następnie połącz ponownie.
Jeśli lista dozwolonych adresów IP jest włączona, adresy IP ruchu wychodzącego Living Security mogły ulec zmianie. Sprawdź Konfigurowanie adresów IP ruchu wychodzącego integracji i zaktualizuj listę Custom IP, aby była z nimi zgodna.
Tokeny v1 i v2 używają różnych mechanizmów uwierzytelniania:
  • v1: parametr zapytania (token=...)
  • v2: nagłówek (Netskope-Api-Token: ...)
Living Security używa uwierzytelniania v2. Wygeneruj nowy token w Settings → Tools → REST API v2 (a nie na stronie starszego tokenu v1).