# Agent Endpoint

Installez, mettez à jour et supprimez l'agent Endpoint sous Windows, macOS et Linux, et découvrez ce qu'il remonte de l'appareil.

Requires: Device Identity (DIAM)

> **Add-on requis :** L'agent Endpoint fait partie de l'add-on **DIAM** (Device Identity).

L'**agent Endpoint** est le logiciel que vous installez sur chaque endpoint. Il enrôle la machine, remonte sa posture de sécurité selon une planification et exécute les [actions à distance](https://dts-identity.com/fr/docs/endpoints/remote-actions.md) que vous déclenchez depuis la console. Sans lui, un appareil ne peut pas apparaître dans l'[inventaire](https://dts-identity.com/fr/docs/endpoints/device-inventory.md). Les appareils enrôlés avec l'ancien client Windows continuent de fonctionner ; consultez [Legacy client](https://dts-identity.com/fr/docs/endpoints/legacy-client.md) pour savoir ce qui diffère et comment les migrer.

## Plateformes prises en charge

| Plateforme | Prise en charge à partir de |
|---|---|
| **Windows** | Windows 11 et Windows Server 2019, x64 |
| **macOS** | macOS 12 Monterey, Intel et Apple silicon |
| **Linux** | Debian 11, Ubuntu 22.04 et Red Hat Enterprise Linux 9 (y compris Rocky et Alma), x64 et ARM64, avec systemd |

Les versions antérieures ne sont pas prises en charge. Lorsque la machine dispose d'un TPM 2.0 (Windows, Linux) ou d'une Secure Enclave (Apple silicon, Mac dotés d'une puce T2), l'agent y conserve sa clé d'appareil ; ailleurs, il utilise une clé stockée sur le disque.

## Ce qui est installé

| Plateforme | Paquet | Ce qui s'exécute |
|---|---|---|
| Windows | `.msi` | Le service **DTS Endpoint Agent** (`DTSAgent`), installé sous `%ProgramFiles%\DTS\Agent` et démarré au démarrage. La fenêtre de l'agent s'ouvre à chaque connexion d'un utilisateur. |
| macOS | `.pkg` | Un démon système sous `/Library/DTS/Agent` et l'application **DTS Endpoint Agent** dans la barre des menus de chaque session utilisateur. |
| Linux | `.deb`, `.rpm` | Le service `dts-agent.service` et une icône d'état dans les sessions de bureau. Les serveurs sans bureau exécutent uniquement le service. |

L'agent conserve son état, y compris son identité d'appareil, dans `%ProgramData%\DTS\Agent` (Windows), `/Library/Application Support/DTS/Agent` (macOS) ou `/var/lib/dts-agent` (Linux), de sorte qu'une mise à niveau sur place ne réenrôle pas la machine. Ses fichiers journaux se trouvent dans le dossier `logs` de cet emplacement et sont conservés sept jours.

## Prérequis [#requirements]

- **Droits d'administrateur ou root** pour l'installation, car le paquet enregistre un service système.
- **HTTPS sortant vers votre instance de la plateforme.** L'agent établit la connexion vers l'extérieur et la maintient ouverte. Aucune règle de pare-feu entrante n'est nécessaire.
- **Un proxy qui inspecte le TLS** fonctionne dès que son certificat racine est approuvé dans le magasin propre au système d'exploitation (le magasin de l'ordinateur sous Windows, le trousseau Système sous macOS, le bundle d'autorités de certification de la distribution sous Linux). Rien n'est à configurer sur l'agent.

## Obtenir le programme d'installation

Le programme d'installation est généré pour votre instance : l'adresse de la plateforme et le certificat dont l'agent a besoin pour s'enrôler y sont intégrés, et il est signé numériquement. Un programme d'installation provenant d'une autre instance ne fonctionnera pas, et il n'y a rien à configurer lors de l'installation.

1. Ouvrez **Paramètres des appareils → Enregistrement**.
2. Demandez une compilation s'il n'en existe pas encore, puis **téléchargez**-la une fois qu'elle est prête. La carte affiche la version ainsi que ses sommes de contrôle SHA-1 et SHA-256.
3. Vérifiez les sommes de contrôle et distribuez le paquet à vos endpoints.

La console propose actuellement le paquet Windows. Les paquets pour macOS et Linux ne sont pas encore disponibles au téléchargement dans la console.

Consultez [Paramètres des appareils](https://dts-identity.com/fr/docs/endpoints/device-settings.md) pour le certificat d'enrôlement sur lequel cela repose et pour sa rotation.

## Installer et enrôler [#install-and-enroll]

Installez le paquet avec des droits d'administrateur, manuellement ou via votre outil de distribution de logiciels ou votre MDM. Il s'installe pour tous les utilisateurs et démarre le service. Les paquets n'acceptent aucune option, si bien qu'une installation silencieuse ne nécessite rien d'autre que les commutateurs habituels de la plateforme :

```
msiexec /i dts-agent-<version>.msi /qn
sudo installer -pkg dts-agent-<version>.pkg -target /
sudo apt install ./dts-agent_<version>_amd64.deb
sudo dnf install ./dts-agent-<version>.x86_64.rpm
```

L'enrôlement se fait ensuite de lui-même. L'agent crée sa clé d'appareil, s'enregistre auprès de la plateforme et reçoit son identité d'appareil. Rien ne doit être saisi sur l'endpoint. Selon le mode **Inscription des appareils** défini dans les [paramètres des appareils](https://dts-identity.com/fr/docs/endpoints/device-settings.md), l'appareil est géré immédiatement ou attend votre approbation dans l'[inventaire des appareils](https://dts-identity.com/fr/docs/endpoints/device-inventory.md).

Sous **macOS**, une partie de la posture (par exemple certains paramètres de sécurité) nécessite l'accès complet au disque, qu'un paquet ne peut pas accorder. Accordez-le à l'agent au moyen d'un profil de préférences de confidentialité (PPPC) depuis votre MDM ; sans lui, ces valeurs manquent et le reste est remonté normalement.

> **Remarque :** L'identité de l'appareil est créée lors du premier enrôlement et stockée sur la machine. La réinstallation d'un appareil à partir d'une image, ou l'effacement de cet état, produit un **nouvel** enregistrement d'appareil. L'ancien reste dans l'inventaire jusqu'à son expiration ou jusqu'à ce que vous le supprimiez.

## Ce que l'agent remonte

La posture est collectée toutes les cinq minutes et envoyée sous forme de différence par rapport au dernier rapport, avec un instantané complet au moins une fois par jour ou chaque fois que la plateforme en demande un. Entre deux rapports, l'agent envoie toutes les quelques secondes un bref signal de présence, ce qui permet d'afficher l'appareil comme connecté.

L'agent remonte :

- **Système d'exploitation et matériel** : version, build, architecture, modèle d'ordinateur, processeur et mémoire, et si la machine est virtuelle.
- **Identité de la machine et de ses utilisateurs** : nom d'hôte, domaine, compte actuellement connecté et comptes utilisateurs de l'appareil.
- **Configuration réseau** : cartes réseau avec adresses MAC et IP, passerelles et serveurs DNS.
- **Volumes et chiffrement de disque** (BitLocker, FileVault, volumes Linux chiffrés).
- **Logiciels installés** avec éditeur, version et date d'installation.
- **État de sécurité** : pare-feu, Microsoft Defender sous Windows, et paramètres tels que Secure Boot, TPM, Gatekeeper, System Integrity Protection, si le Mac est géré par un MDM et si un mot de passe est exigé après le verrouillage de l'écran.
- **Mises à jour manquantes du système d'exploitation** avec leur gravité et l'indication d'un éventuel redémarrage requis.
- **Si la session de console est verrouillée**, avec le signal de présence. La page de l'appareil ne l'affiche que si vous l'[activez](https://dts-identity.com/fr/docs/endpoints/device-settings.md).
- **Son propre état** : version, état d'isolation et état d'enrôlement MFA.

Il ne collecte **aucune géolocalisation** sur l'endpoint (la plateforme déduit une localisation approximative de l'adresse IP de la connexion), ni **aucun historique de navigation, contenu de fichier, frappe au clavier ou capture d'écran**. La **liste des processus**, avec les lignes de commande et le compte sous lequel chaque processus s'exécute, n'est collectée que lorsqu'un administrateur exécute cette [action à distance](https://dts-identity.com/fr/docs/endpoints/remote-actions.md).

Le périmètre de collecte est fixe. Il est identique sur chaque appareil d'une plateforme, et les utilisateurs peuvent le consulter dans la fenêtre de l'agent (voir ci-dessous). Planifiez le déploiement avec les personnes responsables des accords avec les représentants du personnel ou de la validation en matière de protection des données au sein de votre organisation : l'inventaire, le compte connecté et la liste des processus collectée à la demande constituent des données personnelles dans la plupart des juridictions.

## La fenêtre de l'agent

Chaque utilisateur voit l'agent dans la zone de notification (Windows), dans la barre des menus (macOS) ou sous forme d'icône d'état (Linux). Son menu affiche l'heure du dernier rapport, et **Vérifier maintenant** demande à la plateforme un résultat de conformité actualisé. La fenêtre comporte les pages suivantes :

| Page | Affiche |
|---|---|
| **Statut** | Si l'appareil est connecté, enrôlé et remonte ses données, et ce qui échoue actuellement. |
| **Conformité** | Le dernier résultat de conformité de l'appareil avec les contrôles qui ont échoué. |
| **Connexion à deux facteurs** | Sous Windows, les seconds facteurs de l'utilisateur pour la [connexion Windows](https://dts-identity.com/fr/docs/endpoints/windows-logon-mfa.md), lorsque l'appareil les vérifie lui-même. |
| **Confidentialité** | Chaque requête exécutée par l'agent et les données qu'il a envoyées en dernier. |
| **À propos** | La version, ainsi que **Envoyer les diagnostics** / **Enregistrer les diagnostics** pour les demandes de support. |

## La ligne de commande

L'agent installe une commande `dts-agent` destinée aux administrateurs et au support sur l'appareil :

| Commande | Objectif |
|---|---|
| `dts-agent status` | L'état de l'agent au format JSON : connexion, enrôlement, dernier rapport, isolation, et chaque étape qui échoue actuellement avec son message. Le premier élément à consulter lorsqu'un appareil se comporte mal. |
| `dts-agent compliance --refresh` | Le dernier résultat de conformité, redemandé à la plateforme. |
| `dts-agent revert-isolation` | Lève localement l'isolation réseau, à exécuter en tant qu'administrateur ou root. Pour un appareil que l'isolation a coupé de la plateforme. La levée est journalisée. |

## Comportement lorsque la plateforme est injoignable

L'agent continue de réessayer à des intervalles croissants allant jusqu'à cinq minutes et se reconnecte de lui-même. Les rapports de posture ne sont pas mis en file d'attente pendant la déconnexion : après une interruption, la plateforme voit donc l'état actuel, et non l'historique manqué. L'appareil apparaît hors ligne dans la console environ dix secondes après son dernier signal de présence. Un VPN full tunnel qui achemine tout le trafic via le réseau de l'entreprise doit lui aussi autoriser la connexion à votre instance, faute de quoi l'appareil reste hors ligne tant que le VPN est actif.

## Mise à jour

L'agent ne se met **pas** à jour de lui-même. Une mise à jour est un nouveau paquet, déployé de la même manière que le premier.

1. Demandez la nouvelle version sous **Paramètres des appareils → Enregistrement** et téléchargez-la.
2. Déployez-la sur les endpoints avec votre outil de distribution de logiciels ou votre MDM.

L'installation effectue une mise à niveau sur place et préserve l'identité de l'appareil : les appareils ne se réenrôlent pas et leur historique est conservé. Testez la mise à niveau sur un groupe pilote avant un déploiement à l'échelle du parc.

## Désinstallation [#uninstall]

1. **Désinstallez l'agent** par la méthode habituelle de la plateforme (**Paramètres → Applications** sous Windows, votre outil de distribution de logiciels ou votre MDM, `apt remove` ou `dnf remove` sous Linux). Sous macOS, exécutez `sudo dts-agent uninstall`. La désinstallation lève d'abord une éventuelle isolation réseau, puis supprime le service, les fichiers programme, l'état de l'agent et sa clé d'appareil.
2. **Supprimez l'appareil** dans l'[inventaire](https://dts-identity.com/fr/docs/endpoints/device-inventory.md). La désinstallation n'avertit pas la plateforme ; l'enregistrement subsiste donc jusqu'à ce que vous le supprimiez.

> **Remarque :** Sous Debian et Ubuntu, `apt remove` conserve l'état de l'agent jusqu'à ce que vous purgiez le paquet (`apt purge`). La suppression du `.rpm`, ainsi que la désinstallation sous Windows et macOS, le suppriment.

## Dépannage

- **L'appareil n'apparaît jamais dans l'inventaire.** Exécutez `dts-agent status` sur l'appareil : la commande nomme l'étape qui échoue. Vérifiez que l'endpoint peut joindre votre instance en sortie et que le mode d'enrôlement accepte de nouveaux appareils. Un programme d'installation généré pour une autre instance ne s'enrôle jamais.
- **Le statut signale une erreur de connexion, alors que le réseau fonctionne.** Il s'agit généralement d'un proxy qui inspecte le TLS et dont le certificat racine ne figure pas dans le magasin du système d'exploitation. Voir [Prérequis](#requirements).
- **Un appareil apparaît deux fois.** La machine a été réinstallée ou a perdu son état local, puis s'est enrôlée à nouveau. Supprimez l'ancien enregistrement.
- **Les données logicielles ou de correctifs semblent obsolètes.** La posture est remontée selon une planification. Utilisez l'[action à distance](https://dts-identity.com/fr/docs/endpoints/remote-actions.md) **Request full update** pour forcer un rapport complet.
- **Le navigateur demande l'autorisation d'accéder au réseau local lors de la connexion.** Les contrôles de conformité à la connexion fonctionnent en faisant interroger l'agent présent sur la machine elle-même par la page de connexion. Chrome 142 et versions ultérieures, ainsi qu'Edge, sollicitent l'utilisateur avant qu'un site web puisse joindre une adresse locale. Les utilisateurs peuvent l'autoriser une fois par site. Sur les parcs gérés, autorisez-le de manière centralisée pour votre adresse de connexion avec la stratégie de navigateur `LoopbackNetworkAllowedForUrls`, faute de quoi chaque utilisateur voit la demande.
- **Un appareil coupé par l'isolation ne peut plus être libéré depuis la console.** Exécutez `dts-agent revert-isolation` sur l'appareil en tant qu'administrateur ou root.

## Voir aussi

- [Paramètres des appareils](https://dts-identity.com/fr/docs/endpoints/device-settings.md) pour le programme d'installation et le certificat d'enrôlement.
- [Inventaire des appareils](https://dts-identity.com/fr/docs/endpoints/device-inventory.md) pour les appareils enrôlés et leur posture.
- [Actions à distance](https://dts-identity.com/fr/docs/endpoints/remote-actions.md) pour ce que vous pouvez déclencher sur un endpoint.
- [MFA à la connexion Windows](https://dts-identity.com/fr/docs/endpoints/windows-logon-mfa.md) pour la fonctionnalité de connexion qui s'appuie sur l'agent.
- [Legacy client](https://dts-identity.com/fr/docs/endpoints/legacy-client.md) pour les appareils qui exécutent encore l'ancien client Windows.
