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 API.
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.
13.Sous "User Type", sélectionnez External, puis cliquez sur Create. 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.
14.Saisissez l'App name (par exemple Google Drive pour Webmail), une Support email address que les utilisateurs peuvent contacter et une Developer email address que Google peut contacter au sujet des modifications apportées à votre projet. C'est tout ce qui est requis sur cette page pour la configuration, mais selon votre organisation ou vos exigences de vérification, vous pouvez également saisir le logo de votre entreprise et des liens vers vos conditions d'utilisation et votre politique de confidentialité (voir ci-dessus). Les champs Authorized domains sont remplis automatiquement lorsque vous ajoutez les URI de redirection lors d'une étape ultérieure ci-dessous. 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.
15.Cliquez sur Save and Continue.
16.Cliquez sur ADD OR REMOVE SCOPES, puis 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 ensuite sur ADD TO TABLE.
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
17.Cliquez sur Save and Continue.
18.Sous "Test Users", cliquez sur ADD USERS, saisissez chaque compte Google dont MDaemon utilisera le Google Drive via cette application, puis cliquez sur ADD (voir la remarque ci-dessous sur l'état de publication de votre application).
19.Cliquez sur Save and Continue.
20.Sur la page "Summary", cliquez sur BACK TO DASHBOARD en bas de la page.
21.Cliquez sur Credentials dans le volet de gauche, cliquez sur (+) Create Credentials, puis sélectionnez OAuth client ID.
22.Dans la liste déroulante "Application type", sélectionnez Web application et, sous "Authorized redirect URIs", cliquez sur + ADD URIs. 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".
23.Cliquez sur CREATE.
24.Copiez les valeurs de Your Client ID et de Your Client Secret dans les zones ID client Google Drive et Code secret client Google Drive de la page Google Drive de MDaemon. 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. |