Intégration JWT n8nAutomatiser JWT avec n8n.
Signer un token, le contrôler, le relire : trois gestes, un seul nœud. L'intégration JWT n8n couvre 3 opérations sur 1 ressource, avec la clé rangée dans un credential réutilisable. De quoi brancher n8n sur un service qui n'accepte que des tokens signés.
Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth
Que fait l'intégration JWT n8n, concrètement ?
JWT, pour JSON Web Token, le format décrit par la RFC 7519. Dans n8n, l'intégration JWT n8n tient dans un seul nœud, avec 3 opérations sur 1 ressource : fabriquer un token, le contrôler, ou lire ce qu'il contient. Tout se joue entre ce nœud et un credential JWT réutilisable, qui garde la clé et l'algorithme.
Le cas le plus fréquent d'abord. Un workflow planifié doit appeler un service qui n'accepte qu'une assertion signée. Sign a JWT construit le token au moment de l'appel : tu renseignes Expires In, la durée de vie en secondes, tu nommes le destinataire dans Audience, et le token part vers le nœud qui lance la requête.
Dans l'autre sens, un service tiers appelle ton Webhook n8n, l'URL que n8n expose pour qu'un système extérieur démarre un workflow. Le token voyage avec l'appel. Verify a JWT se place juste après, et le reste du flux, une ligne dans MySQL ou une alerte dans Slack, ne tourne que si le token tient.
Reste le cas ingrat, celui qui fait gagner une après-midi. Un token revient d'on ne sait où et personne ne sait ce qu'il transporte. Decode a JWT le transforme en JSON lisible, Return Additional Info y ajoute l'en-tête et la signature, et tu poses le résultat dans Google Sheets le temps de repérer le claim qui t'intéresse.
Ici, on tape rarement une valeur à la main. Elle vient d'une expression, la syntaxe {{ }} qui va chercher une donnée dans l'item entrant, sous la forme {{ $json.field }}. Un champ marqué requis bloque l'exécution du nœud tant qu'il reste vide : c'est le cas de Token sur Decode a JWT et sur Verify a JWT.
Le nœud couvre 3 opérations sur 1 ressource. Hors de ce catalogue, c'est le nœud HTTP Request qui prend le relais : il appelle n'importe quel endpoint de l'API d'un outil, en réutilisant le même credential via l'authentification prédéfinie. Si le choix de plateforme n'est pas encore tranché, l'Avis n8n fait le tour de la question, et la Formation n8n prend le relais quand toute une équipe doit monter ces workflows.
Comment configurer le credential JWT dans n8n ?
- 01
Créer le credential JWT
Dans n8n, ouvre le menu Credentials et crée un credential JWT. Un credential, c'est le coffre qui garde le secret : rempli une fois, il se retrouve dans la liste déroulante de chaque nœud qui en a besoin, sur ce workflow comme sur les suivants. Celui-ci ne sert d'ailleurs pas qu'au nœud JWT, le nœud Webhook accepte le même.
- 02
Choisir le Key Type
Deux types de clé sont proposés. Passphrase signe avec un secret et un algorithme HMAC : le credential demande alors le Secret. PEM Key vise le private key JWT avec un algorithme RSA ou ECDSA : tu colles une Private Key et une Public Key, obtenues en générant une paire de clés. Le bon choix est celui qui correspond à la clé dont tu disposes déjà.
- 03
Sélectionner l'Algorithm
Dernier champ : l'Algorithm utilisé pour signer l'assertion. Le credential accepte
HS256,HS384,HS512,RS256,RS384,RS512,ES256,ES384,ES512,PS256,PS384,PS512etnone. Enregistre, ouvre le nœud JWT, le credential apparaît dans sa liste.
Que sait faire le nœud JWT dans n8n ?
Le nœud JWT expose 3 opérations. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.
Decode a JWT
decodeCe que tu vois dans n8n
Notes & cas d'usage
Le nœud reçoit un token et renvoie son contenu en JSON, prêt pour le nœud suivant. Avec Return Additional Info activé, tu récupères le token décodé complet, avec les informations d'en-tête et de signature, au lieu du seul payload.
Paramètres clés
- Token : le token à vérifier ou décoder, champ requis, en général une expression qui pointe vers l'item entrant,
{{ $json.field }}. - Return Additional Info : désactivé, tu as le payload ; activé, l'en-tête et la signature viennent avec.
- Key ID : le claim d'en-tête optionnel
kid, qui indique la clé servant à valider la signature.
Sign a JWT
signCe que tu vois dans n8n
Notes & cas d'usage
Signer, c'est l'opération qui produit le token au lieu de le lire. Aucun champ n'est requis : tu remplis les claims utiles, un par un dans la collection Payload Claims et ses 12 champs, ou d'un bloc en JSON si un nœud précédent a préparé le payload.
Paramètres clés
- Use JSON to Build Payload : indique si les claims sont construits en JSON, l'objet allant dans Payload Claims (JSON).
- Expires In : la durée de vie du token en secondes,
3600en exemple. - Audience : identifie les destinataires auxquels le JWT est destiné.
Verify a JWT
verifyCe que tu vois dans n8n
Notes & cas d'usage
Le contrôle se joue ici. Le nœud passe le token à l'algorithme défini dans le credential, et les options décident du niveau d'exigence. Si Clock Tolerance existe, c'est bien parce que deux serveurs ne sont jamais à la même seconde.
Paramètres clés
- Token : requis ici aussi, et un champ requis vide arrête le nœud avant tout le reste.
- Ignore Expiration : indique si l'expiration du token est ignorée pendant le contrôle.
- Clock Tolerance : le nombre de secondes tolérées lors de la vérification des claims nbf et exp, pour absorber les petits écarts d'horloge entre serveurs.
Besoin d'aide pour automatiser JWT avec n8n ?
L'équipe te répond directement.
Chaque message est lu par une personne.