1. Introduction
Google Workspace SSO permet à votre organisation d'utiliser les informations de votre compte Google pour se connecter à d'autres applications professionnelles. Cela signifie que vos utilisateurs se connectent une fois avec leurs identifiants Google Workspace et sont automatiquement connectés aux applications approuvées. Dans ce guide, nous expliquons comment configurer Google Workspace en tant que fournisseur d'identité (IdP) pour accéder à la plateforme Cyber Guru.
2. Ce dont vous avez besoin avant de commencer
- Un compte administrateur pour Google Workspace (le compte avec le rôle "Admin")
- Accès à votre console d'administration Google (normalement à https://admin.google.com)
- Disponibilité des valeurs pour les revendications suivantes :
- nom d'utilisateur
- prénom
- nom de famille
- Obtenez les métadonnées du fournisseur IdP sous forme d'URL accessible sur Internet
- Identifier les utilisateurs autorisés à accéder à l'application (des groupes appropriés seraient préférables)
- Si possible, créez un utilisateur pour Cyber Guru à des fins de test
3. Instructions étape par étape
3.1. Connectez-vous à la console d'administration Google
- Ouvrez votre navigateur web et allez sur https://admin.google.com.
- Connectez-vous en utilisant votre adresse email d'administrateur et votre mot de passe.
3.2. Localisez les paramètres SAML SSO et envoyez les métadonnées IdP
- Selon la disposition de votre console d'administration Google, vous trouverez les paramètres SSO à l'un des deux endroits principaux. Essayez ce qui suit :
- Option A : Depuis la page d'accueil
- Dans la page d'accueil de la console d'administration
- Cherchez "Applications" (cela peut être représenté par une icône ou listé dans le menu) et cliquez dessus.
- Ensuite, cliquez sur "Applications web et mobiles". C'est ici que vous gérez les applications SAML.
- Option B : En utilisant le menu Sécurité
- Si vous voyez "Sécurité" sur la page d'accueil, cliquez dessus.
- Sous "Sécurité", cherchez "Configurer la connexion unique (SSO) pour les applications SAML". (Si vous ne voyez pas "Sécurité", cliquez sur "Afficher plus" ou utilisez la barre de recherche en haut de la console d'administration pour rechercher "SSO").
L'option utilisée dans ce document est la n°1
Dans le menu de gauche, sélectionnez "Applications" puis "Applications web et mobiles"
Sélectionnez "Paramètres" -> "Certificats SAML"
Vous obtiendrez une page avec les détails du fournisseur d'identité Google.
Allez en bas de la page
Cliquez sur « TÉLÉCHARGER LES MÉTADONNÉES »
Envoyez le fichier GoogleIDPMetadata.xml à Cyber Guru. Dès que Cyber Guru aura terminé la configuration de son côté, le fichier xml des métadonnées SP sera envoyé au client.
3.3. Ajouter une nouvelle application SAML
Retournez au menu principal
Sélectionnez « Applications » -> « applications web et mobiles »
Ensuite, dans le volet de droite, sélectionnez « Ajouter une application » -> « Ajouter une application SAML personnalisée »
Remplissez le “nom de l'application” et la “Description” puis cliquez sur “Continuer”.
Voici les métadonnées IdP. Vous avez déjà envoyé ces données lors des étapes précédentes.
Cliquez sur “Continuer”.
La valeur pour les champs rouges (URL ACS et ID d'entité) se trouve dans le fichier de métadonnées SP envoyé par Cyber Guru. Voici ci-dessous les extraits du fichier XML où se trouvent les données :
URL ACS
<md:AssertionConsumerService Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST" Location="https://login.stage.cyberguru.dev/realms/techcorpgoo/broker/saml/endpoint" isDefault="true" index="1"/>
ID d'entité
<md:EntityDescriptor xmlns="urn:oasis:names:tc:SAML:2.0:metadata" xmlns:md="urn:oasis:names:tc:SAML:2.0:metadata" xmlns:saml="urn:oasis:names:tc:SAML:2.0:assertion" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" entityID="https://login.stage.cyberguru.dev/realms/techcorpgoo" ID="ID_dcdf9592-8351-4344-936c-5fc195636230">
Remplissez le formulaire avec l'URL ACS et l'ID d'entité et changez le “Format de l'ID de nom” en “TRANSIENT”
Cliquez sur "Continuer"
Cliquez sur "AJOUTER UN MAPPAGE"
Ici, nous configurons les revendications demandées par Cyber Guru après l'authentification.
Nom d'utilisateur
REMARQUE : Pour ce champ, Cyber Guru recommande fortement d'utiliser une valeur qui ne changera pas à l'avenir. Donc, s'il y a une chance que l'« Email principal » change à l'avenir, utilisez un autre champ comme « ID employé » ou similaire
Cliquez sur "AJOUTER UN MAPPAGE"
Cliquez sur "AJOUTER UN MAPPAGE"
Cliquez sur "AJOUTER UN MAPPAGE"
Cliquez sur "Terminer" à la fin de la page. L'application est créée et voici ce que vous devriez voir :
3.4. Activer l'application pour vos utilisateurs
Dans l'aperçu de l'application nouvellement créée, localisez le panneau d'accès utilisateur
Cliquez sur "DÉSACTIVÉ pour tout le monde"
Cliquez sur « Groupes » et sélectionnez le groupe contenant les utilisateurs autorisés à utiliser l'application.
Dans cet exemple de configuration, nous sélectionnons TechCorporation. Veuillez sélectionner le groupe de votre organisation, activer le statut du service et cliquer sur « Enregistrer ».
3.5. Tester la connexion SSO
Avant de le déployer dans toute votre organisation, testons la configuration :
Ouvrez une fenêtre de navigation privée ou incognito.
-
Accédez à la page de connexion : https://<subdomain>.platform.cyberguru.eu
Cliquez sur le bouton “LogInWith (Techcorpgoo IdP)”
REMARQUE : Techcorpgoo est l'entreprise utilisée pour tester le présent guide.
La page de connexion de votre espace de travail Google s'affichera :
Connectez-vous en utilisant vos identifiants Google Workspace, puis vous serez redirigé vers le service. Si tout fonctionne correctement, vous devriez recevoir la page d'accueil de Cyber Guru.
4. Dépannage et Conseils
Si vous recevez une page d'erreur lors de la connexion, vérifiez que l'URL SSO et les autres détails saisis dans la configuration du fournisseur de services correspondent à ce que vous avez téléchargé depuis Google.
N'oubliez pas que la propagation DNS ou des certificats peut prendre quelques minutes. Si les modifications n'apparaissent pas immédiatement, attendez un peu et réessayez.
Conservez le certificat ou le fichier de métadonnées téléchargé dans un endroit sûr. Vous pourriez avoir besoin de le mettre à jour si des modifications surviennent dans votre configuration Google Workspace.
En utilisant un traceur SAML, vérifiez les valeurs des revendications dans la réponse SAML. Par exemple :
.
<saml2:AttributeStatement>
<saml2:Attribute Name="username">
<saml2:AttributeValue xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="xsd:anyType" >
gianmarco.cagnotto@testcyberguru.org
</saml2:AttributeValue>
</saml2:Attribute>
<saml2:Attribute Name="firstName"><saml2:AttributeValue xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="xsd:anyType" >
Gianmarco
</saml2:AttributeValue>
</saml2:Attribute>
<saml2:Attribute Name="lastName">
<saml2:AttributeValue xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="xsd:anyType" >
Cagnotto</saml2:AttributeValue>
</saml2:Attribute>
<saml2:Attribute Name="email">
<saml2:AttributeValue xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="xsd:anyType" >
gianmarco.cagnotto@testcyberguru.org
</saml2:AttributeValue>
</saml2:Attribute>
</saml2:AttributeStatement>5. Obtenir plus d'aide
-
Google dispose d'un Centre d'aide dédié à l'adresse https://support.google.com/ pour des articles supplémentaires et des conseils de dépannage.
-
Si vous avez un doute, demandez de l'aide au support technique de votre organisation ou à votre partenaire Google Workspace.