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

| Bereich | Seiten | Verfügbar für |
|---|---|---|
| **Home** | Agents, Status | Jeden Connector |
| **Configure** | Data source, Identity | Authentication-Connectors |
| **Configure** | Provisioning target, Identity | Provisioning-Connectors |
| **Insight** | Logs, Diagnostics | Diagnostics für Authentication-Connectors, Logs für jeden Connector |
| **Explore** | Users, Groups, Directory structure | Authentication-Connectors |
| **Update** | Release notes, Update | Jeden Connector |

## Data source (Authentication-Connectors)

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

**Verbindung**

| Feld | Bedeutung |
|---|---|
| **Protocol** | `ldaps://` (verschlüsselt, empfohlen) oder `ldap://`. Die unverschlüsselte Variante zeigt eine Warnung, weil Bind-Zugangsdaten und Verzeichnisdaten dann im Klartext übertragen werden. |
| **Host**, **Port** | Adresse des Domänencontrollers oder LDAP-Servers, üblicherweise Port 636 für LDAPS und 389 für LDAP. |
| **Bind DN**, **Bind password** | Das Dienstkonto, mit dem sich der Connector authentifiziert. Lesezugriff genügt, solange Upstream-Sync und Passwort-Rückschreibung nicht aktiviert sind. |
| **Base DN** | Die 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 certificates** | Deaktiviert 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:

| Kategorie | Inhalt |
|---|---|
| **Logs** | Die Logdateien des Connectors. Standardmäßig enthalten. |
| **Settings** | Die Konfiguration der Datenquelle: Host, Bind DN, Base DNs und Filter. Das Bind-Passwort wird ausgelassen. |
| **Connection test** | Das Ergebnis eines frischen Verbindungstests. |
| **Users**, **Groups**, **Directory structure** | Verzeichnisdaten, 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

- [Enterprise Connector installieren](https://dts-identity.com/de/docs/directories/enterprise-connector-installation.md) zu Voraussetzungen, Installation, Updates und Entfernung.
- [Enterprise Connectors](https://dts-identity.com/de/docs/directories/enterprise-connectors.md) zur Konsolen-Seite.
- [Benutzerverzeichnisse](https://dts-identity.com/de/docs/directories/user-directories.md) zu Synchronisation, Passwort-Rückschreibung und den Verzeichniseinstellungen selbst.
