Hub documentation

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

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

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

Esta guía utilizará Microsoft Entra ID como proveedor de SSO y el protocolo Open ID Connect (OIDC) como protocolo de identidad preferido.

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 al centro de administración de Microsoft Entra ID y haga clic en “Enterprise applications”

Serás redirigido a esta página. Luego, haz clic en “New application” en la parte superior y en “Create your own application”.

Introduce un nombre para tu aplicación (por ejemplo, Hugging Face SSO) y luego selecciona “Register an application to integrate with Microsoft Entra ID (App you’re developing)“.

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 OIDC.

Copia la “Redirection URI” de la configuración de la organización en Hugging Face y pégala en el campo “Redirect URI” de Azure Entra ID. Asegúrate de seleccionar “Web” en el menú desplegable. La URL tiene este aspecto: https://huggingface.co/organizations/[organizationIdentifier]/oidc/consume.

Guarde su nueva aplicación.

Paso 3: Finalizar la configuración en Hugging Face

Necesitaremos recopilar la siguiente información para finalizar la configuración en Hugging Face:

  • El ID de cliente de la aplicación OIDC
  • Un secreto de cliente de la aplicación OIDC
  • La URL del emisor de la aplicación OIDC

En Microsoft Entra ID, vaya a Enterprise applications y haga clic en la aplicación recién creada en la lista.

En el resumen de la aplicación, haga clic en “Single sign-on” y luego en “Go to application”.

En el resumen de la aplicación OIDC, encontrará un campo copiable llamado “Application (client) ID”. Copie ese ID en su portapapeles y péguelo en el campo “Client ID” de Hugging Face.

A continuación, haga clic en “Endpoints” en el menú superior de Microsoft Entra. Copie el valor del campo “OpenID connect metadata document” y péguelo en el campo “Issue URL” de Hugging Face.

Vuelva a Microsoft Entra, navegue a “Certificates & secrets” y genere un nuevo secreto haciendo clic en “New client secret”.

Una vez que hayas creado el secreto, copia el valor del secreto y pégalo en el campo “Client secret” en Hugging Face.

Ahora puede hacer clic en “Update and Test OIDC 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 OIDC 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.

Update on GitHub