# Enterprise Connectors

On-Premises-Connectors installieren und verwalten, die Ihr Netzwerk für Verzeichnisauthentifizierung, Synchronisierung und Provisionierung anbinden.

Ein **Enterprise Connector** ist eine schlanke Software, die Sie innerhalb Ihres eigenen Netzwerks installieren. Er öffnet eine dauerhafte ausgehende Verbindung zur Plattform und hält sie offen; auf Ihrer Seite lauscht nichts auf eingehende Verbindungen, und Ihre Firewall braucht keine eingehende Regel. Anfragen an Active Directory oder LDAP laufen über diese Verbindung zum Connector, der lokal mit dem Verzeichnis spricht. Alle Connectors werden an einem Ort unter **Directories → Enterprise Connectors** verwaltet, mit einer Übersicht über jeden Connector, seinen Status und wofür er verwendet wird.

## Connector-Typen

Sie wählen den Typ beim Erstellen des Connectors, und **er kann danach nicht mehr geändert werden**:

| Typ | Zweck | Gebunden an |
|---|---|---|
| **Authentication** | Validiert Anmeldungen gegen Active Directory / LDAP und synchronisiert Benutzer für ein Enterprise-Verzeichnis. | Genau ein Benutzerverzeichnis. |
| **Provisioning** | Leitet ausgehende Provisionierung (SCIM) an Anwendungen weiter, die innerhalb Ihres Netzwerks liegen. | Kein Verzeichnis: Anwendungen wählen ihn aus. |

Ein Authentication-Connector muss an ein Verzeichnis gebunden sein. Ein Verzeichnis kann **mehrere** Authentication-Connectors haben: Jede Anmelde- und Sync-Anfrage geht an den Connector mit der in diesem Moment niedrigsten gemessenen Latenz, und fällt ein Connector aus, übernehmen die anderen.

## Einen Connector erstellen und registrieren

1. Öffnen Sie **Directories → Enterprise Connectors** und wählen Sie, einen neuen Connector zu erstellen.
2. Geben Sie einen **Namen** ein und wählen Sie den **Typ**.
3. Wählen Sie für einen **Authentication**-Connector das **Verzeichnis** aus, das er bedienen wird. Dies ist erforderlich: Der erste Authentication-Connector eines Verzeichnisses etabliert den sicheren Schlüssel, mit dem das Verzeichnis Passwörter Ende-zu-Ende schützt, daher muss er wissen, zu welchem Verzeichnis er gehört.
4. Speichern. Der Connector erscheint mit einer **Provisioning-URL** und einem ausstehenden Status.
5. Installieren Sie die Connector-Software in Ihrem Netzwerk und registrieren Sie sie mit dieser Provisioning-URL. Sobald er sich verbindet, ändert sich sein Status zu **Ready**. Das vollständige Vorgehen samt Voraussetzungen und Installer-Download ist unter [Enterprise Connector installieren](https://dts-identity.com/de/docs/directories/enterprise-connector-installation.md) beschrieben.

Die Provisioning-URL ist einmalig verwendbar und läuft nach einigen Tagen ab. Wenn sie vor der Registrierung abläuft, löschen Sie den ausstehenden Connector und erstellen Sie einen neuen.

### Mehrere Connectors und der gemeinsame Schlüssel

Alle Authentication-Connectors desselben Verzeichnisses müssen mit demselben **Schlüsselpaar** laufen. Der erste Connector, der sich registriert, legt den Schlüssel für das Verzeichnis fest; jeder spätere Connector muss denselben vorweisen, sonst wird die Registrierung abgelehnt. Dies hält den Passwortschutz konsistent, unabhängig davon, welcher Connector eine bestimmte Anmeldung bearbeitet.

## Status und Monitoring

Jeder Connector zeigt seinen aktuellen Zustand:

- **Ready**: verbunden und verfügbar.
- **Connected**: verbunden, aber noch nicht vollständig initialisiert.
- **Pending**: erstellt, aber noch nicht registriert.
- **Disconnected**: aktuell nicht verbunden.

Öffnen Sie einen Connector, um seine Host-Details, Version, letzte Online-Zeit und ein Live-Diagramm der Round-Trip-Zeit zu sehen, solange er verbunden ist.

Jeder Zustandswechsel wird im Audit-Log als `CONNECTOR_ONLINE` / `CONNECTOR_OFFLINE` protokolliert. Ist die Mehrheit der registrierten Authentication-Connectors eines Verzeichnisses offline, markiert ein zusätzliches Ereignis `DIRECTORY_DEGRADED`, dass die Anmeldung an diesem Verzeichnis eingeschränkt sein kann. Nutzen Sie die Alarm-Vorlage **Verzeichnis eingeschränkt**, um darüber benachrichtigt zu werden.

### Update-Hinweis

Sobald eine neuere Connector-Version verfügbar ist, zeigt das Admin-Dashboard oben auf der Seite eine Warnung mit den Connectors, die noch eine ältere Version ausführen, und der Eintrag **Enterprise Connectors** in der Navigation erhält einen roten Punkt. Connectors, die nie eine Version gemeldet haben oder seit 30 Tagen nicht mehr gesehen wurden, werden dort nicht aufgeführt. Die Connector-Liste markiert jeden Connector mit einer älteren Version mit dem Badge **Update verfügbar**, auch wenn er schon länger offline ist. Der Hinweis verschwindet, sobald alle aktiven Connectors die aktuelle Version ausführen.

## Provisionierung über einen Connector

Wenn eine Anwendung Benutzer in ein System provisioniert, das innerhalb Ihres Netzwerks liegt, können Sie diese Provisionierung über einen oder mehrere **Provisioning**-Connectors leiten. Wählen Sie auf der Registerkarte **Provisioning** der Anwendung unter **Connectivity** die zu verwendenden Connectors in Prioritätsreihenfolge aus. Wenn Connectors ausgewählt sind, läuft die Provisionierung **ausschließlich** über sie; wenn keine ausgewählt sind, verbindet sich die Plattform direkt über das Internet mit dem Ziel.

## Einen Connector entfernen

Ein Connector kann gelöscht werden, sobald er **offline** ist. Trennen oder stoppen Sie den Connector zuerst in Ihrem Netzwerk und löschen Sie ihn dann hier.

## Fehlerbehebung

- **Connector bleibt Pending**: Die Provisioning-URL wurde nicht rechtzeitig verwendet, oder der Connector kann die Plattform nicht erreichen. Prüfen Sie die ausgehende Konnektivität und erstellen Sie den Connector neu, falls die URL abgelaufen ist.
- **Connector verbindet sich, wird aber wegen eines abweichenden öffentlichen Schlüssels abgelehnt**: Der Connector läuft mit einem anderen Schlüsselpaar als dem, das für sein Verzeichnis hinterlegt ist. Importieren Sie das exportierte Schlüsselpaar des ursprünglichen Connectors dieses Verzeichnisses in diesen Connector; ist es verloren, entfernen Sie alle Authentication-Connectors des Verzeichnisses und registrieren Sie sie neu.
- **Registrierung für einen zusätzlichen Connector abgelehnt**: Ein zweiter Authentication-Connector auf demselben Verzeichnis muss dasselbe Schlüsselpaar wie der erste verwenden. Verwenden Sie den vorhandenen Schlüssel wieder.
- **Connector kann nicht gelöscht werden**: Er ist noch online. Stoppen Sie ihn zuerst und löschen Sie ihn dann.

Zur Software in Ihrem eigenen Netzwerk siehe [Enterprise Connector installieren](https://dts-identity.com/de/docs/directories/enterprise-connector-installation.md) und [Enterprise Connector konfigurieren und betreiben](https://dts-identity.com/de/docs/directories/enterprise-connector-configuration.md).
