# Comment configurer SAML SSO avec Google Workspace

Dans ce guide, nous utiliserons Google Workspace en tant que fournisseur SSO et le protocole Security Assertion Markup Language (SAML) comme protocole d’identité privilégié.

Nous prenons actuellement en charge l'authentiation initiée par le SP et l'authentification initiée par l'IdP. Pour le provisionnement des utilisateurs, consultez [SCIM](./enterprise-scim).

> [!WARNING]
> Cette fonctionnalité fait partie des offres Team & Enterprise.

## Étape 1 : Créer une application SAML dans Google Workspace

- Dans votre console d’administration Google Workspace, accédez à `Admin` > `Apps` > `Web and mobile apps`.
- Cliquez sur `Add app` puis sur `Add custom SAML app`.
- Vous devez fournir un nom pour votre application dans le champ « Nom de l'application ».
- Cliquez sur `Continue`.

## Étape 2 : Configurer Hugging Face avec les détails de l'IdP de Google

- L'écran suivant de la configuration Google contient les informations SSO pour votre application.
- Dans les paramètres de votre organisation Hugging Face, accédez à l'onglet `SSO` et sélectionnez le protocole `SAML`.
- Copiez l'**URL SSO** de Google dans le champ **URL de connexion** sur Hugging Face.
- Copiez le **Certificate** de Google dans le champ correspondant sur Hugging Face. Le certificat public doit avoir le format suivant :
  ```
  -----BEGIN CERTIFICATE-----
  {certificate}
  -----END CERTIFICATE-----
  ```

- Dans la configuration de Google Workspace, cliquez sur `Continue`.

## Étape 3 : Configurer Google avec les détails du SP de Hugging Face

- Dans l'écran « Détails du fournisseur de service », vous aurez besoin de l'`Assertion Consumer Service URL` et de l'`SP Entity ID` de vos paramètres SSO Hugging Face. Copiez-les dans les champs `ACS URL` et `Entity ID` correspondants dans Google.
- Vérifiez que les éléments suivants sont définis :
    - Cochez la case **Réponse signée**.
    - Format de l'identifiant du nom : `EMAIL`
    - Identifiant du nom : `Basic Information > Primary email`

- Cliquez sur `Continue`.

## Étape 4 : Attribution des attributs

- Sur l'écran « Attribute mapping », cliquez sur `Add mapping` et configurez les attributs que vous souhaitez envoyer. Cette étape est facultative et dépend de l'utilisation de [Role Mapping](./security-sso-user-management#role-mapping) ou de [Resource Group Mapping](./security-sso-user-management#resource-group-mapping) sur Hugging Face.

- Cliquez sur `Finish`.

## Étape 5 : Tester et activer le SSO

> [!WARNING]
> Avant de tester, assurez-vous d’avoir accordé l’accès à l’application aux utilisateurs appropriés dans la console d’administration Google Workspace, sous les paramètres « User access » de l’application. L’administrateur effectuant le test doit disposer de l’accès. Il peut prendre quelques minutes pour que les modifications d’accès des utilisateurs soient appliquées sur Google Workspace.

- Maintenant, dans vos paramètres de SSO Hugging Face, cliquez sur **« Mettre à jour et tester la configuration SAML »**.
- Vous devriez être redirigé vers l'écran de connexion Google. Une fois connecté, vous serez redirigé vers la page de paramètres de votre organisation.
- Une coche verte à proximité du sélecteur SAML confirmera que le test a réussi.
- Une fois le test réussi, vous pouvez activer le SSO pour votre organisation en cliquant sur le bouton « Activer ».
- Une fois activé, les membres de votre organisation doivent compléter le flux d’authentification SSO décrit dans la section [Fonctionnement](./security-sso-basic#how-it-works).