Für Administratoren
← Alle Themen

Microsoft 365: Postfächer verbinden

Die Verbindung mit dem Konto des Postfachs (Client der Organisation), zusätzlich eine Registrierung für freigegebene Postfächer – und was Sie in Microsoft Entra einrichten, Schritt für Schritt.

Damit der Assistent Post in Microsoft 365 lesen und dort Entwürfe anlegen kann, braucht er Zugriff über Microsoft Graph. Dafür registriert die Organisation eine App in ihrem eigenen Microsoft Entra ID; 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 Geschäfts- und Schulkonten von Microsoft 365. Private Konten outlook.com, hotmail.com und live.com lassen sich überhaupt nicht verbinden – 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 Microsoft-Konto an, und jedes hat ein eigenes PostfachClient der Organisation – das genügt
Dazu freigegebene Postfächer (info@, vertrieb@) oder einen zentral eingerichteten Zugriff auf die Postfächer, ohne deren Inhaberzusätzlich die Registrierung der Organisation
Sie möchten keine Anmeldung mit dem Microsoft-Kontodie Mitglieder melden sich mit dem Passwort aus der Einladung an, die Post verbindet die Registrierung der Organisation (oder IMAP)

Zwei verschiedene Apps

Der Client der Organisation und die Registrierung der Organisation sind zwei getrennte Apps in Entra. Jede erledigt etwas anderes, und keine ersetzt die andere:

Client der OrganisationRegistrierung der Organisation
Was sie tutAnmeldung der Mitglieder mit der Schaltfläche Mit Microsoft anmelden und die Schaltfläche Outlook 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 sie in draften einrichtetder Inhaber der Organisationder Inhaber oder ein Manager der Organisation
Berechtigungen in Entradelegierte Berechtigungen (Delegated)Anwendungsberechtigungen (Application)
Wer sich beim Postfach anmeldetder Inhaber jedes Postfachs, einmalniemand
Welche Postfächer erreicht werdennur die, die die Mitglieder selbst verbindendie Postfächer des Verzeichnisses (lässt sich einschränken)
Freigegebene Postfächernein – sie haben keine eigene Anmeldungja
Wenn jemand das Unternehmen verlässtnach der Sperrung seines Kontos wird das Postfach getrenntes ändert sich nichts

Es sind absichtlich zwei Apps. Die Zustimmung zum Client gibt nur Rechte an den Postfächern, die die Mitglieder selbst verbinden – nie an der Post der ganzen Organisation. Die Registrierung der Organisation erreicht dagegen alle Postfächer, und deshalb bekommt draften sie nur für den Zugriff auf die Postfächer, nicht für die Anmeldung. Legen Sie die beiden nicht zu einer zusammen.

Jedes Postfach verwendet einen der beiden Zugänge. Beide Apps können Sie gleichzeitig haben: etwa den Client für die Anmeldung und die eigenen Postfächer und die Registrierung für das freigegebene Postfach info@.

Geben Sie keiner der beiden Apps jemals die Berechtigung Mail.Send. draften sendet nichts und kann es ohne diese Berechtigung auch gar nicht – genau darum geht es.

Client der Organisation: Anmeldung und Outlook verbinden

Der Client hat delegierte Berechtigungen: Die App darf nur, was die angemeldete Person darf, und nur in deren eigenem Postfach. Sie legen ihn einmal an; danach verbinden sich die Inhaber der Postfächer selbst und brauchen keinen Administrator von Entra mehr.

In Microsoft Entra

Sie arbeiten im Microsoft Entra admin center, https://entra.microsoft.com, angemeldet mit dem Konto eines Administrators Ihres Microsoft-365-Verzeichnisses.

  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/callback und /mailboxes/connect/callback. Kopieren Sie sie von dort; sie müssen Zeichen für Zeichen stimmen.
  2. Öffnen Sie die Liste der App-Registrierungen: im Menü links Entra ID → App registrations (in der älteren Form des Menüs Identity → Applications → App registrations). Direkt: https://entra.microsoft.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade
  3. Klicken Sie oben auf + New registration und füllen Sie aus:
    • Name – etwa draften – Anmeldung,
    • Supported account types – Accounts in this organizational directory only (… only - Single tenant),
    • Redirect URI – wählen Sie in der Auswahlliste Select a platform Web und fügen Sie daneben die erste Adresse aus der Karte ein (sie endet auf /auth/callback).

    Klicken Sie auf Register. Die Seite der neuen App öffnet sich.

  4. Kopieren Sie auf der Seite Overview die Application (client) ID und die Directory (tenant) ID (Kopiersymbol neben dem Wert).
  5. Öffnen Sie im Menü der App links Authentication. Klicken Sie bei der Plattform Web im Abschnitt Redirect URIs auf Add URI, fügen Sie die zweite Adresse aus der Karte ein (sie endet auf /mailboxes/connect/callback) und klicken Sie unten auf Save.
  6. Certificates & secrets → Registerkarte Client secrets → + New client secret. Description etwa draften, wählen Sie bei Expires die Gültigkeit (höchstens 24 Monate) und klicken Sie auf Add. Kopieren Sie in der Tabelle sofort den Wert aus der Spalte Value – er wird nur jetzt angezeigt; die Secret ID braucht draften nicht. Notieren Sie auch das Datum in der Spalte Expires.
  7. API permissions → + Add a permission → Microsoft Graph → Delegated permissions. Geben Sie nacheinander in die Suche ein und haken Sie an: openid, profile, email, offline_access, User.Read, Mail.ReadWrite und MailboxSettings.ReadWrite, und klicken Sie unten auf Add permissions. User.Read steht meist schon seit dem Anlegen in der Liste. Ohne offline_access hält die Verbindung nicht – draften bekäme kein Refresh-Token.
  8. Klicken Sie auf derselben Seite auf Grant admin consent for … und bestätigen Sie mit Yes. In allen Zeilen muss in der Spalte Status ein grünes Häkchen stehen. Verbietet Ihre Organisation den Benutzern, Apps zuzustimmen, würde die Verbindung ohne diesen Schritt mit der Meldung enden, dass die Zustimmung verweigert wurde.

In draften

  1. Der Inhaber der Organisation öffnet Organisation → Anmeldung und Zugriff auf die Post, trägt in der Karte Kontoanmeldung und Postfachverbindungen unter Entra-Registrierung für „Mit Microsoft anmelden“ und „Outlook verbinden“ die Application (client) ID (Schritt 4) und das Client secret (Schritt 6) ein und klickt auf Speichern.
  2. Die Anmeldung mit dem Microsoft-Konto schaltet er auf derselben Seite in der Karte Wie sich Mitglieder anmelden ein: Er trägt unter ID des Microsoft-Verzeichnisses (Entra) die Directory (tenant) ID ein. Sobald die Organisation den Client und die Verzeichnis-ID hat, melden sich die Mitglieder mit dem Microsoft-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 Outlook 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

Die Registrierung hat Anwendungsberechtigungen: Der Assistent kommt in das Postfach, ohne dass sich jemand anmeldet. Sie eignet sich für freigegebene Postfächer und für Organisationen, die den Zugriff auf die Postfächer zentral verwalten möchten. Mit der Anmeldung bei draften hat sie nichts zu tun.

Sie brauchen ein Konto mit der Rolle Globaler Administrator oder Administrator für privilegierte Rollen – nur ein solches Konto erteilt die Zustimmung zu Anwendungsberechtigungen von Microsoft Graph. Die Registrierung selbst kann auch ein Anwendungsadministrator anlegen.

In Microsoft Entra

Sie arbeiten im Microsoft Entra admin center, https://entra.microsoft.com.

  1. Öffnen Sie die Liste der App-Registrierungen: im Menü links Entra ID → App registrations (in der älteren Form des Menüs Identity → Applications → App registrations). Direkt: https://entra.microsoft.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade
  2. Klicken Sie oben auf + New registration und füllen Sie aus:
    • Name – etwa draften – Post,
    • Supported account types – Accounts in this organizational directory only (… only - Single tenant),
    • Redirect URI – lassen Sie es leer.

    Klicken Sie auf Register. Die Seite der neuen App öffnet sich.

  3. Kopieren Sie auf der Seite Overview die Application (client) ID und die Directory (tenant) ID (Kopiersymbol neben dem Wert).
  4. Im Menü der App links Certificates & secrets → Registerkarte Client secrets → + New client secret. Description etwa draften, wählen Sie bei Expires die Gültigkeit (höchstens 24 Monate) und klicken Sie auf Add. Kopieren Sie in der Tabelle sofort den Wert aus der Spalte Value – er wird nur jetzt angezeigt; die Secret ID braucht draften nicht. Notieren Sie auch das Datum in der Spalte Expires.
  5. API permissions → + Add a permission → Microsoft Graph → Application permissions (nicht Delegated). Geben Sie in die Suche Mail.ReadWrite und MailboxSettings.ReadWrite ein, haken Sie beide an und klicken Sie unten auf Add permissions. MailboxSettings.ReadWrite dient nur der Farbe der Kategorie in Outlook; ohne diese Berechtigung wird die Kategorie ohne Farbe hinzugefügt. Fügen Sie optional User.Read.All hinzu – damit prüft draften die Aliasse des Postfachs; ohne diese Berechtigung meldet der Verbindungstest bei Aliassen, dass er sie nicht prüfen kann.
  6. Klicken Sie auf derselben Seite auf Grant admin consent for … und bestätigen Sie mit Yes. In allen Zeilen muss in der Spalte Status ein grünes Häkchen stehen.

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: Microsoft 365 (Entra). Füllen Sie Name, Directory (tenant) ID, Application (client) ID, Client secret (den Wert aus Schritt 4, nicht seine ID) und Geheimnis läuft ab aus. Klicken Sie auf Registrierung hinzufügen. Das Geheimnis wird verschlüsselt gespeichert und nicht mehr angezeigt.
  3. Eine Registrierung verbindet von selbst nichts. 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. Die Auswahl sieht nur, wer zugleich Inhaber des Postfachs und Inhaber oder Manager der Organisation ist (der Inhaber der Organisation ist Inhaber aller Postfächer). Den ganzen Ablauf mit Bildschirmfotos zeigt die Anleitung Ein Postfach hinzufügen und verbinden.

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

Auf ausgewählte Postfächer einschränken (optional)

Eine Anwendungsberechtigung erreicht alle Postfächer des Verzeichnisses; darüber wacht draften (ein Mitglied kann kein Postfach hinzufügen, der Assistent sendet und löscht nichts). Wer zusätzlich einen technischen Zaun möchte, beschränkt die App mit der Richtlinie ApplicationAccessPolicy in Exchange Online auf eine Sicherheitsgruppe. Sie brauchen PowerShell und die Rolle Exchange-Administrator (oder Globaler Administrator).

Schritt 1 – das Modul Exchange Online. Installieren Sie es einmal: Starten Sie PowerShell als Administrator des Computers und geben Sie ein:

Install-Module ExchangeOnlineManagement

Schritt 2 – Gruppe und Richtlinie. Melden Sie sich bei Exchange Online an, legen Sie eine Sicherheitsgruppe mit den Postfächern an, auf die draften zugreifen darf, und eine Richtlinie, die die App nur auf diese Gruppe beschränkt. Setzen Sie für <Application (client) ID> die ID der Registrierung aus Schritt 3 oben ein und für die Adressen Ihre Postfächer:

Connect-ExchangeOnline -UserPrincipalName admin@<tenant>.onmicrosoft.com
New-DistributionGroup -Name "draften - erlaubte Postfächer" -Alias draften-postfaecher -Type Security -Members postfach@firma.cz
New-ApplicationAccessPolicy -AppId <Application (client) ID> -PolicyScopeGroupId draften-postfaecher@firma.cz -AccessRight RestrictAccess -Description "draften: nur erlaubte Postfächer"

Schritt 3 – Prüfung. Bei einem Postfach in der Gruppe muss der Befehl AccessCheckResult : Granted ausgeben, bei einem Postfach außerhalb der Gruppe Denied:

Test-ApplicationAccessPolicy -Identity postfach@firma.cz -AppId <Application (client) ID>

Ein weiteres Postfach nehmen Sie dann im Exchange admin center in die Gruppe auf (https://admin.exchange.microsoft.com → Recipients → Groups), oder mit dem Befehl Add-DistributionGroupMember -Identity draften-postfaecher@firma.cz -Member weiteres@firma.cz. Ein Postfach außerhalb der Gruppe endet im Verbindungstest mit dem Fehler 403 (AppOnly AccessPolicy). Die Richtlinie wirkt meist innerhalb einer Stunde; wir haben auch vier Stunden gesehen. Als neuere Alternative bietet Microsoft RBAC for Applications in Exchange Online an; das beschreiben wir noch nicht.

Das Geheimnis ersetzen

Das Geheimnis ist nur begrenzt gültig, und draften schickt vor seinem Ablauf keine Benachrichtigung – das Datum in der Karte wird 30 Tage vor dem Ablauf gelb und danach rot. Tragen Sie sich eine Erinnerung in den Kalender ein. Vor dem Ablauf:

  1. Öffnen Sie in Entra App registrations → Ihre Registrierung (etwa draften – Post) → Certificates & secrets → + New client secret und kopieren Sie den neuen Value (wie in Schritt 4 oben).
  2. Wählen Sie in draften unter Organisation → Anmeldung und Zugriff auf die Post bei der Registrierung Neues Geheimnis und fügen Sie den neuen Wert und das neue Datum ein.
  3. Löschen Sie das alte Geheimnis in Entra mit dem Papierkorbsymbol in seiner Zeile.

Läuft das Geheimnis früher ab, werden die Postfächer getrennt (invalid_client), und die Assistenten überspringen sie. Führen Sie nach dem Ersetzen bei den Postfächern Verbindung testen aus – ein erfolgreicher Test schaltet das Postfach wieder ein.

Fehler beim Verbindungstest

Der Test prüft drei Schritte: Zugriff, Token und Berechtigung und Lesen des Posteingangs. Bei jedem steht ein Häkchen oder ein Kreuz mit dem Grund:

In der MeldungWas es bedeutetWas zu tun ist
AADSTS7000215, AADSTS7000222, invalid_clientfalsches oder abgelaufenes Client secretein neues Geheimnis anlegen und in draften speichern
AADSTS700016, AADSTS90002, unauthorized_clientfalsche Application ID oder Directory IDbeide IDs erneut von Overview abschreiben
AADSTS65001, AADSTS650057, consent_requireddie Administratorzustimmung fehltGrant admin consent bei der App
Token ohne Mail.ReadWritedie Berechtigung fehlt oder ist nicht zugestimmtBerechtigung hinzufügen und Zustimmung erteilen
invalid_grant, AADSTS50173, AADSTS700082, AADSTS70008die Verbindung mit dem Konto ist abgelaufen oder wurde widerrufenOutlook neu verbinden
HTTP 403 AppOnly AccessPolicydas Postfach ist nicht in der Gruppe der Zugriffsrichtliniees in die Gruppe aufnehmen und warten
HTTP 404ein solches Postfach gibt es nichtdie Adresse prüfen; das Postfach muss Exchange Online haben
HTTP 401ein anderes Verzeichnis, oder eine Berechtigung fehltDirectory ID und Berechtigungen prüfen

Weitere Fehler beschreibt Fehlerbehebung.

Textfassung