Een integratie verbinden
Wanneer u een integratie verbindt, koppelt u uw account bij een externe service, zoals Slack of GitHub, aan uw Kliv-app, zodat uw app ermee kan werken. Dat doet u zelf via de instellingen van Kliv. Zodra de verbinding er is, bewaart Kliv de inloggegevens veilig en kan uw app de service gebruiken.
Deze pagina beschrijft hoe het verbinden werkt en wat Kliv voor u opslaat.
Zo verbindt u een integratie
- Ga naar Instellingen → Integraties.
- Kies de gewenste integratie in de catalogus.
- Kies Verbinden. Wat er daarna gebeurt, hangt af van de service:
- Inloggen bij de service. De meeste integraties (Slack, Notion, HubSpot en andere) sturen u naar de betreffende service om in te loggen en toegang goed te keuren, en brengen u daarna terug naar Kliv. U geeft Kliv toestemming om namens u te handelen; u kopieert zelf geen sleutels.
- Een app installeren. Bij sommige integraties, zoals GitHub, installeert u de app van Kliv in uw account of organisatie en kiest u waartoe die toegang heeft.
- Een sleutel plakken. Een paar services verbindt u door een toegangssleutel uit de instellingen van die service te plakken. Kliv slaat die voor u op in de kluis.
- Zodra u terug bent in Kliv, staat de integratie als verbonden aangegeven en is deze klaar voor gebruik.
U kunt meer dan één account voor dezelfde service verbinden, bijvoorbeeld twee Slack-werkruimten, en kiezen welke u voor een bepaald onderdeel van uw app gebruikt.
Wat Kliv voor u opslaat
Wanneer u verbindt, bewaart Kliv de inloggegevens voor die service in een beveiligde kluis. Goed om te weten:
- De inloggegevens staan in de kluis van Kliv, nooit in de code van uw app. Bezoekers van uw app kunnen ze niet zien en u hoeft zelf geen tokens te beheren.
- Kliv levert de inloggegevens op de achtergrond. Wanneer uw app een aanroep doet, voegt Kliv aan de serverkant de juiste inloggegevens toe. De code van uw app beschrijft alleen wat er moet gebeuren, nooit hoe u zich authenticeert.
- Sommige verbindingen worden automatisch vernieuwd. Bij services waarvan de toegang verloopt, vernieuwt Kliv die voor u. Als een service de toegang ooit intrekt, bijvoorbeeld omdat u de app van Kliv aan hun kant hebt verwijderd, vraagt de integratie u om opnieuw te verbinden.
Beheren of loskoppelen
In hetzelfde onderdeel Integraties kunt u een verbonden integratie bekijken, instellen wie ermee mag werken, gebeurtenistriggers instellen of de verbinding verbreken. Als u de verbinding verbreekt, worden de opgeslagen inloggegevens verwijderd en kan uw app de service niet meer gebruiken.
Als er iets misgaat
- "Niet verbonden": de integratie is nog niet verbonden, of de toegang is ingetrokken. Verbind de integratie (opnieuw) via Instellingen → Integraties.
- "Opnieuw verbinden vereist": de externe service heeft de toegang van Kliv ingetrokken. Open de integratie en verbind opnieuw.
- Meer dan één verbinding: als er voor dezelfde service meerdere accounts aan uw app zijn gekoppeld, moet u mogelijk opgeven welke u wilt gebruiken. Op de pagina van elke verbinding staat een verbindingskeuze, een kort label waarmee uw app tussen de verbindingen kiest.
Gerelateerd
- Wat u kunt verbinden: de beschikbare integraties en wat ze mogelijk maken.
- Bepalen wie een connector mag gebruiken: stel de toegang per actie in.
- Reageren op gebeurtenissen van een provider: reageer op gebeurtenissen uit een verbonden service.