Für Administratoren
← Alle Themen

Google Workspace: Postfächer verbinden

Die Verbindung mit dem Konto des Postfachs (Client der Organisation), zusätzlich ein Dienstkonto für freigegebene Postfächer – und was Sie in Google Cloud und Google Admin einrichten, Schritt für Schritt.

Damit der Assistent Post in Google Workspace lesen und dort Entwürfe anlegen kann, braucht er Zugriff über die Gmail API. Dafür legt die Organisation etwas in ihrer eigenen Google Cloud an; draften hat keine gemeinsame App, der Sie nur zustimmen müssten. Das gilt für unseren Dienst ebenso wie für eine Installation auf dem eigenen Server.

Alles hier gilt nur für Konten von Google Workspace mit eigener Domain. Mit einem privaten Konto @gmail.com kann man sich nicht bei draften anmelden; ein privates Gmail verbinden Sie aber über IMAP mit einem App-Passwort – siehe Unterstützte Anbieter und Grenzen.

Was Sie möchten und was Sie einrichten

Was Sie möchtenWas Sie einrichten
Die Mitglieder melden sich mit dem Google-Konto an, und jedes hat ein eigenes PostfachClient der Organisation – das genügt
Dazu Postfächer, bei denen sich niemand anmeldet (etwa info@), oder einen zentral eingerichteten Zugriff auf die Postfächer, ohne deren Inhaberzusätzlich die Registrierung der Organisation (Dienstkonto)
Sie möchten keine Anmeldung mit dem Google-Kontodie Mitglieder melden sich mit dem Passwort aus der Einladung an, die Post verbindet die Registrierung der Organisation (oder IMAP)

Zwei verschiedene Dinge bei Google

Der Client der Organisation und die Registrierung der Organisation sind zwei getrennte Dinge in der Google Cloud. Jedes erledigt etwas anderes, und keines ersetzt das andere:

Client der OrganisationRegistrierung der Organisation
Was es istOAuth-Client mit einem Consent Screen vom Typ InternalDienstkonto mit Schlüssel und Domain-wide Delegation
Was es tutAnmeldung der Mitglieder mit der Schaltfläche Mit Google anmelden und die Schaltfläche Gmail verbinden beim eigenen PostfachZugriff des Assistenten auf die Postfächer, ohne dass sich deren Inhaber anmelden
Wo in draftenOrganisation → Anmeldung und Zugriff auf die Post → Karte Kontoanmeldung und PostfachverbindungenOrganisation → Anmeldung und Zugriff auf die Post → Karte Registrierungen für freigegebene Postfächer und zentrale Verwaltung
Wer es in draften einrichtetder Inhaber der Organisationder Inhaber oder ein Manager der Organisation
Wer es bei Google anlegtein Administrator der Google Cloudein Administrator der Google Cloud und ein Super Admin in Google Admin
Wer sich beim Postfach anmeldetder Inhaber jedes Postfachs, einmalniemand
Welche Postfächer erreicht werdennur die, die die Mitglieder selbst verbindenalle Postfächer der Domain

Es sind absichtlich zwei Dinge. Die Zustimmung zum Client gibt nur Rechte an den Postfächern, die die Mitglieder selbst verbinden – nie an der Post der ganzen Domain. Das Dienstkonto erreicht dagegen jedes Postfach der Domain, und deshalb bekommt draften es nur für den Zugriff auf die Postfächer, nicht für die Anmeldung. Legen Sie die beiden nicht zusammen.

Jedes Postfach verwendet einen der beiden Zugänge; beides können Sie gleichzeitig haben. draften verlangt nur den Berechtigungsbereich gmail.modify – Lesen und Anlegen von Entwürfen, es sendet nichts.

Client der Organisation: Anmeldung und Gmail verbinden

Der Inhaber des Postfachs meldet sich mit seinem Google-Konto an und erlaubt den Zugriff nur auf seine eigene Post. Derselbe Client dient auch der Anmeldung bei draften mit dem Google-Konto.

In der Google Cloud

Sie arbeiten in https://console.cloud.google.com, angemeldet mit dem Konto eines Administrators Ihrer Workspace-Domain. Alles geschieht in einem Projekt – das gewählte Projekt sehen Sie oben links neben dem Logo von Google Cloud; dort wechseln Sie es auch oder legen ein neues an. Das Hauptmenü öffnen Sie mit dem Symbol ☰ oben links.

  1. Öffnen Sie zuerst in draften Organisation → Anmeldung und Zugriff auf die Post, Karte Kontoanmeldung und Postfachverbindungen. Sie zeigt zwei Redirect URIs genau für Ihre Adresse von draften – sie enden auf /auth/google/callback und /mailboxes/connect/google/callback. Kopieren Sie sie von dort; sie müssen Zeichen für Zeichen stimmen.
  2. Wählen Sie ein Projekt, oder legen Sie ein neues an (etwa draften), und schalten Sie darin die Gmail API ein: ☰ → APIs & Services → Library, suchen Sie Gmail API, öffnen Sie sie und klicken Sie auf Enable. Direkt: https://console.cloud.google.com/apis/library/gmail.googleapis.com
  3. Legen Sie fest, wie sich die App den Benutzern vorstellt (Consent Screen): ☰ → APIs & Services → OAuth consent screen. Es öffnet sich die Seite Google Auth Platform; direkt: https://console.cloud.google.com/auth/overview (prüfen Sie, dass oben das richtige Projekt gewählt ist). Klicken Sie auf Get started und gehen Sie die Schritte durch:
    • App Information – App name draften und User support email (Ihre E-Mail-Adresse oder eine Gruppe der Administratoren). Next.
    • Audience – wählen Sie Internal. Anmelden kann sich dann nur ein Konto Ihrer Workspace-Domain, und Google muss die App nicht überprüfen. Next.
    • Contact Information – die E-Mail-Adresse, an die Google Ihnen Hinweise zur App schickt. Next.
    • Finish – haken Sie das Kästchen mit der Zustimmung zu den Richtlinien von Google an (I agree to the Google API Services: User Data Policy), klicken Sie auf Continue und dann auf Create.
  4. Erlauben Sie der App die Berechtigungsbereiche. Öffnen Sie in Google Auth Platform im Menü links Data Access (direkt: https://console.cloud.google.com/auth/scopes) → Add or remove scopes. Haken Sie in der Liste openid, .../auth/userinfo.email und .../auth/userinfo.profile an. Den Berechtigungsbereich für Gmail tragen Sie in das Feld Manually add scopes ein: https://www.googleapis.com/auth/gmail.modify → Add to table. Klicken Sie auf Update und unten auf Save.
  5. Legen Sie den Client an. Öffnen Sie in Google Auth Platform im Menü links Clients (direkt: https://console.cloud.google.com/auth/clients) → Create client. Application type: Web application, Name etwa draften. Klicken Sie bei Authorized redirect URIs auf Add URI und fügen Sie die erste Adresse aus der Karte ein, dann wieder Add URI und die zweite. Klicken Sie auf Create.
  6. Es erscheinen Client ID und Client secret – kopieren Sie sich sofort beides. Das Client secret zeigt Google später nicht mehr an; wenn Sie es verlieren, legen Sie beim Client ein neues an.

In draften

  1. Der Inhaber der Organisation öffnet Organisation → Anmeldung und Zugriff auf die Post, trägt in der Karte Kontoanmeldung und Postfachverbindungen unter Google-OAuth-Client die Client ID und das Client secret aus Schritt 6 ein und klickt auf Speichern.
  2. Die Anmeldung mit dem Google-Konto schaltet er auf derselben Seite in der Karte Wie sich Mitglieder anmelden ein: Er trägt unter E-Mail-Domains der Organisation seine Workspace-Domain ein – die primäre, keine Alias-Domain (die sendet Google bei der Anmeldung nicht). Sobald die Organisation den Client und die Domain hat, melden sich die Mitglieder mit dem Google-Konto an, und ihre Passwörter gelten nicht mehr – siehe Wie sich Mitglieder anmelden.
  3. Der Inhaber des Postfachs öffnet die Seite des Postfachs und klickt in der Karte Zugriff auf die Post in der Zeile Mit dem Konto des Postfachs verbinden: auf Gmail verbinden. Er meldet sich mit dem Konto dieses Postfachs an – ein anderes Konto lehnt draften ab – und erlaubt den Zugriff. Die Schaltfläche sieht nur der Inhaber des Postfachs, und nur wenn die Organisation den Client hat; ohne ihn steht in der Karte statt der Schaltfläche, dass die Verbindung mit dem Konto möglich ist, sobald der Inhaber der Organisation den Client hinzufügt.
  4. Dann Verbindung testen.

Wenn das Postfach getrennt wird

Registrierung der Organisation: Zugriff ohne Anmeldung

Ein Dienstkonto mit Domain-wide Delegation gibt dem Assistenten Zugriff auf die Postfächer der Domain, ohne dass sich jemand anmeldet. Es eignet sich für Postfächer, bei denen sich niemand anmeldet (etwa info@), und für Organisationen, die den Zugriff zentral verwalten möchten. Mit der Anmeldung bei draften hat es nichts zu tun.

In der Google Cloud

Sie arbeiten in https://console.cloud.google.com, im selben Projekt, in dem die Gmail API eingeschaltet ist (Schritt 2 beim Client der Organisation; ohne Client schalten Sie sie genauso ein). Prüfen Sie das Projekt oben links neben dem Logo von Google Cloud.

  1. Öffnen Sie die Liste der Dienstkonten: ☰ → IAM & Admin → Service accounts. Direkt: https://console.cloud.google.com/iam-admin/serviceaccounts
  2. Klicken Sie oben auf + Create service account und gehen Sie drei Schritte durch:
    • Service account details – Service account name etwa draften-post (die ID wird von selbst ergänzt). Klicken Sie auf Create and continue.
    • Permissions (optional) – wählen Sie nichts; Rollen im Projekt braucht es keine, Zugriff auf die Post erhält es erst durch die Delegation in Google Admin. Klicken Sie auf Continue.
    • Principals with access (optional) – tragen Sie nichts ein, klicken Sie auf Done.
  3. Klicken Sie in der Liste auf das neue Dienstkonto. Kopieren Sie auf der Registerkarte Details die Unique ID – eine lange Zahl; das ist die Client-ID für Google Admin.
  4. Registerkarte Keys → Add key → Create new key → Key type: JSON → Create. Der Browser lädt eine Datei mit dem Schlüssel herunter (….json).

Lehnt Google das Anlegen des Schlüssels ab, hat Ihre Organisation die Richtlinie Disable service account key creation (iam.disableServiceAccountKeyCreation; neue Organisationen haben sie standardmäßig) eingeschaltet. Ein Administrator der Organisation schaltet sie für dieses Projekt aus: ☰ → IAM & Admin → Organization policies (https://console.cloud.google.com/iam-admin/orgpolicies), sucht iam.disableServiceAccountKeyCreation → Manage policy → Override parent's policy → Enforcement: Off → Set policy. Wiederholen Sie dann Schritt 4.

In Google Admin

Sie brauchen ein Konto als Super Admin von Google Workspace.

  1. Öffnen Sie https://admin.google.com → im Menü links Security → Access and data control → API controls → unten Domain wide delegation → Manage domain wide delegation. Direkt: https://admin.google.com/ac/owl/domainwidedelegation
  2. Klicken Sie auf Add new und füllen Sie aus:
    • Client ID – die numerische Unique ID aus Schritt 3,
    • OAuth scopes (comma-delimited) – https://www.googleapis.com/auth/gmail.modify.

    Klicken Sie auf Authorize. Die Delegation erscheint in der Liste. Sie wirkt meist innerhalb weniger Minuten, in Ausnahmefällen erst nach einigen Stunden.

In draften

  1. Öffnen Sie Organisation → Anmeldung und Zugriff auf die Post, Karte Registrierungen für freigegebene Postfächer und zentrale Verwaltung. Registrierungen verwalten der Inhaber und die Manager der Organisation.
  2. System: Google Workspace. Füllen Sie Name aus, wählen Sie bei Schlüssel des Dienstkontos (JSON) die heruntergeladene Datei und klicken Sie auf Registrierung hinzufügen. Der Schlüssel wird verschlüsselt gespeichert; in der Karte sind danach nur die E-Mail-Adresse des Dienstkontos und seine Client-ID zu sehen.
  3. Wählen Sie auf der Seite jedes Postfachs in der Karte Zugriff auf die Post bei Registrierung der Organisation diese Registrierung, klicken Sie auf Übernehmen und dann auf Verbindung testen. Den Ablauf mit Bildschirmfotos zeigt die Anleitung Ein Postfach hinzufügen und verbinden.

Löschen Sie danach die heruntergeladene Schlüsseldatei. Wer sie hat, kommt in jedes Postfach der Domain. Einen neuen Schlüssel desselben Dienstkontos (Schritt 4 oben) laden Sie bei der Registrierung über neuer Schlüssel (JSON) hoch; den Schlüssel eines anderen Dienstkontos fügen Sie als neue Registrierung hinzu. Löschen Sie danach den alten Schlüssel in der Google Cloud: Dienstkonto → Registerkarte Keys → Papierkorbsymbol beim alten Schlüssel.

Ist Postfach automatisch eingeschaltet (Wie sich Mitglieder anmelden), wird ein neues Postfach von selbst an die Registrierung gebunden, wenn für Google Workspace genau eine aktiv ist.

Fehler beim Verbindungstest

Der Test prüft drei Schritte: Zugriff, Token und Berechtigung und Lesen des Posteingangs.

In der MeldungWas es bedeutetWas zu tun ist
die Delegation für den Berechtigungsbereich ist nicht erlaubt (unauthorized_client)in Google Admin fehlt die Domain-wide Delegation, oder sie hat eine andere Client-ID oder einen anderen Berechtigungsbereichdie Delegation in Google Admin prüfen: die numerische ID und den genauen Berechtigungsbereich gmail.modify
invalid_grant beim Dienstkontoein solches Postfach gibt es in der Workspace-Domain nichtdie Adresse des Postfachs prüfen
„Gmail API has not been used…“im Projekt ist die Gmail API nicht eingeschaltetdie Gmail API einschalten
Token ohne gmail.modifyder Delegation oder dem Consent Screen fehlt der Berechtigungsbereich gmail.modifyden Berechtigungsbereich ergänzen
invalid_grant, deleted_client bei einem verbundenen Kontodie Verbindung wurde widerrufen oder der Client gelöschtGmail neu verbinden

Weitere Fehler beschreibt Fehlerbehebung.

Textfassung