# Enterprise Connector installieren

Voraussetzungen, Download, Installation, Registrierung, Updates, Migration und Entfernung des On-Premises-Enterprise-Connectors.

Diese Seite behandelt die Software-Seite: was Sie in Ihrem eigenen Netzwerk installieren, wie Sie sie registrieren, aktuell halten und wieder entfernen. Die Konsolen-Seite (Connector anlegen, Provisioning-URL, Status, Löschen) ist unter [Enterprise Connectors](https://dts-identity.com/de/docs/directories/enterprise-connectors.md) beschrieben.

## Was installiert wird

Eine Windows-Installation beherbergt die **Agent-Anwendung** sowie einen oder mehrere **Connectors**. Das sind getrennte Dinge:

| Komponente | Was es ist | Läuft |
|---|---|---|
| **Agent-Anwendung** | Das Verwaltungsfenster, das Sie auf der Maschine öffnen. Registriert Connectors, hält ihre Konfiguration, zeigt Status, Logs und Diagnose. | Bei Bedarf, von Ihnen gestartet. |
| **Lokaler Broker-Dienst** | Wird beim ersten Start als Windows-Dienst `iec-nats` registriert. Trägt die interne Kommunikation zwischen dem Fenster und den installierten Connectors. Nur lokal auf der Maschine gebunden. | Dauerhaft, als Windows-Dienst. |
| **Agent-Dienst** | Ein Windows-Dienst je registriertem Connector, benannt `iec-agent-<agent id>`. Hält die ausgehende Verbindung zur Plattform und erledigt die eigentliche Arbeit. | Dauerhaft, als Windows-Dienst. |

Da jeder Connector ein eigener Windows-Dienst ist, laufen Connectors weiter, wenn das Anwendungsfenster geschlossen ist, und starten nach einem Neustart wieder. Das Fenster brauchen Sie nur zum Konfigurieren, Prüfen oder Aktualisieren.

Eine Maschine kann mehrere Connectors beherbergen, auch Connectors unterschiedlichen Typs und Connectors für verschiedene Verzeichnisse.

## Voraussetzungen

- **Windows auf x64.** Installer und Anwendung benötigen lokale Administratorrechte, und die Anwendung fordert bei jedem Start eine Rechteerhöhung an, weil sie Windows-Dienste verwaltet.
- **Nur ausgehendes HTTPS.** Der Connector baut die Verbindung zu Ihrem Plattform-Host über Port 443 auf (HTTPS und WebSocket über TLS) und hält sie offen. Auf Ihrer Seite ist weder eine eingehende Firewall-Regel noch ein veröffentlichter Port nötig.
- **Erreichbarkeit des Quellsystems.** Ein Authentication-Connector muss Ihren Domänencontroller oder LDAP-Server erreichen, üblicherweise über Port 636 für LDAPS oder 389 für LDAP. Ein Provisioning-Connector muss das SCIM-Ziel erreichen, das er bedienen soll.
- **Ein Dienstkonto für das Verzeichnis.** Ein Authentication-Connector bindet sich mit einem dedizierten Lesekonto an Active Directory oder LDAP (ein schreibberechtigtes Konto nur, wenn Upstream-Sync oder Passwort-Rückschreibung aktiviert wird).
- **Kein eingehender Zugriff auf die Maschine selbst.** Die interne Kommunikation zwischen Fenster und Diensten ist lokal auf die Maschine gebunden und wird auf jeder anderen Adresse abgewiesen.

Wählen Sie eine Maschine, die dauerhaft läuft und nah am Verzeichnisdienst steht, etwa einen Managementserver am selben Standort. Für Ausfallsicherheit installieren Sie einen zweiten Connector desselben Verzeichnisses auf einer anderen Maschine statt eines zweiten Connectors auf derselben.

> **Hinweis:** Der Installer ist noch nicht signiert, daher warnt Windows SmartScreen beim ersten Start. Prüfen Sie vorher die Prüfsumme, die neben dem Download angezeigt wird.

## Installer herunterladen

1. Öffnen Sie in der Konsole **Directories → Enterprise Connectors** und legen Sie den Connector an, den Sie registrieren möchten (siehe [Enterprise Connectors](https://dts-identity.com/de/docs/directories/enterprise-connectors.md)).
2. Öffnen Sie den neu angelegten Connector. Solange er nicht registriert ist, bietet seine Seite **Download for Windows** samt Version und SHA-1-Prüfsumme des Installers an.
3. Laden Sie den Installer herunter und kopieren Sie ihn auf die Zielmaschine.

Wird die Download-Karte nicht angezeigt, ist der Download-Dienst für Ihre Instanz nicht konfiguriert. Fordern Sie das Installationspaket bei Ihrem Support-Kontakt an.

## Anwendung installieren

1. Führen Sie den Installer auf der Zielmaschine aus und bestätigen Sie die Rechteerhöhung. Er installiert für alle Benutzer und legt eine Desktop-Verknüpfung an.
2. Starten Sie die Anwendung. Beim ersten Start registriert und startet sie den lokalen Broker-Dienst.
3. Die Anwendung fordert Sie beim ersten Start auf, ein **Passwort zu setzen**, und fragt es bei jedem weiteren Start ab. Wer Zugriff auf die Maschine und dieses Passwort hat, kann die dortigen Connectors verwalten, behandeln Sie es daher wie ein administratives Kennwort.

Das Passwort schützt ausschließlich das lokale Verwaltungsfenster. Es hat nichts mit Ihrem Konsolenkonto zu tun und wird nicht für die Verbindung zur Plattform verwendet.

## Connector registrieren

Die Registrierung verbindet die lokale Installation mit dem Connector-Datensatz, den Sie in der Konsole angelegt haben.

1. Öffnen Sie den Connector in der Konsole und kopieren Sie seine **Provisioning-URL**. Sie wird nur Admins angezeigt, die das Verzeichnis bearbeiten dürfen (und von der Management-API nur an Clients mit `enterpriseConnectors.write` ausgegeben), da die erste Registrierung den Verschlüsselungsschlüssel des Verzeichnisses festlegt.
2. Öffnen Sie in der Anwendung **Agents** und wählen Sie **Provision agent**.
3. Fügen Sie die Provisioning-URL ein und senden Sie das Formular ab.

Die Anwendung erzeugt ein Schlüsselpaar, tauscht es gegen die dauerhaften Zugangsdaten des Connectors, installiert den Connector-Dienst und startet ihn. Innerhalb weniger Sekunden zeigt die Konsole den Connector als **Ready**.

Die Provisioning-URL ist einmalig verwendbar und läuft nach einigen Tagen ab. Ein bereits registrierter Connector lässt sich mit derselben URL kein zweites Mal registrieren. Ist die URL abgelaufen, löschen Sie den ausstehenden Connector in der Konsole und legen einen neuen an.

### TLS-Aufbrechung und private Zertifizierungsstellen

Wenn Ihr Netzwerk TLS terminiert und neu signiert oder Ihr Plattform-Host ein Zertifikat einer privaten Zertifizierungsstelle verwendet, klappen Sie während der Registrierung die **advanced TLS options** auf:

- **Custom CA certificates (PEM)** erlaubt das Einfügen der Zertifikate, denen der Connector zusätzlich zum Windows-Zertifikatspeicher vertrauen soll. Das ist der empfohlene Weg.
- **Ignore invalid certificates** deaktiviert die Prüfung vollständig, für die Registrierung und für die laufende Verbindung des Connectors. Nutzen Sie das nur als Übergangslösung.

Beide Einstellungen lassen sich später auf der Seite **Identity** der Anwendung ändern. Siehe [Enterprise Connector konfigurieren und betreiben](https://dts-identity.com/de/docs/directories/enterprise-connector-configuration.md).

### Mehrere Connectors für dasselbe Verzeichnis

Alle Authentication-Connectors eines Verzeichnisses müssen mit **demselben Schlüsselpaar** laufen: Der erste registrierte Connector etabliert den Schlüssel des Verzeichnisses, und die Registrierung jedes weiteren Connectors wird abgelehnt, wenn sein Schlüssel abweicht. So ergänzen Sie einen zweiten Connector für ein bestehendes Verzeichnis:

1. Öffnen Sie auf der Maschine mit dem bestehenden Connector die Seite **Identity**, geben Sie eine Passphrase ein und wählen Sie **Export keypair**. Bewahren Sie den verschlüsselten Block und die Passphrase sicher auf.
2. Legen Sie den zweiten Connector in der Konsole an und kopieren Sie seine Provisioning-URL.
3. Wählen Sie auf der zweiten Maschine **Provision agent**, fügen Sie die URL ein, klappen Sie **keypair import** auf und fügen Sie den exportierten Block samt Passphrase ein.

Die Passphrase ist der einzige Schutz des exportierten privaten Schlüssels und die einzige Möglichkeit, den Block wieder zu öffnen. Löschen Sie die exportierte Kopie, sobald der zweite Connector läuft.

## Connector auf eine andere Maschine umziehen

Verwenden Sie dieselben Export- und Importschritte wie oben und nehmen Sie anschließend die alte Installation außer Betrieb:

1. Exportieren Sie das Schlüsselpaar auf der alten Maschine.
2. Legen Sie einen neuen Connector in der Konsole an und registrieren Sie ihn auf der neuen Maschine mit dem exportierten Schlüsselpaar.
3. Prüfen Sie, dass der neue Connector **Ready** meldet und Anmeldungen verarbeitet.
4. Deinstallieren Sie den Connector auf der alten Maschine und löschen Sie seinen Datensatz in der Konsole.

## Vorherigen Connector migrieren

Ist auf der Maschine ein Connector der vorherigen Hauptversion installiert, zeigt die Seite **Agents** ein Banner **Previous connector found**. Mit **Import previous connector** werden Registrierung, Schlüsselpaar und Verzeichniseinstellungen übernommen, anschließend wird der alte Windows-Dienst gestoppt und entfernt. Der Connector behält seine Identität in der Konsole, eine erneute Registrierung und eine neue Provisioning-URL sind nicht nötig.

Was nicht übernommen werden konnte, wird nach dem Import als Warnung aufgeführt, etwa ein Verzeichnisfilter in einem alten Format, der auf der Seite **Data source** neu angelegt werden muss. Prüfen Sie die Einstellungen der Datenquelle und führen Sie einen Verbindungstest aus, bevor Sie die Migration als abgeschlossen betrachten.

## Aktuell halten

Updates gibt es in zwei Ebenen, beide auf der Seite **Update** der Anwendung:

- **Anwendungs-Update** betrifft das Verwaltungsfenster selbst. Wählen Sie **Download update** und danach **Install & restart**. Das Fenster schließt sich kurz; die Connector-Dienste laufen weiter.
- **Agent-Updates** betreffen die Dienst-Binaries. Jede Anwendungsversion bringt die passenden Connector-Binaries mit, daher markiert die Liste **Agents** nach einem Anwendungs-Update betroffene Connectors mit **update available**. Wählen Sie **Update** je Connector oder nutzen Sie die Karte **Agent updates** auf der Seite **Update**. Der Connector-Dienst startet im Zuge des Updates neu.

Aktualisieren Sie bei mehreren Connectors eines Verzeichnisses jeweils einen nach dem anderen, damit Anmeldungen während des Neustarts weiter funktionieren. Die Seite **Release notes** in der Anwendung listet die Änderungen jeder Version.

## Starten, stoppen und neu starten

Die Liste **Agents** bietet **Start**, **Stop** und **Restart** für jeden installierten Connector. Ein Stopp bleibt erhalten: Der Connector bleibt über Neustarts hinweg gestoppt, bis Sie ihn wieder starten.

Solange ein Authentication-Connector gestoppt ist, hat sein Verzeichnis keinen Weg zu Active Directory oder LDAP, sofern kein weiterer Connector dieses Verzeichnisses online ist. Anmeldungen der Benutzer dieses Verzeichnisses schlagen in dieser Zeit fehl, und geplante Synchronisationen entfallen.

## Deinstallieren

### Einen einzelnen Connector entfernen

1. Öffnen Sie in der Anwendung **Agents** und wählen Sie **Stop** für den Connector. Die Deinstallation wird nur für einen gestoppten Connector angeboten.
2. Wählen Sie **Uninstall**. Der Windows-Dienst wird gestoppt und entfernt, das lokale Verzeichnis des Connectors wird gelöscht.
3. Löschen Sie den Connector-Datensatz in der Konsole unter **Directories → Enterprise Connectors**.

Wird der letzte Authentication-Connector eines Verzeichnisses entfernt, hat dieses Verzeichnis keine Verbindung mehr zu seiner Quelle: Anmeldungen und Synchronisation ruhen, bis ein neuer Connector registriert ist. Der gemeinsame Schlüssel des Verzeichnisses bleibt bestehen, ein Ersatz-Connector muss also mit demselben, zuvor exportierten Schlüsselpaar registriert werden.

### Die gesamte Installation entfernen

1. Deinstallieren Sie zuerst jeden Connector in der Anwendung wie oben beschrieben. Der Anwendungs-Deinstaller entfernt die Anwendung und den lokalen Broker-Dienst, aber keine Connector-Dienste, die noch registriert sind.
2. Deinstallieren Sie die Anwendung über **Einstellungen → Apps** in Windows.
3. Löschen Sie die Connector-Datensätze in der Konsole.

## Fehlerbehebung

- **SmartScreen blockiert den Installer.** Vergleichen Sie die in der Konsole angezeigte SHA-1-Prüfsumme mit der heruntergeladenen Datei und fahren Sie dann über **Weitere Informationen → Trotzdem ausführen** fort.
- **Registrierung schlägt mit abgelaufenem oder unbekanntem Ticket fehl.** Die Provisioning-URL ist einmalig verwendbar und kurzlebig. Löschen Sie den ausstehenden Connector in der Konsole, legen Sie einen neuen an und registrieren Sie ihn mit dessen frischer URL.
- **Registrierung wird wegen eines abweichenden öffentlichen Schlüssels abgelehnt.** Ein anderer Connector desselben Verzeichnisses wurde mit einem anderen Schlüsselpaar registriert. Exportieren Sie das Schlüsselpaar vom laufenden Connector und importieren Sie es bei der Registrierung.
- **Registrierung schlägt mit einem Zertifikatsfehler fehl.** Ihr Netzwerk bricht TLS auf, oder das Plattform-Zertifikat stammt aus einer privaten Zertifizierungsstelle. Fügen Sie die Zertifikate der Zertifizierungsstelle unter den erweiterten TLS-Optionen ein.
- **Der Connector-Dienst startet nicht.** Öffnen Sie **Insight → Logs** in der Anwendung für diesen Connector. Ein Dienst, der die Plattform nicht erreicht, versucht es fortlaufend erneut; ein dauerhafter Fehlschlag liegt daher meist an einer ausgehenden Firewall- oder Proxy-Beschränkung auf Port 443.
- **Ein Windows-Dienst wird als zum Löschen markiert gemeldet.** Schließen Sie eine offene Dienste-Konsole und den Dienste-Tab des Task-Managers und versuchen Sie es erneut. Bleibt der Zustand bestehen, starten Sie die Maschine neu.
- **Die Konsole zeigt den Connector offline, obwohl der Dienst läuft.** Der Connector läuft, kann die ausgehende Verbindung aber nicht aufbauen. Prüfen Sie die Seite **Status** der Anwendung und danach die Logs.

## Siehe auch

- [Enterprise Connectors](https://dts-identity.com/de/docs/directories/enterprise-connectors.md) zum Anlegen, Überwachen und Löschen von Connectors in der Konsole.
- [Enterprise Connector konfigurieren und betreiben](https://dts-identity.com/de/docs/directories/enterprise-connector-configuration.md) zu Datenquelle, TLS, Status, Logs und Diagnose.
- [Benutzerverzeichnisse](https://dts-identity.com/de/docs/directories/user-directories.md) zu den Verzeichniseinstellungen, die ein Authentication-Connector bedient.
