Hub documentation

SSO básico

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

SSO básico

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

El SSO básico añade una capa de control de acceso sobre el inicio de sesión estándar de Hugging Face. Permite aplicar la autenticación a través de su proveedor de identidad (IdP) cuando los miembros acceden a recursos bajo el espacio de nombres de su organización, como modelos privados, conjuntos de datos y Spaces.

Para una comparación con Managed SSO, consulte el resumen de SSO.

Cómo funciona

El SSO básico no reemplaza el inicio de sesión de Hugging Face. Sus miembros aún deberán iniciar sesión en Hugging Face con sus propias credenciales (correo electrónico/contraseña, Google o GitHub) antes de que se les solicite completar la autenticación SSO para acceder a los recursos de su organización. Esto es por diseño: el SSO básico protege el acceso a su organización sin tomar el control de la identidad de Hugging Face del usuario.

Cuando el inicio de sesión único está habilitado, los miembros de la organización se autentican a través de su proveedor de identidad (IdP). Usted elige si el SSO es obligatorio o opcional:

  • Obligatorio (predeterminado): Los miembros deben completar la autenticación SSO antes de acceder a cualquier elemento del espacio de nombres de la organización.
  • Opcional: Los miembros reciben un aviso mediante un banner en la parte superior de la página para configurar SSO, pero pueden omitirlo y seguir accediendo a la organización. Esto es útil cuando se está migrando a muchos usuarios y se desea darles tiempo para organizar sus cuentas antes de aplicar SSO de forma obligatoria.

El contenido público sigue siendo accesible para todos, incluidos los no miembros.

Utilizamos las direcciones de correo electrónico para identificar a los usuarios de SSO. Como usuario, asegúrate de que tu dirección de correo electrónico organizativa (p. ej., el correo de tu empresa) haya sido añadida a tu cuenta de usuario.

Cuando los usuarios inician sesión, se les solicitará completar el flujo de autenticación de Single Sign-On con un banner similar al siguiente:

El inicio de sesión único solo se aplica a tu organización. Los miembros pueden pertenecer a otras organizaciones en Hugging Face.

Primeros pasos

La SSO básica se puede configurar directamente desde la configuración de su organización. Hugging Face Hub puede funcionar con cualquier proveedor de identidad compatible con OIDC o SAML, incluidos Okta, OneLogin y Microsoft Entra ID (Azure AD).

Consulte nuestras Guías de configuración para obtener instrucciones de configuración paso a paso.

Provisionamiento de usuarios

Una vez que SSO está habilitado en tu organización, se puede copiar y compartir un enlace de incorporación directo con nuevos miembros. Este enlace de incorporación SSO está disponible en las pestañas de configuración SSO y Members. Dado que las organizaciones con SSO habilitado no pueden usar enlaces de invitación clásicos, el enlace de incorporación SSO es el método principal para invitar a compañeros de equipo a tu organización. Simplemente haz clic en el botón de copiar para copiar el enlace en tu portapapeles y compártelo con los miembros que desees invitar. Cuando los destinatarios hagan clic en el enlace compartido, podrán autenticarse mediante SSO e incorporarse directamente a tu organización.

Las organizaciones con el plan Enterprise también pueden usar SCIM para automatizar el aprovisionamiento basado en invitaciones desde su proveedor de identidad. Consulte la guía de SCIM para obtener más detalles.

Funciones de SSO

El SSO básico admite el mapeo de roles, el mapeo de grupos de recursos, el tiempo de espera de la sesión, el dominio de correo electrónico coincidente y los colaboradores externos. Estas funciones se pueden configurar desde la configuración de tu organización.

Update on GitHub