Suivez les étapes ci-dessous pour créer une application Google permettant aux utilisateurs d'accéder à leur Google Drive dans Webmail, sur la page Documents.
1.Connectez-vous à MDaemon Remote Admin, accédez à la page Google Drive (située sous Accueil » Paramètres de MDaemon Webmail) et activez l'option Activer l'intégration de Google Drive.
2.Dans un autre onglet du navigateur, connectez-vous à votre compte Google et accédez à la console Google Cloud.
3.Si vous êtes sur la page "Project List", cliquez sur NEW PROJECT, ou si vous êtes sur la page "Manage Resources", cliquez sur (+) CREATE PROJECT.
4.Saisissez un Project name, par exemple "Google Drive pour MDaemon", puis cliquez sur Edit si vous souhaitez modifier le "Project ID", ou conservez sa valeur par défaut. Remarque : le "Project ID" ne peut plus être modifié une fois le projet créé.
5.Si vous disposez d'une ressource Organisation, sélectionnez-la dans Location. Sinon, conservez la valeur "No organization".
6.Une fois la page chargée, cliquez sur + ENABLE APIS AND SERVICES.
7.Dans le champ de recherche, saisissez "Google Drive", sélectionnez Google Drive API, puis cliquez sur Enable.
8.Dans le volet de gauche, sous APIs & Services, cliquez sur Credentials.
9.Cliquez sur + Create Credentials en haut de la page, puis sélectionnez API Key dans le menu déroulant.
10.Copiez Your API key (une icône de copie dans le presse-papiers se trouve à côté).
11.Revenez à l'onglet MDaemon de votre navigateur et collez la clé dans le champ Clé d'API Google Drive de la page Google Drive de MDaemon (ou enregistrez-la ailleurs si vous souhaitez le faire plus tard).
12.Dans le volet de gauche, sous APIs & Services, cliquez sur OAuth consent screen, puis sur Get started.
13.Sous App Information, saisissez l'App name (par exemple Google Drive pour Webmail) et, dans User support email, une adresse e-mail que les utilisateurs peuvent contacter, puis cliquez sur Next. Remarque : ces informations sont utilisées pour l'écran de consentement présenté aux utilisateurs pour qu'ils autorisent Webmail à accéder à leur Google Drive. Selon votre organisation ou vos exigences de vérification, vous pourrez également saisir ultérieurement le logo de votre entreprise et des liens vers vos conditions d'utilisation et votre politique de confidentialité (voir ci-dessus) sur la page Branding.
14.Sous Audience, sélectionnez External, puis cliquez sur Next. Remarque : si vous disposez d'une ressource Organisation, ou selon l'état de publication de votre application, il peut être préférable de choisir "Internal". Pour plus d'informations, voir la remarque État de publication ci-dessous.
15.Sous Contact Information, saisissez une adresse e-mail dans Email address pour que Google puisse vous contacter au sujet des modifications apportées à votre projet, puis cliquez sur Next.
16.Sous Finish, acceptez la politique "Google API Services: User Data Policy", cliquez sur Continue, puis sur Create.
17.Dans le volet de gauche, cliquez sur Data Access, puis sur Add or Remove Scopes. Copiez-collez les URI ci-dessous (vous pouvez tous les copier-coller en une seule fois) dans la zone située sous "Manually add scopes", cliquez sur Add to table, puis sur Update.
https://www.googleapis.com/auth/userinfo.email
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/documents
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive.metadata
https://www.googleapis.com/auth/drive.photos.readonly
https://www.googleapis.com/auth/drive.activity.readonly
https://www.googleapis.com/auth/spreadsheets
18.Cliquez sur Save.
19.Dans le volet de gauche, cliquez sur Audience. Sous Test users, cliquez sur Add users, saisissez chaque compte Google dont MDaemon utilisera le Google Drive via cette application, puis cliquez sur Save (voir la remarque ci-dessous sur l'état de publication de votre application).
20.Dans le volet de gauche, cliquez sur Clients, puis sur Create Client.
21.Dans la liste déroulante "Application type", sélectionnez Web application et, sous "Authorized redirect URIs", cliquez sur Add URI. Saisissez l'URI de redirection. L'URI de redirection affiché sur la page Google Drive de MDaemon est un exemple construit à partir du Nom d'hôte SMTP de votre Domaine par défaut, ce qui devrait fonctionner pour les utilisateurs de ce domaine lorsqu'ils se connectent à Webmail. Vous devez ajouter à votre application des URI de redirection supplémentaires pour chacun des autres domaines MDaemon auxquels vos utilisateurs accèdent pour se connecter à Webmail. Par exemple, "https://mail.example.com/WorldClient.dll?View=OAuth&AuthRequest=GoogleDrive" fonctionnerait pour tous vos utilisateurs qui accèdent à mail.example.com pour se connecter à Webmail. Si vous hébergez également un domaine appelé "mail.company.test", vous devez aussi saisir un URI de redirection pour ce domaine, c'est-à-dire "https://mail.company.test/WorldClient.dll?View=OAuth&AuthRequest=GoogleDrive".
22.Cliquez sur Create.
23.Copiez le Client ID et le Client secret dans les zones ID client Google Drive et Code secret client Google Drive de la page Google Drive de MDaemon. Remarque : Google n'affiche le code secret client qu'une seule fois, lors de la création du client. Si vous le perdez, vous devez ajouter un nouveau code secret au client. Vous pouvez également saisir votre clé d'API Google Drive si vous ne l'avez pas fait précédemment.

|
État de publication — Ces instructions concernent la création d'une application Google dont l'état de publication (Publishing Status) est défini sur "Testing". Dans ce cas, vous devez ajouter chaque compte Google qui utilisera l'application pour accéder à son Google Drive, et le nombre d'utilisateurs est limité à 100. De plus, dans Webmail, lorsque vos utilisateurs sont invités à autoriser MDaemon à accéder à Google, un message d'avertissement s'affiche "pour confirmer que l'utilisateur dispose d'un accès test à votre projet, mais qu'il doit tenir compte des risques liés à l'octroi de l'accès à ses données à une application non validée". Par ailleurs, l'autorisation expire au bout de sept jours ; chaque utilisateur doit donc autoriser à nouveau l'accès à Google chaque semaine.
Si vous souhaitez supprimer ces exigences et limitations, vous devez faire passer l'état à "In Production", ce qui peut nécessiter ou non de faire passer votre "User Type" de "External" à "Internal", de suivre une procédure de validation de l'application, ou les deux. Pour plus d'informations sur la validation des applications et l'état de publication, consultez les articles Google suivants : "Setting up your OAuth consent screen" et "OAuth API verification FAQs".
|
Autorisation de Google Drive dans Webmail
Une fois que vous avez créé votre application Google Drive et configuré la page Google Drive de MDaemon conformément aux instructions ci-dessus, chaque utilisateur qui souhaite accéder à son Google Drive dans Webmail doit d'abord autoriser cet accès. Pour cela, chaque utilisateur doit :
1.Se connecter à Webmail.
2.Cliquer sur l'icône Options dans l'angle supérieur droit, puis sur Applications Cloud.
3.Cliquer sur Configurer Google Drive (cela ouvre une page OAuth 2.0).
4.Cliquer sur Connecter à Google Drive.
5.S'il n'est pas connecté, Google Drive lui demande de saisir ses informations de connexion ou de choisir un compte.
6.Un message d'avertissement peut alors s'afficher : "Google hasn't verified this app. You've been given access to an app that's currently being tested. You should only continue if you know the developer that invited you." Cliquer sur Continuer.
7.Sélectionner les fonctionnalités de Google Drive auxquelles Webmail pourra accéder, puis cliquer sur Continuer.
8.Une dernière page s'affiche, indiquant que MDaemon est désormais connecté à Google Drive. L'utilisateur peut alors fermer cette fenêtre.
9.L'utilisateur peut ensuite accéder à Google Drive depuis sa page Documents dans Webmail. |