Gestion des méthodes d'authentification
Les méthodes d'authentification évitent de répéter les accès à un système tiers dans chaque nœud : le schéma d'authentification est centralisé, chiffré et masqué, et Ecosystem applique l'accès à l'exécution. C'est l'arbitrage de référence pour savoir où va un secret. Pour créer et configurer des méthodes, voir Méthodes d'authentification.
Pourquoi centraliser
- Centralisation : les accès sont paramétrés à un seul endroit.
- Performance : avec une date d'expiration (OAuth 2, Custom), Ecosystem garde les tokens en mémoire et gère leur rafraîchissement — au lieu de générer un token à chaque exécution.
- Sécurité : les secrets sont stockés de manière chiffrée et masquée.
- Maintenance : on modifie une fois, tous les flux qui utilisent la méthode sont mis à jour.
Comment ça s'articule
- Une méthode par système —
oauth-salesforce,basic-erp,api-stripeplutôt qu'une méthode « fourre-tout » : les traces et la rotation des secrets n'en sont que plus lisibles. - Le nommage reflète le système :
[type]-[système]-[environnement](ex.oauth-salesforce-prod) si des environnements distincts partagent le même système. - Ce qu'Ecosystem applique, selon le type :
| Type | Ce qu'Ecosystem fait |
|---|---|
| Basic Auth | Ajoute Authorization: Basic xxx |
| OAuth 2 | Gère le token, le rafraîchit, ajoute Authorization: Bearer xxx |
| Custom | Applique votre configuration personnalisée |
Méthodes d'authentification vs dictionnaires
Les deux espaces peuvent contenir des secrets. La différence ne porte pas sur « secret → méthode d'authentification, configuration → dictionnaire », mais sur ce que l'on centralise :
| Espace | Rôle principal | Secrets ? |
|---|---|---|
| Méthodes d'authentification | Centraliser un schéma d'authentification (Basic, OAuth 2, API Key, Custom) chiffré et masqué, réutilisé par plusieurs nœuds. | ✅ Valeurs chiffrées et masquées. Les champs peuvent référencer {{dictionaries.nomDuDico.cleDuDico}}. |
| Dictionnaires | Centraliser des variables par environnement (URLs, timeouts, mais aussi clés et tokens), masquables dans l'interface. | ✅ Valeurs masquables, réutilisables dans les champs des nœuds et des méthodes d'authentification. |
Ce qui va dans une méthode d'authentification :
- un schéma d'auth utilisé par plusieurs nœuds (Basic Auth, OAuth 2, API Key, Custom) ;
- un secret associé à un mécanisme d'auth géré par Ecosystem (rafraîchissement OAuth 2, encodage Basic) ;
- les certificats, clés privées et passphrases liés à une connexion.
Ce qui va dans un dictionnaire :
- une valeur qui varie selon l'environnement (dev, staging, production) ;
- une valeur réutilisée dans plusieurs champs (URL, en-têtes, paramètres, champs d'une méthode d'authentification) ;
- un secret à masquer dans l'interface (
{{dictionaries.nomDuDico.cleDuDico}}).
Un secret se stocke soit dans une méthode d'authentification (si un schéma d'auth est centralisé), soit dans un dictionnaire masqué. Dans les deux cas, ne le saisissez jamais en clair dans un nœud. Rien n'oblige à choisir : une méthode d'authentification centralise le schéma d'auth, et les secrets qu'elle utilise vivent dans un dictionnaire masqué — le flux n'est alors jamais modifié quand un secret tourne.
Variabiliser les secrets par environnement
Les champs d'une méthode d'authentification acceptent les variables de dictionnaire : au lieu d'une valeur fixe, renseignez {{dictionaries.nomDuDico.cleDuDico}} pour que chaque environnement utilise son propre secret sans dupliquer la méthode.
| Champ de la méthode | Valeur saisie |
|---|---|
| Identifiant client | {{dictionaries.oauth.clientId}} |
| Secret client | {{dictionaries.oauth.clientSecret}} |
| URL du jeton | {{dictionaries.oauth.tokenUrl}} |
Ce qu'il faut savoir avant de commencer
- Rotation des secrets — créez les nouveaux secrets dans le système tiers, mettez à jour la méthode (ou le dictionnaire) dans Ecosystem, testez en DEV : les flux utilisent automatiquement les nouveaux secrets, sans modification du flux.
- Ne jamais saisir un secret en clair dans un nœud ni dans un flux versionné. Laissez vide un champ secret d'une méthode d'authentification pour qu'Ecosystem utilise la variable de dictionnaire correspondante.
- Paramétrez les URLs en variables de dictionnaire (
{{dictionaries.nomDuDico.cleDuDico}}) pour dynamiser les valeurs selon l'environnement — voir Dictionnaires.
- Les méthodes d'authentification sont configurées pour tous les environnements
- Les noms sont explicites et cohérents
- Les secrets référencés par les méthodes sont renseignés dans les dictionnaires (valeurs masquées) ou dans la méthode elle-même
- Les tests en DEV valident l'authentification
Aller plus loin
- Créer une méthode d'authentification
- Types de méthodes d'authentification
- Utiliser dans les flux
- Gestion des dictionnaires
Voir aussi : Méthodes d'authentification