Skip to Content

Enterprise Connector konfigurieren und betreiben

Datenquelle, TLS, Status, Logs und Diagnose in der Enterprise-Connector-Anwendung auf Ihrer eigenen Maschine.

Sobald ein Connector registriert ist, liegt seine Konfiguration in der Connector-Anwendung auf der Maschine in Ihrem Netzwerk, nicht in der Konsole. Diese Seite beschreibt diese Anwendung.

Das Anwendungsfenster

Oben links wählt der Connector-Umschalter, welchen der installierten Connectors Sie gerade betrachten. Jede Seite unterhalb des Umschalters bezieht sich auf den ausgewählten Connector, prüfen Sie ihn also zuerst, wenn eine Seite unerwartete Werte zeigt.

Welche Seiten verfügbar sind, hängt vom Typ des ausgewählten Connectors ab:

BereichSeitenVerfügbar für
HomeAgents, StatusJeden Connector
ConfigureData source, IdentityAuthentication-Connectors
ConfigureProvisioning target, IdentityProvisioning-Connectors
InsightLogs, DiagnosticsDiagnostics für Authentication-Connectors, Logs für jeden Connector
ExploreUsers, Groups, Directory structureAuthentication-Connectors
UpdateRelease notes, UpdateJeden Connector

Data source (Authentication-Connectors)

Configure → Data source enthält die Verbindung zu Active Directory oder LDAP. Änderungen greifen ohne Neustart des Dienstes.

Verbindung

FeldBedeutung
Protocolldaps:// (verschlüsselt, empfohlen) oder ldap://. Die unverschlüsselte Variante zeigt eine Warnung, weil Bind-Zugangsdaten und Verzeichnisdaten dann im Klartext übertragen werden.
Host, PortAdresse des Domänencontrollers oder LDAP-Servers, üblicherweise Port 636 für LDAPS und 389 für LDAP.
Bind DN, Bind passwordDas Dienstkonto, mit dem sich der Connector authentifiziert. Lesezugriff genügt, solange Upstream-Sync und Passwort-Rückschreibung nicht aktiviert sind.
Base DNDie Wurzel des Teilbaums, in dem der Connector arbeitet.
Custom CA certificates (PEM)Zertifikate der Zertifizierungsstellen, denen die LDAPS-Verbindung zusätzlich zum Systemspeicher vertrauen soll. Unabhängig von den Zertifikaten für die Plattform-Verbindung.
Ignore invalid certificatesDeaktiviert die Zertifikatsprüfung für die LDAPS-Verbindung. Nur als Übergangslösung nutzen.

Users und Groups nehmen jeweils eine additional base DN, die an die Base DN angehängt wird, sowie einen Filter auf. Gemeinsam bestimmen sie, welche Objekte der Connector an die Plattform übergibt. Enge Filter halten die Synchronisation schnell und verhindern, dass Dienst- oder Systemkonten als Benutzer landen.

Test settings führt einen Verbindungstest mit den aktuell im Formular stehenden Werten aus und meldet das Ergebnis samt Objektanzahlen. Nutzen Sie ihn nach jeder Änderung vor dem Speichern.

Verzeichnisoperationen verwenden standardmäßig ein Zeitlimit von zehn Sekunden, was einen ausgelasteten Domänencontroller an einer langsamen Strecke abdeckt. Eine Benutzeranmeldung, die es überschreitet, gilt als fehlgeschlagene Anmeldung. Untersuchen Sie wiederholte Zeitüberschreitungen daher auf der Verzeichnisseite, statt die Toleranz zu erhöhen.

Provisioning target (Provisioning-Connectors)

Configure → Provisioning target steuert, was ein Provisioning-Connector erreichen darf:

  • Allowed target origins ist die Liste der Systeme, an die dieser Connector Provisionierungsanfragen weiterleiten darf, ein Eintrag pro Zeile. Ein Eintrag kann eine Origin nennen, etwa https://scim.example, oder eine Origin mit Pfadpräfix zur weiteren Eingrenzung. Eine leere Liste weist alles ab, und das ist der gewollte Zustand, bis Sie ein Ziel bewusst freigeben.
  • Custom CA certificates und Ignore invalid certificates funktionieren wie ihre Gegenstücke auf der Seite der Datenquelle, bezogen auf die Zielverbindung.

Die Freigabeliste ist eine Eindämmungsgrenze: Sie begrenzt, welche Systeme in Ihrem Netzwerk über diesen Connector überhaupt erreichbar sind. Halten Sie sie so eng, wie es die Integration zulässt.

Identity (Verbindung zur Plattform)

Configure → Identity betrifft die Kommunikation des Connectors mit der Plattform:

  • Custom CA certificates (PEM) sind die Zertifikate der Zertifizierungsstellen, denen die Verbindung zur Plattform vertrauen soll. Sie werden benötigt, wenn Ihr Netzwerk TLS aufbricht oder das Plattform-Zertifikat aus einer privaten Zertifizierungsstelle stammt. Diese Einstellung wird beim Start des Connector-Dienstes angewendet, der Dienst muss nach einer Änderung also neu gestartet werden.
  • Ignore invalid certificates deaktiviert die Prüfung dieser Verbindung. Nur als Übergangslösung nutzen.
  • Export keypair bündelt das Schlüsselpaar des Connectors in einen mit einer Passphrase verschlüsselten Block. Sie benötigen ihn, um einen weiteren Connector für dasselbe Verzeichnis zu registrieren oder diesen Connector auf eine andere Maschine umzuziehen. Die Passphrase schützt den privaten Schlüssel und kann nicht wiederhergestellt werden, bewahren Sie daher beide Teile sicher auf und löschen Sie den exportierten Block nach der Verwendung.

Status

Home → Status zeigt drei Anzeigen für den ausgewählten Connector: den lokalen Service, die Verbindung zu Identity und die Verbindung zur Data source beziehungsweise zum Provisioning target. Darunter erscheint die jüngste Aktivität live: Synchronisationsläufe mit ihren Benutzerzahlen, erfolgreiche und fehlgeschlagene Anmeldungen, Passwortänderungen sowie Provisionierungsverkehr mit seiner Fehlerzahl.

Das ist der schnellste Weg, ein Connector-Problem von einem Plattform-Problem zu unterscheiden. Ein Connector, dessen Dienst verfügbar und dessen Plattform-Verbindung aufgebaut ist, dessen Datenquelle aber getrennt ist, verweist auf den Verzeichnisdienst oder die Zugangsdaten auf der Seite der Datenquelle.

Verzeichnis erkunden

Explore → Users, Groups und Directory structure zeigen direkt aus der Quelle, was der Connector mit den aktuellen Base DNs und Filtern tatsächlich sieht. Nutzen Sie sie, um einen Filter vor dem Aktivieren der Synchronisation zu prüfen und um festzustellen, ob ein in der Plattform fehlender Benutzer schon an der Quelle fehlt oder durch einen Filter ausgeschlossen wird.

Logs

Insight → Logs listet die Logdateien des ausgewählten Connectors und bietet eine Live-Ansicht, die der aktuellen Datei folgt. Logdateien werden rotiert und in der Größe begrenzt, sie können also nicht unbegrenzt wachsen.

Logs bleiben auf der Maschine. Nichts davon erreicht die Plattform, solange Sie kein Diagnosepaket senden.

Diagnose

Insight → Diagnostics baut aus den ausgewählten Kategorien ein Support-Paket:

KategorieInhalt
LogsDie Logdateien des Connectors. Standardmäßig enthalten.
SettingsDie Konfiguration der Datenquelle: Host, Bind DN, Base DNs und Filter. Das Bind-Passwort wird ausgelassen.
Connection testDas Ergebnis eines frischen Verbindungstests.
Users, Groups, Directory structureVerzeichnisdaten, wie der Connector sie liest. Standardmäßig nicht enthalten, da sie personenbezogene Daten umfassen.

Download speichert das Paket lokal, sodass Sie es vor der Weitergabe prüfen können. Upload to support überträgt es direkt. Prüfen Sie die ausgewählten Kategorien vor dem Hochladen: Die Verzeichniskategorien enthalten personenbezogene Daten Ihrer Benutzer.

Betriebshinweise

  • Die Connectors laufen als Windows-Dienste und arbeiten weiter, wenn das Anwendungsfenster geschlossen ist.
  • Das Stoppen eines Authentication-Connectors stoppt die Anmeldungen seines Verzeichnisses, sofern kein weiterer Connector dieses Verzeichnisses online ist.
  • Datenquelle, Provisionierungsziel und Verzeichnisfilter greifen sofort. Zertifikate für die Plattform-Verbindung greifen nach einem Neustart des Dienstes.
  • Die Seite Update → Release notes listet die Änderungen jeder Version.

Fehlerbehebung

  • Identity ist verbunden, der Connector aber nicht nutzbar. Der Connector hat die Plattform erreicht, wurde aber nicht akzeptiert. Das folgt meist auf einen gelöschten oder neu angelegten Connector-Datensatz in der Konsole. Registrieren Sie den Connector mit einer frischen Provisioning-URL erneut.
  • Die Datenquelle wird als getrennt angezeigt. Testen Sie die Verbindung auf der Seite der Datenquelle. Häufige Ursachen sind ein abgelaufenes Passwort des Bind-Kontos, eine Firewall-Regel zwischen Maschine und Domänencontroller sowie ein LDAPS-Zertifikat, dem die Maschine nicht vertraut.
  • Anmeldungen schlagen fehl, während die Synchronisation funktioniert. Das Bind-Konto darf lesen, aber die Benutzer können sich nicht binden, oder der Benutzerfilter schließt sie aus. Prüfen Sie den Benutzerfilter auf der Seite der Datenquelle und das Konto unter Explore → Users.
  • Nach einer Synchronisation fehlen Benutzer. Prüfen Sie zuerst die zusätzliche Base DN und den Benutzerfilter und bestätigen Sie unter Explore → Users, dass der Connector die Konten überhaupt sieht.
  • Eine Passwortänderung wird abgelehnt. Bei einem Verzeichnis mit Ende-zu-Ende-Passwortschutz setzt der Connector die Passwortrichtlinie durch. Aktualisieren Sie den Connector, wenn die Meldung nicht zur in der Konsole konfigurierten Richtlinie passt.

Siehe auch

Auf dieser Seite