Configurer l'authentification JWT dans Drupal

Le module d'authentification de l'API Drupal utilise les jetons Web JSON (JWT) pour authentifier de manière sécurisée les requêtes API. Vos identifiants Drupal (nom d'utilisateur et mot de passe) sont d'abord vérifiés afin de générer un jeton JWT signé, qui est ensuite renvoyé au client. Ce jeton permet d'accéder aux API Drupal jusqu'à son expiration. JWT prend en charge les algorithmes HSA et RSA pour la signature et la validation. Ce module est entièrement compatible avec Drupal 8, Drupal 9, Drupal 10 et Drupal 11.

Cour de récréation Plans de tarification Organiser un RDV

Étapes de configuration

1. Configurer la méthode d'authentification JWT :

• Dans cette étape, nous allons configurer JWT comme méthode d'authentification API. Pour cela, accédez à Authentification API onglet du module (/admin/config/people/rest_api_authentication/auth_settings).
• Sous Configuration de base, activez le Activer l'authentification basculer.
• Entrer le Nom de l'application et sélectionnez JWT du Méthode d'authentification .

• Faites défiler jusqu'à la Configuration JWT section sur le même onglet.
• Dans le champ Attribut du nom d’utilisateur, saisissez le nom d’attribut du JWT reçu qui contient le nom d’utilisateur Drupal.
• Sélectionner Algorithme de signature de la liste déroulante.
• Facultatif : saisissez la durée d'expiration souhaitée (en minutes) sous Heure d'expiration du jeton.

Pour JWT externe :

• URI JWKS : Si vous souhaitez utiliser un jeton JWT externe, fournissez l'URI JWKS pour le valider dans Drupal.
• Certificat/Clé secrète : Fournissez un certificat si RS256 est sélectionné, ou une clé secrète si HS256 est sélectionné.

Générer des clés personnalisées :



Remarque : Vous pouvez saisir les clés manuellement ou les générer. Ces clés serviront à signer et à vérifier les jetons JWT.



• Clé privée: Saisissez la clé privée pour JWT ou générez une nouvelle clé.
• Clé publique: Saisissez la clé publique pour JWT ou générez une nouvelle clé.
• Cliquez sur Enregistrer la configuration .



• Vous avez configuré avec succès la méthode d’authentification JWT.


Remarque : Utilisez l’en-tête unique spécifique à l’application lors de l’authentification de l’API.




• Tout d'abord, nous devons effectuer un appel API pour obtenir un jeton JWT. Nous utiliserons ensuite ce jeton pour authentifier l'API Drupal afin de créer un utilisateur.
• Nous pouvons obtenir le JWT en envoyant une requête POST contenant le nom d'utilisateur et le mot de passe Drupal de l'utilisateur. Vous devez envoyer le nom d'utilisateur et le mot de passe au format base64. Vous pouvez vous référer au format de requête ci-dessous pour référence.

Demande : POST /rest_api/id_token En-tête : Accepter : application/json Autorisation : Encodé en base64 de base Format de requête CURL - curl --location --request POST ' /rest_api/id_token' \ --header 'Accepter : application/json' \ --header 'Type de contenu : application/json' \ --header 'Autorisation : encodage de base en base64 '

• Vous pouvez également vous référer à l'image de demande du facteur ci-dessous



• Une réponse réussie renvoie le JWT avec l'expiration de son jeton. (veuillez vous référer à l'image ci-dessous)




2. Exemple:

• Pour une meilleure compréhension, examinons un exemple d'utilisation du jeton JWT pour créer un utilisateur dans Drupal avec l'API REST.


Remarque : L’API /entity/user de Drupal est utilisée pour créer un nouvel utilisateur.



• Pour créer un utilisateur dans Drupal, vous devez effectuer une requête POST en utilisant le jeton JWT reçu ou le jeton JWT externe comme jeton porteur dans l'en-tête d'autorisation. Consultez l'exemple ci-dessous pour effectuer l'appel.

Format de requête HTML - Requête : POST /entity/user?_format=json En-tête : AUTH-METHOD : application_id Accepter : application/json Type de contenu : application/json Autorisation : Porteur received_JWT Corps : { "name": { "value": " " }, "mail": { "valeur": " " }, "pass": { "valeur": " " }, "status": { "value": "1" } } Format de requête CURL - curl --location --request POST ' /entity/user?_format=json' \ --header 'AUTH-METHOD: application_id' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --header 'Authorization: Authorization: Bearer ' \ --data-raw ' { "name": [ { "value": "Nom d'utilisateur" } ], "mail": [ { "value": "email" } ], "pass": [ { "value": "Mot de passe" } ], "status": [ { "value": "1" } ] }

• Vous pouvez également vous référer à l'image de demande du facteur ci-dessous





• Une réponse réussie renverra les détails de l'utilisateur que vous avez créé (voir l'image ci-dessous).




Félicitations ! Vous avez correctement configuré la méthode d'authentification JWT à l'aide du module d'authentification de l'API Drupal.

Si la configuration a échoué, veuillez nous contacter à l'adresse drupalsupport@xecurify.com . Merci d'inclure une capture d'écran de la fenêtre d'erreur ; nous vous aiderons à résoudre le problème et vous guiderons tout au long de l'installation.




 Merci pour votre réponse. Nous reviendrons vers vous bientôt.

Quelque chose s'est mal passé. Veuillez soumettre à nouveau votre requête

Nous vous contacterons dans les plus brefs délais !




Entrez votre e-mail*

Téléphone*

Détails supplémentaires*

Soumettre