<synchronisation.md>
Nehm# Synchronisation
Über den Menüpunkt Verwaltung → Drittanbieter → Synchronisation verknüpfen Sie externe Verzeichnisdienste mit skai. Dadurch werden Benutzer und Benutzergruppen aus dem externen System automatisch in skai übernommen und aktuell gehalten – ohne dass Sie Benutzerkonten manuell pflegen müssen.
Derzeit unterstützt skai die Synchronisation mit Microsoft Entra (ehemals Azure Active Directory / Microsoft 365).

Die Liste zeigt alle angelegten Synchronisationen mit ihrem Typ, dem Zeitpunkt der letzten Synchronisierung und – falls konfiguriert – dem nächsten geplanten Ausführungstermin.
Ist die Konfiguration noch unvollständig (z. B. keine Zugangsdaten hinterlegt), wird die Synchronisation mit dem Badge Konfiguration unvollständig markiert.
Synchronisation anlegen
Klicken Sie auf Anlegen, um eine neue Synchronisation einzurichten. Der Assistent führt Sie in drei Schritten durch die Konfiguration.
Schritt 1: Art der Synchronisierung

Wählen Sie Microsoft Entra, um Benutzergruppen aus Microsoft 365 / Entra ID mit skai zu synchronisieren.
Schritt 2: Verbindung herstellen (Microsoft-Anmeldung)
Nach der Auswahl werden Sie automatisch zur Microsoft-Anmeldeseite weitergeleitet. Melden Sie sich dort mit einem Konto an, das über ausreichende Berechtigungen verfügt, die gewünschten Entra-Gruppen auszulesen (in der Regel ein Entra-Administrator oder ein Konto mit der Rolle Verzeichnis-Leser).

Nach erfolgreicher Anmeldung werden Sie automatisch zurück zu skai geleitet und die Verbindung ist hergestellt.
Schritt 3: Benutzergruppen-Zuordnung konfigurieren
Im letzten Schritt legen Sie fest, welche Entra-Gruppen welchen skai-Benutzergruppen entsprechen.

Klicken Sie auf Hinzufügen, um eine Zuordnung einzutragen:
Feld | Bedeutung |
|---|---|
Entra-Gruppe | Auswahlliste der aus Entra geladenen Gruppen |
Skai-Gruppe | Zugeordnete Benutzergruppe in skai |
Sie können beliebig viele Zuordnungen anlegen. Benutzer, die einer Entra-Gruppe angehören, werden bei der Synchronisation automatisch in die entsprechende skai-Gruppe aufgenommen.
Klicken Sie abschließend auf Speichern, um die Konfiguration zu übernehmen.
Synchronisation ausführen
Manuell
Klicken Sie in der Übersicht auf Synchronisieren, um alle konfigurierten Synchronisationen sofort auszuführen. skai gleicht daraufhin die Benutzer aus Entra mit den Konten in skai ab:
Neue Benutzer in den zugeordneten Entra-Gruppen werden in skai angelegt.
Bestehende Benutzer werden aktualisiert (Name, Gruppenzugehörigkeit).
Benutzer, die nicht mehr in einer der synchronisierten Entra-Gruppen sind, werden in skai deaktiviert (nicht gelöscht).
Automatisch (Zeitplan)
Um die Synchronisation regelmäßig und ohne manuellen Eingriff auszuführen, richten Sie über das Kontextmenü einer Synchronisation Automatische Synchronisierung ein.

Sie können einen oder mehrere Ausführungszeitpunkte festlegen:
Modus | Beschreibung |
|---|---|
Einmalig | Synchronisation wird zu einem bestimmten Datum/Uhrzeit einmalig ausgeführt |
Täglich | Wiederholung jeden Tag zur festgelegten Uhrzeit |
Wöchentlich | Wiederholung an bestimmten Wochentagen |
Monatlich | Wiederholung an einem bestimmten Tag im Monat |
In der Übersicht wird nach dem Speichern der nächste geplante Ausführungstermin angezeigt.
Synchronisation bearbeiten oder löschen
Öffnen Sie das Kontextmenü (drei Punkte) einer Synchronisation in der Übersicht:
Verbindung bearbeiten – Führt die Microsoft-Anmeldung erneut durch, um den Zugangs-Token zu erneuern.
Zuweisungen bearbeiten – Öffnet die Benutzergruppen-Zuordnung zur Anpassung.
Automatische Synchronisierung – Konfiguriert den Zeitplan.
Löschen – Entfernt die Synchronisationskonfiguration dauerhaft. Bereits synchronisierte Benutzer und Gruppen in skai bleiben erhalten und müssen ggf. manuell verwaltet werden.