Comment configurer Google Apps Integration Pro sur votre sous-wiki

26 juil. 2021 5 min read
Écrit par Andreea Chirica, Spécialiste Communications et Support

Considérons le cas où vous avez étendu vos procédures ou votre contenu à un sous-wiki. Sur le wiki principal, les utilisateurs accèdent aux applications Google et les modifient après s'être connectés au wiki à l'aide de leur compte Google. Si vous souhaitez aider les employés de la société à se connecter au sous-wiki en utilisant leur compte Google (comme dans le tutoriel consacré à la configuration de l'application d'intégration sur votre wiki principal), suivez les étapes du tutoriel ci-dessous.

Rappel de ce que vous pouvez faire avec l'application Google Apps Integration Pro dans XWiki

Google Apps Integration Pro vous permet d'intégrer XWiki avec l'application d'édition de Google (Google Docs, Spreadsheet, Presentations et Drawing). Grâce à cette application, il est possible de :

  • de se connecter à XWiki en utilisant votre compte Google
  • importer facilement un document Google Apps en tant que pièce jointe dans XWiki (dans plusieurs formats)
  • lancer l'édition d'une pièce jointe XWiki dans Google Apps. Une fois la session d'édition terminée, vous pouvez la réimporter dans XWiki.

Cette intégration utilise le protocole OAuth2 pour connecter Google Apps à XWiki. Elle fonctionne aussi bien avec des comptes Google individuels qu'avec des comptes Google Apps d'entreprise.

Configuration de Google Apps Integration Pro sur le wiki principal

main-wiki-google-apps-configuration-exemple.png

Configuration de l'extension Google Apps Integration Pro effectuée sur un wiki principal avec un ID client et une clé secrète fictifs.

Dans l'image ci-dessus, vous remarquez la section de configuration de Google Apps sur l'administration d'un wiki principal (le processus complet a été expliqué dans cet article). Afin d'utiliser la même application qui a été configurée pour le wiki principal, la même personne qui a fait la configuration de l'intégration doit accéder à nouveau au projet Google Console créé (car il a été créé en utilisant son compte Google), et utiliser le nom de l'application, l'ID client et la clé secrète à partir des informations d'identification créées dans le projet. Vérifiez ci-dessous toutes les étapes pour intégrer et configurer le Google Apps Integration Pro sur votre subwiki.

Étape 1 : Accéder au projet Google Console créé pour le wiki principal

Accédez au projet créé pour le wiki principal sur le site Google Console https://console.developers.google.com/ (dans cet exemple, le projet s'appelle "Activating Google Login"). Vous avez besoin du nom de l'application à partir de l'écran APIs et Services, Écran de consentement OAuth.

google-console-project-application-fr.png

Exemple avec une application d'intégration enregistrée initialement définie pour le wiki principal Cloud - prenez le nom de l'application à partir de cette page.

Étape 2 : obtenez les informations d'identification et ajoutez les URI autorisés vers votre sous-wiki

Cliquez sur les identifiants créés pour ce projet. Ajoutez comme URI de redirection autorisé un chemin qui se référerait à votre sous-wiki visé, avec /GoogleApps/OAuth à la fin. N'oubliez pas de sauvegarder cette modification. Exemples d'URIs ci-dessous :

Copiez l'ID client et le Code secret du client et rendez-vous sur la page d'administration de votre sous-wiki.

identifiants-main-et-subwiki-URI.png

Étape 3 : Installer l'application sur le sous-wiki

Assurez-vous que vous avez installé l'application Google Apps Integration Pro sur le sous-wiki où vous souhaitez vous connecter à l'aide d'un compte Google. Allez dans l'administration du sous-wiki > Gestionnaire d'extensions et installez l'application.

Étape 4 : Configuration de Google Apps dans l'administration du sous-wiki

Après avoir installé l'application, rafraîchissez la page d'administration du sous-wiki et dans la section Divers, vous verrez l'onglet Google Apps. Là, collez l'ID client, le code secret et le nom de l'application dans les champs prévus à cet effet. Il existe également d'autres options supplémentaires si vous souhaitez restreindre le domaine des utilisateurs autorisés à se connecter au sous-wiki. Par exemple, si le compte Google de votre organisation est enregistré sous le domaine fron.com (l'adresse électronique du projet d'exemple est danielle.glence@fron.com), vous pouvez l'ajouter afin que seuls les membres de votre entreprise ayant ce domaine dans leur adresse électronique puissent accéder au wiki. Il y a aussi l'utilisation de cookies pour la connexion Google Apps qui est fournie comme une fonctionnalité pour vous aider à vous connecter à votre wiki plus rapidement et à rester connecté si vous le souhaitez.

subwiki-administration-google-apps-configuration-exemple.png

Étape 5 : Définir les autorisations pour les utilisateurs non enregistrés au niveau global

Ensuite, une dernière modification dans l'administration du sous-wiki serait d'aller dans la section Utilisateurs et groupes, l'onglet Droits, de sélectionner les Utilisateurs et de nier explicitement les droits pour les utilisateurs non enregistrés afin de les empêcher de voir ou de modifier les pages de votre wiki. Ceci est nécessaire car, actuellement, l'application ne fonctionne pas si vous gardez cochée l'option "Interdire aux utilisateurs non inscrits de voir les pages, quels que soient les droits sur la page".

subwiki-rights-unregistered-users-fr.png

Nous espérons que ce tutoriel vous aidera à intégrer Google Apps sur votre sous-wiki. Consultez la page d'installation de l'application Google Apps Integration Pro pour plus d'exemples de configurations sur des wikis locaux et hébergés.

Articles similaires :