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ón user.getInternalProperty("id").
• En “Attribute Statements”, agregue http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress con el valor user.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.