Enterprise Connector configureren en beheren
Gegevensbron, TLS, status, logs en diagnostiek in de Enterprise Connector-applicatie op uw eigen machine.
Zodra een connector is geregistreerd, ligt zijn configuratie in de connectorapplicatie op de machine in uw netwerk, niet in de console. Deze pagina beschrijft die applicatie.
Het applicatievenster
Linksboven bepaalt de connectorschakelaar welke van de geïnstalleerde connectors u bekijkt. Elke pagina onder de schakelaar heeft betrekking op de geselecteerde connector, dus controleer die eerst wanneer een pagina onverwachte waarden toont.
Welke pagina's beschikbaar zijn, hangt af van het type van de geselecteerde connector:
| Gebied | Pagina's | Beschikbaar voor |
|---|---|---|
| Home | Agents, Status | Elke connector |
| Configure | Data source, Identity | Verificatieconnectors |
| Configure | Provisioning target, Identity | Provisioningconnectors |
| Insight | Logs, Diagnostics | Diagnostics voor verificatieconnectors, Logs voor elke connector |
| Explore | Users, Groups, Directory structure | Verificatieconnectors |
| Update | Release notes, Update | Elke connector |
Data source (verificatieconnectors)
Configure → Data source bevat de verbinding met Active Directory of LDAP. Wijzigingen worden van kracht zonder herstart van de service.
Verbinding
| Veld | Betekenis |
|---|---|
| Protocol | ldaps:// (versleuteld, aanbevolen) of ldap://. De onversleutelde variant toont een waarschuwing, omdat bindinloggegevens en directorygegevens dan onversleuteld worden verzonden. |
| Host, Port | Adres van de domeincontroller of LDAP-server, normaal gesproken poort 636 voor LDAPS en 389 voor LDAP. |
| Bind DN, Bind password | Het serviceaccount waarmee de connector zich authenticeert. Leestoegang volstaat zolang upstreamsynchronisatie en het terugschrijven van wachtwoorden niet zijn ingeschakeld. |
| Base DN | De wortel van de deelboom waarin de connector werkt. |
| Custom CA certificates (PEM) | Certificaten van certificeringsinstanties die de LDAPS-verbinding naast het systeemarchief moet vertrouwen. Onafhankelijk van de certificaten voor de platformverbinding. |
| Ignore invalid certificates | Schakelt de certificaatcontrole voor de LDAPS-verbinding uit. Alleen als tijdelijke maatregel gebruiken. |
Users en Groups nemen elk een additional base DN op die aan de base DN wordt toegevoegd, plus een filter. Samen bepalen ze welke objecten de connector aan het platform doorgeeft. Nauwe filters houden de synchronisatie snel en voorkomen dat service- of systeemaccounts als gebruiker terechtkomen.
Test settings voert een verbindingstest uit met de waarden die op dat moment in het formulier staan en meldt wat er is gevonden, inclusief objectaantallen. Gebruik dit na elke wijziging voordat u opslaat.
Directorybewerkingen gebruiken standaard een tijdslimiet van tien seconden, wat een belaste domeincontroller op een trage verbinding dekt. Een gebruikersaanmelding die deze limiet overschrijdt, geldt als mislukte aanmelding. Onderzoek herhaalde tijdsoverschrijdingen daarom aan de directorykant in plaats van de tolerantie te verhogen.
Provisioning target (provisioningconnectors)
Configure → Provisioning target bepaalt wat een provisioningconnector mag bereiken:
- Allowed target origins is de lijst met systemen waaraan deze connector provisioningverzoeken mag doorgeven, één vermelding per regel. Een vermelding kan een origin noemen, bijvoorbeeld
https://scim.example, of een origin met een padvoorvoegsel om die verder in te perken. Een lege lijst wijst alles af, en dat is de bedoelde toestand totdat u een doel bewust vrijgeeft. - Custom CA certificates en Ignore invalid certificates werken zoals hun tegenhangers op de pagina van de gegevensbron, toegepast op de doelverbinding.
De vrijgavelijst is een indammingsgrens: die begrenst welke systemen binnen uw netwerk via deze connector überhaupt bereikbaar zijn. Houd de lijst zo nauw als de integratie toelaat.
Identity (verbinding met het platform)
Configure → Identity betreft de communicatie van de connector met het platform:
- Custom CA certificates (PEM) zijn de certificaten van de certificeringsinstanties die de verbinding met het platform moet vertrouwen. Ze zijn nodig wanneer uw netwerk TLS onderschept of het platformcertificaat van een private instantie komt. Deze instelling wordt bij het starten van de connectorservice toegepast, dus de service moet na een wijziging opnieuw worden gestart.
- Ignore invalid certificates schakelt de controle van die verbinding uit. Alleen als tijdelijke maatregel gebruiken.
- Export keypair bundelt het sleutelpaar van de connector in een met een wachtwoordzin versleuteld blok. U hebt dit nodig om een andere connector voor dezelfde directory te registreren of om deze connector naar een andere machine te verplaatsen. De wachtwoordzin beschermt de privésleutel en kan niet worden hersteld, bewaar dus beide delen veilig en verwijder het geëxporteerde blok zodra het is gebruikt.
Status
Home → Status toont drie indicatoren voor de geselecteerde connector: de lokale Service, de verbinding met Identity en de verbinding met de Data source dan wel het Provisioning target. Daaronder verschijnt de recente activiteit live: synchronisatieruns met hun gebruikersaantallen, geslaagde en mislukte aanmeldingen, wachtwoordwijzigingen en provisioningverkeer met het aantal fouten.
Dit is de snelste manier om een connectorprobleem van een platformprobleem te onderscheiden. Een connector waarvan de service beschikbaar is en de platformverbinding staat, maar waarvan de gegevensbron niet bereikbaar is, wijst naar de directoryservice of naar de inloggegevens op de pagina van de gegevensbron.
De directory verkennen
Explore → Users, Groups en Directory structure tonen rechtstreeks vanuit de bron wat de connector met de huidige base DN's en filters daadwerkelijk ziet. Gebruik ze om een filter te controleren voordat u synchronisatie inschakelt, en om vast te stellen of een in het platform ontbrekende gebruiker al bij de bron ontbreekt of door een filter wordt uitgesloten.
Logs
Insight → Logs somt de logbestanden van de geselecteerde connector op en biedt een Live-weergave die het huidige bestand volgt. Logbestanden worden geroteerd en in omvang begrensd, ze kunnen dus niet onbeperkt groeien.
Logs blijven op de machine. Niets daarvan bereikt het platform tenzij u een diagnosepakket verstuurt.
Diagnostiek
Insight → Diagnostics bouwt uit de door u geselecteerde categorieën een supportpakket:
| Categorie | Inhoud |
|---|---|
| Logs | De logbestanden van de connector. Standaard opgenomen. |
| Settings | De configuratie van de gegevensbron: host, bind DN, base DN's en filters. Het bindwachtwoord wordt weggelaten. |
| Connection test | Het resultaat van een nieuwe verbindingstest. |
| Users, Groups, Directory structure | Directorygegevens zoals de connector ze leest. Standaard niet opgenomen, omdat ze persoonsgegevens bevatten. |
Download slaat het pakket lokaal op, zodat u het vóór het delen kunt inspecteren. Upload to support draagt het rechtstreeks over. Controleer de geselecteerde categorieën vóór het uploaden: de directorycategorieën bevatten persoonsgegevens van uw gebruikers.
Bedrijfsaanwijzingen
- De connectors draaien als Windows-services en blijven werken wanneer het applicatievenster is gesloten.
- Het stoppen van een verificatieconnector stopt de aanmeldingen van zijn directory, tenzij een andere connector van die directory online is.
- Gegevensbron, provisioningdoel en directoryfilters gelden onmiddellijk. Certificaten voor de platformverbinding gelden na een herstart van de service.
- De pagina Update → Release notes vermeldt wat er in elke versie is gewijzigd.
Probleemoplossing
- Identity is verbonden, maar de connector is niet bruikbaar. De connector heeft het platform bereikt, maar is niet geaccepteerd. Dit volgt meestal op een verwijderd of opnieuw aangemaakt connectorrecord in de console. Registreer de connector opnieuw met een nieuwe provisioning-URL.
- De gegevensbron wordt als niet verbonden getoond. Test de verbinding op de pagina van de gegevensbron. Veelvoorkomende oorzaken zijn een verlopen wachtwoord van het bindaccount, een firewallregel tussen de machine en de domeincontroller, en een LDAPS-certificaat dat de machine niet vertrouwt.
- Aanmeldingen mislukken terwijl de synchronisatie werkt. Het bindaccount mag lezen, maar de gebruikers kunnen zich niet binden, of het gebruikersfilter sluit hen uit. Controleer het gebruikersfilter op de pagina van de gegevensbron en het account onder Explore → Users.
- Na een synchronisatie ontbreken gebruikers. Controleer eerst de additional base DN en het gebruikersfilter en bevestig onder Explore → Users dat de connector de accounts überhaupt ziet.
- Een wachtwoordwijziging wordt geweigerd. Bij een directory met end-to-end-wachtwoordbescherming handhaaft de connector het wachtwoordbeleid. Werk de connector bij wanneer de melding niet overeenkomt met het beleid dat in de console is geconfigureerd.
Zie ook
- Enterprise Connector installeren voor vereisten, installatie, updates en verwijdering.
- Enterprise Connectors voor de consolekant.
- Gebruikersdirectory's voor synchronisatie, het terugschrijven van wachtwoorden en de directory-instellingen zelf.