Guide de configuration SSO Google Admin

Ce guide fournit des instructions complètes pour configurer le SSO (Single Sign-On) SAML à l'aide de Google Admin sur la plateforme GPTBots. Veuillez consulter la Page de configuration SSO de GPTBots pour obtenir des conseils opérationnels et finaliser l'ensemble du processus de configuration.

Dans l'intégration SSO entre Google Admin et GPTBots, la correspondance des comptes utilisateurs repose sur l'alignement entre les groupes configurés dans Google Admin et les groupes SSO de GPTBots.

Pour finaliser la configuration SSO Google Admin, les prérequis suivants doivent être remplis. Cet article explique chaque étape dans l'ordre suivant :

• Compte Google Admin : Vous avez enregistré un compte administrateur Google Admin.
• Compte GPTBots et SSO : L'organisation cible doit avoir activé la fonctionnalité SSO (si ce n'est pas le cas, veuillez contacter le service commercial).
• Autorisation de groupe : L'application GPTBots a été autorisée dans Google Admin pour les groupes nécessitant un accès SSO.
• Exigence de cohérence des comptes : L'adresse e-mail utilisée pour se connecter à GPTBots doit correspondre exactement à celle autorisée dans Google Admin.

Remarque : Dans l'environnement Google, la configuration SSO est basée sur l'attribut E-mail principal de l'utilisateur. Google Admin ne prend pas en charge la configuration de plusieurs adresses e-mail SSO pour un même utilisateur. Veuillez vous assurer que l'e-mail utilisé pour la connexion SSO correspond à l'e-mail principal dans l'annuaire Google Admin afin de garantir une authentification réussie.

Processus de configuration

1. Connectez-vous à la console Google Admin, puis dans le menu de navigation à gauche, cliquez sur « Applications > Applications Web et mobiles. »

   

2. Cliquez sur « Ajouter une application » et sélectionnez « Ajouter une application SAML personnalisée ».
   

3. Saisissez le « Nom de l'application » et la « Description » pour identifier cette application SAML.
   

4. Veuillez copier et sauvegarder correctement l'URL SSO et les informations du certificat, qui seront utilisées ultérieurement dans la configuration SSO de GPTBots.
   

5. Connectez-vous à la console GPTBots, accédez à la page de configuration SSO et copiez les informations clés telles que l'Entity ID et l'URL ACS.
   

6. Dans la configuration de l'application SAML Google Admin, saisissez l'Entity ID et l'URL ACS dans les champs correspondants.
   

7. Choisissez EMAIL comme format Name ID, sélectionnez Informations de base > E-mail principal comme Name ID, puis cliquez sur « Continuer. »
   

8. Ajoutez l'attribut d'annuaire Google E-mail principal, et définissez l'attribut de l'application sur :
   http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress.
   Cet attribut s'applique à toutes les configurations SSO Google pour GPTBots.
   
   Cliquez sur « Terminer » pour finaliser la configuration initiale côté Google Admin.

9. Retournez sur la page de configuration SSO de GPTBots et saisissez l'URL SSO et les informations du certificat enregistrées dans les champs URL de connexion IdP, URL de déconnexion IdP et Certificat x509.
   

10. Une fois la configuration terminée, localisez la nouvelle application SAML créée sous « Applications Web et mobiles » dans le menu « Applications », puis cliquez sur la section « Accès utilisateur » (zone non hyperliée).
    

11. Dans le statut du service, sélectionnez « Activé pour tout le monde » afin de garantir que tous les utilisateurs cibles puissent se connecter via SSO.
    

Instructions de connexion et de déconnexion

Pour plus de détails sur les processus standards de connexion et de déconnexion, veuillez consulter la Page de configuration SSO de GPTBots. Cette section se concentre sur les processus d'authentification et les problèmes courants lors de l'utilisation de Google Admin comme fournisseur d'identité (IdP), qui diffèrent des autres IdP.

Vérification de la cohérence des comptes

Lors de l'utilisation de Google Admin SSO pour l'authentification, le système vérifie si le compte Google saisi correspond au compte Google actuellement connecté dans le navigateur. Les scénarios suivants sont inclus :

• Processus de connexion initié via le bouton de connexion SSO
• Liens de connexion SSO (y compris les liens de connexion dans les e-mails d'invitation lors de l'invitation d'utilisateurs à rejoindre une organisation SSO)

Selon l'état de connexion et la correspondance du compte Google, le système réagit comme suit :

Navigateur connecté et comptes correspondants

Aucune action supplémentaire n'est requise ; le système poursuit automatiquement le processus d'authentification SSO.

Navigateur connecté avec plusieurs comptes Google

Le système affiche une fenêtre de sélection de compte. Veuillez sélectionner le compte correspondant à l'e-mail de connexion SSO.

Navigateur non connecté à un compte Google

Le système invite automatiquement l'utilisateur à se connecter à un compte Google. Veuillez suivre les instructions et vous connecter avec le compte correspondant à l'e-mail de connexion SSO.

Navigateur connecté mais comptes non correspondants

Le système affiche une erreur 403 et bloque la tentative de connexion.

Dépannage et changement de compte

Si vous rencontrez une erreur 403, suivez ces étapes pour dépanner et changer de compte :

En prenant Google Chrome comme exemple, accédez à la page « Gérer les profils Chrome ».

Ajoutez ou basculez vers le compte e-mail Google dont vous avez besoin pour la connexion SSO GPTBots. Vérifiez qu'il est correct avant de tenter à nouveau de vous connecter à GPTBots via SSO.

Sinon, si vous n'avez pas besoin d'enregistrer l'historique de navigation, vous pouvez utiliser le mode navigation privée du navigateur pour la connexion SSO. En mode incognito, le système vous invite automatiquement à vous connecter à un compte Google, offrant ainsi un environnement propre et minimisant les conflits de comptes.

FAQ

Q : Lors de la déconnexion, le système invite à sélectionner un compte, mais un clic dessus affiche une page d'erreur 400.

R : Google Workspace ne prend pas en charge le SLO (Single Logout), il n'est donc pas possible de se déconnecter directement du compte Google via le bouton de déconnexion GPTBots. Pour vous déconnecter, accédez à la page de gestion de compte Google du navigateur et déconnectez-vous manuellement du compte Google actuel.