La integración de SSO de Drupal OAuth 2.0/OpenID Connect (OIDC) permite el SSO entre el sitio Drupal y cualquier proveedor de identidad. Esta integración se logra mediante la Cliente miniOrange OAuth módulo que es compatible con Drupal 7, Drupal 8, Drupal 9 y Drupal 10.

El módulo permite que un proveedor de inicio de sesión externo de OpenID Connect autentique e inicie sesión a los usuarios en el sitio Drupal. Consulte los pasos de integración con algunos proveedores populares de OAuth/OpenID como 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 y muchos más.

El módulo también es compatible con proveedores de inicio de sesión social como Google, Discord, Slack, LinkedIn, Facebook, Instagram, Apple, Amazon, Yahoo, Pinterest, Snapchat y Twitter (X).
En este documento, seguiremos los pasos para configurar el módulo:

Configure Drupal como cliente OAuth:

• Después de instalar el módulo, vaya a la Configuración pestaña y haga clic en el Configuración del cliente miniOrange OAuth -> Configurar OAuth y seleccione la aplicación en la Seleccionar aplicación la lista desplegable.

  Note: En caso de que el proveedor de OAuth deseado no aparezca en el menú desplegable, seleccione OAuth personalizado/Proveedor de OAuth personalizado/Proveedor de OpenID personalizado y continúe.

• Copia el URL de devolución de llamada/redireccionamiento y tenlo a mano. Esto será necesario al configurar el proveedor de identidad.

  Note:- Si su proveedor solo admite HTTPS URL de devolución de llamada/redireccionamiento y tiene un sitio HTTP, asegúrese de habilitar la opción 'Aplicar URL de devolución de llamada HTTPS' casilla de verificación en la parte inferior de la pestaña.

• Introduzca el nombre en el Nombre de la aplicación personalizada campo de texto. Por ejemplo, OAuth genérico

Integrando Drupal con el proveedor de identidad:

• Configure la URL de devolución de llamada/redireccionamiento en su IdP y complete los pasos adicionales.
• Agregue los detalles a continuación en el sitio Drupal (los obtendrá todos del proveedor de identidad).

  ID de cliente	Identificador único para la aplicación cliente OAuth 2.
  Secreto del cliente	Información confidencial utilizada para autenticar al cliente.
  Lo que hacemos	El alcance del acceso que el cliente solicita al usuario y al servidor de autorización.
  Autorizar punto final:	URL donde el usuario se autentica y otorga permisos al cliente.
  Punto final del token de acceso:	URL donde el cliente intercambia el código de autorización por un token de acceso.
  Obtener punto final de información del usuario:	URL opcional para recuperar información del usuario


• La casilla de verificación 'Enviar ID de cliente y secreto en encabezado o cuerpo' le permite especificar si el ID de cliente y el secreto deben incluirse en el encabezado o en el cuerpo de la solicitud de punto final de token. Si no está seguro de qué opción seleccionar, puede seguir con la configuración predeterminada.
• Haga clic en la casilla de verificación para Habilitar inicio de sesión con OAuth, desplácese hacia abajo y haga clic en Guardar configuración del botón.

Conexión de prueba entre Drupal y el proveedor de identidad:

• Haga clic en el Realizar configuración de prueba del botón.

• En una ventana emergente de Configuración de prueba, si no tiene una sesión activa en IdP en el mismo navegador, se le pedirá que inicie sesión en Proveedor de identidad (IdP). Una vez que haya iniciado sesión correctamente, recibirá una lista de atributos recuperados del IdP.
• Seleccione Atributo de correo electrónico desde el menú desplegable en el que se obtiene el ID de correo electrónico del usuario y haga clic en el botón b>Listo.

• Una vez que haga clic en el Terminado botón, será redirigido al Mapeo de atributos y roles pestaña. Ahora también puedes elegir el Atributo de nombre de usuario en el menú desplegable y haga clic en el Guardar configuración del botón.

Ten en cuenta que: La asignación del atributo de correo electrónico es obligatoria para iniciar sesión.

¡Felicidades! Ha configurado correctamente Drupal como cliente OAuth.

¿Cómo realizar el SSO?

• Ahora, abra un nuevo navegador/ventana privada y vaya a la página de inicio de sesión de su sitio Drupal.
• Haga clic en el Inicie sesión con {Nombre del proveedor de identidad} enlace para iniciar el SSO desde Drupal.
• Si también desea agregar el enlace SSO a otras páginas, siga los pasos que se indican en la imagen a continuación: