> 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/it/guide/secrets/find-a-reference.md). # Trovare il riferimento a un segreto Trovare il riferimento devo di una password o di un altro campo con Devolutions CLI, senza leggere né mostrare il segreto stesso. Ogni comando di Devolutions CLI che usa un segreto prende un **riferimento**: l’indirizzo di un campo, che inizia con `devo://`. Trovare un riferimento non legge mai il segreto, quindi può farlo ovunque, anche davanti a un agente IA o in un terminale condiviso. ## Trovare la voce Se non conosce il nome esatto della voce, la cerchi prima: ```bash devo entry list "" --vault-name "" ``` `devo entry list` restituisce fino a 100 voci per impostazione predefinita (`--limit` lo cambia). Può anche filtrare per tipo di voce con `--type`. Per cercare in uno spazio di lavoro diverso da quello corrente, aggiunga `--context `. Consulti [Passare da uno spazio di lavoro all’altro](/cli/it/guide/connect/switch-workspaces.md). ## Elencare i riferimenti della voce ```bash devo entry references "" --vault-name "" ``` Per selezionare la voce per ID, scriva `id:` o aggiunga `--id`. `devo secret catalog entry` accetta gli stessi argomenti e restituisce lo stesso risultato. Devolutions CLI stampa una riga per ogni campo che può risolvere, con il riferimento da copiare: ``` Secret references: 2 password (secret): devo://ws//vault//entry//field/password username: devo://ws//vault//entry//field/username ``` Il comando esamina i campi `password`, `username`, `host`, `domain` e `url` della voce. Mostra il riferimento canonico quando gli ID sono noti, altrimenti il riferimento con nome. Con `--output json`, ogni campo elenca entrambe le forme. Consulti [Leggere i risultati come JSON](/cli/it/per-devops-e-amministratori/automate/json-output.md). ## Riferimento con nome o canonico
FORMAASSOMIGLIA ALO USI QUANDO
Con nomedevo://<workspace>/<vault>/<entry>/<field>Vuole un riferimento che le persone possano leggere. Si risolve sul contesto corrente, o su quello selezionato con --context, e smette di funzionare se la voce o la cassaforte è rinominata.
Canonicodevo://ws/<workspace-id>/vault/<vault-id>/entry/<entry-id>/field/<field>Esegue il commit del riferimento o lo condivide. Continua a funzionare dopo una ridenominazione e si risolve sempre sullo spazio di lavoro che lo possiede, qualunque contesto sia selezionato. Un comando può mescolare riferimenti canonici di più spazi di lavoro.
Su Devolutions Server, `devo entry references` elenca solo riferimenti canonici. Ogni parte di un riferimento viene decodificata come URL. Se un nome contiene un `/` o un `#`, lo scriva come `%2F` o `%23`. ## Puntare a un campo in una sezione In un profilo locale, alcune voci raggruppano i campi in sezioni. In un riferimento con nome, aggiunga la sezione tra la voce e il campo: ``` devo://///
/ ``` `devo secret get` prende la sezione con `--section`. Le sezioni funzionano solo con i profili locali: Devolutions Cloud e Devolutions Server rifiutano un riferimento con una sezione, e i riferimenti canonici non hanno sezione. ## Leggere un attributo invece del valore Aggiunga `?attribute=` (o `?attr=`) a un riferimento per leggere qualcosa di diverso dal valore. `devo secret read` e `devo secret get` accettano anche `--attribute`.
ATTRIBUTOCHE COSA OTTIENE
valueIl valore del segreto. Questo è il valore predefinito.
typeIl tipo di campo. I valori dipendono dal tipo di spazio di lavoro.
idL’ID della voce.
titleIl nome della voce. Vuoto per un riferimento canonico su Devolutions Cloud e Devolutions Server.
purposeSu Devolutions Cloud e Devolutions Server, perché il valore è stato richiesto, come read. Vuoto su un profilo locale.
`type`, `id`, `title` e `purpose` sono letture senza valore: Devolutions CLI li restituisce senza leggere il segreto, su Devolutions Cloud, Devolutions Server e i profili locali. È un primo controllo sicuro di un riferimento, senza leggere il segreto: ```bash devo secret read "?attribute=type" ``` Metta il riferimento tra virgolette così la shell non interpreta il `?`. Un esito positivo conferma che il riferimento è ben formato e, per un riferimento con nome o su un profilo locale, che la cassaforte e la voce esistono. Non dimostra che il campo possa essere letto: su Devolutions Cloud e Devolutions Server un riferimento canonico non viene cercato affatto. Solo la lettura del valore conferma il campo. ## Quali campi può leggere ogni tipo di spazio di lavoro `devo secret capabilities` descrive, per Devolutions Cloud, Devolutions Server e i profili locali, quali campi possono essere letti e scritti. Non legge alcun contesto né alcun segreto. Aggiunga `--output json` per l’elenco completo dei campi; l’output di testo mostra solo un riepilogo. ```bash devo secret capabilities --output json ``` ## Se non funziona * Il comando dice che il riferimento non è valido, oppure che la voce o il campo non si trova: consulti [Un riferimento al segreto non si risolve](/cli/it/aiuto/troubleshooting/reference-does-not-resolve.md). * Manca un campo nell’elenco: la voce potrebbe non averlo, oppure il tipo di spazio di lavoro non può risolverlo. Consulti [Confrontare i tipi di spazio di lavoro](/cli/it/guide/understand/workspace-types.md). ## Successivo * [Run a command with its secrets](/cli/it/guide/secrets/run-with-secrets.md) * [Secret reference syntax](/cli/it/riferimento/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/it/guide/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.