/ ```

SEGMENTO	QUÉ ES
`<workspace>`	El espacio de trabajo que contiene la bóveda.
`<vault>`	La bóveda que contiene la entrada.
`<entry>`	La entrada que contiene el campo.
`<section>`	Opcional, solo perfil local. La sección de la entrada que contiene el campo, cuando el campo está en una sección. Devolutions Cloud y Devolutions Server rechazan una sección con `unsupportedSecretField`.
`<field>`	El campo que se va a leer, como `password`, `username`, `domain`, `host`, `otp` o `privatekey`.

Una referencia con nombre se resuelve en el espacio de trabajo seleccionado para el comando: el contexto actual, o el que elija con `--context` o `--source`. Consulte [Opciones globales](/cli/es/referencia/global-options.md). ## Referencias canónicas Una referencia canónica usa ID en lugar de nombres: ``` devo://ws//vault//entry//field/ ``` * Sigue funcionando cuando se cambia el nombre de la entrada, de la bóveda o del espacio de trabajo. * Nombra el espacio de trabajo al que pertenece, así que se resuelve en ese espacio de trabajo, sea cual sea el contexto actual. Un `devo secret run` puede mezclar referencias de un perfil local, de Devolutions Cloud y de Devolutions Server. * No tiene un segmento de sección. * En Devolutions Server, `devo entry references` enumera solo referencias canónicas. Una referencia con nombre que escriba usted mismo sigue funcionando. ## Atributos De forma predeterminada, una referencia devuelve el valor del campo. Añada `?attribute=` (o la forma corta `?attr=`) para leer información sobre el campo en lugar de su valor. Los valores no distinguen mayúsculas.

ATRIBUTO	QUÉ DEVUELVE	SECRETO
`value`	El valor del campo. Es el valor predeterminado y el único atributo que devuelve un secreto.	Sí
`type`	El tipo de campo.	No
`id`	El ID de la entrada.	No
`title`	El nombre de la entrada. Vacío para una referencia canónica en Devolutions Cloud y Devolutions Server.	No
`purpose`	Por qué se solicitó el valor: `read`, `inject`, `run` o `mcp`. Vacío en un perfil local.	No

`type`, `id`, `title` y `purpose` devuelven solo información, nunca el secreto, en todos los tipos de espacio de trabajo. Por ejemplo, `devo://///password?attribute=type` devuelve el tipo del campo `password`, no la contraseña. `devo secret read` y `devo secret get` también aceptan `--attribute` en lugar de la consulta. ## Caracteres especiales Cada segmento entre dos `/` se descodifica como URL. Si un nombre contiene `/`, `?`, `#`, `%` o un espacio, codifíquelo: por ejemplo, escriba `Web%2FProd` para una entrada llamada `Web/Prod`, y `My%20vault` para `My vault`. Un `:` puede quedarse como está. Las referencias que imprime Devolutions CLI, por ejemplo con `devo entry references`, ya están codificadas. ## Reglas y errores Cuando una referencia no se puede leer, el comando falla con el código de error `invalidSecretReference` y uno de estos mensajes.

MENSAJE	QUÉ COMPROBAR
"Secret reference cannot be empty."	La referencia está vacía o solo contiene espacios.
"Secret reference must start with 'devo://'."	Falta el prefijo o está mal escrito. El prefijo no distingue mayúsculas.
"Secret references do not support URI fragments."	La referencia contiene `#`. Codifíquelo como `%23` si forma parte de un nombre.
"Secret reference path cannot be empty."	Nada sigue a `devo://`.
"Use devo://<workspace>/<vault>/<entry>/<field> or devo://<workspace>/<vault>/<entry>/<section>/<field>."	Una referencia con nombre necesita 4 o 5 segmentos. Compruebe si falta un segmento o si hay un `/` sin codificar en un nombre.
"Secret reference path segments cannot be empty."	Dos `/` se siguen, o la referencia termina con `/`.
"Canonical ID references must use devo://ws/<id>/vault/<id>/entry/<id>/field/<field>."	Una referencia que empieza por `ws` y tiene 8 segmentos debe usar las palabras `vault`, `entry` y `field` en ese orden.
"Canonical workspace, vault, and entry identifiers cannot be empty."	Falta un ID en una referencia canónica.
"Canonical field segment cannot be empty."	Falta el campo al final de una referencia canónica.

Un atributo desconocido falla con el código `unsupportedSecretAttribute` y el mensaje «Unsupported secret reference attribute '\'.». Los demás parámetros de consulta se ignoran. Cuando la referencia es válida pero no lleva a un campo que pueda leer, consulte [Una referencia de secreto no se resuelve](/cli/es/ayuda/troubleshooting/reference-does-not-resolve.md). ## Referencias dentro de un texto `devo secret inject` encuentra las referencias en una plantilla y sustituye cada una por su valor. Reconoce dos formas:

FORMA	DÓNDE TERMINA
`{{ devo://… }}`	En el `}}` de cierre. Las llaves también se sustituyen, y los espacios dentro se ignoran. Use esta forma cuando la referencia está junto a otro texto.
`devo://…`	En el primer espacio, salto de línea, `"`, `'`, `<`, `>`, `)`, `]` o `}`.

Un texto que empieza por `devo://` pero no es una referencia válida se deja tal cual. En una plantilla, una referencia también puede contener variables de entorno, que `devo secret inject` sustituye antes de leer el secreto:

EXPRESIÓN	EN QUÉ SE CONVIERTE
`$NAME` or `${NAME}`	El valor de la variable de entorno `NAME`. Si no está definida o está vacía, el comando falla con `missingSecretReferenceVariable`.
`${NAME:-default}`	El valor de `NAME`, o `default` cuando no está definido o está vacío.

Por ejemplo, `{{ devo:///${VAULT:-Staging}//password }}` lee de la bóveda nombrada en `VAULT`, o de `Staging`. {% hint style="warning" %} `devo secret inject` escribe los valores en texto sin formato en su salida. Consulte [Rellenar un archivo de configuración desde una plantilla](/cli/es/guias/secrets/fill-a-template.md). {% endhint %} ## URI de proveedor SecretSpec SecretSpec no usa referencias de secreto. En `secretspec.toml`, usa un URI de proveedor que le indica qué espacio de trabajo debe leer Devolutions CLI. Imprima el correcto con `devo secretspec uri`. Consulte [Usar Devolutions CLI con SecretSpec](/cli/es/guias/secrets/secretspec.md).

URI DEL PROVEEDOR	ESPACIO DE TRABAJO
`devo://cloud[/<vault-id>][?context=<name>]`	Devolutions Cloud, a través del contexto `<name>`, o el contexto actual de Devolutions Cloud sin `?context=`.
`devo://server[/<vault-id>][?context=<name>]`	Devolutions Server, a través del contexto `<name>`, o el contexto actual de Devolutions Server sin `?context=`.
`devo://sqlite[/<vault-id>]?workspace=<workspace-id>`	Un espacio de trabajo local de Devolutions Remote Desktop Manager. `?workspace=` es obligatorio, con un identificador de espacio de trabajo como `sqlite:Connections.db`. `devo workspace current` lo muestra.

`` es opcional: establece la bóveda predeterminada, y cada secreto puede seguir nombrando su propia bóveda. --- # 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/referencia/secret-references.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.