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

# Een integratie instellen

> Bereid de inloggegevens van de provider voor, verbind een ondersteund systeem, schakel de bijbehorende gegevensstreams in en controleer of de eerste synchronisatie is geslaagd.

Deze handleiding beschrijft het gangbare installatietraject voor integraties die worden vermeld onder **instellingen → Integraties → Catalogus**. Providerspecifieke velden, machtigingen en authenticatiestappen staan in de installatiehandleiding waarnaar de Catalogus-kaart van de betreffende provider verwijst.

## Vereisten

| Rol | Verantwoordelijkheid |
| - | - |
| [**Programma-eigenaar**](/nl/reference/glossary#programma-eigenaar) | Selecteert de bron, verbindt deze in Living Security, schakelt streams in en controleert het resultaat |
| [**Systeembeheerder**](/nl/reference/glossary#systeembeheerder) | Maakt inloggegevens en scopes aan in het bronsysteem of keurt deze goed |

Deze rollen kunnen door dezelfde persoon worden vervuld. De persoon die de inloggegevens in Living Security invoert, moet een beheerdersrol hebben die het beheren van integraties toestaat. Nodig een beheerder van het bronsysteem niet uitsluitend uit voor Living Security in de veronderstelling dat er een beperkte installatierol bestaat.

Voordat u begint:

* Kies de Living Security-organisatie en -omgeving waartoe de verbinding behoort.
* Open de Catalogus-handleiding van de provider en verzamel de vereiste scopes, redirect-URL's en allowlist-vereisten.
* Gebruik het door uw organisatie goedgekeurde proces voor het delen van geheimen als verschillende personen de inloggegevens aanmaken en invoeren.
* Verstuur nooit wachtwoorden, client secrets, privésleutels of toegangssleutelwaarden per e-mail of via een supportticket.

## 1. Inloggegevens van de provider voorbereiden

Open **instellingen → Integraties → Catalogus**, zoek de provider op en lees de installatiehandleiding voordat u inloggegevens aanmaakt.

Providerauthenticatie kan gebruikmaken van OAuth-toestemming, een API-token, een client-ID met secret, een serviceaccount of een andere door de provider ondersteunde methode. Maak alleen de inloggegevens en scopes aan die in de handleiding van die provider worden genoemd.

<Warning>
  Kopieer geen machtigingen van een andere provider en verleen geen ruime
  schrijftoegang “voor de zekerheid”. Ontbrekende machtigingen leiden
  doorgaans tot een duidelijke 401- of 403-foutmelding die kan worden
  verholpen; te ruime machtigingen veroorzaken vermijdbare risico’s.
</Warning>

## 2. De provider verbinden

<Steps>
  <Step title="De Catalogus openen">
    Ga naar **instellingen → Integraties → Catalogus** en selecteer de provider.
  </Step>

  <Step title="De verbinding starten">
    Selecteer **verbinden**. Doorloop de OAuth-flow of vul de velden in waarom
    het verbindingsdialoogvenster vraagt. De handleiding van de provider legt uit
    waar elke waarde vandaan komt.
  </Step>

  <Step title="De authenticatie afronden">
    Keur indien van toepassing het toestemmingsscherm van de provider goed. Nadat de authenticatie is geslaagd, opent Living Security de nieuwe verbinding of toont deze onder **verbonden**.
  </Step>
</Steps>

Als de provider de authenticatie weigert, stop dan en corrigeer de inloggegevens, tenant, regio, redirect-URL of machtigingen in het bronsysteem voordat u verdergaat.

## 3. Gegevensstreams inschakelen

Open de verbinding onder **instellingen → Integraties → verbonden**. Living Security detecteert de synchronisatiesjablonen die voor die provider beschikbaar zijn en toont deze als streams.

1. Controleer de naam en het doel van elke stream.
2. Schakel alleen de streams in die uw programma nodig heeft.
3. Laat niet-relevante streams gepauzeerd.
4. Gebruik **Nu synchroniseren**, indien beschikbaar, om de eerste run aan te vragen.

Niet elke provider biedt dezelfde streams of planningsopties. Volg de besturingselementen die bij de verbinding worden weergegeven en ga er niet van uit dat er een universele wizard bestaat voor frequentie, scope, veldtoewijzing, concepten of activering.

## 4. De eerste run controleren

Alleen een geslaagde authenticatie van de verbinding bewijst niet dat er gegevens binnenkomen.

<Steps>
  <Step title="De status van de verbinding controleren">
    Controleer of de verbinding in orde is en geen nieuwe autorisatie vraagt.
  </Step>

  <Step title="De status van de stream controleren">
    Controleer of de vereiste stream is ingeschakeld en niet gepauzeerd is.
  </Step>

  <Step title="De laatste run bekijken">
    Open de stream, de synchronisatielink van de verbinding of **instellingen** → **Integraties** → **Synchronisaties**. Wacht op een succesvol eindresultaat en controleer providerfouten en recordaantallen, indien beschikbaar.
  </Step>

  <Step title="Downstream-gegevens bevestigen">
    Open het relevante onderdeel van Living Security. Identiteitsgegevens moeten de verwachte personen en identiteiten opleveren in Personeelsbestand; gegevens uit beveiligingsbronnen moeten verschijnen in de functie die door die provider wordt beschreven.
  </Step>
</Steps>

Tijdens de onboarding worden de taken **Controleer of identiteitsgegevens binnenkomen** en **Controleer of integratiegegevens binnenkomen** van de Journey Map voltooid op basis van opgenomen gegevens. Vervang deze verificatieresultaten niet door een opgeslagen verbinding.

## Detailpagina van een synchronisatie

Open onder **instellingen** → **Integraties** → **Synchronisaties** een willekeurige synchronisatie om de configuratie en de runhistorie op één plek te bekijken.

De detailpagina toont het volgende:

| Sectie | Wat deze bevat |
| - | - |
| **Koptekst** | Naam van de synchronisatie, statusbadge en integratieprovider |
| **Statistieken** | Model, laatste synchronisatie, voltooide runs en totaal aantal records |
| **Runhistorie** | Recente runs met status, timing en recordaantallen |
| **Acties** | **Vernieuwen**, **Pauze** / **CV** en **Nu synchroniseren** |

Gebruik **Nu synchroniseren** om direct een run te starten wanneer de synchronisatie actief is. Gepauzeerde synchronisaties moeten worden hervat voordat nieuwe geplande of handmatige runs starten.

U kunt een synchronisatie ook openen vanaf de detailpagina van de verbinding wanneer de integratie actieve streams vermeldt.

## Verbindingsbewerkingen

De detailpagina van de verbinding biedt de bewerkingen die door die integratie worden ondersteund:

| Bewerking | Effect |
| - | - |
| **Nu synchroniseren** | Vraagt een directe run aan voor de geselecteerde stream |
| **Pauzeer stream** | Stopt nieuwe runs voor die stream en behoudt de verbinding |
| **Pauzeer verbinding** | Stopt ondersteunde verbindingsactiviteit zonder de configuratie te verwijderen |
| **CV** | Start een gepauzeerde stream of verbinding opnieuw |
| **Opnieuw autoriseren** | Herhaalt de authenticatie nadat inloggegevens of toestemming zijn gewijzigd |
| **Verwijderen** | Verwijdert de verbindingsconfiguratie na bevestiging |

Het verwijderen van een verbinding is niet hetzelfde als het verwijderen van gegevens die al via die verbinding zijn opgenomen. Raadpleeg de handleiding van de provider of neem contact op met Support als het gedrag rond gegevensbewaring van invloed is op uw beslissing.

## Aangepaste pushbronnen

Gebruik **Aangepaste pushbron** wanneer een systeem gegevens naar Living Security verstuurt in plaats van via een Catalogus-connector te worden uitgevraagd.

1. Maak de bron aan onderaan de **Catalogus**.
2. Open de detailpagina onder het gedeelte voor aangepaste pushbronnen.
3. Selecteer de doelstream.
4. Gebruik **CSV uploaden** voor een handmatige batch of **Pushen via API** voor een geautomatiseerde afzender.
5. Bekijk na het verzenden een voorbeeld van het bestand of de payload en controleer de runhistorie van de bron.

Zie [Custom Push Source API](/nl/integrations/custom-push-source) voor het volledige contract voor endpoint, authenticatie, payload, nieuwe pogingen en verificatie. Leid deze details niet af uit een oudere integratiehandleiding voor Unify.

De uploader op de bron-detailpagina accepteert een CSV-bronbestand van maximaal 100 MB. Voordat het bestand wordt geüpload, splitst het Dashboard het aan de clientzijde op in verzoeken van elk maximaal 10 MB en 10.000 rijen. Deze bronspecifieke uploader staat los van de algemene pagina **Integraties → uploaden** voor identiteits- en activiteitssjablonen.

## Probleemoplossing

| Symptoom | Controleer |
| - | - |
| `401 Unauthorized` | Waarde, vervaldatum en intrekking van de inloggegevens, providertenant en status van de autorisatie |
| `403 Forbidden` | Vereiste providerrol, scopes, beheerderstoestemming en toegangsbeleid van het bronsysteem |
| Verbinding mislukt onmiddellijk | Redirect-URL, regio, bron-URL, vereisten voor netwerk- of IP-allowlist |
| Verbinding is in orde, maar er zijn geen runs | De vereiste stream is ingeschakeld en de provider biedt die stream aan |
| Geslaagde run levert geen records op | Het bronaccount kan de verwachte populatie zien en eventuele filters aan de providerzijde zijn correct |
| Gegevens verschijnen bij de verkeerde persoon | Identiteitskenmerken en aliassen zijn consistent in alle verbonden bronnen |
| Gegevens worden niet meer bijgewerkt | Stream of verbinding is gepauzeerd, inloggegevens zijn verlopen of de laatste run is mislukt |

Vermeld bij contact met [Living Security Support](mailto:support@livingsecurity.com) de organisatie, provider, verbindingsnaam, stream, tijdstip van de laatste run en de zichtbare foutmelding. Voeg geen geheimen toe.

## Gerelateerd

<CardGroup cols={2}>
  <Card title="Overzicht van integraties" icon="grid-2" href="/nl/integrations/overview">
    Naslag voor verbonden, Catalogus, Synchronisaties, Acties en uploaden.
  </Card>

  <Card title="Gegevenstoewijzing" icon="arrows-left-right" href="/nl/integrations/managing/data-mapping">
    Lees meer over ondersteunde kenmerken en toewijzingen waar beschikbaar.
  </Card>

  <Card title="Levenscyclus van integraties" icon="route" href="/nl/integrations/managing/lifecycle">
    Beheer een bestaande integratie, inclusief opnieuw autoriseren of verwijderen.
  </Card>

  <Card title="Onboarding voor beheerders" icon="circle-check" href="/nl/getting-started/onboarding">
    Voltooi de verificatietaken voor identiteits- en beveiligingsgegevens.
  </Card>
</CardGroup>


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