Een integratie instellen

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

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.

​

2. De provider verbinden

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

Vermeld bij contact met Living Security Support de organisatie, provider, verbindingsnaam, stream, tijdstip van de laatste run en de zichtbare foutmelding. Voeg geen geheimen toe.

​

Gerelateerd