> ## 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-integratie instellen

> Koppel Netskope aan Living Security voor activiteit op het gebied van web, cloud, authenticatie, gegevensbescherming en bedreigingen.

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>Gerelateerde bronnen</h2>
    <ul>
      <li>
        <a href="/nl/signals/data-sources">Lees hoe integratiegegevens worden omgezet in Human Risk Management-signalen</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">Ontdek de integraties van Living Security</a>
      </li>
      <li>
        <a href="https://app.livingsecurity.ai/">Open het Living Security Platform</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/request-demo/">Vraag een demo van Living Security aan</a>
      </li>
    </ul>
  </>;

export const EgressIpSafelist = ({system}) => <Note>
    <strong>Voeg alle vier de uitgaande IP-adressen voor synchronisatie van Living Security toe</strong> aan de allowlist in{' '}
    {system}. Voer elk adres in als afzonderlijke host met <code>/32</code> als {system} CIDR-notatie verwacht:
    <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 />
    Het verkeer kan via elk van de vier adressen uitgaan. Als u slechts een deel ervan op de allowlist zet, leidt dat tot onregelmatige
    synchronisatiefouten. Deze vier adressen zijn in elke regio van Living Security gelijk. Zie{' '}
    <a href="/nl/integrations/managing/egress-ip-addresses">
      Uitgaande IP-adressen van Integraties configureren
    </a>{' '}
    voor de volledige lijst, het wijzigingsbeleid en probleemoplossing.
  </Note>;

export const ConnectInPlatform = ({tile, children}) => <Step title="Voer de inloggegevens in het Living Security Platform in">
    <p>
      Uit te voeren door degene die toegang heeft tot Living Security — de programma-eigenaar, of de
      systeembeheerder als deze is uitgenodigd (gedelegeerde installatie).
    </p>
    <ol>
      <li>
        Ga naar <strong>instellingen → Integraties → Catalog</strong>, zoek de tegel{' '}
        <strong>{tile}</strong> en klik op <strong>verbinden</strong>.
      </li>
      <li>
        Vul de onderstaande velden in en klik vervolgens op <strong>verbinden</strong>.
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>Deze handleiding is bedoeld voor uw {system}-beheerder.</strong> Hierin wordt beschreven hoe u API-referenties aanmaakt in {system}. Hiervoor is beheerderstoegang tot {system} vereist, niet tot het
      Living Security Platform.
    </p>
    <p>
      Als u de <strong>programma-eigenaar</strong> van Living Security bent en {system} niet beheert,
      stuur deze pagina dan door naar de persoon die dat wel doet. Die persoon voltooit deel A en geeft de referenties aan u terug
      (of voert ze rechtstreeks in als u diegene hebt uitgenodigd voor het platform).
      {recommendDelegated && <>
          {' '}Omdat tijdens de installatie gevoelig sleutelmateriaal wordt gegenereerd, raden wij het{' '}
          <strong>gedelegeerde installatietraject</strong> aan, zodat het geheim nooit naar u wordt teruggestuurd.
        </>}
    </p>
  </Note>;

<SystemAdminBanner system="Netskope" />

## Wat deze integratie bijdraagt

Netskope kan genormaliseerde activiteit op het gebied van web, cloud, authenticatie, gegevensbescherming en bedreigingen aanleveren. Beoordeelde voorbeelden zijn onder meer:

* `web.ai.visited` — AI-website bezocht
* `data.bulk.uploaded` — bulkupload van gegevens
* `geo.impossible` — onmogelijke reis tussen aanmeldingen

De huidige koppeling maakt gebruik van REST API v2; voor bestaande klanten kan een verouderde REST-variant verschijnen. Zie [hoe integratiegegevens Signalen worden](/nl/signals/data-sources).

## Wat Living Security nodig heeft

| Referentie | Beschrijving |
| - | - |
| **API-token** | Een REST API v2-token dat is gegenereerd in de Netskope-beheerconsole |
| **Tenant-subdomein** | Het subdomein van uw Netskope-tenant (bijv. `acme` van `acme.goskope.com`) |

**Vereiste toegang tot endpoints:**

| Endpoint | Doel |
| - | - |
| `/api/v2/events/data/alert` | Bedreigingsmeldingen, beleidsovertredingen, DLP-gebeurtenissen, malwaredetecties |
| `/api/v2/events/data/page` | Webactiviteit — browsen, toegestane en geblokkeerde sites, toegang tot cloud-apps |

**Vereiste rol:** **Tenant Admin** of een equivalente rol met toegang tot **Settings → Tools**

<Note>
  Voor deze integratie is een **v2 API-token** vereist, geen v1-token. V1-tokens gebruiken authenticatie via een queryparameter en werken niet met het v2 API-endpoint.
</Note>

### Vereisten

* U moet beschikken over **Tenant Admin**-toegang in Netskope om REST API-tokens te beheren.

***

## Deel A — In Netskope

*Uw Netskope-beheerder voert deze stappen uit.*

<Steps>
  <Step title="Naar het beheer van REST API v2-tokens gaan">
    1. Meld u aan bij uw Netskope-beheerconsole via `https://<tenant>.goskope.com`.
    2. Klik in het navigatiemenu links op **Settings**.
    3. Selecteer onder **Tools** de optie **REST API v2**.
  </Step>

  <Step title="Een nieuw token aanmaken">
    1. Klik op **New Token**.
    2. Voer een beschrijvende naam in (bijv. `Living Security Platform`).
    3. Schakel onder endpointtoegang toegang in voor:

    | Endpoint | Vereiste toegang |
    | - | - |
    | `/api/v2/events/data/alert` | Read |
    | `/api/v2/events/data/page` | Read |

    <Warning>
      Verleen toegang tot **beide** endpoints. Ze voeden twee afzonderlijke stromen — `alerts` en
      `events` — en een token dat slechts tot één van beide is beperkt, maakt nog steeds succesvol verbinding.
      De stroom achter het ontbrekende endpoint levert dan niets op, zonder foutmelding
      die aangeeft waarom.
    </Warning>

    <Note>
      Deze twee zijn de enige endpoints die Living Security nodig heeft. Door niets
      daarbovenop toe te kennen, volgt u het principe van minimale rechten.
    </Note>

    4. Klik op **Opslaan** (of **Generate Token**).
  </Step>

  <Step title="Uw token kopiëren en opslaan">
    **Kopieer het token direct** en bewaar het veilig.

    <Warning>
      Netskope toont de tokenwaarde **slechts één keer** bij het aanmaken. Als u wegnavigeert zonder het te kopiëren, moet u het token verwijderen en een nieuw token aanmaken.
    </Warning>
  </Step>

  <Step title="IP-allowlist configureren (indien van toepassing)">
    Als voor uw Netskope-tenant IP-allowlisting is ingeschakeld, moet u de egress-IP-bereiken van Living Security toevoegen.

    1. Ga in de Netskope-beheerconsole naar **Settings → Administration → IP Allowlist**.
    2. Als IP-allowlisting is ingeschakeld, voegt u elk [egress-IP-adres van Living Security](/nl/integrations/managing/egress-ip-addresses) toe aan de lijst **Custom IP**.

    <EgressIpSafelist system="Netskope" />

    <Warning>
      Als IP-allowlisting is ingeschakeld, slaagt het verbindingsdialoogvenster, maar mislukt de gegevenssynchronisatie met `401 Unauthorized` totdat de juiste IP-adressen zijn toegevoegd.
    </Warning>
  </Step>

  <Step title="Uw tenant-subdomein bepalen">
    Uw tenant-subdomein is het voorvoegsel van de URL van uw Netskope-beheerconsole.

    Als de URL van uw console `https://acme.goskope.com` is, is uw subdomein `acme`.

    Voer uitsluitend het kale subdomein in — geen `https://`, geen `.goskope.com`, geen afsluitende schuine streep.

    <Note>
      Het verbindingsdialoogvenster accepteert meerdere invoervormen (kaal subdomein, volledige hostnaam of volledige URL) en normaliseert deze automatisch. Het wordt echter aanbevolen om het kale subdomein in te voeren.
    </Note>
  </Step>
</Steps>

***

## Deel B — In het Living Security Platform

*De programma-eigenaar voert deze stap uit, of de systeembeheerder bij gedelegeerde installatie.*

<Steps>
  <ConnectInPlatform tile="Netskope (v2 API)">
    | Veld | Waarde |
    | - | - |
    | **API-sleutel** | Het token uit Deel A, stap 3 |
    | **Tenant-subdomein** | Het subdomein uit Deel A, stap 5 (bijv. `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="Verbindingsdialoogvenster van Living Security voor Netskope v2 API" style={{maxWidth: "450px"}} width="576" height="356" data-path="integrations/images/netskope-v2-api/connect-dialog.png" />
  </ConnectInPlatform>
</Steps>

U bent nu verbonden met Netskope (v2 API).

***

## Probleemoplossing

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    Veelvoorkomende oorzaken:

    1. **Token ingetrokken of verlopen** — genereer een nieuw token
    2. **Gebruik van een v1-token** — v1-tokens authenticeren via een queryparameter en werken niet met v2-endpoints. Genereer een nieuw v2-token via **Settings → Tools → REST API v2**
    3. **IP-allowlist blokkeert verzoeken** — als voor uw tenant IP-allowlisting is ingeschakeld, controleert u of alle vier de [egress-IP-adressen van Living Security](/nl/integrations/managing/egress-ip-addresses) op de allowlist staan
  </Accordion>

  <Accordion title="403 Forbidden">
    Het token is aangemaakt zonder toegang tot `/api/v2/events/data/alert` of `/api/v2/events/data/page`. De endpointmachtigingen van een token kunnen na het aanmaken niet meer worden gewijzigd — maak een nieuw token aan met leestoegang tot beide en koppel opnieuw.
  </Accordion>

  <Accordion title="Meldingen komen binnen, maar webactiviteit ontbreekt (of andersom)">
    Het token mist een van de twee vereiste endpoints. Een token dat slechts tot
    `/api/v2/events/data/alert` of slechts tot `/api/v2/events/data/page` is beperkt, maakt nog steeds verbinding,
    en de stroom achter het ontbrekende endpoint blijft stilzwijgend leeg.

    Endpointmachtigingen kunnen na het aanmaken van een token niet meer worden gewijzigd — genereer een nieuw
    token met leestoegang tot beide en koppel vervolgens opnieuw.
  </Accordion>

  <Accordion title="Synchronisaties werkten, maar mislukken nu met 401">
    Als IP-allowlisting is ingeschakeld, kunnen de egress-IP-adressen van Living Security zijn gewijzigd. Raadpleeg [Egress-IP-adressen voor integraties configureren](/nl/integrations/managing/egress-ip-addresses) en werk de lijst **Custom IP** dienovereenkomstig bij.
  </Accordion>

  <Accordion title="Een v1-token gebruiken in plaats van v2">
    V1- en v2-tokens gebruiken verschillende authenticatiemechanismen:

    * **v1**: queryparameter (`token=...`)
    * **v2**: header (`Netskope-Api-Token: ...`)

    Living Security gebruikt v2-authenticatie. Genereer een nieuw token via **Settings → Tools → REST API v2** (niet via de verouderde v1-tokenpagina).
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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