Ir a YuJa
  1. Centro de Ayuda de YuJa
  2. Plataforma de accesibilidad web EqualGround
  3. Integraciones
  4. Integraciones de SSO

Integración de EqualGround con ADFS (SAML)

Avatar
YuJa
  • Actualización

Los administradores pueden configurar una conexión segura entre EqualGround y ADFS para autenticar a los usuarios que inician sesión en EqualGround. Para autenticar e iniciar sesión de forma segura a los usuarios, asegúrese de que EqualGround y ADFS se hayan configurado siguiendo los pasos a continuación.  

Qué se requiere para la configuración de ADFS

La configuración de ADFS requiere tres pasos, como se indica a continuación.

  1. Creación de una relación de confianza para usuario autenticado (RPT) con EqualGround.
  2. Adición de reglas de notificación para la RPT, de modo que las respuestas SAML contengan la información correcta sobre el usuario.
  3. Ajuste del algoritmo hash de la RPT. Esto garantiza que se completen las 3 partes para que la configuración se realice correctamente. 

Creación de una relación de confianza para usuario autenticado

  1. En el servidor ADFS, abra la aplicación Administración de ADFS.
  2. En el panel izquierdo, en Relaciones de confianza, haga clic en Relaciones de confianza para usuario autenticado (RPT). 
  3. En el panel Acciones, haga clic en Agregar relación de confianza para usuario autenticado. 
    Se muestra la carpeta Relaciones de confianza para usuario autenticado dentro de ADFS con la opción Agregar relación de confianza para usuario autenticado resaltada.
  4. En la ventana del Asistente para agregar relación de confianza para usuario autenticado, haga clic en Iniciar.
    El Asistente para agregar relación de confianza para usuario autenticado solicita al usuario que inicie el proceso completando varios pasos.
  5. Seleccione Escribir manualmente los datos sobre el usuario autenticado, y haga clic en Siguiente.
    En el paso Seleccionar origen de datos, la opción para escribir los datos sobre el usuario autenticado está seleccionada y el botón Siguiente aparece resaltado.
  6. Ingrese un nombre para mostrar de la RPT (p. ej., “EqualGround”), y haga clic en Siguiente.
    En el paso Especificar nombre para mostrar, se ingresa un nombre para mostrar y el botón Siguiente aparece resaltado.
  7. Seleccione Perfil de ADFS y haga clic en Siguiente.
    En el paso Elegir perfil, el perfil de AD FS está seleccionado y el botón Siguiente aparece resaltado.
  8. Cuando esté en el paso Configurar certificado, haga clic en Siguiente. No cifre las notificaciones enviadas a YuJa.
    El botón Siguiente aparece resaltado en el paso Configurar certificado.
  9. Seleccione Habilitar compatibilidad con el protocolo WebSSO de SAML 2.0.
  10. Ingrese la URL del servicio SSO de SAML 2.0 del usuario autenticado según su zona. Importante: Si tiene una URL personalizada de la plataforma EqualGround, ingrésela en lugar de la URL de la zona. 
    • Zona de EE. UU.: https://EqualGround.yuja.com/api/sso/samlReceiveResponse 
    • Zona de Canadá: https://EqualGround-cz.yuja.com/api/sso/samlReceiveResponse 
    • Zona de Europa: https://EqualGround-ez.yuja.com/api/sso/samlReceiveResponse
    • Zona de Australia: https://EqualGround-az.yuja.com/api/sso/samlReceiveResponse
    • URL personalizada: https://YOUR_CUSTOM_EqualGround_URL/api/sso/samlReceiveResponse
      • Ejemplo: https://hudsonu.EqualGround.yuja.com/api/sso/samlReceiveResponse
  11. Haga clic en Siguiente.
    En el paso Configurar URL, la opción Habilitar compatibilidad con el protocolo SAML 2.0 WebSSO está seleccionada y el botón Siguiente aparece resaltado.
  12. Para el Identificador de la relación de confianza para usuario autenticado, ingrese la URL según su zona. Importante: Si tiene una URL personalizada de la plataforma EqualGround, ingrésela en lugar de la URL de la zona. 
    • Zona de EE. UU.: https://EqualGround.yuja.com 
       
    • Zona de Canadá: https://EqualGround-cz.yuja.com
       
    • Zona de Europa: https://EqualGround-ez.yuja.com 
       
    • Zona de Australia: https://EqualGround-az.yuja.com 
    • URL personalizada:  YOUR_CUSTOM_EqualGround_URL
      • Ejemplo: https://hudsonu.EqualGround.yuja.com
  13. Haga clic en Agregar, luego haga clic en Siguiente.
    En el paso Configurar identificadores, se muestra agregado un identificador de la relación de confianza para usuario autenticado y el botón Siguiente aparece resaltado.
  14. Seleccione No deseo configurar los ajustes de autenticación multifactor para esta relación de confianza para usuario autenticado en este momento. Luego haga clic en Siguiente.
    En el paso Configurar ahora la autenticación multifactor, la opción No deseo configurar la autenticación multifactor está seleccionada y el botón Siguiente aparece resaltado.
  15. Seleccione Permitir que todos los usuarios tengan acceso a este usuario autenticado. Haga clic en Siguiente.
    En el paso Elegir reglas de autorización de emisión, la opción Permitir que todos los usuarios tengan acceso al usuario autenticado está seleccionada y el botón Siguiente aparece resaltado.
  16. Revise la configuración para asegurarse de que todo sea correcto y luego haga clic en Siguiente.
    En el paso Listo para agregar la relación de confianza, el botón Siguiente aparece resaltado.
  17. Asegúrese de tener seleccionada la opción Abrir el cuadro de diálogo Editar reglas de notificación para esta relación de confianza para usuario autenticado al cerrar el asistente, y luego haga clic en Cerrar.
    En el paso Finalizar, la opción Abrir Editar reglas de notificación está marcada y el botón Cerrar aparece resaltado.

Adición de reglas de notificación

  1. Para crear o editar reglas de notificación, primero haga clic en la RPT. En el panel del lado derecho, haga clic en Editar reglas de notificación.
    En la aplicación AD FS, el usuario autenticado de EqualGround está seleccionado.
  2. Haga clic en Agregar regla.
  3. Seleccione Enviar atributos LDAP como notificaciones y haga clic en Siguiente.
    Se muestra la ventana Editar reglas de notificación con el botón Agregar regla resaltado.
  4. Ingrese un Nombre de la regla de notificación (p. ej., EqualGround).
  5. Seleccione Active Directory como el Almacén de atributos.

  6. Cree cuatro asignaciones de notificaciones como se muestra en la tabla a continuación y luego haga clic en Finalizar.
    Asignación de atributos LDAP a tipos de notificación salientes: 

    Atributo LDAP Tipo de notificación saliente
    Email-Addresses Dirección de correo electrónico
    Given-Name Nombre
    Surname Apellido
    <Un atributo relacionado con el rol de un usuario (p. ej., Admin)> Rol

    Los atributos LDAP se muestran en una tabla con los atributos LDAP y su tipo de notificación saliente.

  7. Ahora, cree una segunda regla de notificación. Haga clic en Agregar regla.
    La ventana Editar reglas de notificación muestra el botón Agregar regla resaltado.
  8. Seleccione Transformar una notificación entrante. Haga clic en Siguiente.
    Transformar una notificación entrante está seleccionado como plantilla de la regla de notificación y el botón Siguiente aparece resaltado.
  9. Ingrese un Nombre de regla de notificación. En Tipo de notificación entrante, seleccione Dirección de correo electrónico. Importante: Esto supone que cada usuario del sistema ADFS tiene una dirección de correo electrónico asociada. Si no es así, seleccione Given-Name en su lugar.
  10. En Tipo de notificación saliente, seleccione Id. de nombre. En Formato de id. de nombre saliente, seleccione Correo electrónico. 
  11. Haga clic en Finalizar.
    La información de la regla de notificación está completa y el botón Finalizar aparece resaltado.
  12. Haga clic en Aceptar en la ventana Editar reglas de notificación. 
    El botón Aceptar aparece resaltado en la ventana Editar reglas de notificación.

Ajuste del algoritmo hash 

  1. Haga doble clic en su RPT.
    El usuario autenticado de Engage está seleccionado en la aplicación AD FS.
  2. Seleccione la pestaña Avanzadas .
  3. En la lista desplegable Algoritmo hash seguro, seleccione SHA-1.
  4. Haga clic en Aceptar.
    La pestaña Avanzadas está seleccionada en las propiedades de EqualGround y SHA-! está seleccionado como Algoritmo hash seguro.

Configuración de EqualGround

Después de ajustar todos los parámetros en ADFS, podrá configurar los ajustes dentro de EqualGround.

  1. Inicie sesión en EqualGround.
  2. Seleccione Configuraciones y luego seleccione Configuración de Integración.
  3. En el menú desplegable Seleccionar integraciones, seleccione SSO-SAML y habilite Permitir autenticación a través de SSO.
    La página de integraciones SSO SAML de EqualGround.

  4. Deberá completar la información de cada uno de los paneles de la integración: Detalles Generales de SSO, Aprovisionamiento de usuarios, Asignación de roles e Integración cruzada con LTI 1.3. Siga la tabla a continuación para completar la información.

    Atributo ¿Obligatorio? Descripción
    Detalles Generales de SSO 
    URL de SSO  Sí

    La URL utilizada para el SSO. Aquí es donde EqualGround enviará los tokens AuthnRequest. Se encuentra en los metadatos del IDP como el atributo “Location”. Nota: Para EqualGround se utiliza un enlace HTTP-Redirect.

    Ejemplo: “https:///adfs/ls/”
    Formato de ID de nombre Sí

    El formato que deben utilizar el SP y el IDP al comunicarse sobre un sujeto. Se encuentra en los metadatos del IDP como el valor de esa etiqueta. Nota: Si está disponible, se deben priorizar y utilizar las direcciones de correo electrónico.

    Ejemplo: urn:oasis:names:tc:SAML:1.1:nameid- format:emailAddress
    Huella digital del certificado de firma de ADFS Sí

    La huella digital única del certificado del IDP se utiliza al firmar las respuestas SAML. La huella digital no se encuentra de forma explícita en los metadatos, pero el certificado se utiliza para firmar la SAMLResponse o la Assertion. Consulte Cómo obtener la huella digital de un certificado en la sección Herramientas adicionales de este documento para obtener más detalles.

    Ejemplo: 7j2mka9cfe2d09j23eefe11142f6a49d1222391
    Aprovisionamiento de usuarios 
    Atributo de nombre de pila Sí

    El nombre del atributo en la respuesta SAML que describe el nombre de pila del usuario (es decir, el primer nombre). Se encuentra en los metadatos del IDP. Hay una sección en el archivo .XML que debe contener una lista de etiquetas. Ingrese el valor de la clave “Name” correspondiente al nombre de pila.

    El valor debe ser: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname
    Atributo de apellido Sí

    El nombre del atributo en la respuesta SAML que describe el apellido del usuario (es decir, el apellido paterno). Se encuentra en los metadatos del IDP. Hay una sección en el archivo .XML que debe contener una lista de etiquetas. Ingrese el valor de la clave “Name” correspondiente al apellido.

    El valor debe ser: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname
    Atributo de correo electrónico Sí

    El nombre del atributo en la respuesta SAML que describe la dirección de correo electrónico del usuario. Se encuentra en los metadatos del IDP. Hay una sección en el archivo .XML que debe contener una lista de etiquetas. Ingrese el valor de la clave “Name” correspondiente a la dirección de correo electrónico. 

    El valor debe ser: http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress
    Atributo de rol Sí

    El nombre del atributo en la respuesta SAML que describe el rol del usuario. Se encuentra en los metadatos del IDP. Hay una sección en el archivo .XML que debe contener una lista de etiquetas. Ingrese el valor de la clave “Name” correspondiente al rol.  

    El valor debe ser: http://schemas.microsoft.com/ws/2008/06/identity/claims/role
    Asignación de roles
    Asignación de administrador Sí

    Se puede utilizar una lista de valores separados por comas. Si el valor recibido en el Atributo de rol coincide con alguno de estos valores, el usuario se aprovisionará como gerente de TI.

    Ejemplo: IT Manager
    Asignación de instructor Sí

    Se puede utilizar una lista de valores separados por comas. Si el valor recibido en el Atributo de rol coincide con alguno de estos valores, el usuario se aprovisionará como instructor.

    Ejemplo: Instructor, Teacher o TA
    Integración cruzada con LTI
    Atributo de vinculación de SSO No Un atributo único que vincula el SSO con el LMS. Esto permite que un usuario sea reconocido como un único usuario, independientemente de si inicia sesión con su SSO o con el LMS. Deberá ingresar el nombre del atributo de vinculación proporcionado por su SSO.
    Campo personalizado de vinculación de LTI 1.3 No Un atributo único que vincula el SSO con el LMS. Esto permite que un usuario sea reconocido como un único usuario, independientemente de si inicia sesión con su SSO o con el LMS. Deberá ingresar el nombre del campo personalizado utilizado para configurar el inicio de LTI. 
  5. Una vez que haya ajustado todos los parámetros necesarios, haga clic en Guardar cambios para completar la integración. Nota: Puede probar su integración de SSO seleccionando Lanzar página de inicio de sesión SSO e iniciando sesión con su integración.
    El botón Guardar aparece resaltado en la página de integraciones SSO SAML de EqualGround.

Herramientas adicionales

Cómo obtener la huella digital de un certificado

La huella digital del certificado del IDP se utiliza como medida de seguridad adicional cuando el SP verifica una respuesta SAML del IDP. Para obtener la huella digital del certificado, siga las instrucciones a continuación:

  1. En los metadatos del IDP de Google, extraiga el certificado X509. Debe encontrarse en: <IDPSSODescriptor> →<KeyDescriptor use=”signing”> → <KeyInfo> → <X509Data> → <X509Certificate>
  2. Una vez que tenga el certificado, vaya al siguiente sitio web: https://www.samltool.com/fingerprint.php.
  3. Pegue el certificado en el cuadro de texto “X509 cert”.
  4. Asegúrese de que “sha1” esté seleccionado como Algoritmo.
  5. Haga clic en “Calculate Fingerprint”.
  6. Copie el valor “FingerPrint” generado. Este es el valor que se utiliza en la base de datos. La huella digital debe ser un arreglo de 20 bytes para “sha1”.
Comuníquese con soporte