> 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/quick-start.md).

# Démarrage rapide

Installez Devolutions CLI, connectez-vous à votre coffre et exécutez une commande avec un secret qu’elle n’affiche jamais, en cinq minutes environ.

À la fin de cette page, vous exécuterez une commande qui reçoit un mot de passe de votre coffre Devolutions, sans que le mot de passe apparaisse dans votre terminal, vos fichiers ou l’historique de votre shell. Cela prend environ cinq minutes.

Vous avez besoin d’un compte sur Devolutions Cloud ou Devolutions Server, ou d’un profil local Devolutions Remote Desktop Manager, avec au moins une entrée que vous pouvez lire.

{% stepper %}
{% step %}

### Installer Devolutions CLI

Devolutions CLI est fourni sous forme d’archive pour votre plateforme. Extrayez-la dans un dossier, ajoutez ce dossier à votre `PATH`, puis vérifiez que votre terminal trouve `devo` (`devo.exe` sur Windows) :

```bash
devo --help
```

Les autres façons d’installer, et les plateformes prises en charge, se trouvent dans [Installer Devolutions CLI](/cli/fr/reference/installation.md).
{% endstep %}

{% step %}

### Se connecter à votre espace de travail

Enregistrez votre espace de travail comme **contexte**, un nom que vous utiliserez ensuite. Le contexte auquel vous vous connectez devient le contexte actuel.

{% tabs %}
{% tab title="Devolutions Cloud" %}

```bash
devo login my-cloud --cloud https://<your-organization>.devolutions.app --oauth
```

Votre navigateur s’ouvre pour que vous puissiez vous connecter. Sur un ordinateur sans navigateur, connectez-vous plutôt avec une clé d’application : consultez [Se connecter à Devolutions Cloud](/cli/fr/guides/connect/devolutions-cloud.md).
{% endtab %}

{% tab title="Devolutions Server" %}

```bash
devo login my-server --server https://<your-server-address> --oauth
```

Votre navigateur s’ouvre pour que vous puissiez vous connecter. Les autres méthodes de connexion, comme une clé d’API ou l’authentification Windows, se trouvent dans [Se connecter à Devolutions Server](/cli/fr/guides/connect/devolutions-server.md).
{% endtab %}

{% tab title="Local profile" %}

```bash
devo login my-local --sqlite <profile-folder>
```

Remplacez `<profile-folder>` par le dossier du profil Devolutions Remote Desktop Manager qui contient votre espace de travail local. Il n’y a pas de connexion : un contexte local ne fait que pointer vers ce dossier.
{% endtab %}
{% endtabs %}
{% endstep %}

{% step %}

### Trouver la référence d’un mot de passe

Demandez à Devolutions CLI les références d’une entrée. Cela indique où se trouve chaque secret, jamais le secret lui-même.

```bash
devo entry references "<entry-name>" --vault-name "<vault-name>"
```

Copiez la référence du champ `password`. Elle commence par `devo://`.

{% hint style="info" %}
Deux sortes de références peuvent apparaître. Une **référence nommée** utilise les noms de l’espace de travail, du coffre et de l’entrée, elle est donc facile à lire. Une **référence canonique** (`devo://ws/…/vault/…/entry/…/field/…`) utilise des ID, elle continue donc de fonctionner quand une entrée est renommée. Sur Devolutions Server, cette commande n’affiche que des références canoniques. Consultez [Trouver la référence d’un secret](/cli/fr/guides/secrets/find-a-reference.md).
{% endhint %}
{% endstep %}

{% step %}

### Exécuter une commande avec le secret

Passez la référence à `devo secret run`. Devolutions CLI lit le mot de passe dans votre coffre, le place dans une variable d’environnement pour cette seule commande et la démarre. Tout ce qui suit `--` est votre commande.

{% tabs %}
{% tab title="PowerShell" %}

```powershell
devo secret run --env-ref DEMO_SECRET=<reference> -- pwsh -NoProfile -Command 'Write-Output $env:DEMO_SECRET'
```

{% endtab %}

{% tab title="Bash" %}

```bash
devo secret run --env-ref DEMO_SECRET=<reference> -- sh -c 'echo "$DEMO_SECRET"'
```

{% endtab %}
{% endtabs %}

La commande a bien reçu le mot de passe, mais le terminal affiche `<concealed by Devolutions>` : Devolutions CLI masque les valeurs qu’il a résolues dans tout ce que la commande affiche. Quand la commande se termine, la variable disparaît. Elle n’a jamais existé dans votre shell.

Remplacez l’exemple par votre propre programme, par exemple une migration de base de données ou un script de déploiement qui lit son mot de passe dans une variable d’environnement.

{% hint style="warning" %}
Le masquage protège ce que la commande affiche, pas ce qu’elle fait. Un programme qui reçoit un secret peut quand même l’écrire dans un fichier ou l’envoyer quelque part. N’exécutez que des programmes à qui vous confiez vos secrets. Consultez [Ce qui reste caché, et ce qui ne l’est pas](/cli/fr/guides/understand/security-model.md).
{% endhint %}
{% endstep %}

{% step %}

### Vérifier avant d’exécuter (facultatif)

Ajoutez `--check` pour vous assurer que la commande existe et que chaque référence est bien formée, sans lire de secret ni rien démarrer :

```bash
devo secret run --check --env-ref DEMO_SECRET=<reference> -- <your-command>
```

D’autres options, comme plusieurs secrets à la fois, une limite de temps ou un fichier de lancement, se trouvent dans [Exécuter une commande avec ses secrets](/cli/fr/guides/secrets/run-with-secrets.md).
{% endstep %}
{% endstepper %}

## C’est fait. Et ensuite?

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Nettoyer vos fichiers .env</strong></td><td>Gardez vos fichiers <code>.env</code> dans le dépôt, avec des références au lieu des mots de passe.</td><td><a href="/cli/fr/guides/secrets/replace-env-files.md">Retirer les mots de passe d’un fichier .env</a></td></tr><tr><td><strong>Travailler en sécurité avec des agents d’IA</strong></td><td>Laissez un agent exécuter des commandes qui ont besoin d’identifiants, sans que les valeurs n’atteignent sa transcription.</td><td><a href="/cli/fr/guides/ai-agents/run-an-agent.md">Donner un identifiant à un agent sans l’exposer</a></td></tr><tr><td><strong>L’automatiser</strong></td><td>Connectez-vous depuis un pipeline CI sans navigateur ni invite.</td><td><a href="/cli/fr/pour-le-devops-et-les-administrateurs/automate/ci-sign-in.md">Se connecter depuis un pipeline CI</a></td></tr></tbody></table>


---

# 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/quick-start.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.