> 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/administration/remote-access/remote-terminal.md).

# Terminal distant

Ouvrir un shell de commandes sur un appareil Windows, Linux ou macOS depuis la fenêtre distante, choisir le shell et le compte qui l'exécute, et retrouver l'enregistrement d'audit.

## Ce que c'est et quand l'utiliser

L'onglet **Terminal** de la fenêtre distante ouvre un shell de commandes interactif sur l'appareil, dans votre navigateur. Utilisez-le pour le travail qui va plus vite à l'invite de commandes que sur le bureau : vérifier un fichier de configuration, redémarrer un daemon, lire un journal, exécuter une commande ponctuelle en suivant sa sortie.

Il fonctionne sur les appareils Windows, Linux et macOS. Sous Linux et macOS, c'est l'onglet sur lequel s'ouvre la fenêtre distante, car l'onglet de bureau n'existe que pour Windows.

Le terminal passe par le service d'accès à distance, comme le bureau à distance ; il faut donc que l'agent d'accès à distance de l'appareil soit en ligne. Pour exécuter une commande sans session interactive, ou sur de nombreux appareils à la fois, utilisez plutôt [Exécuter une commande ou un script sur un appareil](https://wiki.datadike.com/fr/sonar/administration/automation/run-commands-and-scripts.md).

## Avant de commencer

* Un rôle disposant de **List Agents** et de **Use Mesh** dans **Admin Center › Roles**. Il n'existe pas de permission distincte pour le terminal : **Use Mesh** couvre le bureau, le terminal et l'explorateur de fichiers.
* L'appareil affiche **Remote Online** dans le panneau de l'appareil.
* Pour **User Shell** ou **User PowerShell**, un utilisateur connecté à l'appareil.

## Étapes

1. Ouvrez **Dashboard › Sysadmin**, sélectionnez l'appareil et cliquez sur **Take Control**. Voir [Contrôle à distance](https://wiki.datadike.com/fr/sonar/administration/remote-access/remote-control.md) pour les autres façons d'ouvrir la fenêtre distante.
2. Cliquez sur l'onglet **Terminal**.
3. Pour ouvrir le shell par défaut, cliquez sur **Connect**. Pour choisir le shell, faites un clic droit sur **Connect** et choisissez-en un dans la liste. Les shells sont listés dans la référence des champs ci-dessous.
4. Attendez l'invite, puis saisissez vos commandes.
5. Cliquez sur **Disconnect** lorsque vous avez terminé.

## Ce que vous devez voir

L'état affiché à côté de **Connect** n'indique plus **Disconnected**, et l'invite du shell apparaît dans la zone du terminal.

La barre sous le terminal affiche **Session time**, une liste de touches spéciales avec **Send**, et des boutons **Ctl-C**, **Ctl-X** et **ESC**, pour les touches que votre navigateur intercepterait sinon.

Si les paramètres de consentement de votre déploiement l'exigent, la personne connectée à l'appareil est d'abord sollicitée, avec le message "*name* requesting remote terminal access. Grant access?". Votre terminal affiche "Waiting for user to grant access..." jusqu'à ce qu'elle réponde. Les entrées **Ask** de la liste des shells Windows demandent toujours le consentement, quels que soient les paramètres. Ce que voit la personne sur l'endpoint est décrit dans [Contrôle à distance](https://wiki.datadike.com/fr/sonar/administration/remote-access/remote-control.md).

## Comment vérifier que cela a fonctionné

1. Exécutez une commande dont vous connaissez la réponse, comme `hostname` ou `whoami`. La sortie doit afficher le nom de l'appareil et le compte sous lequel le shell s'exécute.
2. Ouvrez l'onglet **Audits** du panneau de l'appareil. L'entrée **Remote Session** écrite à l'ouverture de la fenêtre distante doit y figurer, avec votre nom d'utilisateur.

{% hint style="info" %}
Le terminal est couvert par l'unique enregistrement **Remote Session** que SONAR écrit à l'ouverture de la fenêtre distante. Les commandes que vous saisissez ne sont pas enregistrées dans SONAR. Si vous avez besoin d'une trace d'une commande et de sa sortie, exécutez-la plutôt avec **Send Command** depuis le menu d'actions de l'appareil, qui conserve la commande et sa sortie dans l'onglet **History** de l'appareil.
{% endhint %}

## Erreurs courantes

| Symptôme                                                         | Cause                                                                                     | Correction                                                                                                                                                                                    |
| ---------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| L'onglet **Terminal** affiche **Remote access unavailable**      | L'agent d'accès à distance n'était pas en ligne à l'ouverture de la fenêtre               | Attendez **Remote Online** dans le panneau de l'appareil et rouvrez la fenêtre. Voir [Contrôle à distance](https://wiki.datadike.com/fr/sonar/administration/remote-access/remote-control.md) |
| "Waiting for user to grant access..." et l'invite n'apparaît pas | La personne sur l'endpoint n'a pas cliqué sur **Allow**, ou a cliqué sur **Deny**         | Contactez l'utilisateur, ou connectez-vous avec un shell qui ne demande pas de consentement                                                                                                   |
| "PowerShell is not supported on this version of windows"         | La version de Windows de l'appareil n'a pas de PowerShell que le terminal puisse démarrer | Utilisez **Admin Shell** ou **User Shell**                                                                                                                                                    |
| **User Shell** ou **User PowerShell** ne s'ouvre pas             | Aucun utilisateur n'est connecté à l'appareil                                             | Utilisez **Admin Shell** ou **Admin PowerShell**                                                                                                                                              |
| **Login Shell** demande un nom d'utilisateur                     | Il lance l'ouverture de session propre à l'appareil                                       | Connectez-vous avec un compte qui existe sur l'appareil                                                                                                                                       |

## Référence des champs

Shells de la liste ouverte par un clic droit sur **Connect** :

| Shell                                                                                      | S'exécute en tant que                                                                                               | Plateforme   |
| ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------- | ------------ |
| **Admin Shell**                                                                            | Invite de commandes avec des droits d'administrateur. C'est ce que **Connect** ouvre sous Windows                   | Windows      |
| **Admin PowerShell**                                                                       | PowerShell avec des droits d'administrateur                                                                         | Windows      |
| **User Shell**                                                                             | Invite de commandes sous l'identité de l'utilisateur connecté à l'appareil                                          | Windows      |
| **User PowerShell**                                                                        | PowerShell sous l'identité de l'utilisateur connecté à l'appareil                                                   | Windows      |
| **Ask Admin Shell**, **Ask Admin PowerShell**, **Ask User Shell**, **Ask User PowerShell** | Les quatre mêmes shells, avec une demande de consentement présentée d'abord à la personne devant l'appareil         | Windows      |
| **Root Shell**                                                                             | `bash` en tant que root, ou `sh` là où `bash` est absent. C'est ce que **Connect** ouvre sous Linux et macOS        | Linux, macOS |
| **User Shell**                                                                             | Le shell sous l'identité de l'utilisateur connecté à la console de l'appareil                                       | Linux, macOS |
| **Login Shell**                                                                            | L'invite de connexion de l'appareil. Vous vous connectez avec un nom d'utilisateur et un mot de passe de l'appareil | Linux, macOS |

Commandes du terminal :

| Commande                               | Ce qu'elle fait                                                                                 |
| -------------------------------------- | ----------------------------------------------------------------------------------------------- |
| **Connect** / **Disconnect**           | Ouvre et ferme le shell. Faites un clic droit sur **Connect** pour afficher la liste des shells |
| **Session time**                       | Depuis combien de temps le shell est ouvert                                                     |
| Liste de touches spéciales et **Send** | Envoie au shell la touche sélectionnée                                                          |
| **Ctl-C**, **Ctl-X**, **ESC**          | Envoient ces touches au shell                                                                   |

## Pages associées

* [Contrôle à distance](https://wiki.datadike.com/fr/sonar/administration/remote-access/remote-control.md) : la fenêtre distante, l'état distant et le consentement
* [Transférer des fichiers](https://wiki.datadike.com/fr/sonar/administration/remote-access/file-transfer.md) : déplacer des fichiers vers et depuis le même appareil
* [Exécuter une commande ou un script sur un appareil](https://wiki.datadike.com/fr/sonar/administration/automation/run-commands-and-scripts.md) : des commandes conservées dans l'historique de l'appareil
* [Piste d'audit](https://wiki.datadike.com/fr/sonar/administration/audit/audit-trail.md) : l'enregistrement **Remote Session**
