Um eine Google-App zu erstellen, die Ihren Benutzern den Zugriff auf ihre Google-Drive-Benutzerkonten von der Webmail-Seite Dokumente aus gestattet, gehen Sie folgendermaßen vor:
1.Melden Sie sich an der MDaemon-Remoteverwaltung an, und rufen Sie die Seite Google Drive auf. Sie finden diese Seite unter Hauptmenü » Webmail-Einstellungen. Aktivieren Sie dort die Option Einbindung von Google Drive aktivieren.
2.Wechseln Sie in einen gesonderten Browser-Tab. Melden Sie sich dort an Ihrem Google-Benutzerkonto an, und rufen Sie die Google-API-Konsole auf.
3.Falls Sie sich in der Projektliste befinden, klicken Sie auf NEUES PROJEKT. Falls Sie sich auf der Seite Ressourcen verwalten befinden, klicken Sie auf (+) PROJEKT ERSTELLEN.
4.Geben Sie einen Projektnamen ein, z.B. "Google Drive für MDaemon". Falls Sie die Projekt-ID ändern wollen, klicken Sie auf BEARBEITEN. Sie können die Projekt-ID auch unverändert lassen. Beachte: Die Projekt-ID kann nach der Erstellung des Projekts nicht mehr geändert werden.
5.Falls Sie über eine Organisationsressource verfügen, wählen Sie diese im Feld Speicherort aus. Andernfalls belassen Sie den Eintrag "Keine Organisation".
6.Nachdem das Projekt geladen wurde, klicken Sie auf + APIS UND DIENSTE AKTIVIEREN.
7.Tragen Sie in das Suchfeld "Google Drive" ein, wählen Sie Google Drive API aus, und klicken Sie auf Aktivieren.
8.Klicken Sie im Navigationsbereich links im Abschnitt APIs und Dienste auf Anmeldedaten.
9.Klicken Sie am oberen Seitenrand auf + ANMELDEDATEN ERSTELLEN, und wählen Sie im Dropdownmenü den Eintrag API-Schlüssel.
10.Kopieren Sie den Schlüssel aus dem Feld Mein API-Schlüssel in die Zwischenablage (hierfür steht eine Schaltfläche neben dem Eintrag zur Verfügung).
11.Wechseln Sie in den Browser-Tab, in dem die MDaemon-Remoteverwaltung angezeigt wird, und fügen Sie den API-Schlüssel in das Feld API-Schlüssel für Google Drive ein. Falls Sie diesen Vorgang später ausführen wollen, können Sie den API-Schlüssel auch anderweit speichern.
12.Wechseln Sie zurück in den Browser-Tab, in dem die Google-API-Konsole angezeigt wird. Klicken Sie dort im Navigationsbereich links im Abschnitt API und Dienste auf OAuth-Zustimmungsbildschirm.
13.Wählen Sie im Abschnitt Under User Type den Eintrag Extern aus, und klicken Sie auf ERSTELLEN. Beachte: Falls Sie über eine Organisationsressource verfügen, sowie in Abhängigkeit von dem Veröffentlichungsstatus Ihrer App, kann die Option Intern vorzugswürdig sein. Nähere Informationen hierzu finden Sie im Abschnitt Veröffentlichungsstatus weiter unten.
14.Geben Sie den Anwendungsnamen ein (z.B. Google Drive für Webmail). Geben Sie eine Nutzersupport-E-Mail ein, an die sich die Benutzer wenden können, und geben Sie unter Kontaktdaten des Entwicklers eine E-Mail-Adresse ein, an die sich Google bei Änderungen an Ihrem Projekt wenden kann. Weitere Angaben müssen Sie auf dieser Seite für die Erstellung der App nicht machen. Je nach Ihrer Organisation oder Ihren Prüfvorschriften können Sie aber noch das Anwendungslogo und Verknüpfungen zu Ihren Nutzungsbedingungen und der Datenschutzerklärung Ihres Unternehmens hinzufügen. Die Felder für die Anwendungsdomänen und die Liste autorisierter Domänen werden automatisch ausgefüllt, wenn Sie in einem späteren Schritt die Redirect-URIs hinzufügen. Beachte: Diese Informationen werden für den Zustimmungsbildschirm verwendet, den Ihre Benutzer dann angezeigt erhalten, wenn sie MultiPOP für den Zugriff auf Google Drive berechtigen.
15.Klicken Sie auf SPEICHERN UND FORTFAHREN.
16.Klicken Sie auf BEREICHE HINZUFÜGEN ODER ENTFERNEN, und kopieren Sie die nachfolgend aufgeführten URIs in das Eingabefeld im Abschnitt "Bereiche manuell hinzufügen". Sie können alle URIs gleichzeitig kopieren. Klicken Sie danach auf ZUR TABELLE HINZUFÜGEN.
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.Klicken Sie auf SPEICHERN UND FORTFAHREN.
18.Klicken Sie im Abschnitt Testnutzer auf ADD USERS (Benutzer hinzufügen), und geben Sie jedes Google-Drive-Benutzerkonto ein auf das über MDaemon zugegriffen werden soll. Klicken Sie danach auf HINZUFÜGEN (beachten Sie auch die Hinweise zum Veröffentlichungsstatus Ihrer App weiter unten).
19.Klicken Sie auf SPEICHERN UND FORTFAHREN.
20.Klicken Sie im Abschnitt Fazit am Ende der Seite auf ZURÜCK ZUM DASHBOARD.
21.Klicken Sie im Navigationsbereich links auf Anmeldedaten, und klicken Sie danach auf (+) ANMELDEDATEN ERSTELLEN. Wählen Sie die Option OAuth-Client-ID.
22.Wählen Sie im Dropdownmenü "Anwendungstyp" den Eintrag Webanwendung aus, und klicken Sie danach im Abschnitt "Autorisierte Weiterleitungs-URIs", click + URI HINZUFÜGEN. Geben Sie den Weiterleitungs-URI ein. Der Redirect-URI, der auf der Seite Google Drive als Beispiel angezeigt wird, ist ein Beispiel, das aus dem SMTP-Hostnamen der Standard-Domäne erstellt wird. Er sollte für die Benutzer dieser Domäne bei der Anmeldung an Webmail nutzbar sein. Sie sollten auch für alle anderen MDaemon-Domänen, die Ihre Benutzer für die Anmeldung an Webmail möglicherweise verwenden, solche Redirect-URIs erstellen. Ein Beispiel hierzu: "https://mail.example.com/WorldClient.dll?View=OAuth&AuthRequest=GoogleDrive" würde für alle Benutzer funktionieren, die sich über die Domäne mail.example.com an Webmail anmelden. Falls bei Ihnen beispielsweise auch eine Domäne "mail.company.test" gehostet wird, dann würde auch ein Redirect-URI für diese Domäne benötigt, also beispielsweise "https://mail.company.test/WorldClient.dll?View=OAuth&AuthRequest=GoogleDrive".
23.Klicken Sie auf ERSTELLEN.
24.Kopieren Sie die Daten aus den Feldern Client-ID und Clientschlüssel in die Felder für die Client-ID und den Client-Schlüssel in Ihrem Konfigurationsdialog Google Drive. Sie können hier auch den API-Schlüssel für Google Drive eintragen, falls Sie das zuvor nicht schon erledigt haben.
|
Veröffentlichungsstatus — Diese Anleitung bezieht sich auf die Erstellung einer Google-App mit dem Veröffentlichungsstatus "Test". Dieser Status erfordert das Hinzufügen jedes einzelnen Google-Benutzerkontos, auf dessen Google Drive von Webmail aus zugegriffen werden soll. Die Höchstgrenze sind hierbei 100 Benutzer. Wenn Ihre Benutzer in Webmail dazu aufgefordert werden, MDaemon die Berechtigung zum Zugriff auf Google Drive zu erteilen, erscheint eine Warnmeldung. Sie fordert den Benutzer dazu auf, zu bestätigen, dass Testzugriff auf das Projekt besteht und dass die Risiken verstanden werden, die mit dem Zugriff einer ungeprüften App auf die Daten verbunden sind. Die eingeräumte Berechtigung verfällt nach sieben Tagen; alle Benutzer müssen daher einmal wöchentlich den Zugriff auf Google Drive erneut gestatten.
Um diese Einschränkungen und Anforderungen außer Kraft zu setzen, müssen Sie den Status der App auf "In Produktion" setzen. Sie müssen dazu unter Umständen einen Prüfprozess durchlaufen. Nähere Informationen über die Prüfung von Apps und den Veröffentlichungsstatus finden Sie in folgenden Artikeln, die Google in englischer Sprache veröffentlicht hat: Erstellen Ihres OAuth-Zustimmungsbildschirms und FAQ zur Prüfung der Authentifizierungs-API.
|
Berechtigung für Google Drive in Webmail erteilen
Nachdem die App für Google Drive erstellt und die Optionen auf der Seite Google Drive in MDaemon nach der vorstehenden Anleitung konfiguriert wurden, müssen alle Benutzer, die über Webmail auf ihre Google-Drive-Benutzerkonten zugreifen wollen, hierzu die entsprechende Berechtigung erteilen. Hierzu müssen die Benutzer folgendermaßen vorgehen:
1.An Webmail anmelden
2.Das Symbol Optionen in der oberen rechten Bildschirmecke anklicken, und danach Cloud-Apps anklicken.
3.Google Drive einrichten anklicken. Hierdurch öffnet sich eine OAuth-2.0-Seite.
4.Verknüpfung mit Google Drive herstellen anklicken.
5.Falls der Benutzer noch nicht angemeldet ist, fordert Google Drive zur Anmeldung oder zur Auswahl eines Benutzerkontos auf.
6.Es kann eine Warnmeldung angezeigt werden, dass Google die App nicht überprüft hat, und dass Zugriff auf eine App gewährt wird, die noch getestet wird, sowie dass der Vorgang nur fortgesetzt werden soll, wenn sich der Benutzer sicher ist, dass der Entwickler der App bekannt ist. Diese Warnmeldung muss mit Fortfahren bestätigt werden.
7.Die Leistungsmerkmale von Google Drive auswählen, die in Webmail zur Verfügung stehen sollen. Anschließend Fortsetzen anklicken.
8.Es erscheint ein abschließender Hinweis, dass MDaemon jetzt mit Google Drive verbunden ist. Das Fenster kann nun geschlossen werden.
9.Der Zugriff auf Google Drive über die Seite Dokumente in Webmail ist jetzt möglich. |
Erstellen und Verbinden Ihrer App für Google Drive