EMC – Entra Matrix Connector

Ausführung EMC-Synchronisierung aktiv Ausführungsintervall (Minuten) wie oft EMC bei Entra nachschaut Protokolle aufbewahren (Tage) Änderungs-, Fehler-, Anmelde- und E-Mail-Protokoll, gesperrte Mitarbeiterdaten sowie dauerhaft fehlgeschlagene Warteschlangen-Einträge - älter wird automatisch gelöscht. 0 = unbegrenzt aufbewahren. Schutz vor Massensperrung (%) Würde ein Lauf mehr als diesen Anteil der aktiven Benutzer (und mindestens 5) auf einmal sperren, wird er abgebrochen, ohne etwas an MATRIX zu senden - z.B. nach versehentlich gelöschter Zuordnung. Admin oder Manager können den Lauf über "Jetzt synchronisieren" bewusst bestätigen. 0 = aus. Gesperrte Benutzer in MATRIX löschen nach (Tagen) Ist eine Person so viele Tage gesperrt, löscht EMC sie in MATRIX (die MATRIX-Schnittstelle braucht dafür das Recht "Löschen" für Person). Wird sie später wieder Mitglied einer zugeordneten Gruppe, wird sie neu angelegt. 0 = nie löschen, nur gesperrt lassen.

Sicherheit Zwei-Faktor-Authentifizierung (2FA) für die Anmeldung erforderlich Betrifft alle Web-Accounts. Bei Deaktivierung genügt Benutzername und Passwort, ohne Abfrage eines 2FA-Codes. Fehlerprotokoll für Manager und User anzeigen Ausgeschaltet sehen nur Admins das Fehlerprotokoll im Status-Tab. Zutrittsprofile für Manager und User freigeschaltet Ausgeschaltet ist der Tab Zutrittsprofile zwar sichtbar, beim Öffnen erscheint aber nur der Hinweis, dass er noch nicht freigeschaltet ist. Admins können ihn immer nutzen. Die Synchronisierung läuft unabhängig davon weiter.

Microsoft Entra Tenant ID Client ID Client Secret

Entra Client Secret – Ablaufdatum

Entra meldet den Ablauf des Client Secret nicht selbst - Datum hier eintragen, damit EMC rechtzeitig per E-Mail warnt. Erinnerung erfolgt dreistufig (Vorlaufzeit, halbe Vorlaufzeit, 5 Tage vorher) sowie eine Alarmmeldung bei tatsächlichem Ablauf.

Läuft ab am Warnung vorab (Tage)

Matrix Basis-URL (z.B. https://firma.matrix.dormakaba.com/matrix/rest) API-Token Tenant-Nummer Schnittstellen-Nummer (interfaceNumber) Timeout (Sekunden)

Der Test legt/aktualisiert eine Testperson "EMC-VERBINDUNGSTEST" in MATRIX an (ohne Ausweisnummer und ohne Zutrittsberechtigung) - Geprüft wird bewusst ein Schreibvorgang, denn Personen, Ausweise und Zutrittsberechtigungen schreibt EMC nur und liest sie nie aus MATRIX. Lesend ruft EMC nur die Liste der Zutrittsprofile ab (Bezeichnungen im Tab Zutrittsprofile, dafür braucht der MATRIX-Zugang das Leserecht "Personenverwaltung").

Wechsel auf ein anderes MATRIX: "Sync-Stand zurücksetzen" lässt EMC vergessen, was es bisher an MATRIX übertragen hat, verwirft offene Jobs und sendet danach jede Person aus den zugeordneten Gruppen neu (Vollabgleich). Zuordnungen, Einstellungen und Protokolle bleiben.

Datenzuordnung

Fest vorgegeben, bis auf Ausweisnummer und E-Mail (dort frei wählbar, welches Entra-Attribut verwendet wird) und Ausweistyp (feste Nummer aus MATRIX, wird nicht aus Entra gelesen):

Matrix	Microsoft Entra
Vorname	givenName
Nachname	surname
Personalnummer	id (Objekt-ID)
Ausweisnummer
E-Mail
Ausweistyp
Zutrittsprofil	über die Zuordnung zu Entra-Gruppen, siehe Tab "Zutrittsprofile"

Datenschutz Anonym Vor- und Nachname werden nicht aus Entra übernommen, sondern immer als "Anonym" an Matrix übertragen, die E-Mail-Adresse bleibt dabei leer. Jede Änderung dieses Schalters erfordert das Datenschutz-Passwort (falls hinterlegt). Datenschutz-Passwort

Sperrgründe

Nummer des in Matrix hinterlegten Sperrgrunds (BlockingReasonNumber), je nach Ursache der Sperrung. EMC löscht Benutzer nie, sondern sperrt sie ausschließlich.

Sperrgrund: Entra-Konto deaktiviert Sperrgrund: Benutzer in Entra gelöscht Sperrgrund: in keiner zugeordneten Entra-Gruppe mehr

E-Mail-Server SMTP-Server SMTP-Port TLS verwenden (STARTTLS) Benutzername Passwort Absendername wird im "Von"-Feld der E-Mail angezeigt, z.B. "EMC Benachrichtigungen" Absenderadresse Mailvorlage Freies HTML - die eigentliche Systemmeldung wird an der Stelle von ##EMC## eingesetzt. Logo per <img src="cid:logo"> einbindbar.

E-Mail-Benachrichtigungen Ihre E-Mail-Adresse für Benachrichtigungen Umfang der Benachrichtigungen

Synchronisierung –

Nächster Lauf –

Letzter Lauf –

Letzter erfolgreicher Lauf –

Offene Jobs –

Änderungen heute –

Offene Jobs

ID	Personalnummer	Vorgang	Erstellt	Versuche	Letzter Fehler
Lade…

Änderungen

Zeitpunkt	Benutzer	Art der Änderung	Zutrittsprofil	Ergebnis
Lade…

Fehlerprotokoll

ID	Zeitpunkt	Komponente	Meldung
Lade…

E-Mail-Protokoll

Zeitpunkt	Betreff	Empfänger	Ergebnis
Lade…

Anmeldeprotokoll

Zeitpunkt	Benutzername	Ergebnis	IP-Adresse
Lade…

Zuordnung Matrix Zutrittsprofil ↔ Entra-Gruppe

Synchronisiert werden alle Benutzer, die Mitglied mindestens einer hier eingetragenen Entra-Gruppe sind (auch über Untergruppen). Sie erhalten in MATRIX alle Zutrittsprofile ihrer Gruppen. Wer in keiner Gruppe mehr ist, wird in MATRIX gesperrt. Zutrittsprofile, die direkt in MATRIX vergeben wurden, werden dabei überschrieben.

		Entra Beschreibung
Lade…

Neue Zuordnung

CSV-Import

Je Zeile: Zutrittsprofil;Entra-Gruppen-ID - eine Kopfzeile ist erlaubt, Trennzeichen Semikolon oder Komma (z.B. aus Excel "CSV UTF-8" gespeichert). Gruppenname und Beschreibung werden aus Entra, die Bezeichnung des Zutrittsprofils aus MATRIX gelesen. Bestehende Zuordnungen bleiben erhalten, bereits vorhandene werden übersprungen. Ist eine Zeile fehlerhaft, wird nichts importiert.

Vorschau

Zeigt, was der nächste Lauf tun würde - liest nur aus Entra, sendet nichts an MATRIX.

Benutzer	Bisher	Künftig	Aktion

Benutzer

Benutzername	Rolle	E-Mail	Benachrichtigung	2FA	Angelegt
Lade…

Neuen Benutzer anlegen

Manuelles Backup

Erstellt ein frisches, verschlüsseltes Backup (Konfiguration, Datenbank, Schlüssel) und lädt es direkt herunter.

Backup wiederherstellen

Achtung: überschreibt Konfiguration, Schlüssel und Datenbank vollständig mit dem Inhalt der hochgeladenen Datei. Der Dienst muss danach neu gestartet werden. Vor dem Überschreiben wird automatisch eine Sicherheitskopie des aktuellen Standes angelegt.

Backup-Protokoll

Zeitpunkt	Ziel	Ergebnis
Lade…

Passwort vergessen

Neues Passwort

Bestätigungscode