> 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/find-a-reference.md). # Encontrar la referencia de un secreto Encontrar la referencia devo de una contraseña u otro campo con Devolutions CLI, sin leer ni mostrar el secreto en sí. Cada comando de Devolutions CLI que usa un secreto toma una **referencia**: la dirección de un campo, que empieza por `devo://`. Encontrar una referencia no lee nunca el secreto, así que puede hacerlo en cualquier sitio, incluso delante de un agente de IA o en un terminal compartido. ## Encontrar la entrada Si no conoce el nombre exacto de la entrada, búsquela primero: ```bash devo entry list "" --vault-name "" ``` `devo entry list` devuelve hasta 100 entradas de forma predeterminada (`--limit` lo cambia). También puede filtrar por tipo de entrada con `--type`. Para buscar en otro espacio de trabajo que no sea el actual, añada `--context `. Consulte [Cambiar entre espacios de trabajo](/cli/es/guias/connect/switch-workspaces.md). ## Enumerar las referencias de la entrada ```bash devo entry references "" --vault-name "" ``` Para seleccionar la entrada por identificador, escriba `id:` o añada `--id`. `devo secret catalog entry` toma los mismos argumentos y devuelve el mismo resultado. Devolutions CLI imprime una línea por campo que puede resolver, con la referencia que hay que copiar: ``` Secret references: 2 password (secret): devo://ws//vault//entry//field/password username: devo://ws//vault//entry//field/username ``` El comando examina los campos `password`, `username`, `host`, `domain` y `url` de la entrada. Muestra la referencia canónica cuando se conocen los identificadores, y la referencia con nombre en caso contrario. Con `--output json`, cada campo enumera ambas formas. Consulte [Leer los resultados como JSON](/cli/es/para-devops-y-administradores/automate/json-output.md). ## Referencia con nombre o canónica
FORMASE PARECE AÚSELO CUANDO
Con nombredevo://<workspace>/<vault>/<entry>/<field>Quiere una referencia que las personas puedan leer. Se resuelve en el contexto actual, o en el que seleccione con --context, y deja de funcionar si se cambia el nombre de la entrada o de la bóveda.
Canónicadevo://ws/<workspace-id>/vault/<vault-id>/entry/<entry-id>/field/<field>Confirma la referencia o la comparte. Sigue funcionando después de un cambio de nombre y siempre se resuelve en el espacio de trabajo al que pertenece, sea cual sea el contexto seleccionado. Un comando puede mezclar referencias canónicas de varios espacios de trabajo.
En Devolutions Server, `devo entry references` enumera solo referencias canónicas. Cada parte de una referencia se descodifica como URL. Si un nombre contiene un `/` o un `#`, escríbalo como `%2F` o `%23`. ## Apuntar a un campo de una sección En un perfil local, algunas entradas agrupan los campos en secciones. En una referencia con nombre, añada la sección entre la entrada y el campo: ``` devo://///
/ ``` `devo secret get` toma la sección con `--section`. Las secciones solo funcionan con los perfiles locales: Devolutions Cloud y Devolutions Server rechazan una referencia con una sección, y las referencias canónicas no tienen sección. ## Leer un atributo en lugar del valor Añada `?attribute=` (o `?attr=`) a una referencia para leer algo distinto del valor. `devo secret read` y `devo secret get` también aceptan `--attribute`.
ATRIBUTOQUÉ OBTIENE
valueEl valor del secreto. Este es el valor predeterminado.
typeEl tipo de campo. Los valores dependen del tipo de espacio de trabajo.
idEl ID de la entrada.
titleEl nombre de la entrada. Vacío para una referencia canónica en Devolutions Cloud y Devolutions Server.
purposeEn Devolutions Cloud y Devolutions Server, por qué se solicitó el valor, como read. Vacío en un perfil local.
`type`, `id`, `title` y `purpose` son lecturas sin valor: Devolutions CLI los devuelve sin leer el secreto, en Devolutions Cloud, Devolutions Server y los perfiles locales. Esta es una primera comprobación segura de una referencia, sin leer el secreto: ```bash devo secret read "?attribute=type" ``` Ponga la referencia entre comillas para que su shell no interprete el `?`. Un éxito confirma que la referencia está bien formada y, para una referencia con nombre o en un perfil local, que la bóveda y la entrada existen. No demuestra que el campo se pueda leer: en Devolutions Cloud y Devolutions Server, una referencia canónica no se busca en absoluto. Solo leer el valor confirma el campo. ## Qué campos puede leer cada tipo de espacio de trabajo `devo secret capabilities` describe, para Devolutions Cloud, Devolutions Server y los perfiles locales, qué campos se pueden leer y escribir. No lee ningún contexto ni ningún secreto. Añada `--output json` para la lista completa de campos; la salida de texto muestra solo un resumen. ```bash devo secret capabilities --output json ``` ## Si no funciona * El comando dice que la referencia no es válida, o que la entrada o el campo no se encuentra: consulte [Una referencia de secreto no se resuelve](/cli/es/ayuda/troubleshooting/reference-does-not-resolve.md). * Falta un campo en la lista: puede que la entrada no lo tenga, o que su tipo de espacio de trabajo no pueda resolverlo. Consulte [Comparar los tipos de espacio de trabajo](/cli/es/guias/understand/workspace-types.md). ## Siguiente * [Run a command with its secrets](/cli/es/guias/secrets/run-with-secrets.md) * [Secret reference syntax](/cli/es/referencia/secret-references.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/secrets/find-a-reference.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.