Microsoft-365-Verzeichnissynchronisierung einrichten (Beta)
Beta-Funktion: Die Microsoft-365-Verzeichnissynchronisierung befindet sich derzeit in der Beta-Phase. Prüfe den Synchronisierungsverlauf nach der Einrichtung und nach Änderungen an Gruppen, Berechtigungen oder verifizierten Domains.
Die Microsoft-365-Verzeichnissynchronisierung verbindet AutoPhish mit Microsoft Entra ID. Du wählst Microsoft-365- oder Sicherheitsgruppen aus, und AutoPhish erstellt für jede Gruppe eine passende Zielliste.
Die Synchronisierung läuft nur in eine Richtung:
Microsoft Entra ID → AutoPhish
Jede erzeugte Zielliste ist ein exaktes Abbild der zulässigen Gruppenmitglieder. Füge Mitglieder in Microsoft 365 hinzu oder entferne sie dort – nicht in AutoPhish.
Bevor du beginnst
Du brauchst:
- Zugriff auf das Microsoft Entra Admin Center.
- Die Berechtigung, eine App-Registrierung zu erstellen und mandantenweit die Administratoreinwilligung zu erteilen. Dafür kann die Unterstützung deiner Microsoft-365-Administration nötig sein.
- Unternehmensadmin-Zugriff in AutoPhish.
- In AutoPhish verifizierte E-Mail-Domains für alle deine Mitarbeitenden.
Wichtig: AutoPhish importiert nur Benutzer, deren E-Mail-Domain für das aktive AutoPhish-Unternehmen verifiziert ist. Verifiziere die benötigten Domains vor der ersten Synchronisierung. Andernfalls werden Benutzer übersprungen und können aus einer bereits synchronisierten Liste entfernt werden.
1. Microsoft Entra ID konfigurieren
Anwendung registrieren
- Melde dich im Microsoft Entra Admin Center an.
- Wenn du Zugriff auf mehrere Mandanten hast, prüfe, ob du im richtigen Mandanten arbeitest.
- Gehe zu Entra ID → App registrations.
- Wähle New registration.
- Gib einen Namen ein, zum Beispiel:
AutoPhish Directory Sync
- Wähle unter Supported account types Folgendes aus:
Accounts in this organizational directory only (Single tenant)
- Lass Redirect URI leer. Die Verzeichnissynchronisierung verwendet die Anwendungsauthentifizierung und benötigt weder eine interaktive Microsoft-Anmeldung noch eine Redirect-URI.
- Wähle Register.
Weitere Informationen findest du unter Register an application in Microsoft Entra ID.
Mandanten-ID und Client-ID kopieren
Kopiere auf der Seite Overview der App-Registrierung:
- Directory (tenant) ID
- Application (client) ID
Beide Werte trägst du später in AutoPhish ein.
Kopiere die Application (client) ID, nicht die Object ID der Anwendung.
Microsoft-Graph-Berechtigungen hinzufügen
- Gehe in der App-Registrierung zu API permissions.
- Wähle Add a permission.
- Wähle Microsoft Graph.
- Wähle Application permissions.
Wähle nicht „Delegated permissions“.
- Füge diese Berechtigungen hinzu:
Berechtigung | Typ | Zweck |
|---|---|---|
| Application | Listet unterstützte Gruppen auf und liest Gruppeninformationen |
| Application | Liest die Gruppenmitgliedschaft |
| Application | Liest Namen, E-Mail-Adressen, User Principal Names und Kontostatus der Mitglieder |
- Wähle Grant admin consent for dein Mandant.
- Bestätige die Abfrage zur Einwilligung.
- Prüfe, ob in der Spalte „Status“ bei allen drei Berechtigungen Granted for dein Mandant steht.
Alle benötigten Berechtigungen erlauben nur Lesezugriff. AutoPhish kann in Microsoft Entra ID keine Benutzer oder Gruppen erstellen, bearbeiten oder löschen.
Microsoft-Graph-Anwendungsberechtigungen gelten mandantenweit, obwohl AutoPhish nur die Gruppen synchronisiert, die du ausdrücklich auswählst. Die Beschreibungen der Berechtigungen findest du in der Microsoft-Graph-Berechtigungsreferenz.
AutoPhish verwendet keine delegierten Berechtigungen. Falls die App-Registrierung standardmäßig eine delegierte Berechtigung
User.Readenthält, wird sie für die Verzeichnissynchronisierung nicht benötigt und kann entfernt werden.
Clientgeheimnis erstellen
- Gehe in der App-Registrierung zu Certificates & secrets.
- Öffne Client secrets.
- Wähle New client secret.
- Gib eine Beschreibung ein, zum Beispiel:
AutoPhish Directory Sync
- Wähle eine Gültigkeitsdauer, die den Sicherheitsrichtlinien deiner Organisation entspricht.
- Wähle Add.
- Kopiere sofort den Value des Clientgeheimnisses.
Kopiere den Value des Geheimnisses, nicht die Secret ID. Microsoft zeigt den Value nur ein einziges Mal an.
Bewahre das Geheimnis sicher auf, bis du es in AutoPhish eingetragen hast. Weitere Informationen findest du unter Add and manage application credentials in Microsoft Entra ID.
Checkliste für die Microsoft-365-Konfiguration
Bevor du weitermachst, stelle sicher, dass du Folgendes hast:
- Eine App-Registrierung für einen einzelnen Mandanten (Single tenant).
- Die Directory (tenant) ID.
- Die Application (client) ID.
- Den Value eines Clientgeheimnisses.
Group.Read.Allals Application permission.GroupMember.Read.Allals Application permission.User.Read.Allals Application permission.- Die erteilte Administratoreinwilligung für alle drei Berechtigungen.
- Keine konfigurierte und keine benötigte Redirect-URI.
2. Microsoft 365 mit AutoPhish verbinden
- Melde dich in AutoPhish als Unternehmensadmin an.
- Wähle das Unternehmen aus, das du konfigurieren möchtest.
- Prüfe, ob die E-Mail-Domains der Mitarbeitenden des Unternehmens in AutoPhish verifiziert sind.
- Gehe zu Einstellungen → Verzeichnissynchronisierung.
- Trage die folgenden Werte ein:
- Tenant-ID: die Directory (tenant) ID
- Client-ID: die Application (client) ID
- Client-Geheimnis: der Value des Clientgeheimnisses
- Wähle Verbindung speichern.
- Wähle Verbindung testen.
Ein erfolgreicher Test zeigt die Anzahl der unterstützten Gruppen an, die im Mandanten gefunden wurden.
Wichtig: Der Verbindungstest prüft die Authentifizierung und die Gruppenauflistung. Die erste Synchronisierung testet zusätzlich den Zugriff auf Gruppenmitgliedschaften und Benutzerdetails. Wenn der Test erfolgreich ist, die erste Synchronisierung aber fehlschlägt, prüfe alle drei Graph-Anwendungsberechtigungen und den Status der Administratoreinwilligung noch einmal.
3. Gruppensynchronisierung hinzufügen
- Wähle unter Gruppenzuordnungen bei Bedarf Gruppen aktualisieren.
- Wähle eine Microsoft-365-Gruppe oder eine Sicherheitsgruppe aus.
- Wähle Gruppensynchronisierung hinzufügen.
AutoPhish erstellt eine neue, von der Integration verwaltete Zielliste mit dem ungefähren Namen:
M365: <Gruppenname>
Die Funktion synchronisiert nicht in eine bestehende Zielliste.
- Wähle Jetzt synchronisieren, um die erste Synchronisierung auszuführen.
- Prüfe das Ergebnis unter Synchronisierungsverlauf.
Wiederhole diese Schritte für jede Gruppe, die du synchronisieren möchtest.
Unterstützte Gruppen und Benutzer
AutoPhish unterstützt:
- Microsoft-365-Gruppen.
- Sicherheitsgruppen, einschließlich E-Mail-aktivierter Sicherheitsgruppen.
- Benutzer in verschachtelten Gruppen. Verschachtelte Mitgliedschaften werden bei der Synchronisierung aufgelöst und zusammengeführt.
Normale Verteilerlisten und dynamische Verteilergruppen werden nicht als unterstützte Gruppen angezeigt.
Gruppen mit verborgener Mitgliedschaft solltest du während der Beta-Phase vermeiden. Die Standardkonfiguration fordert die zusätzliche Microsoft-Graph-Berechtigung Member.Read.Hidden nicht an.
Ein Benutzer wird nur synchronisiert, wenn alle folgenden Bedingungen erfüllt sind:
- Das Mitglied ist ein Benutzerobjekt in Microsoft Entra.
- Das Konto ist aktiviert.
- Der Benutzer hat eine verwendbare
mail-Adresse oder einen verwendbarenuserPrincipalName. - Die resultierende E-Mail-Adresse gehört zu einer Domain, die in AutoPhish verifiziert ist.
Deaktivierte Konten, Benutzer ohne verwendbare Adresse, User Principal Names mit #EXT# sowie Benutzer mit nicht verifizierten oder externen E-Mail-Domains werden übersprungen.
So funktioniert die Synchronisierung
AutoPhish synchronisiert täglich nach Zeitplan. Du kannst jederzeit auch Jetzt synchronisieren wählen.
Bei jeder Synchronisierung macht AutoPhish Folgendes:
- Es fügt zulässige Benutzer hinzu, die der Gruppe beigetreten sind.
- Es aktualisiert Vor- und Nachnamen bestehender Mitglieder.
- Es entfernt die Listenmitgliedschaft von Benutzern, die die Gruppe verlassen haben oder nicht mehr zulässig sind.
- Es erfasst die Anzahl der hinzugefügten, aktualisierten, entfernten und übersprungenen Benutzer im Synchronisierungsverlauf.
Wenn du jemanden aus einer synchronisierten Liste entfernst, werden seine bisherigen Kampagnen- und Berichtsdaten nicht gelöscht.
Microsoft Graph arbeitet bei Mitgliedschaftsabfragen mit Eventual Consistency. Sehr aktuelle Änderungen in Microsoft 365 können daher kurz brauchen, bis sie erscheinen.
Synchronisierte Ziellisten verwalten
Eine synchronisierte Zielliste wird von der Integration verwaltet. Solange die Gruppenzuordnung besteht, kannst du Folgendes nicht tun:
- Mitglieder manuell hinzufügen, bearbeiten oder entfernen.
- Mitglieder per CSV importieren.
- Die Zielliste löschen.
Diese Einschränkungen gelten auch, solange die Synchronisierung pausiert ist.
Du kannst die Zielliste weiterhin umbenennen oder ihren Kontext aktualisieren.
Mit den Steuerelementen unter Einstellungen → Verzeichnissynchronisierung kannst du Folgendes tun:
- Jetzt synchronisieren: sofort synchronisieren.
- Pausieren: geplante Synchronisierungen anhalten.
- Fortsetzen: geplante Synchronisierungen wieder starten.
- Entfernen: die Gruppenzuordnung entfernen.
Wenn du eine Zuordnung entfernst, bleiben die aktuellen Mitglieder der Zielliste erhalten, und die Liste lässt sich wieder normal manuell verwalten.
Wenn du die Verbindung zu Microsoft 365 trennst, entfallen künftige Gruppensynchronisierungen, die aktuellen Stände der Ziellisten bleiben aber ebenfalls erhalten.
Ablaufendes Clientgeheimnis erneuern
Clientgeheimnisse in Microsoft Entra laufen ab. AutoPhish erfasst das Ablaufdatum derzeit nicht und sendet keine Erinnerungen vor dem Ablauf.
Richte dir intern eine Erinnerung ein, um das Geheimnis vor dem Ablauf zu erneuern:
- Öffne die AutoPhish-App-Registrierung in Microsoft Entra ID.
- Gehe zu Certificates & secrets → Client secrets.
- Erstelle ein neues Clientgeheimnis.
- Kopiere seinen Value.
- Gehe in AutoPhish zu Einstellungen → Verzeichnissynchronisierung.
- Trage das neue Geheimnis ein und wähle Verbindung aktualisieren.
- Wähle Verbindung testen.
- Lösche das alte Geheimnis in Microsoft Entra ID, nachdem du sichergestellt hast, dass die Synchronisierung funktioniert.
Wenn du nur die Tenant-ID oder die Client-ID änderst, kannst du das Feld „Client-Geheimnis“ leer lassen. Dann bleibt das gespeicherte Geheimnis erhalten.
Fehlerbehebung
Der Verbindungstest meldet ein ungültiges Clientgeheimnis
Prüfe Folgendes:
- Du hast den Value des Clientgeheimnisses eingetragen, nicht die Secret ID.
- Das Geheimnis ist nicht abgelaufen.
- Tenant-ID und Client-ID gehören zur selben App-Registrierung.
- Es wurden keine führenden oder nachgestellten Leerzeichen mitkopiert.
Der Verbindungstest meldet unzureichende Berechtigungen
Prüfe Folgendes:
- Die Berechtigungen wurden unter Application permissions hinzugefügt.
Group.Read.All,GroupMember.Read.AllundUser.Read.Allsind vorhanden.- Die Administratoreinwilligung wurde für den Mandanten erteilt.
- Bei jeder Berechtigung steht in Microsoft Entra ID Granted.
Es kann kurz dauern, bis sich Berechtigungsänderungen auswirken.
Der Verbindungstest ist erfolgreich, aber die Synchronisierung schlägt fehl
Der Verbindungstest listet Gruppen auf, liest aber nicht deren vollständige Mitgliedschaft.
Prüfe GroupMember.Read.All und User.Read.All noch einmal, einschließlich der Administratoreinwilligung. Stelle außerdem sicher, dass die ausgewählte Gruppe keine verborgene Mitgliedschaft verwendet.
Eine Gruppe wird nicht angezeigt
Wähle Gruppen aktualisieren. Es werden nur Microsoft-365-Gruppen und Sicherheitsgruppen unterstützt. Normale Verteilerlisten werden nicht angezeigt.
Benutzer werden übersprungen oder die Zielliste ist leer
Öffne den Synchronisierungsverlauf und prüfe die Anzahl der übersprungenen Mitglieder.
Häufige Ursachen sind:
- Das Benutzerkonto ist deaktiviert.
- Der Benutzer hat keine verwendbare E-Mail-Adresse und keinen verwendbaren User Principal Name.
- Die E-Mail-Domain ist in AutoPhish nicht verifiziert.
- Der Benutzer ist ein externes Konto mit einer externen Adresse oder einer
#EXT#-Adresse.
Eine manuelle Änderung an der Zielliste wird blockiert
Das ist so gewollt. Synchronisierte Listen sind exakte Abbilder und können nicht manuell bearbeitet werden. Ändere die Mitgliedschaft in Microsoft Entra ID und warte dann auf die nächste geplante Synchronisierung oder wähle Jetzt synchronisieren.
Wenn du die Liste manuell verwalten möchtest, entferne zuerst ihre Gruppenzuordnung.
Die Synchronisierung hat funktioniert, läuft jetzt aber nicht mehr
Prüfe, ob das Clientgeheimnis in Microsoft Entra abgelaufen ist. Erstelle ein neues Geheimnis, speichere es in AutoPhish und teste die Verbindung erneut.
Sicherheit und Datenzugriff
Die Verzeichnissynchronisierung verwendet die reine Anwendungsauthentifizierung von Microsoft Graph. Über AutoPhish meldet sich kein Microsoft-365-Benutzer an.
AutoPhish liest nur die Informationen, die für die Synchronisierung erforderlich sind:
- Identität und Typ der Gruppe.
- Gruppenmitgliedschaft.
- Status „Konto aktiviert“.
- E-Mail-Adresse oder User Principal Name.
- Vor- und Nachname.
Die Integration fordert keine Schreibberechtigungen für Microsoft Graph an und kann deine Microsoft-365-Benutzer oder -Gruppen nicht verändern. Das Clientgeheimnis wird verschlüsselt gespeichert und nach dem Speichern nicht mehr angezeigt.
Aktualisiert am: 28/10/2026
Danke!