> 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/es/guias/connect/devolutions-server.md).

# Iniciar sesión en Devolutions Server

Iniciar sesión en Devolutions Server desde Devolutions CLI con el navegador, una clave de API, un nombre de usuario y una contraseña, o la autenticación de Windows.

Inicie sesión una vez y Devolutions CLI guarda su Devolutions Server como contexto, para que cada comando posterior lo use sin volver a preguntar. Devolutions Server ofrece más métodos de inicio de sesión que los otros tipos de espacio de trabajo, así que elija el que corresponda a quién, o a qué, inicia sesión.

Necesita la dirección de su Devolutions Server, por ejemplo `https://<your-server-address>`. Use una dirección `https`.

## Elegir la opción adecuada

<table><thead><tr><th width="250">ELIJA</th><th>QUÉ OCURRE</th><th>ÚSELO CUANDO</th></tr></thead><tbody><tr><td><strong>Inicio de sesión en el navegador</strong> (<code>--oauth</code>)</td><td>Su navegador se abre para iniciar sesión. Devolutions CLI guarda la sesión en el almacén seguro de su sistema operativo y la renueva por sí mismo.</td><td>Trabaja en su propio ordenador.</td></tr><tr><td><strong>Clave de API</strong> (<code>--api-key-env</code> o <code>--api-key-file</code>)</td><td>Devolutions CLI inicia sesión con una clave de API leída de una variable de entorno o de un archivo.</td><td>Un script o una canalización de CI inicia sesión sin nadie presente.</td></tr><tr><td><strong>Nombre de usuario y contraseña</strong> (<code>--username</code> con <code>--password-env</code> o <code>--password-file</code>)</td><td>Devolutions CLI inicia sesión con una cuenta de Devolutions Server. La contraseña se lee desde una variable de entorno o un archivo.</td><td>Usa una cuenta de Devolutions Server, una cuenta de dominio o un usuario de aplicación.</td></tr><tr><td><strong>Autenticación de Windows</strong> (<code>--windows-auth</code>)</td><td>Devolutions CLI inicia sesión como su cuenta actual de Windows. No hay contraseña que indicar.</td><td>Está en Windows y su Devolutions Server acepta la autenticación de Windows.</td></tr></tbody></table>

Use exactamente un método por inicio de sesión. Devolutions CLI rechaza un comando que combine dos.

## Iniciar sesión

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

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

Se abre su navegador. Si no se abre, copie la dirección que se muestra en el terminal en un navegador.

En un equipo sin navegador, añada `--use-device-code` y siga las instrucciones del terminal para iniciar sesión desde otro dispositivo. Si la página de inicio de sesión pide un código de confirmación, escriba el código que se muestra en el terminal.
{% endtab %}

{% tab title="API key" %}
Ponga la clave de API en una variable de entorno o en un archivo que solo usted pueda leer, y después:

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

O, desde un archivo:

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

{% endtab %}

{% tab title="Username and password" %}
Ponga la contraseña en una variable de entorno o en un archivo que solo usted pueda leer, y después:

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

* Para una cuenta de dominio, añada `--domain-id <domain-id>`.
* Para un usuario de aplicación, añada `--as-application`.
  {% endtab %}

{% tab title="Windows authentication" %}

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

Disponible solo en Windows.
{% endtab %}
{% endtabs %}

Devolutions CLI comprueba el inicio de sesión con su Devolutions Server antes de guardar el contexto. El nuevo contexto pasa a ser el actual.

{% hint style="info" %}
Devolutions CLI no guarda claves de API ni contraseñas. Guarda el nombre de la variable de entorno o la ruta del archivo, y vuelve a leer el valor cada vez que un comando lo necesita. Mantenga esa variable definida, o ese archivo en su sitio, mientras use el contexto.
{% endhint %}

## Comprobar y finalizar la sesión

* `devo status` muestra el contexto actual y si tiene un inicio de sesión. Añada `--online` para contactar Devolutions Server y confirmar que el inicio de sesión sigue funcionando.
* `devo info` muestra información sobre su Devolutions Server. Añada `--private` para incluir la información que necesita su inicio de sesión.
* `devo logout` borra el inicio de sesión del contexto actual, o del contexto que usted nombra. El contexto permanece, así que puede iniciar sesión de nuevo con el mismo nombre.
* `devo context delete <context-name> --yes` quita el contexto y su sesión almacenada.

## Bueno saberlo

* `--timeout` establece cuánto tiempo, en segundos, espera Devolutions CLI cada solicitud de inicio de sesión: de `3` a `600`, `15` de forma predeterminada.
* `--no-set-current` guarda el contexto sin convertirlo en el actual. Si todavía no hay ningún contexto de Devolutions Server actual, pasa a ser el que usa `--source server`.
* Con un nombre de usuario y una contraseña o la autenticación de Windows, la solicitud de inicio de sesión incluye el nombre de su equipo y su nombre de usuario local. Consulte [Qué datos envía Devolutions CLI](/cli/es/guias/understand/privacy.md).
* `devo entry references` enumera solo referencias canónicas para las entradas de Devolutions Server. Consulte [Comparar los tipos de espacio de trabajo](/cli/es/guias/understand/workspace-types.md).
* ¿El inicio de sesión falla o la sesión ha caducado? Consulte [El inicio de sesión falla o la sesión ha caducado](/cli/es/ayuda/troubleshooting/sign-in-fails.md).

## Siguiente

* [Find the reference to a secret](/cli/es/guias/secrets/find-a-reference.md)
* [Sign in from a CI pipeline](/cli/es/para-devops-y-administradores/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/es/guias/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.