# 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](./enterprise-scim).

> [!WARNING]
> 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 **Certificate** 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 `ACS URL` y `Entity ID` correspondientes en Google.
- Asegúrate de que lo siguiente esté configurado:
    - 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](./security-sso-user-management#role-mapping) o [Resource Group Mapping](./security-sso-user-management#resource-group-mapping) en Hugging Face.

- Haz clic en `Finish`.

## Paso 5: Probar y habilitar SSO

> [!WARNING]
> 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 **"Actualizar y probar la configuración de SAML"**.
- 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](./security-sso-basic#how-it-works).