L'intégration SSO Drupal OAuth 2.0 / OpenID Connect (OIDC) permet le SSO entre le site Drupal et n'importe quel fournisseur d'identité. Cette intégration est réalisée par le Client OAuth miniOrange module compatible avec Drupal 7, Drupal 8, Drupal 9 ainsi que Drupal 10.

Le module permet à un fournisseur de connexion OpenID Connect externe d'authentifier et de connecter les utilisateurs au site Drupal. Découvrez les étapes d'intégration avec certains fournisseurs OAuth/OpenID populaires comme Azure AD, Azure AD B2C, Keycloak, Okta, Salesforce, Active Directory Federation Services (AD FS), AWS Cognito, Auth0, Microsoft Office 365, Github, Gitlab, OneLogin, Ping Identity, FusionAuth, WSO2 Identity Server, Bitbucket, Fitbit, Gluu, Onelogin, WildApricot, WHMCS, ForgeRock Identity Platform et beaucoup plus.

Le module est également compatible avec les fournisseurs de connexion sociale tels que Google, Discord, Slack, LinkedIn, Facebook, Instagram, Apple, Amazon, Yahoo, Pinterest, Snapchat et Twitter (X).
Dans ce document, nous passerons en revue les étapes pour configurer le module :

Configurez Drupal en tant que client OAuth :

• Après avoir installé le module, allez dans le configuration onglet et cliquez sur le Configuration du client miniOrange OAuth -> Configurer OAuth et sélectionnez l'application dans l'onglet Sélectionnez une application la liste déroulante.

  Notes: Si le fournisseur OAuth souhaité n'est pas répertorié dans la liste déroulante, veuillez sélectionner OAuth personnalisé/Fournisseur OAuth personnalisé/Fournisseur OpenID personnalisé et continuer.

• Copiez le URL de rappel/redirection et gardez-le à portée de main. Cela sera requis lors de la configuration du fournisseur d’identité.

  Notes:- Si votre fournisseur ne prend en charge que HTTPS URL de rappel/redirection et vous disposez d'un site HTTP, assurez-vous d'activer le 'Appliquer l'URL de rappel HTTPS' en bas de l'onglet.

• Entrez le nom dans le Nom de l'application personnalisée champ de texte. Par exemple, OAuth générique

Intégration de Drupal avec le fournisseur d'identité :

• Configurez l'URL de rappel/de redirection dans votre IdP et suivez les étapes suivantes.
• Ajoutez les détails ci-dessous sur le site Drupal (vous les obtiendrez tous auprès du fournisseur d'identité.)

  identité du client	Identifiant unique de l'application client OAuth 2.
  Secret client	Informations confidentielles utilisées pour authentifier le client.
  Domaine	L'étendue de l'accès que le client demande à l'utilisateur et au serveur d'autorisation.
  Autoriser le point de terminaison :	URL où l'utilisateur est authentifié et accorde des autorisations au client.
  Point de terminaison du jeton d’accès :	URL où le client échange le code d'autorisation contre un jeton d'accès.
  Obtenir le point de terminaison des informations utilisateur :	URL facultative pour récupérer les informations utilisateur


• La case à cocher « Envoyer l'ID client et le secret dans l'en-tête ou le corps » vous permet de spécifier si l'ID client et le secret doivent être inclus dans l'en-tête ou dans le corps de la demande de point de terminaison de jeton. Si vous ne savez pas quelle option sélectionner, vous pouvez vous en tenir aux paramètres par défaut.
• Cliquez sur la case à cocher pour Activer la connexion avec OAuth, faites défiler vers le bas et cliquez sur l'icône Enregistrer la configuration .

Testez la connexion entre Drupal et le fournisseur d'identité :

• Cliquez sur le Effectuer une configuration de test .

• Dans une fenêtre contextuelle de configuration de test, si vous n'avez pas de session active sur IdP sur le même navigateur, vous serez invité à vous connecter au fournisseur d'identité (IdP). Une fois connecté avec succès, vous recevrez une liste d'attributs récupérés de l'IdP.
• Sélectionnez le Attribut d'e-mail dans le menu déroulant dans lequel l'identifiant de messagerie de l'utilisateur est obtenu et cliquez sur le bouton b>Terminé.

• Une fois cliqué sur le OK bouton, vous serez redirigé vers le Cartographie des attributs et des rôles languette. Désormais, vous pouvez également choisir le Attribut de nom d'utilisateur dans la liste déroulante et cliquez sur le Enregistrer la configuration .

Veuillez noter : Le mappage de l'attribut e-mail est obligatoire pour la connexion.

Toutes nos félicitations! Vous avez configuré avec succès Drupal en tant que client OAuth.

Comment réaliser le SSO ?

• Maintenant, ouvrez un nouveau navigateur/fenêtre privée et accédez à la page de connexion de votre site Drupal.
• Cliquez sur le Connectez-vous en utilisant {Nom du fournisseur d'identité} lien pour lancer le SSO depuis Drupal.
• Si vous souhaitez également ajouter le lien SSO à d'autres pages, veuillez suivre les étapes indiquées dans l'image ci-dessous :