# Enterprise Connectors

Gérez les connecteurs sur site qui relient votre réseau à la plateforme pour l'authentification, la synchronisation et le provisionnement.

Un **Enterprise Connector** est un logiciel léger que vous installez au sein de votre propre réseau. Il ouvre une connexion sortante persistante vers la plateforme et la maintient active ; rien de votre côté n'écoute de connexions entrantes, et votre pare-feu n'a besoin d'aucune règle entrante. Les requêtes vers Active Directory ou LDAP transitent par cette connexion jusqu'au connecteur, qui communique localement avec l'annuaire. Tous les connecteurs se gèrent à un seul endroit, sous **Répertoires → Connecteurs d'entreprise**, avec une vue d'ensemble de chaque connecteur, de son état et de son usage.

## Types de connecteur

Vous choisissez le type lors de la création du connecteur, et **il ne peut plus être modifié ensuite** :

| Type | Objectif | Lié à |
|---|---|---|
| **Authentification** | Valide les connexions auprès d'Active Directory / LDAP et synchronise les utilisateurs d'un répertoire d'entreprise. | Exactement un répertoire utilisateur. |
| **Provisioning** | Achemine le provisionnement sortant (SCIM) vers des applications situées dans votre réseau. | Aucun répertoire : ce sont les applications qui le sélectionnent. |

Un connecteur d'authentification doit être lié à un répertoire. Un répertoire peut disposer de **plusieurs** connecteurs d'authentification : chaque requête de connexion et de synchronisation est envoyée au connecteur présentant la latence mesurée la plus faible à cet instant, et lorsqu'un connecteur tombe, les autres prennent le relais.

## Créer et enrôler un connecteur

1. Ouvrez **Répertoires → Connecteurs d'entreprise** et choisissez de créer un nouveau connecteur.
2. Saisissez un **nom** et choisissez le **type**.
3. Pour un connecteur d'**authentification**, sélectionnez le **répertoire** qu'il desservira. Ce choix est obligatoire : le premier connecteur d'authentification d'un répertoire établit la clé sécurisée que le répertoire utilise pour protéger les mots de passe de bout en bout, il doit donc savoir à quel répertoire il appartient.
4. Enregistrez. Le connecteur apparaît avec une **URL de provisionnement** et un état en attente.
5. Installez le logiciel du connecteur dans votre réseau et enrôlez-le à l'aide de cette URL de provisionnement. Dès qu'il se connecte, son état passe à **Ready**. La procédure complète, y compris les prérequis et le téléchargement du programme d'installation, est décrite dans [Installer un Enterprise Connector](https://dts-identity.com/fr/docs/directories/enterprise-connector-installation.md).

L'URL de provisionnement est à usage unique et expire au bout de quelques jours. Si elle expire avant l'enrôlement, supprimez le connecteur en attente et créez-en un nouveau.

### Plusieurs connecteurs et la clé partagée

Tous les connecteurs d'authentification d'un même répertoire doivent fonctionner avec la **même paire de clés**. Le premier connecteur enrôlé définit la clé du répertoire ; chaque connecteur ultérieur doit présenter la même, faute de quoi l'enrôlement est refusé. La protection des mots de passe reste ainsi cohérente, quel que soit le connecteur qui traite une connexion donnée.

## État et supervision

Chaque connecteur affiche son état actuel :

- **Ready** : connecté et disponible.
- **Connecté** : connecté, mais pas encore entièrement initialisé.
- **En attente** : créé, mais pas encore enrôlé.
- **Déconnecté** : actuellement non connecté.

Ouvrez un connecteur pour afficher les détails de son hôte, sa version, sa dernière heure de présence en ligne et, tant qu'il est connecté, un graphique en direct du temps aller-retour.

Chaque changement d'état est consigné dans le journal d'audit sous la forme `CONNECTOR_ONLINE` / `CONNECTOR_OFFLINE`. Lorsque la majorité des connecteurs d'authentification enrôlés d'un répertoire sont hors ligne, un événement supplémentaire `DIRECTORY_DEGRADED` signale que la connexion via ce répertoire peut être perturbée. Utilisez le modèle d'alarme **Répertoire dégradé** pour en être averti.

### Avis de mise à jour

Lorsqu'une version plus récente du connecteur est disponible, le tableau de bord d'administration affiche en haut de la page un avertissement listant les connecteurs qui exécutent une version plus ancienne, et l'entrée **Connecteurs d'entreprise** de la navigation porte un point rouge. Les connecteurs qui n'ont jamais signalé de version, ou qui n'ont pas été vus depuis 30 jours, n'y figurent pas. La liste des connecteurs signale chaque connecteur en retard sur la dernière version par un badge **Mise à jour disponible**, y compris ceux hors ligne depuis plus longtemps. L'avis disparaît dès que tous les connecteurs actifs exécutent la dernière version.

## Provisionnement via un connecteur

Lorsqu'une application provisionne des utilisateurs dans un système situé au sein de votre réseau, vous pouvez acheminer ce provisionnement via un ou plusieurs connecteurs de type **Provisioning**. Dans l'onglet **Provisioning** de l'application, sous **Connectivité**, sélectionnez les connecteurs à utiliser, par ordre de priorité. Lorsque des connecteurs sont sélectionnés, le provisionnement passe **uniquement** par eux ; lorsqu'aucun n'est sélectionné, la plateforme se connecte directement à la cible via Internet.

## Supprimer un connecteur

Un connecteur peut être supprimé dès qu'il est **hors ligne**. Déconnectez ou arrêtez d'abord le connecteur dans votre réseau, puis supprimez-le ici.

## Dépannage

- **Le connecteur reste En attente** : l'URL de provisionnement n'a pas été utilisée à temps ou le connecteur ne parvient pas à joindre la plateforme. Vérifiez la connectivité sortante et, si l'URL a expiré, recréez le connecteur.
- **Enrôlement refusé pour un connecteur supplémentaire** : un deuxième connecteur d'authentification sur le même répertoire doit utiliser la même paire de clés que le premier. Réutilisez la clé existante.
- **Le connecteur se connecte mais est rejeté pour une clé publique non concordante** : le connecteur utilise une paire de clés différente de celle enregistrée pour son répertoire. Importez dans ce connecteur la paire de clés exportée du connecteur d'origine du répertoire ; si cette paire de clés est perdue, supprimez tous les connecteurs d'authentification du répertoire et enrôlez-les de nouveau.
- **Impossible de supprimer un connecteur** : il est encore en ligne. Arrêtez-le d'abord, puis supprimez-le.

Pour le logiciel installé dans votre propre réseau, voir [Installer un Enterprise Connector](https://dts-identity.com/fr/docs/directories/enterprise-connector-installation.md) et [Configurer et exploiter un Enterprise Connector](https://dts-identity.com/fr/docs/directories/enterprise-connector-configuration.md).
