> For the complete documentation index, see [llms.txt](https://wiki.datadike.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.datadike.com/fr/sonar/deploy-operate/network-requirements.md).

# Prérequis réseau

Les connexions sortantes qu'ouvre un endpoint géré : l'adresse de l'API SONAR et celle d'accès à distance sur le 443, plus les destinations tierces de l'agent.

## Ce que couvre cette page

Les règles de pare-feu et de proxy dont un **endpoint géré** a besoin. Toutes les connexions ci-dessous sont **sortantes depuis l'endpoint** : rien ne se connecte à l'appareil, et aucun port entrant n'a besoin d'être ouvert sur celui-ci ni sur son réseau.

Le serveur SONAR lui-même est exploité par DataDike. Ses adresses sont fournies par DataDike pour votre instance, et rien sur cette page ne s'y configure.

## Les deux adresses SONAR

Chaque instance possède deux adresses que les endpoints doivent pouvoir joindre. DataDike fournit les deux à la livraison de l'instance. Sur cette page, elles apparaissent sous forme de valeurs d'exemple :

| Valeur d'exemple     | Ce que c'est                                                                                                                                                                                          |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `api.example.com`    | L'**adresse de l'API**. L'agent s'enregistre, remonte ses informations et reçoit des commandes par cette adresse. C'est l'adresse intégrée dans chaque programme d'installation généré par la console |
| `remote.example.com` | L'**adresse d'accès à distance**. L'agent d'accès à distance y maintient sa connexion, et le contrôle à distance, le terminal distant et le transfert de fichiers passent par elle                    |

## Connexions ouvertes par l'endpoint

| Source                           | Destination          | Protocole et port                               | Usage                                                                                                                                                                                                          |
| -------------------------------- | -------------------- | ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Agent SONAR                      | `api.example.com`    | HTTPS, 443/tcp                                  | Installation (vérification du jeton, enregistrement), rapports périodiques (inventaire logiciel, géolocalisation, résultats des checks et des tâches), téléchargements de l'agent et du module de productivité |
| Agent SONAR                      | `api.example.com`    | WebSocket sécurisé (WSS), 443/tcp, longue durée | Signal de présence (heartbeat), inventaire et toutes les commandes envoyées depuis la console. C'est cette connexion qui maintient l'appareil **online**                                                       |
| Agent d'accès à distance         | `remote.example.com` | WebSocket sécurisé (WSS), 443/tcp, longue durée | Contrôle à distance, terminal distant, transfert de fichiers et l'état **Remote Offline**                                                                                                                      |
| Module de productivité (Windows) | `api.example.com`    | HTTPS, 443/tcp                                  | Rapports d'activité et de sessions, demandes de prolongation                                                                                                                                                   |
| Module de productivité (Windows) | `api.example.com`    | WebSocket sécurisé (WSS), 443/tcp, longue durée | Politiques d'accès envoyées à l'appareil                                                                                                                                                                       |
| Script d'installation Linux      | `api.example.com`    | HTTPS, 443/tcp                                  | Téléchargement de l'agent                                                                                                                                                                                      |
| Script d'installation Linux      | `remote.example.com` | HTTPS, 443/tcp                                  | Téléchargement de l'agent d'accès à distance                                                                                                                                                                   |

Sous Windows et macOS, l'agent d'accès à distance est téléchargé via l'adresse de l'API pendant l'installation ; le script Linux le télécharge directement depuis l'adresse d'accès à distance.

## Destinations tierces utilisées par l'agent

Ce ne sont pas des adresses SONAR. L'agent les contacte pour des fonctions précises ; en bloquer une ne désactive que la fonction concernée.

| Destination                                                                                 | Plateforme | Quand                                                                                                                                                  | Conséquence d'un blocage                                                    |
| ------------------------------------------------------------------------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------- |
| `checkip.amazonaws.com`, `icanhazip.com`, `ifconfig.co`, `ifconfig.me` (HTTPS)              | Toutes     | Toutes les 5 à 8 minutes, l'une après l'autre jusqu'à ce que l'une réponde                                                                             | La valeur **Public IP** de l'appareil reste vide ou obsolète                |
| `github.com` (HTTPS, téléchargements de versions publiées sur GitHub)                       | Windows    | Au premier démarrage de l'agent, lorsque l'environnement d'exécution Python n'est pas encore présent                                                   | Les scripts Python ne peuvent pas s'exécuter sur l'appareil                 |
| `github.com` (HTTPS, téléchargements de versions publiées sur GitHub)                       | Toutes     | Uniquement là où les environnements d'exécution de scripts Nushell ou Deno sont activés pour votre instance, avec le support de mise en œuvre DataDike | Ces types de scripts ne peuvent pas s'exécuter                              |
| `chocolatey.org`, `community.chocolatey.org` (HTTPS)                                        | Windows    | Au démarrage du service tant que Chocolatey n'est pas installé, et lorsqu'un logiciel est installé depuis la console                                   | L'installation de logiciels depuis la console ne fonctionne pas             |
| La source Windows Update configurée sur l'appareil (Microsoft Update ou votre serveur WSUS) | Windows    | Recherches et installations de mises à jour                                                                                                            | Les recherches Windows Update et les installations de mises à jour échouent |

Le trafic Windows Update suit la configuration Windows Update propre à l'appareil : l'agent pilote le client Windows Update de l'appareil, et ce client télécharge depuis l'emplacement configuré dans Windows.

## Proxies

L'agent accepte un proxy HTTP à l'installation avec l'argument `-proxy` (`-proxy "http://proxyserver:port"`), qui figure sous **Optional Arguments** dans les instructions d'installation manuelle. Le proxy est enregistré dans la configuration de l'agent et utilisé pour :

* les requêtes d'installation et les téléchargements effectués par l'agent, y compris les mises à jour de l'agent ;
* les requêtes HTTPS de l'agent vers l'adresse de l'API ;
* sous Windows, l'installation de l'agent d'accès à distance.

La connexion WebSocket longue durée vers `api.example.com` est ouverte directement, et non via ce proxy. Un appareil derrière un proxy a donc toujours besoin d'une route sortante directe vers `api.example.com` sur 443/tcp. Le module de productivité se connecte lui aussi directement.

## Inspection TLS et filtrage web

Les deux adresses SONAR portent des connexions WebSocket longue durée. Les proxies, pare-feu et filtres web qui inspectent le TLS, coupent rapidement les connexions inactives ou n'autorisent pas la mise à niveau (upgrade) vers WebSocket les interrompent, et l'appareil apparaît hors ligne ou en **Remote Offline** alors que les requêtes HTTPS fonctionnent toujours.

* Excluez `api.example.com` et `remote.example.com` de l'inspection TLS.
* Autorisez la mise à niveau vers WebSocket pour les deux adresses.
* Autorisez les connexions à rester ouvertes indéfiniment. L'agent envoie un keepalive environ toutes les 35 à 45 secondes et se reconnecte automatiquement après une coupure.

## Comment vérifier que cela a fonctionné

Depuis l'endpoint, avant ou après l'installation :

* **Windows**, dans PowerShell : `Test-NetConnection api.example.com -Port 443` et `Test-NetConnection remote.example.com -Port 443` doivent tous deux renvoyer `TcpTestSucceeded : True`. Le programme d'installation PowerShell exécute le même test vers l'adresse de l'API et affiche *Unable to connect to server* en cas d'échec.
* **Linux et macOS :** `curl -sS -o /dev/null -w "%{http_code}\n" https://api.example.com/` et la même commande pour `https://remote.example.com/` doivent renvoyer un code d'état HTTP plutôt qu'une erreur de connexion.

Après l'installation, l'appareil apparaît dans **Dashboard › Sysadmin** avec **Agent Status** **Online**, et son panneau de détails n'affiche pas le badge **Remote Offline** une fois l'agent d'accès à distance connecté.

## Erreurs courantes

| Symptôme                                                                                                            | Cause                                                                                        | Correction                                                                                                     |
| ------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| Le programme d'installation PowerShell affiche *Waiting for network* trois fois, puis *Unable to connect to server* | L'endpoint ne peut pas ouvrir 443/tcp vers l'adresse de l'API                                | Ouvrez le 443/tcp sortant vers `api.example.com` et vérifiez la résolution de noms                             |
| L'appareil s'enregistre mais n'apparaît jamais **Online**, ou repasse hors ligne à répétition                       | La connexion WebSocket vers l'adresse de l'API est bloquée, inspectée ou coupée par un proxy | Autorisez une connexion 443/tcp directe, non inspectée et avec mise à niveau WebSocket, vers `api.example.com` |
| L'appareil est en ligne mais affiche **Remote Offline**, et le contrôle à distance ne s'ouvre pas                   | L'agent d'accès à distance ne peut pas joindre l'adresse d'accès à distance                  | Autorisez le 443/tcp sortant avec mise à niveau WebSocket vers `remote.example.com`                            |
| **Public IP** est vide                                                                                              | Tous les services de recherche d'IP publique sont bloqués                                    | Autorisez au moins l'un d'eux, ou acceptez la colonne vide                                                     |
| Les scripts Python échouent sur un nouvel appareil Windows                                                          | L'environnement d'exécution Python n'a pas pu être téléchargé depuis GitHub                  | Autorisez les téléchargements depuis `github.com`, puis redémarrez le service de l'agent                       |
| Les installations de logiciels depuis la console échouent                                                           | Chocolatey est injoignable                                                                   | Autorisez `chocolatey.org` et `community.chocolatey.org`                                                       |

## Pages associées

* [Prérequis des appareils](https://wiki.datadike.com/fr/sonar/deploy-operate/requirements.md)
* [Installer l'agent sous Windows](https://wiki.datadike.com/fr/sonar/deploy-operate/install-agent-windows.md)
* [Déployer des agents à grande échelle](https://wiki.datadike.com/fr/sonar/deploy-operate/mass-deployment.md)
* [Dépanner les agents](https://wiki.datadike.com/fr/sonar/deploy-operate/troubleshooting.md)
* [Accès à distance](https://wiki.datadike.com/fr/sonar/administration/remote-access.md)
