> 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/secrets.md).

# Usar secretos sin exponerlos

Elegir el comando de Devolutions CLI que da un secreto a su programa y expone lo menos posible del valor.

Devolutions CLI puede entregar un secreto de su bóveda a un programa de varias formas. Se diferencian en lo que más importa: si el valor llega alguna vez a un lugar donde usted, su shell o un archivo puedan verlo. Empiece por `devo secret run`, y elija otro comando solo cuando su herramienta no pueda funcionar con él.

## Elegir el comando adecuado

<table><thead><tr><th width="220">ELIJA</th><th>QUÉ OCURRE</th><th width="220">¿EL VALOR PERMANECE OCULTO?</th></tr></thead><tbody><tr><td><code>devo secret run</code></td><td>Resuelve referencias en el entorno o la entrada estándar de un solo comando, lo inicia y sustituye los valores por <code>&#x3C;concealed by Devolutions></code> en lo que imprime.</td><td><strong>Sí.</strong> Los valores existen solo en el entorno de ese comando, mientras se ejecuta.</td></tr><tr><td><code>devo secret inject</code></td><td>Sustituye las referencias de una plantilla y escribe el resultado en un archivo o en la salida estándar.</td><td><strong>No.</strong> El resultado contiene los valores en texto sin formato.</td></tr><tr><td><code>devo secret shell enter</code></td><td>Imprime código de Bash o PowerShell que define variables de entorno en su shell actual. Usted ejecuta ese código con <code>eval</code> o <code>Invoke-Expression</code>.</td><td><strong>No.</strong> Los valores permanecen en texto sin formato en su sesión de shell hasta que salga del ámbito.</td></tr><tr><td><code>devo secret read</code></td><td>Resuelve una referencia e imprime el valor, o lo escribe en un archivo privado con <code>--out-file</code>.</td><td><strong>No.</strong> Usted obtiene el valor.</td></tr><tr><td><code>devo secret get</code></td><td>Igual que <code>devo secret read</code>, pero nombra el campo y la entrada en lugar de escribir una referencia.</td><td><strong>No.</strong> Usted obtiene el valor.</td></tr><tr><td><code>devo secret set</code></td><td>Escribe un valor nuevo en un campo de una entrada. El valor procede de una variable de entorno o de un archivo.</td><td><strong>Sí.</strong> El valor nuevo nunca se escribe en la línea de comandos y nunca se imprime.</td></tr><tr><td><code>devo secretspec</code></td><td>Registra Devolutions CLI como el proveedor al que SecretSpec llama para los URI de proveedor <code>devo://</code>.</td><td><strong>No.</strong> Devolutions CLI devuelve el valor a SecretSpec, que lo pasa a su aplicación.</td></tr></tbody></table>

{% hint style="warning" %}
`devo secret read`, `devo secret get`, `devo secret inject` y `devo secret shell enter` entregan el valor real a propósito. Úselos solo donde eso sea aceptable, y nunca en la transcripción de un agente de IA. Consulte [Qué permanece oculto y qué no](/cli/es/guias/understand/security-model.md).
{% endhint %}

## En esta sección

* [Encontrar la referencia de un secreto](/cli/es/guias/secrets/find-a-reference.md): enumera las referencias `devo://` de una entrada, sin leer ningún valor.
* [Ejecutar un comando con sus secretos](/cli/es/guias/secrets/run-with-secrets.md): `devo secret run`, la forma más segura de dar un secreto a un programa.
* [Sacar las contraseñas de un archivo .env](/cli/es/guias/secrets/replace-env-files.md): conserve los archivos `.env` en el repositorio, con referencias en lugar de valores.
* [Rellenar un archivo de configuración desde una plantilla](/cli/es/guias/secrets/fill-a-template.md): `devo secret inject`, para las herramientas que solo leen un archivo de configuración.
* [Usar secretos en el shell actual](/cli/es/guias/secrets/current-shell.md): `devo secret shell enter`, para varios comandos seguidos.
* [Actualizar un secreto desde un script](/cli/es/guias/secrets/update-a-secret.md): `devo secret set`, para rotar una contraseña sin escribirla.
* [Usar Devolutions CLI con SecretSpec](/cli/es/guias/secrets/secretspec.md): haga de su bóveda el backend de SecretSpec.


---

# 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/secrets.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.