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

# Installatie van de Adaptive Security-integratie

> Koppel Adaptive Security aan het Living Security Platform om resultaten van phishing-, smishing- en vishingsimulaties en resultaten van security awareness-trainingen voor uw personeelsbestand te importeren.

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 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="Adaptive Security" />

## Wat deze integratie bijdraagt

Adaptive Security kan gegevens over het personeelsbestand, trainingen en resultaten van simulaties via meerdere kanalen aanleveren. Beoordeelde voorbeelden zijn:

* `phishing.simulation.clicked` — heeft op een gesimuleerde e-mail geklikt zonder deze te melden
* `phishing.simulation.credential.submitted` — heeft inloggegevens ingevoerd op een gesimuleerde inlogpagina
* `phishing.simulation.attachment.opened` — heeft een bijlage van een gesimuleerde e-mail geopend
* `phishing.simulation.reported` — heeft een gesimuleerde e-mail gemeld
* `smishing.simulation.replied` — heeft geantwoord op een gesimuleerd sms-bericht
* `vishing.simulation.succeeded` — heeft gevolg gegeven aan een gesimuleerde beller
* `training.assigned` — kreeg een securitytraining toegewezen
* `training.completed` — heeft een securitytraining afgerond
* `training.past.due` — heeft een trainingsdeadline gemist

Deze voorbeelden tonen de soorten genormaliseerde activiteit die Living Security kan gebruiken. Zie
[hoe integratiegegevens signalen worden](/nl/signals/data-sources).

<Note>
  **Adaptive simuleert via drie kanalen en Living Security beoordeelt elk kanaal afzonderlijk.**
  E-mailresultaten tellen mee als phishing, resultaten van sms-berichten als smishing en resultaten van telefoongesprekken als vishing. Iemand die op een gesimuleerde e-mail klikt en iemand die antwoordt op een gesimuleerd sms-bericht worden niet gemeten als hetzelfde gedrag, omdat de afweging die iemand daarbij maakt verschilt.
</Note>

## Wat Living Security nodig heeft

| Inloggegevens | Beschrijving |
| - | - |
| **API-token** | Een API-token van Adaptive Security. Living Security verstuurt dit bij elk verzoek als bearer-token. |

**Vereiste rol:** Een beheerder van uw Adaptive Security-account met toegang tot
**Settings → API**. Adaptive regelt API-toegang via rolgebaseerde machtigingen, dus het
token moet behoren bij een rol die gebruikers, phishing en training kan lezen.

**Toegang:** Alleen-lezen. Living Security leest alleen uit Adaptive Security en maakt, wijzigt of verwijdert nooit iets in uw account.

### Wat Living Security ophaalt

| Gegevens | Details |
| - | - |
| **Mensen** | Uw Adaptive-gebruikersmap: naam, e-mailadres, afdeling, functietitel, naam en e-mailadres van de leidinggevende, locatie, divisie, dienstverbandstatus en startdatum. |
| **E-mailsimulaties** | Per persoon per simulatie: wanneer het bericht is afgeleverd, geopend, aangeklikt, beantwoord, of de bijlage is geopend, de QR-code is gescand, inloggegevens zijn ingevoerd of het bericht is gemeld. |
| **Tekstsimulaties** | Per persoon per simulatie: afgeleverd, geopend, aangeklikt, beantwoord, inloggegevens ingevoerd of gemeld. |
| **Spraaksimulaties** | Per persoon per simulatie: het afgeleverde lokmiddel, het gebelde nummer, of de persoon gevolg heeft gegeven aan de beller en of hij of zij het heeft gemeld. |
| **Training** | Per persoon per campagne: wanneer de persoon is ingeschreven, wanneer de deadline was, wanneer de training is gestart, wanneer deze is afgerond en of de persoon het campagnebeleid heeft bevestigd. |

<Note>
  **Telefoonnummers worden niet opgeslagen.** Adaptive geeft kantoor- en mobiele nummers terug in het gebruikersrecord. Living Security verwijdert beide voordat er iets wordt opgeslagen, omdat geen enkele functie van Living Security ze gebruikt.
</Note>

<Note>
  **De eigen risicoscore van Adaptive wordt vastgelegd maar nooit gebruikt voor scoring.** Adaptive berekent per persoon een
  `current_risk_score`. Living Security bewaart deze zodat u beide
  systemen naast elkaar kunt vergelijken, maar de Menselijke risico-index wordt altijd berekend op basis van waargenomen
  gedrag met behulp van het eigen gepubliceerde model van Living Security — nooit op basis van de samengestelde score van een andere leverancier.
</Note>

### Vereisten

* Een Adaptive Security-account waarvoor de API is ingeschakeld.
* Beheerderstoegang tot [admin.adaptivesecurity.com](https://admin.adaptivesecurity.com).
* E-mailadressen van gebruikers in Adaptive die overeenkomen met de adressen die uw andere gekoppelde systemen
  gebruiken. Living Security koppelt een Adaptive-gebruiker via het e-mailadres aan een persoon.

***

## Deel A — In Adaptive Security

*Uw Adaptive Security-beheerder voert deze stappen uit.*

<Steps>
  <Step title="Open de API-instellingen">
    1. Meld u als beheerder aan bij [admin.adaptivesecurity.com](https://admin.adaptivesecurity.com).
    2. Ga naar **Settings → API**.
  </Step>

  <Step title="Genereer het API-token">
    1. Genereer een nieuw API-token.
    2. Geef het een naam die u later herkent — bijvoorbeeld `Living Security`.
    3. Controleer of de rol van het token gebruikers, phishingcampagnes en trainingscampagnes kan lezen.
    4. Kopieer het token.

    <Warning>
      Kopieer het token voordat u de pagina verlaat. Als uw Adaptive-account een vervaldatum voor het
      token instelt, noteer dan de datum — Living Security kan na het verlopen geen gegevens meer ophalen en
      de koppeling moet dan worden bijgewerkt met een nieuw token.
    </Warning>
  </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="Adaptive Security">
    | Veld | Waarde |
    | - | - |
    | **API-token** | Het token dat u in deel A hebt gegenereerd |
  </ConnectInPlatform>
</Steps>

U bent nu verbonden met Adaptive Security.

***

## Hoe vaak gegevens worden opgehaald

| Gegevens | Schema |
| - | - |
| Mensen | Elke 6 uur |
| Simulatieresultaten (e-mail, tekst, spraak) | Elke 6 uur |
| Trainingsresultaten | Elke 6 uur |

De rapportage-API van Adaptive biedt geen filter voor "wat is er gewijzigd sinds", dus Living Security
leest elke simulatie- en trainingscampagne zolang er nog resultaten uit voortkomen, en
stopt met lezen twee weken nadat de campagne is gesloten. Late klikken en late meldingen
worden zo nog steeds vastgelegd, en afgeronde campagnes worden niet eindeloos opnieuw gelezen.

<Note>
  Een eerste koppeling met een groot Adaptive-account kan meerdere geplande uitvoeringen nodig hebben om alles
  in te lezen. Elke uitvoering leest zoveel mogelijk en de volgende gaat verder waar de vorige
  is gestopt, waardoor de aantallen gedurende de eerste dag of twee oplopen in plaats van in één keer te verschijnen.
</Note>

***

## Probleemoplossing

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    Het API-token is onjuist, verlopen of ingetrokken. Adaptive geeft bij deze fout een lege response body
    terug, dus er zijn geen verdere details te lezen. Genereer een nieuw token via
    **Settings → API** en maak opnieuw verbinding met dat token. Een gedeeltelijk gekopieerd token veroorzaakt dezelfde
    fout en is de meest voorkomende oorzaak.
  </Accordion>

  <Accordion title="403 Forbidden">
    Het token is geauthenticeerd, maar de bijbehorende rol kan de gevraagde gegevens niet lezen. Hetzelfde
    token opnieuw plakken helpt niet. Controleer in Adaptive of de rol van het token leestoegang heeft tot gebruikers,
    phishing en training, of geef een token uit vanuit een rol die dat wel heeft.
  </Accordion>

  <Accordion title="429 Too Many Requests">
    Adaptive heeft de verbinding beperkt via een rate limit. Living Security stopt die uitvoering en hervat op dezelfde
    plek bij de volgende geplande uitvoering, dus er gaan geen gegevens verloren — de aantallen lopen alleen langzamer op. Als dit
    dagenlang aanhoudt, neem dan contact op met de support van Adaptive Security om te vragen naar de
    rate limit die voor uw account geldt.
  </Accordion>

  <Accordion title="Mensen verschijnen, maar er zijn geen simulatieresultaten">
    Controleer of de campagnes die u verwacht daadwerkelijk zijn uitgevoerd. Adaptive rapporteert inschrijvingen alleen
    voor simulaties die zijn verzonden, dus een campagne met de status **Draft** of **Scheduled**
    levert niets op totdat deze is verstuurd. Living Security leest die bewust niet, zodat
    het aantal verzoeken wordt besteed aan campagnes met daadwerkelijke resultaten.
  </Accordion>

  <Accordion title="Spraak- of tekstsimulaties ontbreken">
    Living Security bepaalt het kanaal van elk resultaat aan de hand van het bijbehorende scenario. Als een
    scenario in Adaptive is verwijderd nadat de simulatie is uitgevoerd, worden de resultaten
    vastgelegd onder het e-mailkanaal, omdat het kanaal niet meer kan worden gelezen. Dit voorkomt u door
    buiten gebruik gestelde scenario's in Adaptive te bewaren in plaats van ze te verwijderen.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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