Skip to main content

​
Mivel járul hozzá ez az integráció

A Netskope normalizált webes, felhős, hitelesítési, adatvédelmi és fenyegetési tevékenységi adatokat képes szolgáltatni. Az áttekintett példák közé tartoznak:
  • web.ai.visited — mesterséges intelligenciával kapcsolatos webhely meglátogatása
  • data.bulk.uploaded — tömeges adatfeltöltés
  • geo.impossible — lehetetlen utazás a bejelentkezések között
A jelenlegi kapcsolat REST API v2-t használ; a meglévő ügyfelek esetében megjelenhet egy régebbi REST-változat is. Lásd: hogyan válnak az integrációs adatok jelzésekké.

​
Mire van szüksége a Living Security szolgáltatásnak

Szükséges végponthozzáférés: Szükséges szerepkör: Tenant Admin vagy azzal egyenértékű szerepkör, amely hozzáfér a Settings → Tools menüponthoz
Ehhez az integrációhoz v2 API tokenre van szükség, nem v1 tokenre. A v1 tokenek lekérdezési paraméteres hitelesítést használnak, ezért nem működnek a v2 API végponttal.

​
Előfeltételek

  • A REST API tokenek kezeléséhez Tenant Admin hozzáféréssel kell rendelkeznie a Netskope-ban.

​
A rész — A Netskope-ban

Ezeket a lépéseket a Netskope rendszergazdája végzi el.
1

Navigálás a REST API v2 tokenkezeléshez

  1. Jelentkezzen be a Netskope rendszergazdai konzolba a következő címen: https://<tenant>.goskope.com.
  2. A bal oldali navigációs sávban kattintson a Settings elemre.
  3. A Tools alatt válassza a REST API v2 lehetőséget.
2

Új token létrehozása

  1. Kattintson a New Token gombra.
  2. Adjon meg egy beszédes nevet (pl. Living Security Platform).
  3. A végponthozzáférés alatt engedélyezze a hozzáférést a következőkhöz:
Mindkét végponthoz adjon hozzáférést. Ezek két külön adatfolyamot táplálnak — alerts és events —, és az a token, amely csak az egyikre van korlátozva, továbbra is sikeresen csatlakozik. A hiányzó végpont mögötti adatfolyam ekkor nem ad vissza semmit, és semmilyen hibaüzenet nem jelzi az okot.
Ez a két végpont az egyetlen, amelyre a Living Security szolgáltatásnak szüksége van. Ha ezeken túl nem ad további jogosultságot, azzal betartja a legkisebb jogosultság elvét.
  1. Kattintson a Save (vagy a Generate Token) gombra.
3

A token másolása és mentése

Azonnal másolja ki a tokent, és tárolja biztonságosan.
A Netskope a token értékét csak egyszer, a létrehozáskor jeleníti meg. Ha a másolás előtt elnavigál az oldalról, törölnie kell a tokent, és újat kell létrehoznia.
4

IP-engedélyezési lista beállítása (ha van ilyen)

Ha a Netskope-bérlőn be van kapcsolva az IP-címek engedélyezési listája, hozzá kell adnia a Living Security kimenő IP-tartományait.
  1. A Netskope rendszergazdai konzolján nyissa meg a Settings → Administration → IP Allowlist oldalt.
  2. Ha az IP-engedélyezési lista be van kapcsolva, adja hozzá a Living Security kimenő IP-címeit a Custom IP listához.
Ha az IP-engedélyezési lista be van kapcsolva, a csatlakozási párbeszédpanel sikeresen lefut, de az adatszinkronizálások 401 Unauthorized hibával meghiúsulnak, amíg a megfelelő IP-címeket nem adja hozzá.
5

A bérlő aldomainjének azonosítása

A bérlő aldomainje a Netskope rendszergazdai konzol URL-jének előtagja.Ha a konzol URL-je https://acme.goskope.com, akkor az aldomain acme.Csak a puszta aldomaint adja meg — https:// és .goskope.com nélkül, záró perjel nélkül.
A csatlakozási párbeszédpanel többféle beviteli formát is elfogad (puszta aldomain, teljes állomásnév vagy teljes URL), és automatikusan normalizálja azokat. A puszta aldomain megadása azonban ajánlott.

​
B rész — A Living Security Platformon

Ezt a lépést a programgazda végzi el, vagy a rendszergazda, ha delegált beállítást használnak.
Ezzel sikeresen csatlakozott a Netskope-hoz (v2 API).

​
Hibaelhárítás

Gyakori okok:
  1. A token visszavonták vagy lejárt — generáljon új tokent
  2. v1 token használata — a v1 tokenek lekérdezési paraméterrel hitelesítenek, ezért nem működnek a v2 végpontokkal. Generáljon új v2 tokent a Settings → Tools → REST API v2 oldalon
  3. Az IP-engedélyezési lista blokkolja a kéréseket — ha a bérlőn be van kapcsolva az IP-engedélyezési lista, ellenőrizze, hogy mind a négy Living Security kimenő IP-cím szerepel-e a listán
A tokent a következőkhöz való hozzáférés nélkül hozták létre: /api/v2/events/data/alert vagy /api/v2/events/data/page. A token végpontjogosultságai létrehozás után nem módosíthatók — hozzon létre egy új tokent mindkét végponthoz olvasási hozzáféréssel, majd csatlakozzon újra.
A tokenből hiányzik a két szükséges végpont egyike. Az a token, amely csak a /api/v2/events/data/alert vagy csak a /api/v2/events/data/page végpontra van korlátozva, továbbra is csatlakozik, a hiányzó végpont mögötti adatfolyam pedig hibaüzenet nélkül üres marad.A végpontjogosultságok a token létrehozása után nem módosíthatók — generáljon új tokent mindkét végponthoz olvasási hozzáféréssel, majd csatlakozzon újra.
Ha az IP-engedélyezési lista be van kapcsolva, előfordulhat, hogy a Living Security kimenő IP-címei megváltoztak. Tekintse meg az Integrációk kimenő IP-címeinek konfigurálása című oldalt, és frissítse ennek megfelelően a Custom IP listát.
A v1 és a v2 tokenek eltérő hitelesítési mechanizmust használnak:
  • v1: lekérdezési paraméter (token=...)
  • v2: fejléc (Netskope-Api-Token: ...)
A Living Security v2 hitelesítést használ. Generáljon új tokent a Settings → Tools → REST API v2 oldalon (nem a régi v1 tokenoldalon).