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

# Iniciar sesión en Devolutions Cloud

Iniciar sesión en Devolutions Cloud desde Devolutions CLI con el navegador, o con una clave de aplicación y un secreto para scripts y canalizaciones.

Inicie sesión una vez y Devolutions CLI guarda su Devolutions Cloud como contexto, para que cada comando posterior lo use sin volver a preguntar. Use el navegador cuando trabaja en su ordenador, y una clave de aplicación cuando un script o una canalización inicia sesión por usted.

Necesita la dirección de su Devolutions Cloud, por ejemplo `https://<your-organization>.devolutions.app`. Use una dirección `https`.

## Elegir la opción adecuada

<table><thead><tr><th width="230">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 en Devolutions Account. 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 aplicación</strong> (<code>--application-key</code>)</td><td>Devolutions CLI inicia sesión con una clave de aplicación y su secreto. El secreto se lee desde una variable de entorno o un archivo, nunca se escribe en la línea de comandos.</td><td>Un script, una tarea programada o una canalización de CI inicia sesión sin que haya nadie presente.</td></tr></tbody></table>

## Iniciar sesión con su navegador

1. Ejecute `devo login` con un nombre de contexto de su elección:

   ```bash
   devo login <context-name> --cloud https://<your-organization>.devolutions.app --oauth
   ```
2. Su navegador se abre. Inicie sesión en su cuenta de Devolutions. Si el navegador no se abre, o se abre en segundo plano, copie la dirección que se muestra en el terminal en un navegador.

El terminal confirma el inicio de sesión, y el contexto nuevo pasa a ser el actual.

{% hint style="warning" %}
`--use-device-code` le permite iniciar sesión desde otro dispositivo, por ejemplo en un ordenador remoto sin navegador. Pero un inicio de sesión con código de dispositivo en Devolutions Cloud no recibe la clave que abre los datos de su bóveda: solo puede comprobar su estado y cerrar la sesión. Para trabajar con bóvedas y secretos, inicie sesión con el navegador en el mismo ordenador, o use una clave de aplicación.

La variable de entorno `DEVO_CLI_USE_DEVICE_CODE` tiene el mismo efecto: cuando tiene un valor distinto de vacío, `0` o `false`, cada inicio de sesión `--oauth` usa un código de dispositivo, incluso sin `--use-device-code`. Bórrela antes de iniciar sesión en Devolutions Cloud con el navegador.
{% endhint %}

## Iniciar sesión con una clave de aplicación

1. Ponga el secreto de aplicación en una variable de entorno o en un archivo que solo usted pueda leer. No lo escriba en la línea de comandos.
2. Ejecute `devo login` con la clave de aplicación y el nombre de la variable, o la ruta del archivo:

{% 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 comprueba la clave y el secreto con su Devolutions Cloud antes de guardar el contexto.

{% hint style="info" %}
Devolutions CLI no guarda el secreto de aplicación. Guarda el nombre de la variable o la ruta del archivo, y vuelve a leer el secreto cada vez que un comando lo necesita. Mantenga esa variable definida, o ese archivo en su sitio, mientras use el contexto.
{% endhint %}

Para las canalizaciones, consulte [Iniciar sesión desde una canalización de CI](/cli/es/para-devops-y-administradores/automate/ci-sign-in.md).

## 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 Cloud y confirmar que el inicio de sesión sigue funcionando.
* `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 Cloud actual, pasa a ser el que usa `--source cloud`.
* Un nombre de contexto solo puede usarlo un tipo de espacio de trabajo. Si el nombre ya existe para un perfil local o un Devolutions Server, elija otro nombre o elimine primero el otro contexto.
* El inicio de sesión en el navegador necesita el almacén seguro de su sistema operativo. Consulte [Qué datos envía Devolutions CLI](/cli/es/guias/understand/privacy.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)
* [Switch between workspaces](/cli/es/guias/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/es/guias/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.