> 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-server.md).

# Se connecter à Devolutions Server

Se connecter à Devolutions Server depuis Devolutions CLI avec votre navigateur, une clé d’API, un nom d’utilisateur et un mot de passe, ou l’authentification Windows.

Connectez-vous une fois et Devolutions CLI enregistre votre Devolutions Server comme contexte, pour que chaque commande suivante l’utilise sans redemander. Devolutions Server offre plus de méthodes de connexion que les autres types d’espaces de travail, donc choisissez celle qui correspond à qui, ou à quoi, se connecte.

Il vous faut l’adresse de votre Devolutions Server, par exemple `https://<your-server-address>`. Utilisez une adresse `https`.

## Choisir la bonne option

<table><thead><tr><th width="250">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 pour la connexion. 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’API</strong> (<code>--api-key-env</code> ou <code>--api-key-file</code>)</td><td>Devolutions CLI se connecte avec une clé d’API lue depuis une variable d’environnement ou un fichier.</td><td>Un script ou un pipeline CI se connecte sans personne présente.</td></tr><tr><td><strong>Nom d’utilisateur et mot de passe</strong> (<code>--username</code> avec <code>--password-env</code> ou <code>--password-file</code>)</td><td>Devolutions CLI se connecte avec un compte de Devolutions Server. Le mot de passe est lu depuis une variable d’environnement ou un fichier.</td><td>Vous utilisez un compte Devolutions Server, un compte de domaine ou un utilisateur d’application.</td></tr><tr><td><strong>Authentification Windows</strong> (<code>--windows-auth</code>)</td><td>Devolutions CLI se connecte en tant que votre compte Windows actuel. Aucun mot de passe à donner.</td><td>Vous êtes sur Windows et votre Devolutions Server accepte l’authentification Windows.</td></tr></tbody></table>

Utilisez exactement une méthode par connexion. Devolutions CLI refuse une commande qui en combine deux.

## Se connecter

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

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

Votre navigateur s’ouvre. S’il ne s’ouvre pas, copiez l’adresse affichée dans le terminal dans un navigateur.

Sur un ordinateur sans navigateur, ajoutez `--use-device-code` et suivez les instructions dans le terminal pour vous connecter depuis un autre appareil. Si la page de connexion demande un code de confirmation, entrez le code affiché dans le terminal.
{% endtab %}

{% tab title="API key" %}
Placez la clé d’API dans une variable d’environnement ou un fichier que vous seul pouvez lire, puis :

```bash
devo login <context-name> --server https://<your-server-address> --api-key-env <VARIABLE_NAME>
```

Ou, depuis un fichier :

```bash
devo login <context-name> --server https://<your-server-address> --api-key-file <path-to-file>
```

{% endtab %}

{% tab title="Username and password" %}
Placez le mot de passe dans une variable d’environnement ou un fichier que vous seul pouvez lire, puis :

```bash
devo login <context-name> --server https://<your-server-address> --username <username> --password-env <VARIABLE_NAME>
```

* Pour un compte de domaine, ajoutez `--domain-id <domain-id>`.
* Pour un utilisateur d’application, ajoutez `--as-application`.
  {% endtab %}

{% tab title="Windows authentication" %}

```bash
devo login <context-name> --server https://<your-server-address> --windows-auth
```

Offert sur Windows seulement.
{% endtab %}
{% endtabs %}

Devolutions CLI vérifie la connexion auprès de votre Devolutions Server avant d’enregistrer le contexte. Le nouveau contexte devient le contexte actuel.

{% hint style="info" %}
Devolutions CLI n’enregistre pas les clés d’API ni les mots de passe. Il enregistre le nom de la variable d’environnement ou le chemin du fichier, et relit la valeur 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 %}

## Vérifier et terminer la session

* `devo status` affiche le contexte actuel et s’il a une connexion. Ajoutez `--online` pour joindre Devolutions Server et confirmer que la connexion fonctionne encore.
* `devo info` affiche des informations sur votre Devolutions Server. Ajoutez `--private` pour inclure les informations qui exigent votre connexion.
* `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 Server n’est encore actuel, il devient quand même celui que `--source server` utilise.
* Avec un nom d’utilisateur et un mot de passe ou l’authentification Windows, la requête de connexion comprend le nom de votre ordinateur et votre nom d’utilisateur local. Consultez [Quelles données Devolutions CLI envoie](/cli/fr/guides/understand/privacy.md).
* `devo entry references` n’énumère que des références canoniques pour les entrées Devolutions Server. Consultez [Comparer les types d’espace de travail](/cli/fr/guides/understand/workspace-types.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)
* [Sign in from a CI pipeline](/cli/fr/pour-le-devops-et-les-administrateurs/automate/ci-sign-in.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-server.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.