Skip to main content

​
Ko šī integrācija nodrošina

Netskope var nodrošināt normalizētus datus par tīmekļa, mākoņa, autentifikācijas, datu aizsardzības un draudu aktivitāti. Pārskatītie piemēri ietver:
  • web.ai.visited — apmeklēta MI vietne
  • data.bulk.uploaded — masveida datu augšupielāde
  • geo.impossible — neiespējama pārvietošanās starp pierakstīšanās reizēm
Pašreizējais savienojums izmanto REST API v2; esošiem klientiem var būt pieejams arī vecāks REST variants. Skatiet kā integrāciju dati kļūst par signāliem.

​
Kas nepieciešams Living Security

Nepieciešamā piekļuve galapunktiem: Nepieciešamā loma: Tenant Admin vai līdzvērtīga loma ar piekļuvi sadaļai Settings → Tools
Šai integrācijai nepieciešams v2 API token, nevis v1 token. V1 token izmanto autentifikāciju ar vaicājuma parametru un nedarbosies ar v2 API galapunktu.

​
Priekšnosacījumi

  • Jums Netskope ir jābūt Tenant Admin piekļuvei, lai pārvaldītu REST API token.

​
A daļa — Netskope

Šīs darbības veic jūsu Netskope administrators.
1

Pāriet uz REST API v2 Token Management

  1. Pierakstieties savā Netskope administratora konsolē adresē https://<tenant>.goskope.com.
  2. Kreisajā navigācijas izvēlnē noklikšķiniet uz Settings.
  3. Sadaļā Tools izvēlieties REST API v2.
2

Izveidot jaunu token

  1. Noklikšķiniet uz New Token.
  2. Ievadiet aprakstošu nosaukumu (piemēram, Living Security Platform).
  3. Sadaļā par piekļuvi galapunktiem iespējojiet piekļuvi:
Piešķiriet piekļuvi abiem galapunktiem. Tie baro divas atsevišķas plūsmas — alerts un events — un token, kam piešķirta piekļuve tikai vienam no tiem, tik un tā veiksmīgi izveido savienojumu. Plūsma, kas atbilst trūkstošajam galapunktam, tad neatgriež neko, un nekāds kļūdas ziņojums neizskaidro iemeslu.
Šie divi ir vienīgie galapunkti, kas nepieciešami Living Security. Nepiešķirot neko papildus, tiek ievērots mazāko privilēģiju princips.
  1. Noklikšķiniet uz Save (vai Generate Token).
3

Nokopēt un saglabāt token

Nekavējoties nokopējiet token un droši to uzglabājiet.
Netskope token vērtību parāda tikai vienu reizi — tā izveides brīdī. Ja pametat lapu, to nenokopējot, token būs jāizdzēš un jāizveido jauns.
4

Konfigurēt IP atļauto sarakstu (ja piemērojams)

Ja jūsu Netskope nomniekam ir iespējots IP atļauto saraksts, jums jāpievieno Living Security izejošo IP adrešu diapazoni.
  1. Netskope administratora konsolē atveriet Settings → Administration → IP Allowlist.
  2. Ja IP atļauto saraksts ir iespējots, pievienojiet katru Living Security izejošo IP adresi sarakstam Custom IP.
Ja IP atļauto saraksts ir iespējots, savienojuma dialoglodziņš darbosies veiksmīgi, taču datu sinhronizācija beigsies ar kļūdu 401 Unauthorized, kamēr netiks pievienotas pareizās IP adreses.
5

Noteikt nomnieka apakšdomēnu

Jūsu nomnieka apakšdomēns ir jūsu Netskope administratora konsoles URL prefikss.Ja jūsu konsoles URL ir https://acme.goskope.com, jūsu apakšdomēns ir acme.Ievadiet tikai apakšdomēnu — bez https://, bez .goskope.com, bez noslēdzošās slīpsvītras.
Savienojuma dialoglodziņš pieņem vairākus ievades veidus (tikai apakšdomēnu, pilnu resursdatora nosaukumu vai pilnu URL) un automātiski tos normalizē. Tomēr ieteicams ievadīt tikai apakšdomēnu.

​
B daļa — Living Security Platform

Šo darbību veic programmas īpašnieks vai sistēmas administrators, ja tiek izmantota deleģēta iestatīšana.
Tagad esat izveidojis savienojumu ar Netskope (v2 API).

​
Problēmu novēršana

Biežākie cēloņi:
  1. Token ir atsaukts vai beidzies tā derīguma termiņš — izveidojiet jaunu token
  2. Tiek izmantots v1 token — v1 token autentificējas ar vaicājuma parametru un nedarbosies ar v2 galapunktiem. Izveidojiet jaunu v2 token sadaļā Settings → Tools → REST API v2
  3. IP atļauto saraksts bloķē pieprasījumus — ja jūsu nomniekam ir iespējots IP atļauto saraksts, pārliecinieties, ka visas četras Living Security izejošās IP adreses ir atļauto sarakstā
Token tika izveidots bez piekļuves /api/v2/events/data/alert vai /api/v2/events/data/page. Token galapunktu atļaujas pēc izveides nevar mainīt — izveidojiet jaunu token ar lasīšanas piekļuvi abiem galapunktiem un izveidojiet savienojumu atkārtoti.
Tokenam trūkst viena no diviem nepieciešamajiem galapunktiem. Token, kam piešķirta piekļuve tikai /api/v2/events/data/alert vai tikai /api/v2/events/data/page, tik un tā izveido savienojumu, un plūsma, kas atbilst trūkstošajam galapunktam, paliek tukša bez jebkādiem paziņojumiem.Galapunktu atļaujas pēc token izveides nevar mainīt — izveidojiet jaunu token ar lasīšanas piekļuvi abiem galapunktiem un pēc tam izveidojiet savienojumu atkārtoti.
Ja IP atļauto saraksts ir iespējots, Living Security izejošās IP adreses, iespējams, ir mainījušās. Skatiet Integrāciju izejošo IP adrešu konfigurēšana un atjauniniet sarakstu Custom IP, lai tas atbilstu.
V1 un v2 token izmanto dažādus autentifikācijas mehānismus:
  • v1: vaicājuma parametrs (token=...)
  • v2: galvene (Netskope-Api-Token: ...)
Living Security izmanto v2 autentifikāciju. Izveidojiet jaunu token sadaļā Settings → Tools → REST API v2 (nevis vecajā v1 token lapā).