> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Netskope integrācijas iestatīšana

> Savienojiet Netskope ar Living Security, lai iegūtu datus par tīmekļa, mākoņa, autentifikācijas, datu aizsardzības un draudu aktivitāti.

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>Saistītie resursi</h2>
    <ul>
      <li>
        <a href="/lv/signals/data-sources">Uzziniet, kā integrāciju dati kļūst par cilvēciskā riska pārvaldības signāliem</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">Izpētiet Living Security Integrations</a>
      </li>
      <li>
        <a href="https://app.livingsecurity.ai/">Atveriet Living Security Platform</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/request-demo/">Pieprasiet Living Security demonstrāciju</a>
      </li>
    </ul>
  </>;

export const EgressIpSafelist = ({system}) => <Note>
    <strong>Pievienojiet visas četras Living Security sinhronizācijas izejošā datplūsmas IP adreses</strong> atļauto sarakstam sistēmā{' '}
    {system}. Ja {system} sagaida CIDR pierakstu, katru adresi ievadiet kā atsevišķu resursdatoru ar <code>/32</code>:
    <br />
    <code>52.34.139.153/32</code>, <code>54.69.127.183/32</code>, <code>44.247.133.183/32</code>,{' '}
    <code>52.26.211.56/32</code>
    <br />
    <br />
    Datplūsma var iziet no jebkuras no šīm četrām adresēm, tāpēc, ja atļauto sarakstam tiek pievienotas tikai dažas no tām, rodas periodiskas sinhronizācijas kļūmes. Šīs četras adreses ir vienādas visos Living Security reģionos. Pilnu sarakstu, izmaiņu politiku un problēmu novēršanas norādījumus skatiet sadaļā{' '}
    <a href="/lv/integrations/managing/egress-ip-addresses">
      Configuring Integration Egress IP Addresses
    </a>.
  </Note>;

export const ConnectInPlatform = ({tile, children}) => <Step title="Ievadiet akreditācijas datus Living Security Platform">
    <p>
      Šo darbību veic persona, kurai ir Living Security piekļuve — programmas īpašnieks vai
      sistēmas administrators, ja viņš ir uzaicināts (deleģēta iestatīšana).
    </p>
    <ol>
      <li>
        Dodieties uz <strong>Settings → Integrations → Catalog</strong>, atrodiet elementu{' '}
        <strong>{tile}</strong>, noklikšķiniet uz <strong>Connect</strong>.
      </li>
      <li>
        Aizpildiet tālāk norādītos laukus, pēc tam noklikšķiniet uz <strong>Connect</strong>.
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>Šī rokasgrāmata ir paredzēta jūsu {system} administratoram.</strong> Tajā aprakstīts, kā izveidot API
      akreditācijas datus sistēmā {system}, kam nepieciešama administratora piekļuve sistēmai {system}, nevis
      Living Security Platform.
    </p>
    <p>
      Ja jūs esat Living Security <strong>programmas īpašnieks</strong> un neadministrējat sistēmu {system},
      nosūtiet šo lapu personai, kas to dara. Šī persona izpilda A daļu un nodod akreditācijas datus jums
      (vai ievada tos tieši, ja esat uzaicinājis šo personu platformā).
      {recommendDelegated && <>
          {' '}Tā kā iestatīšanas rezultātā tiek izveidots sensitīvs atslēgu materiāls, iesakām izmantot{' '}
          <strong>deleģēto iestatīšanu</strong>, lai noslēpums nekad netiktu sūtīts atpakaļ jums.
        </>}
    </p>
  </Note>;

<SystemAdminBanner system="Netskope" />

## 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](/lv/signals/data-sources).

## Kas nepieciešams Living Security

| Credential | Apraksts |
| - | - |
| **API token** | REST API v2 token, kas izveidots Netskope administratora konsolē |
| **Tenant subdomain** | Jūsu Netskope nomnieka apakšdomēns (piemēram, `acme` no `acme.goskope.com`) |

**Nepieciešamā piekļuve galapunktiem:**

| Galapunkts | Mērķis |
| - | - |
| `/api/v2/events/data/alert` | Draudu brīdinājumi, politiku pārkāpumi, DLP notikumi, ļaunprātīgas programmatūras atklāšana |
| `/api/v2/events/data/page` | Tīmekļa aktivitāte — pārlūkošana, atļautās un bloķētās vietnes, piekļuve mākoņlietotnēm |

**Nepieciešamā loma:** **Tenant Admin** vai līdzvērtīga loma ar piekļuvi sadaļai **Settings → Tools**

<Note>
  Š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.
</Note>

### 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.*

<Steps>
  <Step title="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**.
  </Step>

  <Step title="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:

    | Galapunkts | Nepieciešamā piekļuve |
    | - | - |
    | `/api/v2/events/data/alert` | Read |
    | `/api/v2/events/data/page` | Read |

    <Warning>
      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.
    </Warning>

    <Note>
      Šie divi ir vienīgie galapunkti, kas nepieciešami Living Security. Nepiešķirot neko
      papildus, tiek ievērots mazāko privilēģiju princips.
    </Note>

    4. Noklikšķiniet uz **Save** (vai **Generate Token**).
  </Step>

  <Step title="Nokopēt un saglabāt token">
    **Nekavējoties nokopējiet token** un droši to uzglabājiet.

    <Warning>
      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.
    </Warning>
  </Step>

  <Step title="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](/lv/integrations/managing/egress-ip-addresses) sarakstam **Custom IP**.

    <EgressIpSafelist system="Netskope" />

    <Warning>
      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.
    </Warning>
  </Step>

  <Step title="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.

    <Note>
      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.
    </Note>
  </Step>
</Steps>

***

## B daļa — Living Security Platform

*Šo darbību veic programmas īpašnieks vai sistēmas administrators, ja tiek izmantota deleģēta iestatīšana.*

<Steps>
  <ConnectInPlatform tile="Netskope (v2 API)">
    | Field | Value |
    | - | - |
    | **API key** | Token no A daļas 3. darbības |
    | **Tenant subdomain** | Apakšdomēns no A daļas 5. darbības (piemēram, `acme`) |

    <img src="https://mintcdn.com/livingsecurity/oVkrOMkYmNevekTI/integrations/images/netskope-v2-api/connect-dialog.png?fit=max&auto=format&n=oVkrOMkYmNevekTI&q=85&s=89b64e78a14c51a0977c3a2a28418988" alt="Living Security savienojuma dialoglodziņš Netskope v2 API" style={{maxWidth: "450px"}} width="576" height="356" data-path="integrations/images/netskope-v2-api/connect-dialog.png" />
  </ConnectInPlatform>
</Steps>

Tagad esat izveidojis savienojumu ar Netskope (v2 API).

***

## Problēmu novēršana

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    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](/lv/integrations/managing/egress-ip-addresses) ir atļauto sarakstā
  </Accordion>

  <Accordion title="403 Forbidden">
    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.
  </Accordion>

  <Accordion title="Brīdinājumi tiek saņemti, bet tīmekļa aktivitātes dati trūkst (vai otrādi)">
    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.
  </Accordion>

  <Accordion title="Sinhronizācija darbojās, bet tagad beidzas ar kļūdu 401">
    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](/lv/integrations/managing/egress-ip-addresses) un atjauniniet sarakstu **Custom IP**, lai tas atbilstu.
  </Accordion>

  <Accordion title="Tiek izmantots v1 token v2 vietā">
    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ā).
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.