Configurer l'authentification de base dans Drupal
L'authentification de base est une méthode d'authentification simple et directe. Dans cette approche, le client envoie des requêtes HTTP avec un en-tête d'autorisation contenant le nom d'utilisateur et le mot de passe du site Drupal, codés au format Base64. Avec l'authentification de base, Authentification API Drupal le module vérifie les informations d'identification de l'utilisateur par rapport à son nom d'utilisateur et son mot de passe Drupal. L'utilisateur sera autorisé à effectuer l'opération demandée uniquement si l'authentification est réussie. Ce module est entièrement compatible avec Drupal 8, Drupal 9, Drupal 10 et Drupal 11.
- Utiliser le compositeur
- Utiliser Drush
- Installation manuelle
Conditions préalables:
- Interface utilisateur REST: Ce module fournit une interface conviviale pour configurer le module REST.
- Activez les modules de services Web suivants à partir du étendre section (/admin/modules) de votre site Drupal :
- JSON : API
- Interface utilisateur REST
- Services Web RESTful
- La sérialisation
Activer l'API et attribuer des méthodes :
- La première étape consiste à activer l'API et à lui attribuer les méthodes et opérations autorisées. Pour ce faire, utilisez l'option Interface utilisateur REST module, ou en modifiant directement la configuration Drupal.
- Cliquez sur le Activer l'API .
- Pour activer l'API à l'aide du module REST UI, cliquez sur le Configurez bouton (comme indiqué ci-dessous).
- Dans notre exemple, nous devons activer le /entité/utilisateur API. Pour ce faire, cliquez sur l'option Activer devant.
- Puisque notre objectif est de créer un utilisateur dans Drupal, sélectionnez les configurations suivantes :
- Préparation: POSTEZ
- Format: JSON
- Fournisseur d'authentification : authentification_rest_api
- Cela permet au module d'authentification de l'API miniOrange d'authentifier l'API. Cliquez sur le Enregistrer la configuration pour continuer.
Étapes de configuration
1. Configurer la méthode d’authentification de base :
- Dans cette étape, nous allons configurer l'authentification de base 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 cliquez sur le Enregistrer la configuration .
- Faites défiler jusqu'à la Méthode d'authentification section sur le même onglet et sélectionnez L'authentification de base méthode.
- Vous avez configuré avec succès la méthode d’authentification de base.
Note: Utilisez l’en-tête unique spécifique à l’application lors de l’authentification de l’API.
Accorder des autorisations de rôle pour créer des utilisateurs
- Si nécessaire, vous pouvez autoriser les rôles Drupal non administrateurs à créer des utilisateurs. Pour cela, attribuez l'autorisation « Administrer les utilisateurs » aux rôles souhaités depuis la page « Autorisations » (/admin/people/permissions) de votre site Drupal.
2. Exemple:
- Pour une meilleure compréhension, examinons un exemple d’utilisation de l’authentification de base pour créer un utilisateur dans Drupal avec l’API REST.
- Pour créer un utilisateur dans Drupal, vous devez effectuer une requête POST avec le nom d'utilisateur et le mot de passe Drupal. Ces derniers doivent être encodés au format Base64. Consultez l'exemple ci-dessous pour effectuer cet appel.
Note: L'API /entity/user dans Drupal est utilisée pour créer un nouvel utilisateur.
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 : codé en base64 de base Corps : { "nom" : { "valeur" : " " }, "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: Basic base64encoded ' \ --data-raw ' { "name": [ { "value": "Nom d'utilisateur" } ], "mail": [ { "value": "email" } ], "pass": [ { "value": "Mot de passe" } ], "status": [ { "value": "1" } ] }
- 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é l'authentification de base avec le module d'authentification de l'API Drupal.
Si la configuration n'a pas réussi, veuillez nous contacter à [email protected]Veuillez inclure une capture d'écran de la fenêtre d'erreur et nous vous aiderons à résoudre le problème et vous guiderons tout au long de la configuration.
