Intégrations
Qui la voit
Section intitulée « Qui la voit »Intégrations est proposée à un membre dont le rôle peut gérer les rôles et les paramètres de l’organisation. La même permission porte Notifications et Paramètres.
Où c’est
Section intitulée « Où c’est »Sous Compte dans le menu. Les anciennes adresses Clés API et Webhooks répondent toujours et ouvrent cette page, puisque les trois sujets vivent maintenant dessus.
À quoi ça sert
Section intitulée « À quoi ça sert »La page l’énonce en une ligne : comment un autre système parle à cette organisation.
Il y a deux directions, et les onglets les séparent. Une clé va vers l’extérieur : l’autre système nous appelle avec elle. Un webhook vient de l’intérieur : nous appelons l’autre système. On les met en place ensemble et on les dépanne ensemble, c’est pourquoi ils partagent une page.
Clés API
Section intitulée « Clés API »
123- 1Avec une clé, un autre système nous appelle. Avec un webhook, nous appelons un autre système. Un compte de service est un membre machine.
- 2Délivre une clé. Elle est affichée une fois et ne peut pas être relue ensuite.
- 3Chaque clé, et sa dernière utilisation — ce qui te dit si elle sert encore.
Create API Key demande un nom et délivre la clé.
La clé est affichée une seule fois, et le panneau le dit : copie cette clé maintenant, tu ne pourras plus la revoir. Il n’y a aucun moyen de la relire ensuite. Si tu la perds, révoque-la et fais-en une autre.
Le tableau liste chaque clé avec Name, Key, Last Used et Created. Last Used est ce qui te dit si une clé sert encore.
Une clé délivrée ici porte autorité sur les webhooks autant que sur les clients et la vérification. Une seule clé, pas une par onglet. Traite-la en conséquence, et donne à chaque système sa propre clé pour qu’en révoquer une n’arrête pas les autres.
Webhooks
Section intitulée « Webhooks »Un webhook nous permet d’appeler un autre système quand quelque chose se passe, par exemple un client activé, suspendu ou révoqué.
Ajouter un webhook demande une URL du point d’accès et les Évènements que tu veux. À la création, une clé de signature est affichée, une seule fois, avec le même avertissement qu’une clé. Cette clé est ce que ton serveur utilise pour confirmer que l’appel vient bien de nous.
Chaque webhook affiche son dernier succès, combien d’échecs il a eus, et s’il est Actif, En pause ou Désactivé.
Envoyer un test appelle ton point d’accès maintenant et rapporte ce qui revient, sous forme de code de statut. Utilise-le quand le point d’accès a changé, plutôt que d’attendre qu’un vrai évènement te le dise.
Comptes de service
Section intitulée « Comptes de service »Un compte de service est un membre machine de cette organisation. Il exécute le client de bureau sur un serveur et vérifie des codes sans personne. Il n’a pas de boîte aux lettres et reste invisible pour les autres membres d’une connexion.
En créer un demande un nom et renvoie son secret de code d’identité. Affiché une seule fois, comme tout le reste ici.
Chaque compte de service indique combien de connexions il détient, et porte sa propre liste de clés API, avec Nouvelle clé et Révoquer.
La raison d’en utiliser un plutôt que le compte d’un collègue : une vérification automatisée qui tourne sur un serveur ne devrait pas cesser de fonctionner quand une personne part, et ne devrait pas être visible par les gens de l’autre côté d’une connexion.
Révoquer
Section intitulée « Révoquer »Chaque clé, chaque webhook et chaque compte de service peut être retiré ici. Révoquer une clé arrête immédiatement le système qui l’utilise, vérifie donc ce qui la détient avant de le faire.