Connecter une intégration
Connecter une intégration relie votre compte d'un service extérieur — comme Slack ou GitHub — à votre application Kliv, pour que votre application puisse travailler avec. Vous le faites vous-même depuis les paramètres de Kliv ; une fois la connexion établie, Kliv garde les identifiants en sécurité et votre application peut commencer à l'utiliser.
Cette page décrit le parcours de connexion et ce que Kliv stocke pour vous.
Le parcours de connexion
- Allez dans Paramètres → Intégrations.
- Choisissez l'intégration voulue dans le catalogue.
- Choisissez Connecter. La suite dépend du service :
- Se connecter au service. La plupart des intégrations (Slack, Notion, HubSpot, et d'autres) vous envoient vers ce service pour vous identifier et approuver l'accès, puis vous ramènent dans Kliv. Vous autorisez Kliv à agir en votre nom — vous ne copiez aucune clé vous-même.
- Installer une application. Certaines, comme GitHub, vous demandent d'installer l'application de Kliv dans votre compte ou votre organisation et de choisir ce qu'elle peut atteindre.
- Coller une clé. Quelques services se connectent en collant une clé d'accès récupérée dans les paramètres du service. Kliv la stocke pour vous dans le coffre-fort.
- À votre retour dans Kliv, l'intégration apparaît comme connectée et prête à l'emploi.
Vous pouvez connecter plusieurs comptes pour un même service — par exemple deux espaces de travail Slack — et choisir lequel une partie donnée de votre application utilise.
Ce que Kliv stocke pour vous
Quand vous vous connectez, Kliv enregistre les identifiants de ce service dans un coffre-fort sécurisé. Quelques points à connaître :
- Les identifiants vivent dans le coffre-fort de Kliv, jamais dans le code de votre application. Les visiteurs de votre application ne peuvent pas les voir, et vous n'avez jamais à gérer de jetons vous-même.
- Kliv fournit l'identifiant en coulisses. Quand votre application fait un appel, Kliv attache le bon identifiant côté serveur. Le code de votre application décrit seulement quoi faire, jamais comment s'authentifier.
- Certaines connexions se renouvellent automatiquement. Pour les services dont l'accès expire, Kliv le renouvelle pour vous. Si un service révoque l'accès — par exemple si vous avez retiré l'application de Kliv de son côté — l'intégration vous demandera de vous reconnecter.
Gérer ou déconnecter
Depuis la même zone Intégrations, vous pouvez examiner une intégration connectée, définir qui a le droit de l'utiliser, configurer des déclencheurs d'événements, ou la déconnecter. La déconnexion supprime les identifiants stockés et empêche votre application d'utiliser ce service.
Si quelque chose ne va pas
- « Non connectée » — l'intégration n'a pas encore été connectée, ou son accès a été retiré. Connectez-la (ou reconnectez-la) depuis Paramètres → Intégrations.
- « Reconnexion requise » — le service extérieur a révoqué l'accès de Kliv. Ouvrez l'intégration et connectez-la à nouveau.
- Plusieurs connexions — si votre application a plusieurs comptes connectés pour le même service, vous devrez peut-être lui indiquer lequel utiliser — la page de chaque connexion affiche un sélecteur de connexion, une courte étiquette que votre application utilise pour choisir entre elles.
Voir aussi
- Ce que vous pouvez connecter — les intégrations disponibles et ce qu'elles débloquent.
- Contrôler qui peut utiliser un connecteur — définir l'accès action par action.
- Réagir aux événements d'un fournisseur — répondre aux événements d'un service connecté.