Hub documentation

Cómo configurar SAML SSO con Google Workspace

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

Cómo configurar SAML SSO con Google Workspace

En esta guía, utilizaremos Google Workspace como proveedor de SSO y el protocolo Security Assertion Markup Language (SAML) como 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: Crear una aplicación SAML en Google Workspace

  • En la consola de administración de Google Workspace, vaya a Admin > Apps > Web and mobile apps.
  • Haz clic en Add app y luego en Add custom SAML app.
  • Debes proporcionar un nombre para tu aplicación en el campo “App name”.
  • Haz clic en Continue.

Paso 2: Configure Hugging Face con los detalles del IdP de Google

  • La siguiente pantalla de la configuración de Google contiene la información de SSO para su aplicación.
  • En la configuración de tu organización de Hugging Face, ve a la pestaña SSO y selecciona el protocolo SAML.
  • Copia la URL de SSO de Google en el campo URL de inicio de sesión de Hugging Face.
  • Copia el certificado de Google en el campo correspondiente de Hugging Face. El certificado público debe tener el siguiente formato:
    -----BEGIN CERTIFICATE-----
    {certificate}
    -----END CERTIFICATE-----
  • En la configuración de Google Workspace, haz clic en Continue.

Paso 3: Configure Google con los detalles de SP de Hugging Face

  • En la pantalla “Service provider details”, necesitarás la Assertion Consumer Service URL y el SP Entity ID de la configuración de SSO de Hugging Face. Cópialos en los campos correspondientes de ACS URL y Entity ID en Google.
  • Asegúrate de que se hayan configurado los siguientes elementos:
    • Marque la casilla Respuesta firmada.
    • Formato del ID de nombre: EMAIL
    • ID del nombre: Basic Information > Primary email
  • Haz clic en Continue.

Paso 4: Mapeo de atributos

  • En la pantalla “Attribute mapping”, haga clic en Add mapping y configure los atributos que desea enviar. Este paso es opcional y depende de si desea usar Role Mapping o Resource Group Mapping en Hugging Face.
  • Haz clic en Finish.

Paso 5: Probar y habilitar SSO

Antes de realizar la prueba, asegúrate de haber concedido acceso a la aplicación a los usuarios correspondientes en la consola de administración de Google Workspace, en la configuración de “Acceso de usuario” de la aplicación. El administrador que realice la prueba debe tener acceso. Puede tardar unos minutos en que los cambios de acceso de usuario se apliquen en Google Workspace.

  • Ahora, en la configuración de SSO de Hugging Face, haz clic en “Update and Test SAML configuration”.
  • Deberías ser redirigido a la pantalla de inicio de sesión de Google. 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.
  • Una vez que la prueba sea exitosa, puedes habilitar el SSO para 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