> 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/cli/fr/guides/understand/how-it-works.md).

# Fonctionnement de Devolutions CLI

Devolutions CLI remplace les valeurs secrètes par des références devo et les résout depuis votre espace de travail seulement au démarrage d’une commande.

Devolutions CLI ne stocke pas vos secrets. Il **pointe vers eux**. Vos scripts, les fichiers `.env` et les instructions d’agent contiennent une référence `devo://`, et Devolutions CLI va chercher la valeur dans votre espace de travail seulement au moment où une commande en a besoin. Comprendre cette seule idée explique presque tout le reste : ce que vous pouvez commiter sans risque, pourquoi vous vous connectez une fois, et quelles commandes gardent un secret caché.

## Quatre blocs de base

<table><thead><tr><th width="190">BLOC DE BASE</th><th>CE QUE C’EST</th><th>EXEMPLE</th></tr></thead><tbody><tr><td><strong>Espace de travail</strong></td><td>Là où vivent vos secrets : Devolutions Cloud, Devolutions Server ou un profil local Devolutions Remote Desktop Manager. À l’intérieur, les secrets se trouvent dans des champs d’entrées, regroupés dans des coffres.</td><td>Le champ <code>password</code> de l’entrée <em>Production database</em>, dans le coffre <em>Operations</em>.</td></tr><tr><td><strong>Contexte</strong></td><td>Une connexion enregistrée vers un espace de travail, avec un nom que vous choisissez. Vous la créez une fois avec <code>devo login</code>, et chaque commande ensuite utilise le contexte actuel.</td><td><code>my-cloud</code>, <code>work-server</code>, <code>my-local</code></td></tr><tr><td><strong>Référence</strong></td><td>L’adresse d’un champ, qui commence par <code>devo://</code>. Elle dit où se trouve le secret, jamais ce qu’il est.</td><td><code>devo://&#x3C;workspace>/&#x3C;vault>/&#x3C;entry>/password</code></td></tr><tr><td><strong>Commande</strong></td><td>Le programme qui a besoin du secret. <code>devo secret run</code> résout les références, donne les valeurs à ce programme seulement, et le démarre.</td><td>Un script de déploiement, un client de base de données, un agent d’IA.</td></tr></tbody></table>

## Ce que cela signifie pour vous

**Les références peuvent être partagées sans risque.** Une référence contient des noms ou des ID, pas une valeur. Vous pouvez la commiter, la coller dans un billet ou la donner à un agent d’IA. Sans accès au coffre, elle n’ouvre rien. Consultez [Syntaxe des références de secret](/cli/fr/reference/secret-references.md).

**Vous vous connectez une fois, puis vous travaillez.** `devo login` enregistre le contexte et le rend actuel, pour que les commandes suivantes ne redemandent pas. Pour utiliser un autre espace de travail pour une seule commande, ajoutez `--context <name>`. Consultez [Basculer entre les espaces de travail](/cli/fr/guides/connect/switch-workspaces.md).

**Les mêmes commandes fonctionnent partout.** Lire un secret ou exécuter une commande se présente de la même façon sur Devolutions Cloud, Devolutions Server et un profil local. Quand un espace de travail ne peut pas faire quelque chose, la commande le dit au lieu d’échouer en silence. Consultez [Comparer les types d’espaces de travail](/cli/fr/guides/understand/workspace-types.md).

**Un secret n’atteint que la commande que vous démarrez.** `devo secret run` place les valeurs dans l’environnement de ce seul programme, pas dans votre shell. Devolutions CLI refuse les références écrites comme arguments de commande, et masque les valeurs résolues dans ce que le programme affiche. Consultez [Exécuter une commande avec ses secrets](/cli/fr/guides/secrets/run-with-secrets.md).

**Certaines commandes remettent la valeur exprès.** Lire un secret dans le terminal, remplir un fichier modèle, charger des secrets dans votre shell actuel ou laisser un client d’IA lire une entrée vous donne, ou donne au modèle, la valeur réelle. Choisissez la commande qui correspond à ce que vous voulez exposer. Consultez [Ce qui reste caché, et ce qui ne l’est pas](/cli/fr/guides/understand/security-model.md).

## Le processus en arrière-plan

Pour rester rapide, `devo` démarre un processus en arrière-plan la première fois qu’une commande a besoin de votre espace de travail, puis le réutilise. C’est le même fichier `devo` qui s’exécute en arrière-plan, sous votre compte d’utilisateur, et il parle à `devo` par un canal local sur votre ordinateur. Vous n’avez pas à installer un service ni à démarrer quoi que ce soit vous-même.

Si vous préférez le contrôler, l’option `--daemon` accepte `auto` (la valeur par défaut : le démarrer au besoin), `require` (en utiliser un déjà en cours) ou `never`. Les commandes `devo daemon` affichent son état, l’arrêtent ou le redémarrent. Consultez [Le processus en arrière-plan ne démarre pas](/cli/fr/aide/troubleshooting/daemon-wont-start.md).


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.devolutions.net/cli/fr/guides/understand/how-it-works.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.