> 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/quick-start.md). # Inicio rápido Instale Devolutions CLI, inicie sesión en su bóveda y ejecute un comando con un secreto que nunca muestra, en unos cinco minutos. Al final de esta página ejecutará un comando que recibe una contraseña de su bóveda de Devolutions, sin que la contraseña aparezca en el terminal, en sus archivos o en el historial del shell. Tarda unos cinco minutos. Necesita una cuenta en Devolutions Cloud o Devolutions Server, o un perfil local de Devolutions Remote Desktop Manager, con al menos una entrada que pueda leer. {% stepper %} {% step %} ### Instalar Devolutions CLI Devolutions CLI se entrega como un archivo para su plataforma. Extráigalo en una carpeta, añada esa carpeta a su `PATH` y compruebe que el terminal encuentra `devo` (`devo.exe` en Windows): ```bash devo --help ``` Otras formas de instalarlo, y las plataformas compatibles, están en [Instalar Devolutions CLI](/cli/es/referencia/installation.md). {% endstep %} {% step %} ### Iniciar sesión en su espacio de trabajo Guarde su espacio de trabajo como un **contexto**, un nombre que usará a partir de ahora. El contexto en el que inicia sesión se convierte en el actual. {% tabs %} {% tab title="Devolutions Cloud" %} ```bash devo login my-cloud --cloud https://.devolutions.app --oauth ``` El navegador se abre para que pueda iniciar sesión. En un ordenador sin navegador, inicie sesión con una clave de aplicación: consulte [Iniciar sesión en Devolutions Cloud](/cli/es/guias/connect/devolutions-cloud.md). {% endtab %} {% tab title="Devolutions Server" %} ```bash devo login my-server --server https:// --oauth ``` El navegador se abre para que pueda iniciar sesión. Otros métodos, como una clave de API o la autenticación de Windows, están en [Iniciar sesión en Devolutions Server](/cli/es/guias/connect/devolutions-server.md). {% endtab %} {% tab title="Local profile" %} ```bash devo login my-local --sqlite ``` Sustituya `` por la carpeta del perfil de Devolutions Remote Desktop Manager que contiene su espacio de trabajo local. No hay inicio de sesión: un contexto local solo apunta a esa carpeta. {% endtab %} {% endtabs %} {% endstep %} {% step %} ### Encontrar la referencia de una contraseña Pida a Devolutions CLI las referencias de una entrada. Esto indica dónde está cada secreto, nunca el secreto en sí. ```bash devo entry references "" --vault-name "" ``` Copie la referencia del campo `password`. Empieza por `devo://`. {% hint style="info" %} Pueden aparecer dos clases de referencias. Una **referencia con nombre** usa los nombres del espacio de trabajo, de la bóveda y de la entrada, así que es fácil de leer. Una **referencia canónica** (`devo://ws/…/vault/…/entry/…/field/…`) usa identificadores, así que sigue funcionando cuando se cambia el nombre de una entrada. En Devolutions Server, este comando solo enumera referencias canónicas. Consulte [Encontrar la referencia de un secreto](/cli/es/guias/secrets/find-a-reference.md). {% endhint %} {% endstep %} {% step %} ### Ejecutar un comando con el secreto Pase la referencia a `devo secret run`. Devolutions CLI lee la contraseña de su bóveda, la coloca en una variable de entorno para ese único comando y lo inicia. Todo lo que va después de `--` es su comando. {% tabs %} {% tab title="PowerShell" %} ```powershell devo secret run --env-ref DEMO_SECRET= -- pwsh -NoProfile -Command 'Write-Output $env:DEMO_SECRET' ``` {% endtab %} {% tab title="Bash" %} ```bash devo secret run --env-ref DEMO_SECRET= -- sh -c 'echo "$DEMO_SECRET"' ``` {% endtab %} {% endtabs %} El comando sí recibió la contraseña, pero el terminal muestra ``: Devolutions CLI oculta los valores que resolvió en todo lo que imprime el comando. Cuando el comando termina, la variable desaparece. Nunca existió en su shell. Sustituya el ejemplo por su propio programa, por ejemplo una migración de base de datos o un script de implementación que lee su contraseña de una variable de entorno. {% hint style="warning" %} El enmascaramiento protege lo que el comando imprime, no lo que hace. Un programa que recibe un secreto puede escribirlo en un archivo o enviarlo a algún sitio. Ejecute solo programas en los que confíe sus secretos. Consulte [Qué permanece oculto y qué no](/cli/es/guias/understand/security-model.md). {% endhint %} {% endstep %} {% step %} ### Comprobar antes de ejecutar (opcional) Añada `--check` para asegurarse de que el comando existe y de que cada referencia está bien formada, sin leer ningún secreto ni iniciar nada: ```bash devo secret run --check --env-ref DEMO_SECRET= -- ``` Más opciones, como varios secretos a la vez, un límite de tiempo o un archivo de inicio, están en [Ejecutar un comando con sus secretos](/cli/es/guias/secrets/run-with-secrets.md). {% endstep %} {% endstepper %} ## Ha terminado. ¿Qué sigue?
Limpiar sus archivos .envConserve sus archivos .env en el repositorio, con referencias en lugar de contraseñas.Sacar las contraseñas de un archivo .env
Trabajar con seguridad con agentes de IADeje que un agente ejecute comandos que necesitan credenciales, sin que los valores lleguen a su transcripción.Dar una credencial a un agente sin exponerla
AutomatizarloInicie sesión desde una canalización de CI sin un navegador ni una solicitud.Iniciar sesión desde una canalización de CI
--- # 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/quick-start.md?ask=&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.