Configurer et exploiter un Enterprise Connector
Source de données, TLS, statut, logs et diagnostics dans l'application Enterprise Connector sur votre propre machine.
Une fois un connecteur enrôlé, sa configuration réside dans l'application du connecteur installée sur la machine de votre réseau, et non dans la console. Cette page décrit cette application.
La fenêtre de l'application
En haut à gauche, le sélecteur de connecteur détermine lequel des connecteurs installés vous consultez. Chaque page située sous le sélecteur porte sur le connecteur sélectionné : vérifiez donc le sélecteur en premier lorsqu'une page affiche des valeurs inattendues.
Les pages disponibles dépendent du type du connecteur sélectionné :
| Domaine | Pages | Disponible pour |
|---|---|---|
| Home | Agents, Status | Tous les connecteurs |
| Configure | Data source, Identity | Connecteurs d'authentification |
| Configure | Provisioning target, Identity | Connecteurs de provisioning |
| Insight | Logs, Diagnostics | Diagnostics pour les connecteurs d'authentification, Logs pour tous les connecteurs |
| Explore | Users, Groups, Directory structure | Connecteurs d'authentification |
| Update | Release notes, Update | Tous les connecteurs |
Data source (connecteurs d'authentification)
Configure → Data source contient la connexion à Active Directory ou LDAP. Les modifications prennent effet sans redémarrage du service.
Connexion
| Champ | Signification |
|---|---|
| Protocol | ldaps:// (chiffré, recommandé) ou ldap://. La variante non chiffrée affiche un avertissement, car les identifiants de bind et les données du répertoire circulent alors en clair. |
| Host, Port | Adresse du contrôleur de domaine ou du serveur LDAP, normalement le port 636 pour LDAPS et 389 pour LDAP. |
| Bind DN, Bind password | Le compte de service avec lequel le connecteur s'authentifie. L'accès en lecture suffit tant que la synchronisation ascendante et la réécriture des mots de passe ne sont pas activées. |
| Base DN | La racine du sous-arbre dans lequel le connecteur travaille. |
| Custom CA certificates (PEM) | Les certificats d'autorité auxquels la connexion LDAPS doit faire confiance en plus du magasin système. Indépendants des certificats configurés pour la connexion à la plateforme. |
| Ignore invalid certificates | Désactive la vérification des certificats pour la connexion LDAPS. À n'utiliser qu'à titre transitoire. |
Users et Groups acceptent chacun une additional base DN ajoutée à la base DN, ainsi qu'un filter. Ensemble, ils déterminent quels objets le connecteur transmet à la plateforme. Des filtres restrictifs maintiennent une synchronisation rapide et évitent que des comptes de service ou de système ne se retrouvent parmi les utilisateurs.
Test settings exécute un test de connexion avec les valeurs actuellement saisies dans le formulaire et rend compte du résultat, y compris le nombre d'objets. Utilisez-le après chaque modification, avant d'enregistrer.
Les opérations sur le répertoire utilisent par défaut un délai d'expiration de dix secondes, ce qui couvre un contrôleur de domaine chargé sur une liaison lente. Une connexion utilisateur qui le dépasse est comptée comme une connexion échouée : examinez donc les expirations répétées du côté du répertoire plutôt que d'augmenter la tolérance.
Provisioning target (connecteurs de provisioning)
Configure → Provisioning target détermine ce qu'un connecteur de provisioning est autorisé à joindre :
- Allowed target origins est la liste des systèmes auxquels ce connecteur peut transmettre des requêtes de provisionnement, à raison d'une entrée par ligne. Une entrée peut désigner une origine, par exemple
https://scim.example, ou une origine assortie d'un préfixe de chemin pour la restreindre davantage. Une liste vide rejette tout, et c'est l'état voulu tant que vous n'avez pas délibérément autorisé une cible. - Custom CA certificates et Ignore invalid certificates fonctionnent comme leurs équivalents sur la page de la source de données, appliqués à la connexion vers la cible.
La liste d'autorisation constitue une limite de confinement : elle borne les systèmes de votre réseau qui peuvent être joints via ce connecteur. Gardez-la aussi restreinte que l'intégration le permet.
Identity (connexion à la plateforme)
Configure → Identity couvre la manière dont le connecteur dialogue avec la plateforme :
- Custom CA certificates (PEM) sont les certificats d'autorité auxquels la connexion à la plateforme doit faire confiance, nécessaires lorsque votre réseau intercepte le trafic TLS ou que le certificat de la plateforme provient d'une autorité privée. Ce réglage est appliqué par le service du connecteur au démarrage : le service doit donc être redémarré après une modification.
- Ignore invalid certificates désactive la vérification de cette connexion. À n'utiliser qu'à titre transitoire.
- Export keypair regroupe la paire de clés du connecteur dans un bloc chiffré par une phrase secrète. Il vous est nécessaire pour enrôler un autre connecteur pour le même répertoire, ou pour déplacer ce connecteur vers une autre machine. La phrase secrète protège la clé privée et ne peut pas être récupérée : conservez les deux éléments en lieu sûr et supprimez le bloc exporté une fois qu'il a été utilisé.
Statut
Home → Status affiche trois indicateurs pour le connecteur sélectionné : le Service local, la connexion à Identity et la connexion à la Data source ou au Provisioning target. En dessous, l'activité récente apparaît en direct : exécutions de synchronisation avec leur nombre d'utilisateurs, connexions réussies et échouées, changements de mot de passe, ainsi que le trafic de provisionnement avec son nombre d'échecs.
C'est le moyen le plus rapide de distinguer un problème de connecteur d'un problème de plateforme. Un connecteur dont le service est disponible et dont la connexion à la plateforme est établie, mais dont la source de données est indisponible, oriente vers le service d'annuaire ou vers les identifiants configurés sur la page de la source de données.
Explorer le répertoire
Explore → Users, Groups et Directory structure montrent, directement depuis la source, ce que le connecteur voit réellement avec les base DN et les filtres actuels. Utilisez-les pour vérifier un filtre avant d'activer la synchronisation, et pour déterminer si un utilisateur absent de la plateforme manque déjà à la source ou s'il est exclu par un filtre.
Logs
Insight → Logs liste les fichiers journaux du connecteur sélectionné et propose une vue Live qui suit le fichier en cours. Les fichiers journaux font l'objet d'une rotation et d'une limite de taille : ils ne peuvent donc pas croître indéfiniment.
Les logs restent sur la machine. Rien de leur contenu n'atteint la plateforme tant que vous n'envoyez pas de paquet de diagnostic.
Diagnostics
Insight → Diagnostics constitue un paquet de support à partir des catégories que vous sélectionnez :
| Catégorie | Contenu |
|---|---|
| Logs | Les fichiers journaux du connecteur. Inclus par défaut. |
| Settings | La configuration de la source de données : hôte, bind DN, base DN et filtres. Le mot de passe de bind est omis. |
| Connection test | Le résultat d'un nouveau test de connexion. |
| Users, Groups, Directory structure | Les données du répertoire telles que le connecteur les lit. Non inclus par défaut, car elles contiennent des données personnelles. |
Download enregistre le paquet localement afin que vous puissiez l'inspecter avant de le partager. Upload to support le transfère directement. Vérifiez les catégories sélectionnées avant l'envoi : les catégories de répertoire contiennent des données personnelles de vos utilisateurs.
Notes d'exploitation
- Les connecteurs s'exécutent comme services Windows et continuent de fonctionner lorsque la fenêtre de l'application est fermée.
- Arrêter un connecteur d'authentification interrompt les connexions de son répertoire, sauf si un autre connecteur de ce répertoire est en ligne.
- La source de données, la cible de provisionnement et les filtres de répertoire s'appliquent immédiatement. Les certificats de la connexion à la plateforme s'appliquent après un redémarrage du service.
- La page Update → Release notes liste les changements de chaque version.
Dépannage
- Identity est connecté mais le connecteur n'est pas utilisable. Le connecteur a joint la plateforme mais n'a pas été accepté. Cela fait généralement suite à un enregistrement de connecteur supprimé ou recréé dans la console. Enrôlez à nouveau le connecteur avec une nouvelle URL de provisionnement.
- La source de données est affichée comme déconnectée. Testez la connexion sur la page de la source de données. Les causes fréquentes sont un mot de passe expiré du compte de bind, une règle de pare-feu entre la machine et le contrôleur de domaine, et un certificat LDAPS auquel la machine ne fait pas confiance.
- Les connexions échouent alors que la synchronisation fonctionne. Le compte de bind peut lire, mais les utilisateurs ne parviennent pas à se lier, ou le filtre utilisateur les exclut. Vérifiez le filtre utilisateur sur la page de la source de données et contrôlez le compte sous Explore → Users.
- Des utilisateurs manquent après une synchronisation. Vérifiez d'abord la base DN supplémentaire et le filtre utilisateur, puis confirmez sous Explore → Users que le connecteur voit bien les comptes.
- Un changement de mot de passe est refusé. Pour un répertoire avec protection des mots de passe de bout en bout, la politique de mots de passe est appliquée par le connecteur. Mettez le connecteur à jour lorsque le message ne correspond pas à la politique configurée dans la console.
Voir aussi
- Installer un Enterprise Connector pour les prérequis, l'installation, les mises à jour et la suppression.
- Enterprise Connectors pour le volet console.
- Répertoires utilisateur pour la synchronisation, la réécriture des mots de passe et les paramètres de répertoire eux-mêmes.