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.

Cette fonctionnalité fait partie des plans 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 « App name ».
• 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 :
  Copié

  -----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 ou de Resource Group Mapping sur Hugging Face.

• Cliquez sur Finish.

Étape 5 : Tester et activer le SSO

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 « Accès des utilisateurs » de l’application. L’administrateur effectuant le test doit disposer de cet accès. Il peut se passer quelques minutes avant que les modifications d’accès des utilisateurs ne 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.

Update on GitHub