Skip to Content

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:

TypZweckGebunden an
AuthenticationValidiert Anmeldungen gegen Active Directory / LDAP und synchronisiert Benutzer für ein Enterprise-Verzeichnis.Genau ein Benutzerverzeichnis.
ProvisioningLeitet 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 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 und Enterprise Connector konfigurieren und betreiben.

Auf dieser Seite