> 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/connect/devolutions-cloud.md).

# Se connecter à Devolutions Cloud

Se connecter à Devolutions Cloud depuis Devolutions CLI avec votre navigateur, ou avec une clé d’application et un secret pour les scripts et les pipelines.

Connectez-vous une fois et Devolutions CLI enregistre votre Devolutions Cloud comme contexte, pour que chaque commande suivante l’utilise sans redemander. Utilisez votre navigateur quand vous travaillez à votre ordinateur, et une clé d’application quand un script ou un pipeline se connecte pour vous.

Il vous faut l’adresse de votre Devolutions Cloud, par exemple `https://<your-organization>.devolutions.app`. Utilisez une adresse `https`.

## Choisir la bonne option

<table><thead><tr><th width="230">CHOISIR</th><th>CE QUI SE PASSE</th><th>À UTILISER QUAND</th></tr></thead><tbody><tr><td><strong>Connexion par navigateur</strong> (<code>--oauth</code>)</td><td>Votre navigateur s’ouvre sur Devolutions Account. Devolutions CLI conserve la session dans le magasin sécurisé de votre système d’exploitation et la renouvelle de lui-même.</td><td>Vous travaillez sur votre propre ordinateur.</td></tr><tr><td><strong>Clé d’application</strong> (<code>--application-key</code>)</td><td>Devolutions CLI se connecte avec une clé d’application et son secret. Le secret est lu depuis une variable d’environnement ou un fichier, jamais tapé sur la ligne de commande.</td><td>Un script, une tâche planifiée ou un pipeline CI se connecte sans personne présente.</td></tr></tbody></table>

## Se connecter avec votre navigateur

1. Exécutez `devo login` avec un nom de contexte de votre choix :

   ```bash
   devo login <context-name> --cloud https://<your-organization>.devolutions.app --oauth
   ```
2. Votre navigateur s’ouvre. Connectez-vous à votre compte Devolutions. Si le navigateur ne s’ouvre pas, ou s’ouvre en arrière-plan, copiez l’adresse affichée dans le terminal dans un navigateur.

Le terminal confirme la connexion, et le nouveau contexte devient le contexte actuel.

{% hint style="warning" %}
`--use-device-code` vous permet de vous connecter depuis un autre appareil, par exemple sur un ordinateur distant sans navigateur. Mais une connexion par code d’appareil à Devolutions Cloud ne reçoit pas la clé qui ouvre les données de votre coffre : vous pouvez seulement vérifier son état et vous déconnecter. Pour travailler avec les coffres et les secrets, connectez-vous avec le navigateur sur le même ordinateur, ou utilisez une clé d’application.

La variable d’environnement `DEVO_CLI_USE_DEVICE_CODE` a le même effet : quand elle contient une valeur autre que vide, `0` ou `false`, chaque connexion `--oauth` utilise un code d’appareil, même sans `--use-device-code`. Effacez-la avant de vous connecter à Devolutions Cloud avec le navigateur.
{% endhint %}

## Se connecter avec une clé d’application

1. Placez le secret d’application dans une variable d’environnement ou un fichier que vous seul pouvez lire. Ne le tapez pas sur la ligne de commande.
2. Exécutez `devo login` avec la clé d’application et le nom de la variable, ou le chemin du fichier :

{% tabs %}
{% tab title="Environment variable" %}

```bash
devo login <context-name> --cloud https://<your-organization>.devolutions.app --application-key <application-key> --application-secret-env <VARIABLE_NAME>
```

{% endtab %}

{% tab title="File" %}

```bash
devo login <context-name> --cloud https://<your-organization>.devolutions.app --application-key <application-key> --application-secret-file <path-to-file>
```

{% endtab %}
{% endtabs %}

Devolutions CLI vérifie la clé et le secret auprès de votre Devolutions Cloud avant d’enregistrer le contexte.

{% hint style="info" %}
Devolutions CLI n’enregistre pas le secret d’application. Il enregistre le nom de la variable ou le chemin du fichier, et relit le secret chaque fois qu’une commande en a besoin. Gardez cette variable définie, ou ce fichier en place, aussi longtemps que vous utilisez le contexte.
{% endhint %}

Pour les pipelines, consultez [Se connecter depuis un pipeline CI](/cli/fr/pour-le-devops-et-les-administrateurs/automate/ci-sign-in.md).

## Vérifier et terminer la session

* `devo status` affiche le contexte actuel et s’il a une connexion. Ajoutez `--online` pour joindre Devolutions Cloud et confirmer que la connexion fonctionne encore.
* `devo logout` efface la connexion du contexte actuel, ou du contexte que vous nommez. Le contexte reste, donc vous pouvez vous reconnecter avec le même nom.
* `devo context delete <context-name> --yes` retire le contexte et sa session enregistrée.

## Bon à savoir

* `--timeout` définit combien de temps, en secondes, Devolutions CLI attend chaque requête de connexion : de `3` à `600`, `15` par défaut.
* `--no-set-current` enregistre le contexte sans le rendre actuel. Si aucun contexte Devolutions Cloud n’est encore actuel, il devient quand même celui que `--source cloud` utilise.
* Un nom de contexte ne peut être utilisé que par un seul type d’espace de travail. Si le nom existe déjà pour un profil local ou un Devolutions Server, choisissez un autre nom ou supprimez d’abord l’autre contexte.
* La connexion par navigateur a besoin du magasin sécurisé de votre système d’exploitation. Consultez [Quelles données Devolutions CLI envoie](/cli/fr/guides/understand/privacy.md).
* La connexion échoue ou la session a expiré ? Consultez [La connexion échoue ou la session a expiré](/cli/fr/aide/troubleshooting/sign-in-fails.md).

## Suivant

* [Find the reference to a secret](/cli/fr/guides/secrets/find-a-reference.md)
* [Switch between workspaces](/cli/fr/guides/connect/switch-workspaces.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/connect/devolutions-cloud.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.