Cómo configurar SAML SSO con Microsoft Entra ID (Azure AD)

En esta guía, utilizaremos Microsoft Entra ID como proveedor de SSO y el protocolo Security Assertion Markup Language (SAML) como nuestro protocolo de identidad preferido.

Actualmente, admitimos la autenticación iniciada por SP y la iniciada por IdP. Para el aprovisionamiento de usuarios, consulte SCIM.

Esta función forma parte de los planes Team & Enterprise.

Paso 1: Crea una nueva aplicación en tu Identity Provider

Abra una nueva pestaña/ventana en su navegador e inicie sesión en el portal de Azure de su organización.

Vaya a “Enterprise applications” y haga clic en el botón “New application”.

Serás redirigido a esta página, haz clic en “Create your own application”, completa el nombre de tu aplicación y luego “Create” la aplicación.

Luego, seleccione “Single Sign-On” y elija SAML

Paso 2: Configure su aplicación en Azure

Abre una nueva pestaña o ventana en tu navegador y navega a la sección de SSO de la configuración de tu organización. Selecciona el protocolo SAML.

Copia el “SP Entity Id” de la configuración de la organización en Hugging Face y pégalo en el campo “Identifier (Entity Id)” de Azure (1).

Copia la “Assertion Consumer Service URL” de la configuración de la organización en Hugging Face y pégala en el campo “Reply URL” de Azure (2).

La URL tiene este aspecto: https://huggingface.co/organizations/[organizationIdentifier]/saml/consume.

Luego, en “SAML Certificates”, verifique que “Signin Option” esté configurado en “Sign SAML response and assertion”.

Guarde su nueva aplicación.

Paso 3: Finalizar la configuración en Hugging Face

En su aplicación de Azure, bajo “Set up”, busque el siguiente campo:

• URL de inicio de sesión

Y bajo “SAML Certificates”:

• Descargue el “Certificado (base64)”

Los necesitarás para finalizar la configuración de SSO en Hugging Face.

En la sección SSO de la configuración de su organización, copie y pegue estos valores de Azure:

• URL de inicio de sesión -> URL de inicio de sesión
• Certificado -> Certificado público

El certificado público debe tener el siguiente formato:

-----BEGIN CERTIFICATE-----
{certificate}
-----END CERTIFICATE-----

Ahora puede hacer clic en “Update and Test SAML configuration” para guardar la configuración.

Deberías ser redirigido al prompt de inicio de sesión de tu proveedor de SSO (IdP). Una vez que inicies sesión, serás redirigido a la página de configuración de tu organización.

Una marca de verificación verde cerca del selector de SAML confirmará que la prueba fue exitosa.

Paso 4: Habilitar SSO en su organización

Ahora que Single Sign-On está configurado y probado, puedes activarlo para los miembros de tu organización haciendo clic en el botón “Enable”.

Una vez habilitado, los miembros de su organización deben completar el flujo de autenticación SSO descrito en la sección Cómo funciona.