> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.autophish.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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](https://entra.microsoft.com/).
- 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

1. Melde dich im [Microsoft Entra Admin Center](https://entra.microsoft.com/) an.

2. Wenn du Zugriff auf mehrere Mandanten hast, prüfe, ob du im richtigen Mandanten arbeitest.

3. Gehe zu **Entra ID → App registrations**.

4. Wähle **New registration**.

5. Gib einen Namen ein, zum Beispiel:
`AutoPhish Directory Sync`

6. Wähle unter **Supported account types** Folgendes aus:
**Accounts in this organizational directory only (Single tenant)**

7. Lass **Redirect URI** leer. Die Verzeichnissynchronisierung verwendet die Anwendungsauthentifizierung und benötigt weder eine interaktive Microsoft-Anmeldung noch eine Redirect-URI.

8. Wähle **Register**.

Weitere Informationen findest du unter [Register an application in Microsoft Entra ID](https://learn.microsoft.com/en-us/entra/identity-platform/quickstart-register-app).

### 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

1. Gehe in der App-Registrierung zu **API permissions**.

2. Wähle **Add a permission**.

3. Wähle **Microsoft Graph**.

4. Wähle **Application permissions**.
Wähle nicht „Delegated permissions“.

5. Füge diese Berechtigungen hinzu:

| Berechtigung | Typ | Zweck |
| ---- | ---- | ---- |
| `Group.Read.All` | Application | Listet unterstützte Gruppen auf und liest Gruppeninformationen |
| `GroupMember.Read.All` | Application | Liest die Gruppenmitgliedschaft |
| `User.Read.All` | Application | Liest Namen, E-Mail-Adressen, User Principal Names und Kontostatus der Mitglieder |

6. Wähle **Grant admin consent for** **_dein Mandant_**.

7. Bestätige die Abfrage zur Einwilligung.

8. 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](https://learn.microsoft.com/en-us/graph/permissions-reference).

> AutoPhish verwendet keine delegierten Berechtigungen. Falls die App-Registrierung standardmäßig eine delegierte Berechtigung `User.Read` enthält, wird sie für die Verzeichnissynchronisierung nicht benötigt und kann entfernt werden.

### Clientgeheimnis erstellen

1. Gehe in der App-Registrierung zu **Certificates & secrets**.

2. Öffne **Client secrets**.

3. Wähle **New client secret**.

4. Gib eine Beschreibung ein, zum Beispiel:
`AutoPhish Directory Sync`

5. Wähle eine Gültigkeitsdauer, die den Sicherheitsrichtlinien deiner Organisation entspricht.

6. Wähle **Add**.

7. 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](https://learn.microsoft.com/en-us/entra/identity-platform/how-to-add-credentials).

### 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.All` als Application permission.
- `GroupMember.Read.All` als Application permission.
- `User.Read.All` als Application permission.
- Die erteilte Administratoreinwilligung für alle drei Berechtigungen.
- Keine konfigurierte und keine benötigte Redirect-URI.

## 2. Microsoft 365 mit AutoPhish verbinden

1. Melde dich in AutoPhish als Unternehmensadmin an.

2. Wähle das Unternehmen aus, das du konfigurieren möchtest.

3. Prüfe, ob die E-Mail-Domains der Mitarbeitenden des Unternehmens in AutoPhish verifiziert sind.

4. Gehe zu **Einstellungen → Verzeichnissynchronisierung**.

5. Trage die folgenden Werte ein:

- **Tenant-ID:** die Directory (tenant) ID
- **Client-ID:** die Application (client) ID
- **Client-Geheimnis:** der Value des Clientgeheimnisses

6. Wähle **Verbindung speichern**.

7. 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

1. Wähle unter **Gruppenzuordnungen** bei Bedarf **Gruppen aktualisieren**.

2. Wähle eine Microsoft-365-Gruppe oder eine Sicherheitsgruppe aus.

3. 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.

4. Wähle **Jetzt synchronisieren**, um die erste Synchronisierung auszuführen.

5. 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 verwendbaren `userPrincipalName`.
- 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:

1. Öffne die AutoPhish-App-Registrierung in Microsoft Entra ID.

2. Gehe zu **Certificates & secrets → Client secrets**.

3. Erstelle ein neues Clientgeheimnis.

4. Kopiere seinen **Value**.

5. Gehe in AutoPhish zu **Einstellungen → Verzeichnissynchronisierung**.

6. Trage das neue Geheimnis ein und wähle **Verbindung aktualisieren**.

7. Wähle **Verbindung testen**.

8. 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.All` und `User.Read.All` sind 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.