Comment configurer Google Apps Integration Pro sur votre wiki principal

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

Si votre organisation utilise Google Apps, vous serez heureux d'apprendre qu'une intégration est disponible dans XWiki. Ce tutoriel montre comment ajouter la fonction de connexion à un wiki principal à l'aide d'un compte Google.

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.

Étapes d'installation requises sur la Google Console

Si c'est la première fois que vous essayez d'ajouter une connexion Google sur votre wiki principal, vous devez suivre certaines étapes.

L'application Google Apps Integration Pro nécessite quelques réglages afin de pouvoir se connecter à votre wiki à l'aide d'un compte Google. Vous devez d'abord vous enregistrer pour l'accès OAuth sur la console Google. Suivez les étapes ci-dessous :

Étape 1 : Créer un projet Google pour votre application Google Apps Integration Pro

Allez sur https://console.developers.google.com/ (voir aussi https://developers.google.com/identity/protocols/oauth2). Créez un projet Google pour votre application comme indiqué ci-dessous :

nouveau-projet.png

Étape 2 : Activer l'API Google People

Pour continuer, vous devez activer l'API Google People. Cette API est nécessaire pour accéder aux informations du compte Google. Pour l'activer, allez dans la section API et services du projet, sur le Tableau de bord, cliquez sur ACTIVER LES API ET SERVICES, recherchez l'API Google People et cliquez sur ACTIVER.

googlepeople-api.png

Étape 3 : Activez l'API Google Drive

Cette API est nécessaire pour accéder aux documents Google. De même, pour l'activer, retournez au tableau de bord et cliquez sur ACTIVER LES API ET SERVICES, recherchez l'API Google Drive et cliquez sur ACTIVER.

googledrive-api.png

Étape 4 : Paramètres de l'écran de consentement OAuth

Sélectionnez l'option Interne pour que l'option de connexion Google ne soit accessible qu'aux utilisateurs de votre organisation. 

consentement-OAuth-app.png

Sélectionnez le type d'utilisateurs que vous souhaitez viser dans le cadre de ce projet.
 

Ensuite, remplissez les champs suivants :

  • Nom de l'application (à utiliser ultérieurement sur la page de configuration de Google Apps dans la section Autres de l'administration du wiki).
  • Domaines autorisés (dans nos exemples, nous avons ajouté "xwiki.com")
  • Lien vers la page d'accueil de l'application (nous avons ajouté le lien vers la page principale du XWiki standard)
  • Lien vers la politique de confidentialité de l'application (nous avons ajouté le lien vers la page d'aide standard de XWiki)

enregistrement-app-OAuth.png

Exemple avec un wiki Cloud

Étape 5 : Générer l'identifiant et le code secret du client Google

La dernière étape consiste à générer les informations d'identification OAuth : l'identifiant et le code secret du client Google, qui seront ensuite ajoutés à la page de configuration de Google Apps sur votre administration principale du wiki. Ainsi, après avoir configuré le client OAuth, allez dans " Identifiants " et cliquez sur " Créer des identifiants " > " ID client OAuth ".

Ensuite, sélectionnez "Application Web" et indiquez un nom, ainsi que les URI de redirection autorisés. L'URI de redirection autorisé doit se terminer par GoogleApps/Oauth. Assurez-vous de taper sur la touche Entrée après avoir rempli l'URI de redirection autorisé, sinon la valeur ne sera pas enregistrée. Cliquez ensuite sur le bouton Enregistrer.

Vous trouverez ci-dessous un exemple avec un ID client et un code secret fictifs (pour des raisons de sécurité) et un URI de redirection autorisé utilisé pour se connecter à Google à partir d'un wiki principal. Il faudrait installer l'application Google Apps Integration Pro sur le wiki principal.

identifiants-id-code-appURI.png

Exemple d'URI autorisé, sur un wiki Cloud, lorsque le Google Login est configuré sur le wiki principal

Maintenant, vous avez tout mis en place sur le projet Google Console. Le nom de l'application (défini à l'étape précédente), l'ID client et le code secret devront être utilisés sur la page de configuration de Google Apps sur votre wiki principal (voir l'étape suivante pour des exemples).

Étapes requises du côté du wiki

Étape 6 : Installation de l'application

Tout d'abord, assurez-vous que vous avez installé l'application Google Apps Integration Pro sur le wiki principal. Allez dans l'administration du wiki principal > Gestionnaire d'extensions et installez l'application.

Étape 7 : Activer l'authentification Google

Activez l'authentification Groovy en ajoutant les paramètres suivants dans le fichier xwiki.cfg (trouvé dans webapps > xwiki > WEB-INF) et redémarrez le wiki :

xwiki.authentication.authclass=com.xpn.xwiki.user.impl.xwiki.GroovyAuthServiceImpl
xwiki.authentication.groovy.pagename=xwiki:GoogleApps.AuthService

Si vous êtes un utilisateur XWiki Cloud, vous n'avez pas d'accès direct au fichier xwiki.cfg. Vous devrez contacter l'équipe de support XWiki qui effectuera cette modification pour vous.

Étape 8 : Configuration de Google Apps dans l'administration du wiki

Allez dans l'administration du wiki, dans la section Divers et collez l'ID du client, l'ID 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 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.

configuration-sur-xwiki.png

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

Ensuite, une dernière modification dans l'administration du wiki principal 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".

droit-utilisateurs-nonenregistres.png

Nous espérons que ce tutoriel vous aidera à intégrer Google Apps dans votre plateforme XWiki. 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 :