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öchten | Was Sie einrichten |
|---|---|
| Die Mitglieder melden sich mit dem Microsoft-Konto an, und jedes hat ein eigenes Postfach | Client der Organisation – das genügt |
| Dazu freigegebene Postfächer (info@, vertrieb@) oder einen zentral eingerichteten Zugriff auf die Postfächer, ohne deren Inhaber | zusätzlich die Registrierung der Organisation |
| Sie möchten keine Anmeldung mit dem Microsoft-Konto | die 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 Organisation | Registrierung der Organisation | |
|---|---|---|
| Was sie tut | Anmeldung der Mitglieder mit der Schaltfläche Mit Microsoft anmelden und die Schaltfläche Outlook verbinden beim eigenen Postfach | Zugriff des Assistenten auf die Postfächer, ohne dass sich deren Inhaber anmelden |
| Wo in draften | Organisation → Anmeldung und Zugriff auf die Post → Karte Kontoanmeldung und Postfachverbindungen | Organisation → Anmeldung und Zugriff auf die Post → Karte Registrierungen für freigegebene Postfächer und zentrale Verwaltung |
| Wer sie in draften einrichtet | der Inhaber der Organisation | der Inhaber oder ein Manager der Organisation |
| Berechtigungen in Entra | delegierte Berechtigungen (Delegated) | Anwendungsberechtigungen (Application) |
| Wer sich beim Postfach anmeldet | der Inhaber jedes Postfachs, einmal | niemand |
| Welche Postfächer erreicht werden | nur die, die die Mitglieder selbst verbinden | die Postfächer des Verzeichnisses (lässt sich einschränken) |
| Freigegebene Postfächer | nein – sie haben keine eigene Anmeldung | ja |
| Wenn jemand das Unternehmen verlässt | nach der Sperrung seines Kontos wird das Postfach getrennt | es ä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.
- Ö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/callbackund/mailboxes/connect/callback. Kopieren Sie sie von dort; sie müssen Zeichen für Zeichen stimmen. - Ö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
- 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.
- Name – etwa
- Kopieren Sie auf der Seite Overview die Application (client) ID und die Directory (tenant) ID (Kopiersymbol neben dem Wert).
- Ö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. - 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. - 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.ReadWriteundMailboxSettings.ReadWrite, und klicken Sie unten auf Add permissions.User.Readsteht meist schon seit dem Anlegen in der Liste. Ohneoffline_accesshält die Verbindung nicht – draften bekäme kein Refresh-Token. - 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
- 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.
- 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.
- 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.
- Dann Verbindung testen.
Wenn das Postfach getrennt wird
- Das Geheimnis des Clients ist abgelaufen – öffnen Sie in Entra App registrations → die Registrierung des Clients (etwa
draften – Anmeldung) → Certificates & secrets → + New client secret und kopieren Sie Value. Speichern Sie es in der Karte Kontoanmeldung und Postfachverbindungen und klicken Sie bei den Postfächern auf Outlook neu verbinden. - Die Person hat das Unternehmen verlassen, oder ihr Konto wurde gesperrt – Microsoft stellt keine Tokens mehr aus, und draften trennt das Postfach. Ein Postfach ohne eigene Anmeldung verbinden Sie über die Registrierung der Organisation (unten).
- „Der Anbieter hat kein Refresh-Token ausgestellt“ – dem Client fehlt die Berechtigung
offline_access(Schritt 7). - „Es hat sich ein anderes Konto angemeldet als die Adresse des Postfachs“ – melden Sie sich beim Verbinden mit dem Konto genau dieses Postfachs an; wer im Browser mehrere Microsoft-Konten hat, wählt das richtige.
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.
- Ö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
- 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.
- Name – etwa
- Kopieren Sie auf der Seite Overview die Application (client) ID und die Directory (tenant) ID (Kopiersymbol neben dem Wert).
- 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. - API permissions → + Add a permission → Microsoft Graph → Application permissions (nicht Delegated). Geben Sie in die Suche
Mail.ReadWriteundMailboxSettings.ReadWriteein, haken Sie beide an und klicken Sie unten auf Add permissions.MailboxSettings.ReadWritedient nur der Farbe der Kategorie in Outlook; ohne diese Berechtigung wird die Kategorie ohne Farbe hinzugefügt. Fügen Sie optionalUser.Read.Allhinzu – damit prüft draften die Aliasse des Postfachs; ohne diese Berechtigung meldet der Verbindungstest bei Aliassen, dass er sie nicht prüfen kann. - 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
- Ö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.
- 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.
- 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:
- Ö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). - 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.
- 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 Meldung | Was es bedeutet | Was zu tun ist |
|---|---|---|
AADSTS7000215, AADSTS7000222, invalid_client | falsches oder abgelaufenes Client secret | ein neues Geheimnis anlegen und in draften speichern |
AADSTS700016, AADSTS90002, unauthorized_client | falsche Application ID oder Directory ID | beide IDs erneut von Overview abschreiben |
AADSTS65001, AADSTS650057, consent_required | die Administratorzustimmung fehlt | Grant admin consent bei der App |
Token ohne Mail.ReadWrite | die Berechtigung fehlt oder ist nicht zugestimmt | Berechtigung hinzufügen und Zustimmung erteilen |
invalid_grant, AADSTS50173, AADSTS700082, AADSTS70008 | die Verbindung mit dem Konto ist abgelaufen oder wurde widerrufen | Outlook neu verbinden |
HTTP 403 AppOnly AccessPolicy | das Postfach ist nicht in der Gruppe der Zugriffsrichtlinie | es in die Gruppe aufnehmen und warten |
| HTTP 404 | ein solches Postfach gibt es nicht | die Adresse prüfen; das Postfach muss Exchange Online haben |
| HTTP 401 | ein anderes Verzeichnis, oder eine Berechtigung fehlt | Directory ID und Berechtigungen prüfen |
Weitere Fehler beschreibt Fehlerbehebung.