Hub documentation
Cómo configurar SAML SSO con Okta
Cómo configurar SAML SSO con Okta
En esta guía, utilizaremos Okta 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
Abre una nueva pestaña/ventana en tu navegador e inicia sesión en tu cuenta de Okta.
Vaya a “Admin/Applications” y haga clic en el botón “Create App Integration”.

Luego, elige una aplicación “SAML 2.0” y haz clic en “Create”.

Paso 2: Configure su aplicación en Okta
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 la “Assertion Consumer Service URL” de la configuración de la organización en Hugging Face y pégala en el campo “Single sign-on URL” de Okta.
La URL tiene este aspecto: https://huggingface.co/organizations/[organizationIdentifier]/saml/consume.

En Okta, configura los siguientes ajustes:
- Establezca Audience URI (SP Entity Id) para que coincida con el valor de “SP Entity ID” en Hugging Face.
- Establezca el formato de Name ID en
Unspecified. - Establezca el nombre de usuario de la aplicación en
Custom, con la expresiónuser.getInternalProperty("id"). - En “Attribute Statements”, agregue
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddresscon el valoruser.email. - En “Show Advanced Settings”, verifique que Response y Assertion Signature estén configurados en: Signed.
Guarde su nueva aplicación.
Paso 3: Finalizar la configuración en Hugging Face
En su aplicación de Okta, bajo “Sign On/Settings/More details”, busque los siguientes campos:
- URL de inicio de sesión
- Certificado público
- ID de entidad de SP Necesitarás estos datos 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 Okta:
- URL de inicio de sesión
- ID de entidad SP
- 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.
Update on GitHub