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
- Open Directory's → Enterprise Connectors en kies ervoor een nieuwe connector aan te maken.
- Voer een naam in en kies het type.
- Selecteer voor een verificatieconnector 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.
- Sla op. De connector verschijnt met een provisioning-URL en de status in behandeling.
- 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.
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 provisioningconnectors 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 en Een Enterprise Connector configureren en beheren.
Organisatieportaal
Het afgebakende self-serviceoppervlak waar de beheerder van een zakelijke klant leden, uitnodigingen en applicatietoegang beheert.
Enterprise Connector installeren
Vereisten, download, installatie, registratie, updates, migratie en verwijdering van de on-premises Enterprise Connector.