> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/rdm/fr/knowledge-base/knowledge-base-articles/protocol-handler.md).

# Gestionnaire de protocole

Un ***Gestionnaire de protocole*** a été implémenté dans Remote Desktop Manager afin de pouvoir lancer une session directement depuis du contenu HTML. Cela peut être très utile pour appeler Remote Desktop Manager depuis une base de données de gestion de configuration (CMDB) ou même un système de gestion documentaire (DMS).

{% hint style="info" %}
Internet Explorer et Mozilla Firefox exécutent l'URL en cliquant dessus ou en appuyant sur <kbd>Entrée</kbd>. Cependant, avec certains autres navigateurs web tels que Google Chrome, l'exécution de l'URL aboutit normalement à une recherche web. Ces navigateurs peuvent nécessiter d'effectuer <kbd>Ctrl</kbd>+clic ou <kbd>Ctrl</kbd>+<kbd>Entrée</kbd> pour exécuter l'URL.
{% endhint %}

### Scénarios

Il existe deux façons d'utiliser le gestionnaire :

* Générer une URL pour une session : essentiellement tout type d'entrée qui se connecte à un appareil distant à l'aide d'un protocole.
* Générer une URL pour un modèle : vous permet de spécifier le nom d'hôte de l'appareil auquel vous souhaitez vous connecter, mais utilise les paramètres du modèle.

### Paramètres

Voici les paramètres utilisés pour construire une URL de gestionnaire de protocole pour des scénarios avancés. ***DataSource*** et les ***Session IDs*** sont suffisants pour ouvrir une connexion.

{% hint style="info" %}
Le paramètre ***DataSource*** remplace l'espace de travail auquel l'application se connecte au démarrage. Cela s'applique même si l'utilisateur est invité à choisir un espace de travail auquel se connecter.
{% endhint %}

<table><thead><tr><th width="123.5999755859375">PARAMÈTRE</th><th>DESCRIPTION</th></tr></thead><tbody><tr><td>DataSource</td><td>Indiquer l'espace de travail ou l'identifiant de la base de données. Retrouvez-les dans la section <em><strong>IDs</strong></em> des <em><strong>Propriétés avancées</strong></em> d'une entrée.<br><br>Un identifiant d'espace de travail est unique par installation, ce qui rend l'URL utilisable uniquement par le poste de travail sur lequel l'espace de travail a été créé. Par défaut, Remote Desktop Manager génère l'URL avec l'identifiant de la base de données.</td></tr><tr><td>Session</td><td>Indiquer l'identifiant d'une session. Retrouvez-le dans le champ <em><strong>Session ID</strong></em> des <em><strong>Propriétés avancées</strong></em> d'une session.</td></tr><tr><td>Template</td><td>Indiquer l'identifiant du modèle d'une entrée. Le paramètre de modèle récupère certaines propriétés d'un modèle et les applique au paramètre de session. Le paramètre d'hôte est obligatoire lors de l'utilisation du paramètre de modèle.</td></tr><tr><td>Host</td><td>Indiquer le nom d'hôte ou l'adresse IP de l'appareil distant. Utilisé conjointement avec le paramètre de modèle, ou pour remplacer la propriété d'hôte du paramètre de session.</td></tr><tr><td>Port</td><td>Indiquer le port à utiliser. Utilisé pour remplacer la propriété de port du paramètre de session ou de modèle.</td></tr><tr><td>Username</td><td>Indiquer le nom d'utilisateur à utiliser. Utilisé pour remplacer la propriété de nom d'utilisateur du paramètre de session ou de modèle.</td></tr><tr><td>Password</td><td>Indiquer le mot de passe à utiliser. Utilisé pour remplacer la propriété de mot de passe du paramètre de session ou de modèle.</td></tr><tr><td>Domain</td><td>Indiquer le domaine à utiliser. Utilisé pour remplacer la propriété de domaine du paramètre de session ou de modèle.</td></tr><tr><td>Title</td><td>Indiquer le titre de l'onglet lorsqu'une session est lancée en mode d'affichage <em><strong>Intégré</strong></em> (par onglets). Cela peut être très utile lorsque plusieurs sessions sont lancées simultanément.</td></tr><tr><td>Filter</td><td>Remplir le champ <em><strong>Rechercher</strong></em>.</td></tr><tr><td>Tabpage</td><td>Donner le focus à un onglet du tableau de bord une fois que l'application a terminé la procédure de démarrage. Disponible uniquement avec l'action <em><strong>Select</strong></em>. Les onglets possibles sont :- <em><strong>Overview</strong></em></td></tr></tbody></table>

* ***Documentation***
* ***Macros/Scripts/Tools***
* ***Management Tools***
* ***Information***
* ***Attachments***
* ***Journaux***
* ***Recordings*** |

### Actions

* ***Open*** : Ouvrir la connexion spécifiée.
* ***Find*** : Rechercher des sessions par hôte.
* ***Edit*** : Modifier la connexion spécifiée.
* ***View*** : Afficher le mot de passe de l'entrée spécifiée.
* ***OpenWithMacro*** : Ouvrir la connexion spécifiée avec une macro.
* ***Select*** : Sélectionner une connexion dans le ***volet de navigation*** (permet également de sélectionner un onglet dans le tableau de bord).

### Syntaxe

`rdm://<action>=<value>[&=<value>]`

La syntaxe de base du gestionnaire de protocole nécessite le protocole d'application, une action et au moins un paramètre pour fonctionner.

Il y a trois règles à respecter lors de la construction d'une URL pour le gestionnaire de protocole :

* L'action est séparée des paramètres par un point d'interrogation (?).
* Chaque paramètre se voit attribuer une valeur à l'aide d'un signe égal (=).
* Les paires paramètre/valeur sont séparées par une esperluette (&).

### Exemples

**Ouvrir Remote Desktop Manager avec le champ de recherche/filtre rempli et le focus sur le tableau de bord**

`rdm://open?Filter=RDP&Tabpage=Dashboard`

**Ouvrir une session RDP**

1. Dans la section ***Entry information*** des propriétés d'une entrée, cliquer sur ***Create web Url***.

   <figure><img src="https://cdnweb.devolutions.net/docs/RDMW2029_2024_1.png" alt=""><figcaption></figcaption></figure>
2. Sélectionner ***RDM protocol handler (rdm://)***.

   <figure><img src="https://cdnweb.devolutions.net/docs/RDMW2030_2024_1.png" alt=""><figcaption></figcaption></figure>
3. L'URL a maintenant été copiée dans le presse-papiers. Cliquer sur ***OK*** pour fermer la fenêtre de confirmation.

   <figure><img src="https://cdnweb.devolutions.net/docs/RDMW2031_2024_1.png" alt=""><figcaption></figcaption></figure>
4. Coller (<kbd>Ctrl</kbd>+<kbd>V</kbd>) cette URL dans toute application capable de gérer les protocoles d'application. Il peut s'agir d'une page web, de la barre d'adresse d'un navigateur web, ou même d'une application de messagerie prise en charge. Le gestionnaire de protocole lance Remote Desktop Manager s'il est fermé, puis effectue l'action demandée avec les paramètres fournis.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.devolutions.net/rdm/fr/knowledge-base/knowledge-base-articles/protocol-handler.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.