Google Workspace est un fournisseur d’identité (IdP) qui permet aux utilisateurs de se connecter à plusieurs applications en utilisant leurs identifiants Google. Avec le SSO SAML configuré entre Google Workspace et Document360, vos membres d’équipe et lecteurs peuvent accéder à Document360 sans avoir besoin d’un mot de passe séparé.
Seuls les utilisateurs ayant les rôles de projet Propriétaire ou Administrateur peuvent configurer SSO dans Document360.
Que faire avec Google Workspace comme IDP
| Capacités | Soutenu |
|---|---|
| Authentification utilisateur (portail) | Oui |
| Authentification par lecteur (site de base de connaissances) | Oui |
| Connexion initiée par l’IdP | Oui |
| Provisionnement SCIM | Non |
| Héritage de configuration SSO (projets parent-enfant) | Oui (paramètres SSO uniquement, pas SCIM) |
Le provisionnement SCIM n’est pas pris en charge lorsque Google Workspace est configuré comme votre fournisseur d’identité. La gestion des utilisateurs et des lecteurs doit être gérée manuellement dans Document360.
Avant que tu commences
- Vous avez un compte Google Workspace actif avec accès administrateur. Si vous devez en créer un, inscrivez-vous à workspace.google.com.
- Vous avez l’accès Propriétaire ou Administrateur dans votre projet Document360.
- Ouvrez Document360 et Google Workspace dans deux onglets de navigateur distincts. Vous devrez basculer entre les deux plusieurs fois pendant la configuration.
Étape 1 : Créer une application SAML personnalisée dans Google Workspace
Ajouter une application SAML personnalisée
- Sur la page d’accueil de la console d’administration de Google Workspace, cliquez sur Applications et sélectionnez Applications SAML.
- Cliquez sur Ajouter l’application et dans le menu déroulant, sélectionnez Ajouter une application SAML personnalisée.
- Dans les détails de l’application, saisissez un nom pour votre application et cliquez sur Continuer.
Notez les détails de l’IDP et téléchargez le certificat
- À la page suivante, vous trouverez l’URL SSO, l’ID de l’entité et le certificat. Notez ces détails — vous en aurez besoin lors de la configuration du fournisseur d’identité dans Document360.
- Dans la section Certificat , cliquez sur l’icône de téléchargement pour enregistrer le certificat au
.pemformat dans votre stockage local. Vous téléverserez ce certificat plus tard dans Document360.
Activez l’application pour les utilisateurs
- Dans l’accès utilisateur, le statut du service est par défaut défini sur DÉSACTIVÉ pour tout le monde .
- Changez-la sur ON pour que tout le monde puisse permettre aux utilisateurs de s’authentifier via cette application.
Après avoir terminé la configuration côté Google, votre application SAML se présentera comme suit.
Étape 2 : Configurez le SAML dans Google Workspace en utilisant les paramètres Document360
Obtenez les paramètres du fournisseur de services via Document360
- Dans Document360, allez dans Paramètres () > Utilisateurs et permissions > SSO entreprise.
- Cliquez sur Créer SSO.
- Dans l’étape Choisir l’IDP , sélectionnez Google comme fournisseur d’identité.
- Depuis l’étape Configurer SP , copiez les paramètres requis.
Entrez les paramètres Document360 dans Google Workspace
- Passez à l’onglet Google Workspace et collez les paramètres Document360 dans l’application SAML personnalisée de Google en utilisant la correspondance ci-dessous.
| Application SAML personnalisée Google | Document360 |
|---|---|
| ACS URL | Chemin de rappel |
| Identifiant d’entité | ID d’entité fournisseur de services |
- Dans le format Name ID, sélectionnez EMAIL dans le menu déroulant.
- Dans l’ID du nom, sélectionnez Informations de base > Adresse principale à l’adresse E-mail.
- Cliquez sur Continuer.
Ajouter des correspondances d’attributs dans Google Workspace
- Ajoutez et sélectionnez des champs utilisateur dans Google Directory, puis associez-les aux attributs du fournisseur de services à l’aide du tableau ci-dessous.
| Attributs du Google Directory | Attributs de l’application |
|---|---|
| Adresse principale | Nom |
| Adresse principale | |
| Adresse principale | urn :oasis :names :tc :SAML :2.0 :nameid |
- Cliquez sur Ajouter une correspondance à chaque fois que vous ajoutez un attribut.
- Une fois terminé, cliquez sur Terminer.
Étape 3 : Terminer la configuration SSO dans Document360
Configurez le fournisseur d’identité dans Document360
- Revenez à Document360 à l’étape Configurer SP et cliquez sur Suivant pour accéder à l’étape Configurer l’IdP .
- Le champ Configurer une connexion existante vous permet d’hériter d’une configuration SSO déjà créée. En sélectionnant cette option, la configuration SSO actuelle sera définie comme enfant et aucune modification ne pourra être apportée. Pour en savoir plus sur l’héritage.
Une fois la configuration SSO créée avec une connexion héritée, les paramètres sont hérités de l’application mère et ne peuvent pas être modifiés dans l’application enfant. Les paramètres SCIM ne peuvent pas être hérités lorsque Google est l’IDP, même si la configuration parente a SCIM activé.
- Dans l’étape Configurer l’IdP , ajoutez les informations que vous avez indiquées depuis la page de l’application SAML personnalisée Google via la correspondance ci-dessous.
| Document360 | Application SAML personnalisée Google |
|---|---|
| URL de connexion | SSO URL |
| Identifiant d’entité | Identifiant d’entité |
| Certificat SAML | Certificat (téléchargez le fichier .pem téléchargé depuis Google) |
- Activez ou désactivez l’option Permettre la connexion initiée IdP en fonction des exigences de votre projet.
- Cliquez sur Suivant pour accéder à l’étape de provisionnement SCIM .
Étape de provisionnement SCIM
Le provisionnement SCIM n’est pas pris en charge lorsque Google est configuré comme votre fournisseur d’identité (IdP) dans Document360.
Cette limitation s’applique dans deux scénarios :
- Lors de la configuration d’une nouvelle configuration Google IdP.
- Lorsque vous avez hérité d’une configuration SSO existante qui utilise Google comme IDP.
Cliquez sur Suivant pour continuer.
Configurez le nom SSO et les options de connexion
- Dans le champ nom SSO , saisissez un nom pour la configuration SSO.
- Dans le texte du bouton Connexion, saisissez le texte que vous souhaitez afficher sur le bouton de connexion affiché aux utilisateurs.
- Assignation automatique du groupe de lecteurs — cette option n’est disponible que pour les configurations SSO existantes. Pour les configurations SSO nouvellement créées, ce basculement ne sera pas affiché car SCIM fournit automatiquement les utilisateurs et les groupes. En savoir plus sur l’assignation automatique du groupe de lecteurs.
- Choisissez d’inviter tous les utilisateurs ou des utilisateurs sélectionnés en utilisant les boutons radio SSO Convertir les comptes utilisateurs et lecteurs existants .
- Cliquez sur Créer pour compléter la configuration SSO.
La configuration SSO basée sur le protocole SAML a été configurée avec succès via Google Workspace.
Héritage d’une autre application
Lors de la création d’une nouvelle configuration SSO dans Document360, vous pouvez hériter des paramètres d’une connexion SSO existante. Cela simplifie le processus de configuration, évite la répétition des étapes de configuration et aide les administrateurs à gagner du temps tout en assurant la cohérence entre les intégrations.
À l’étape Configurer l’idP , sélectionnez le champ Configurer une connexion existante et choisissez l’application parent compatible SSO SCIM dont vous souhaitez hériter. En sélectionnant cette option, le projet en cours est désigné comme projet enfant, héritant de toutes les propriétés pertinentes du parent.
Une fois la configuration SSO créée, les paramètres seront hérités de l’application mère et ne pourront pas être modifiés dans l’application enfant.
Puisque le provisionnement SCIM ne prend pas en charge les configurations Google IdP, les paramètres SCIM du projet parent ne peuvent pas être hérités.
Alors que d’autres paramètres de configuration SSO sont hérités du projet parent, les paramètres SCIM seuls ne peuvent pas être hérités.
Gestion des utilisateurs dans Google IdP
Comme SCIM n’est pas pris en charge pour Google IdP, les utilisateurs et lecteurs doivent être gérés manuellement dans Document360.
Pour voir les lecteurs ajoutés via votre application Google SAML :
- Dans Document360, allez dans Paramètres () > Utilisateurs et permissions > Lecteurs et groupes.
- Sélectionnez un lecteur pour accéder à son profil de lecteur.
Les lecteurs provisionnés via SCIM afficheront un badge SSO-SCIM à côté de leur nom.
Lorsque SCIM est activé, modifier le nom d’un utilisateur ou supprimer un utilisateur directement dans Document360 est désactivé, car ces actions doivent être gérées via votre IdP pour maintenir les deux plateformes synchronisées. Vous ne pouvez gérer l’accès au contenu que depuis Document360.
Gérer l’accès au contenu des lecteurs, utilisateurs et groupes
Le rôle de contenu par défaut attribué à tout nouvel utilisateur, lecteur ou groupe est basé sur ce qui a été configuré lors de la configuration du provisionnement SCIM. Les permissions seront réglées par défaut sur Aucun mais pourront être mises à jour à tout moment.
- Sélectionnez le lecteur désiré et cliquez sur Gérer l’accès au contenu.
- Choisissez le niveau d’accès souhaité dans le menu déroulant et cliquez sur Mettre à jour.
Vous pouvez également gérer des groupes pour un lecteur en cliquant sur Gérer les groupes dans la section Groupe de lecteurs.
Meilleures pratiques
- Activez l’application pour tous les utilisateurs avant de tester SSO. Le statut du service d’application SAML Google est DÉSACTIVÉ pour tout le monde par défaut. Changez-le sur ON pour tout le monde avant d’inviter les utilisateurs à se connecter avec SSO.
- Sauvegardez le certificat .pem de manière sécurisée. Téléchargez et stockez le certificat Google avant de terminer la configuration dans Document360. Vous ne serez pas invité à le télécharger à nouveau.
- Utilisez la gestion manuelle des utilisateurs pour Google IdP. Puisque SCIM n’est pas pris en charge, planifiez comment vous allez ajouter, mettre à jour et supprimer des utilisateurs dans Document360 lorsque vous utilisez Google comme IDP.
- Envisagez Okta ou Entra si vous avez besoin de provisionnement SCIM. Si la gestion automatisée du cycle de vie utilisateur est nécessaire, configurez plutôt SSO en utilisant Okta ou Microsoft Entra comme fournisseur d’identité.
FAQ
Pourquoi le provisionnement SCIM n’est-il pas pris en charge pour Google IdP ?
Le provisionnement SCIM de Document360 nécessite des capacités spécifiques que Google Workspace ne prend pas en charge de la même manière qu’Okta ou Microsoft Entra. Si vous avez besoin d’un provisionnement automatisé des utilisateurs, envisagez de configurer SSO en utilisant Okta ou Microsoft Entra comme fournisseur d’identité.
Puis-je hériter des paramètres SCIM d’un projet parent lorsque j’utilise Google comme IDP ?
Non. Alors que d’autres paramètres de configuration SSO peuvent être hérités d’un projet parent, les paramètres SCIM ne peuvent pas être hérités lorsque Google est configuré comme fournisseur d’identité. Cela s’applique aussi bien aux nouvelles configurations qu’aux configurations héritées où le parent utilise Google comme IdP.
Que se passe-t-il pour les utilisateurs existants de Document360 lorsque je configure le SSO Google ?
Les utilisateurs existants ne sont pas automatiquement convertis. Dans le cadre de la configuration des options de nom et de connexion SSO, vous pouvez choisir d’inviter tous les utilisateurs existants ou certains utilisateurs à passer à la connexion SSO. Les utilisateurs convertis conservent tous leurs rôles et permissions existants.