Méthodes d'authentification
Les méthodes d'authentification centralisent les accès à un système tiers — identifiants, clés API, tokens, certificats — dans un espace chiffré et masqué. Un flux qui appelle ce système sélectionne la méthode correspondante, au lieu de saisir les secrets dans chaque nœud.
Comment ça s'articule
Une méthode d'authentification est créée une fois, puis réutilisée par les nœuds qui sollicitent un système tiers. Au moment de l'exécution, Ecosystem applique ce que la méthode décrit : encodage Basic, obtention et rafraîchissement d'un token OAuth 2, injection d'une clé API dans les en-têtes ou la requête, ou exécution d'un code personnalisé.
Elle s'articule avec deux autres espaces :
- les dictionnaires : les champs d'une méthode d'authentification acceptent les variables de dictionnaire (
{{dictionaries.nomDuDico.cleDuDico}}) pour adapter les secrets à l'environnement d'exécution sans dupliquer la méthode ; - les ressources et les Apps : la ressource porte la configuration du système appelé, la méthode d'authentification porte l'accès.
Quand utiliser quoi
| Besoin | Choix |
|---|---|
| Plusieurs nœuds partagent le même schéma d'authentification (Basic, OAuth 2, API Key, Custom) | Méthode d'authentification |
| Une valeur — secrète ou non — varie selon l'environnement (dev, staging, production) | Variable de dictionnaire |
| Une valeur masquée et chiffrée liée à un schéma d'auth géré par Ecosystem (rafraîchissement OAuth 2, encodage Basic) | Méthode d'authentification |
| Une simple clé à envoyer dans un en-tête ou un paramètre de requête | Variable de dictionnaire |
Ce qu'il faut savoir avant de commencer
- Les valeurs sont chiffrées et masquées. Une valeur masquée n'est pas affichée en clair dans l'interface ; pour la modifier, la re-saisir.
- Les tokens sont mis en cache. Quand la méthode porte une date d'expiration (OAuth 2, Custom), Ecosystem garde l'accès en mémoire et évite de régénérer un token à chaque exécution.
- Une méthode par système. Créez une méthode par système tiers, nommée de façon explicite (voir Gestion des méthodes d'authentification), plutôt qu'une méthode « fourre-tout ».
- Les champs acceptent les variables de dictionnaire. C'est le mécanisme pour variabiliser un secret par environnement sans dupliquer la méthode.
Aller plus loin
- Créer une méthode d'authentification — guide
- Types de méthodes d'authentification — référence
- Utiliser les méthodes d'authentification dans les flux — guide
- Gestion des méthodes d'authentification — bonnes pratiques