# Enterprise Connectors

Beheer de on-premises connectors die uw netwerk met het platform verbinden voor verificatie, synchronisatie en provisioning.

Een **Enterprise Connector** is lichtgewicht software die u binnen uw eigen netwerk installeert. Deze opent een permanente uitgaande verbinding met het platform en houdt die in stand; aan uw kant luistert niets naar inkomende verbindingen en uw firewall heeft geen inkomende regel nodig. Verzoeken aan Active Directory of LDAP lopen via die verbinding naar de connector, die lokaal met de directory communiceert. Alle connectors worden op één plek beheerd onder **Directory's → Enterprise Connectors**, met een overzicht van elke connector, de status ervan en waarvoor deze wordt gebruikt.

## Connectortypen

U kiest het type bij het aanmaken van de connector, en **het kan daarna niet meer worden gewijzigd**:

| Type | Doel | Gebonden aan |
|---|---|---|
| **Verificatie** | Valideert aanmeldingen tegen Active Directory / LDAP en synchroniseert gebruikers voor een enterprise-directory. | Precies één gebruikersdirectory. |
| **Provisioning** | Leidt uitgaande provisioning (SCIM) naar applicaties die zich binnen uw netwerk bevinden. | Geen directory: applicaties selecteren de connector. |

Een verificatieconnector moet aan één directory gebonden zijn. Een directory kan **meerdere** verificatieconnectors hebben: elk aanmeldings- en synchronisatieverzoek gaat naar de connector met de op dat moment laagst gemeten latentie, en wanneer één connector uitvalt, nemen de andere het over.

## Een connector aanmaken en registreren

1. Open **Directory's → Enterprise Connectors** en kies ervoor een nieuwe connector aan te maken.
2. Voer een **naam** in en kies het **type**.
3. Selecteer voor een **verificatie**connector de **directory** die deze zal bedienen. Dit is verplicht: de eerste verificatieconnector van een directory legt de beveiligde sleutel vast waarmee de directory wachtwoorden end-to-end beschermt, dus deze moet weten bij welke directory hij hoort.
4. Sla op. De connector verschijnt met een **provisioning-URL** en de status in behandeling.
5. Installeer de connectorsoftware in uw netwerk en registreer deze met die provisioning-URL. Zodra de connector verbinding maakt, verandert de status in **Ready**. De volledige procedure, inclusief vereisten en de download van het installatieprogramma, wordt beschreven onder [Een Enterprise Connector installeren](https://dts-identity.com/nl/docs/directories/enterprise-connector-installation.md).

De provisioning-URL is eenmalig bruikbaar en verloopt na enkele dagen. Als deze verloopt vóór de registratie, verwijder dan de connector in behandeling en maak een nieuwe aan.

### Meerdere connectors en de gedeelde sleutel

Alle verificatieconnectors van dezelfde directory moeten met **hetzelfde sleutelpaar** draaien. De eerste connector die zich registreert, legt de sleutel voor de directory vast; elke latere connector moet dezelfde sleutel aanbieden, anders wordt de registratie geweigerd. Zo blijft de wachtwoordbescherming consistent, ongeacht welke connector een bepaalde aanmelding afhandelt.

## Status en monitoring

Elke connector toont zijn huidige status:

- **Ready**: verbonden en beschikbaar.
- **Verbonden**: verbonden maar nog niet volledig geïnitialiseerd.
- **In behandeling**: aangemaakt maar nog niet geregistreerd.
- **Niet verbonden**: momenteel niet verbonden.

Open een connector om de hostgegevens, versie, laatste online-tijd en, zolang deze verbonden is, een live grafiek van de round-trip-tijd te bekijken.

Elke statuswijziging wordt in het auditlogboek vastgelegd als `CONNECTOR_ONLINE` / `CONNECTOR_OFFLINE`. Wanneer de meerderheid van de geregistreerde verificatieconnectors van een directory offline is, geeft een extra gebeurtenis `DIRECTORY_DEGRADED` aan dat aanmelden bij de directory beperkt kan zijn. Gebruik het alarmsjabloon **Directory beperkt beschikbaar** om hierover een melding te ontvangen.

### Updatemelding

Wanneer een nieuwere connectorversie beschikbaar is, toont het admin-dashboard bovenaan de pagina een waarschuwing met de connectors die een oudere versie draaien, en krijgt het item **Enterprise Connectors** in de navigatie een rode stip. Connectors die nooit een versie hebben gemeld, of die al 30 dagen niet zijn gezien, worden daar niet vermeld. De connectorlijst markeert elke connector die achterloopt op de nieuwste versie met de badge **Update beschikbaar**, ook connectors die al langer offline zijn. De melding verdwijnt zodra elke actieve connector de nieuwste versie draait.

## Provisioning via een connector

Wanneer een applicatie gebruikers provisioneert naar een systeem binnen uw netwerk, kunt u die provisioning via een of meer **provisioning**connectors laten lopen. Selecteer op het tabblad **Provisioning** van de applicatie, onder **Connectiviteit**, de te gebruiken connectors in volgorde van prioriteit. Wanneer connectors zijn geselecteerd, loopt de provisioning **uitsluitend** via deze connectors; wanneer er geen zijn geselecteerd, maakt het platform rechtstreeks via internet verbinding met het doel.

## Een connector verwijderen

Een connector kan worden verwijderd zodra deze **offline** is. Verbreek de verbinding of stop de connector eerst in uw netwerk en verwijder hem daarna hier.

## Probleemoplossing

- **Connector blijft In behandeling**: de provisioning-URL is niet op tijd gebruikt of de connector kan het platform niet bereiken. Controleer de uitgaande connectiviteit en maak de connector opnieuw aan als de URL is verlopen.
- **Registratie geweigerd voor een extra connector**: een tweede verificatieconnector voor dezelfde directory moet hetzelfde sleutelpaar gebruiken als de eerste. Hergebruik de bestaande sleutel.
- **Connector maakt verbinding maar wordt geweigerd wegens een afwijkende publieke sleutel**: de connector draait met een ander sleutelpaar dan het sleutelpaar dat voor zijn directory is opgeslagen. Importeer het geëxporteerde sleutelpaar van de oorspronkelijke connector van de directory in deze connector; als dat sleutelpaar verloren is, verwijder dan alle verificatieconnectors van de directory en registreer ze opnieuw.
- **Connector kan niet worden verwijderd**: deze is nog online. Stop hem eerst en verwijder hem daarna.

Voor de software in uw eigen netwerk, zie [Een Enterprise Connector installeren](https://dts-identity.com/nl/docs/directories/enterprise-connector-installation.md) en [Een Enterprise Connector configureren en beheren](https://dts-identity.com/nl/docs/directories/enterprise-connector-configuration.md).
