Datensynchronisierung durchführen

Hinweis: Diese Dokumentation bezieht sich auf die aktuellste Version des Plugins agorum core directory sync. Aktualisieren Sie das hier beschriebene Plugin, um die Dokumentation verwenden zu können.

Nach der Erstellung einer Konfiguration wird die Synchronisierung der Daten aus dem Verzeichnisdienst entweder automatisch oder manuell durchgeführt.

Automatische Synchronisierung

Die automatische Synchronisierung erfolgt jede Minute für alle aktiven Konfigurationen. Hierfür ist keine weitere Einrichtung notwendig.

Voraussetzungen für die automatische Synchronisierung:

Die Konfiguration muss erstellt und gespeichert sein.
Die Checkbox Konfig aktiv muss aktiviert sein.
Die Verbindungsdaten zum Directory Service müssen korrekt sein.
Die Synchronisierungsregeln müssen korrekt und vollständig sein.

Hinweis: Das System prüft automatisch jede Minute, ob aktive Konfigurationen vorhanden sind, und führt die Synchronisierung durch.

Manuelle Synchronisierung

Sie können die Synchronisierung auch jederzeit manuell anstoßen. Wenn Sie Konfigurationen synchronisieren wollen, die nicht aktiv sind, müssen Sie diese entweder aktivieren oder die Synchronisierung manuell durchführen.

Öffnen Sie > Administration > Konfiguration > Verzeichnissynchronisierung.

Ergebnis: Das Fenster Verzeichnissynchronisierung einrichten öffnet sich mit einer Auswahlliste aller vorhandenen Konfigurationen.
Wählen Sie die Konfiguration aus, deren Daten Sie synchronisieren möchten, und klicken Sie auf Bearbeiten.

Ergebnis: Das Bearbeitungsfenster der ausgewählten Konfiguration öffnet sich.
Klicken SIe auf auf Synchronisieren, um eine manuelle Synchronisierung durchzuführen.

Ergebnis: Das Fenster Hintergrundaktivitäten öffnet sich und zeigt den Fortschritt der Synchronisierung an.

Wann ist eine manuelle Synchronisierung sinnvoll?

Nach der Ersteinrichtung einer Konfiguration zum Testen
Nach Änderungen an den Synchronisierungsregeln
Wenn Sie inaktive Konfigurationen synchronisieren wollen

Überwachung und Logging

Sie können den Fortschritt und mögliche Fehler der Synchronisierung überwachen:

Hintergrundaktivitäten: Während einer manuellen Synchronisierung öffnet sich automatisch das Fenster Hintergrundaktivitäten, das den aktuellen Status anzeigt.
Log-Anzeige: In der Synchronisierungskonfiguration können Sie auf Log anzeigen klicken, um detaillierte Log-Einträge im Support-Tool anzuzeigen.
Fehlerprotokollierung: Bei Fehlern werden diese im Log protokolliert und als 'Sticky'-Eintrag markiert, sodass sie auch nach Systemneustart sichtbar bleiben.

Was passiert bei der Synchronisierung

Bei jedem Synchronisierungslauf werden folgende Schritte ausgeführt:

Verbindung zum Verzeichnisdienst: Das System stellt eine Verbindung zum konfigurierten Verzeichnisdienst-Server her.
Abfrage der Objekte: Alle Benutzer und Gruppen, die den definierten Synchronisierungsregeln entsprechen, werden abgefragt.
Vergleich und Aktualisierung: Für jedes gefundene Objekt wird geprüft:
- Existiert das Objekt bereits in agorum core pro?
- Haben sich Daten geändert? (Name, E-Mail, Beschreibung usw.)
- Ist das Objekt in eine andere OU verschoben worden?
Anlegen neuer Objekte: Neue Benutzer und Gruppen werden in der entsprechenden Ordnerstruktur angelegt.
Aktualisierung bestehender Objekte: Geänderte Daten werden aktualisiert, ggf. werden Objekte in andere Ordner verschoben.
Gruppenmitgliedschaften: Bei Gruppen werden die Mitgliedschaften aktualisiert (rekursiv, wenn konfiguriert).
Sperrung/Löschung: Objekte, die im Verzeichnisdienst nicht mehr gefunden werden oder deaktiviert sind, werden gesperrt (Benutzer) bzw. gelöscht (Gruppen).