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

# Comandi dei segreti

Ogni opzione dei comandi devo secret, devo secretspec e devo generate, con i valori predefiniti, i valori consentiti e le regole che Devolutions CLI controlla.

Questa pagina elenca ogni argomento e ogni opzione dei comandi che leggono, inseriscono e scrivono segreti (`devo secret`), collegano SecretSpec (`devo secretspec`) e generano password e chiavi (`devo generate`). Per una panoramica di tutti i comandi, consulti [Comandi](/cli/it/riferimento/commands.md). Per un aiuto passo dopo passo, consulti [Usare i segreti senza esporli](/cli/it/guide/secrets.md), [Eseguire un comando con i suoi segreti](/cli/it/guide/secrets/run-with-secrets.md), [Usare i segreti nella shell corrente](/cli/it/guide/secrets/current-shell.md), [Compilare un file di configurazione da un modello](/cli/it/guide/secrets/fill-a-template.md), [Aggiornare un segreto da uno script](/cli/it/guide/secrets/update-a-secret.md), [Usare Devolutions CLI con SecretSpec](/cli/it/guide/secrets/secretspec.md) e [Generare password e chiavi SSH](/cli/it/guide/generate.md).

Le opzioni che ogni comando accetta, come `--context`, `--source` o `--output json`, sono in [Opzioni globali](/cli/it/riferimento/global-options.md). La sintassi dei riferimenti `devo://` è in [Sintassi dei riferimenti al segreto](/cli/it/riferimento/secret-references.md).

{% hint style="warning" %}
`devo secret read`, `devo secret get`, `devo secret inject` e `devo secret shell enter` le consegnano il valore: compare nel terminale, in un file o nella sessione della shell. `devo secret run` è l’unico comando che lo tiene fuori dal terminale. Consulti [Che cosa resta nascosto e che cosa no](/cli/it/guide/understand/security-model.md).
{% endhint %}

## devo secret run

Esegue un comando con i riferimenti risolti solo nel suo ambiente. I valori risolti sono sostituiti con `<concealed by Devolutions>` in ciò che il comando stampa, a meno che non aggiunga `--no-masking`.

**Spazio di lavoro:** Tutti i tipi di spazio di lavoro

```bash
devo secret run [--env-ref <NAME>=<reference>]... [--env-file <path>] [--stdin-reference <reference>] [--timeout-seconds <seconds>] -- <command> [<arguments>]
devo secret run --manifest <path>
```

<table><thead><tr><th width="300">OPZIONE</th><th width="130">PREDEFINITO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>-- &#x3C;command> [&#x3C;arguments>]</code></td><td></td><td>Il comando da eseguire e i suoi argomenti, dopo <code>--</code>. Obbligatorio, a meno che non usi <code>--manifest</code>. Un argomento che è un riferimento viene rifiutato: passi i riferimenti con <code>--env-ref</code>, <code>--stdin-reference</code>, <code>--env-file</code> o <code>--manifest</code>. Un riferimento dentro un argomento più lungo, come <code>--password=devo://…</code>, non viene rifiutato, ma non viene nemmeno risolto.</td></tr><tr><td><code>--env-ref &#x3C;NAME>=&#x3C;reference></code></td><td></td><td>Mette il valore di un riferimento nella variabile d’ambiente <code>NAME</code> del comando. Ripeta per più variabili. Il nome deve usare lettere, cifre e trattini bassi e non può iniziare con una cifra. Il valore deve essere un riferimento <code>devo://</code> esatto.</td></tr><tr><td><code>--env-file &#x3C;path></code></td><td></td><td>File di ambiente di righe <code>KEY=value</code>. Le righe vuote e le righe che iniziano con <code>#</code> sono ignorate; le virgolette intorno a un valore vengono rimosse. I valori possono essere riferimenti. Una riga senza <code>=</code> ferma il comando con codice di uscita <code>2</code>. Una variabile del file sostituisce una variabile dell’ambiente con lo stesso nome. Consulti <a href="/cli/it/guide/secrets/replace-env-files.md">Togliere le password da un file .env</a>.</td></tr><tr><td><code>--stdin-reference &#x3C;reference></code></td><td></td><td>Riferimento il cui valore è scritto, esattamente, nell’input standard del comando. Deve essere un riferimento <code>devo://</code> esatto; funzionano sia i riferimenti con nome sia quelli canonici.</td></tr><tr><td><code>--manifest &#x3C;path></code></td><td></td><td>Manifesto di avvio: un file JSON con versione che contiene il comando, i suoi argomenti, i suoi riferimenti e, facoltativamente, un riferimento allo standard input, un timeout e una cartella di lavoro (una cartella assoluta esistente). Non può essere combinato con <code>--env-ref</code>, <code>--env-file</code>, <code>--stdin-reference</code>, <code>--timeout-seconds</code> o un comando dopo <code>--</code>. Con un manifesto, le variabili dell’ambiente che contengono un riferimento non vengono risolte.</td></tr><tr><td><code>--timeout-seconds &#x3C;seconds></code></td><td>Nessuno</td><td>Tempo massimo di esecuzione del comando, maggiore di zero. Quando è superato, il comando è fermato e <code>devo</code> esce con il codice <code>124</code>. Senza, non c’è un limite di tempo.</td></tr><tr><td><code>--receipt-file &#x3C;path></code></td><td></td><td>Scrive una ricevuta dell’avvio al termine del comando: un file JSON con il piano di avvio, i nomi delle variabili, il codice di uscita e la durata, senza alcun valore. Il file non deve ancora esistere. Se esiste, il comando viene comunque eseguito, ma la ricevuta non viene scritta e <code>devo</code> termina con il codice <code>1</code> invece del codice di uscita del comando.</td></tr><tr><td><code>--check</code></td><td>Disattivato</td><td>Controlla che il comando esista e che i riferimenti siano ben formati, senza leggere alcun segreto né avviare il comando. Su un profilo locale, e per un riferimento con nome, controlla anche che la cassaforte e la voce esistano; su Devolutions Cloud e Devolutions Server un riferimento canonico non viene cercato. Non può essere combinato con <code>--dry-run</code>.</td></tr><tr><td><code>--dry-run</code></td><td>Disattivato</td><td>Controlla il piano di avvio e lo mostra, senza contattare lo spazio di lavoro, senza cercare il comando, senza leggere alcun segreto e senza avviare il comando. Non può essere combinato con <code>--check</code>.</td></tr><tr><td><code>--no-masking</code></td><td>Disattivato</td><td>Smette di sostituire i valori risolti con <code>&#x3C;concealed by Devolutions></code> in ciò che il comando stampa sul suo output standard e sul suo output di errore.</td></tr></tbody></table>

Oltre a `--env-ref` e `--env-file`, qualsiasi variabile dell’ambiente il cui valore è un riferimento `devo://` viene risolta per il comando, a meno che non usi `--manifest`. Lo stesso nome di variabile non può provenire da due origini, per esempio un `--env-ref` e una variabile dell’ambiente: il comando si ferma invece.

**Codici di uscita:** un avvio non valido, come un `--env-ref` malformato oppure sia `--check` sia `--dry-run`, termina con `2` prima che venga letto qualcosa. Un timeout termina con `124`, un annullamento con <kbd>Ctrl</kbd>+<kbd>C</kbd> con `130`. Altrimenti `devo secret run` termina con il codice di uscita del comando. Consulti [Codici di uscita ed errori](/cli/it/riferimento/exit-codes-and-errors.md).

## devo secret read

Legge un riferimento e scrive il valore nel terminale o in un file.

**Spazio di lavoro:** Tutti i tipi di spazio di lavoro

```bash
devo secret read <reference> [--attribute <attribute>] [--out-file <path> [--force]] [--raw]
```

<table><thead><tr><th width="300">OPZIONE</th><th width="130">PREDEFINITO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>&#x3C;reference></code></td><td></td><td>Il riferimento da leggere, come <code>devo://&#x3C;workspace>/&#x3C;vault>/&#x3C;entry>/password</code>. Obbligatorio. Un riferimento mal formato è rifiutato prima di qualsiasi lettura. Consulti <a href="/cli/it/riferimento/secret-references.md">Sintassi dei riferimenti al segreto</a>.</td></tr><tr><td><code>--attribute &#x3C;attribute></code> (<code>--attr</code>)</td><td></td><td>Che cosa leggere del campo: <code>value</code>, <code>type</code>, <code>id</code>, <code>title</code> o <code>purpose</code>, senza distinzione tra maiuscole e minuscole. <code>otp</code> è accettato, ma non restituisce nulla. Qualsiasi altro valore è rifiutato. Senza questa opzione si applica il <code>?attribute=</code> proprio del riferimento, oppure <code>value</code>. Consulti <a href="/cli/it/riferimento/secret-references.md#attributes">Attributi</a>.</td></tr><tr><td><code>--out-file &#x3C;path></code> (<code>-f</code>)</td><td></td><td>Scrive il valore in un file invece che nel terminale. La cartella deve esistere e il percorso non può essere una cartella. Con l’output di testo non viene stampato nient’altro; con <code>--output json</code>, il risultato è stampato senza il valore.</td></tr><tr><td><code>--force</code></td><td>Disattivato</td><td>Sovrascrive il file <code>--out-file</code> se esiste. Senza di essa, un file esistente viene rifiutato.</td></tr><tr><td><code>--raw</code></td><td>Disattivato</td><td>Con l’output di testo, scrive esattamente il valore sull’output standard, senza un’interruzione di riga alla fine. Senza di essa, un’interruzione di riga segue il valore.</td></tr></tbody></table>

## devo secret get

Legge un campo di una voce dello spazio di lavoro selezionato, per nome o ID della voce, senza scrivere un riferimento.

**Spazio di lavoro:** Tutti i tipi di spazio di lavoro

```bash
devo secret get <field> <entry> [--vault <vault>] [--attribute <attribute>] [--out-file <path> [--force]] [--raw]
devo secret get <field> id:<entry-id> --vault-id <vault-id>
```

<table><thead><tr><th width="300">OPZIONE</th><th width="130">PREDEFINITO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>&#x3C;field></code></td><td></td><td>Il campo da leggere, come <code>password</code>, <code>username</code>, <code>domain</code>, <code>host</code>, <code>otp</code> o <code>privatekey</code>. Obbligatorio. Devolutions Server legge qualsiasi proprietà di dati della voce.</td></tr><tr><td><code>&#x3C;entry></code></td><td></td><td>Il nome della voce, o il suo ID con <code>id:&#x3C;value></code> o <code>--id</code>. Obbligatorio.</td></tr><tr><td><code>--id</code></td><td>Disattivato</td><td>Tratta <code>&#x3C;entry></code> come un ID.</td></tr><tr><td><code>--workspace &#x3C;workspace></code></td><td>Spazio di lavoro corrente</td><td>Spazio di lavoro della voce, per nome o per ID.</td></tr><tr><td><code>--vault &#x3C;vault></code></td><td>Cassaforte corrente</td><td>Cassaforte della voce, per nome o per ID.</td></tr><tr><td><code>--vault-id &#x3C;id></code></td><td></td><td>Cassaforte della voce, per ID. Ha la priorità su <code>--vault</code>. Con un ID di voce e nessuna opzione di cassaforte, è usata la cassaforte corrente; se nessuna cassaforte è selezionata, il comando chiede <code>--vault-id</code>.</td></tr><tr><td><code>--section &#x3C;section></code></td><td></td><td>Sezione del campo, quando il campo è in una sezione. Non può essere combinata con un ID di voce né con le opzioni della passphrase.</td></tr><tr><td><code>--attribute &#x3C;attribute></code> (<code>--attr</code>)</td><td><code>value</code></td><td>Che cosa leggere sul campo: <code>value</code>, <code>type</code>, <code>id</code>, <code>title</code> o <code>purpose</code>. <code>otp</code> è accettato, ma non restituisce nulla. Con un’opzione di passphrase è accettato solo <code>value</code>.</td></tr><tr><td><code>--passphrase-env &#x3C;variable></code></td><td></td><td>Solo profilo locale: nome della variabile d’ambiente che contiene la passphrase di uno spazio di lavoro protetto. Rifiutato su Devolutions Cloud e Devolutions Server. Richiede l’ID della voce (<code>id:&#x3C;value></code> o <code>--id</code>). Con un’opzione di passphrase si può leggere solo il campo <code>password</code>, si può indicare solo una delle due opzioni di passphrase, si accetta solo l’output di testo e, senza <code>--vault-id</code> o <code>--vault</code>, si usa la cassaforte predefinita dello spazio di lavoro.</td></tr><tr><td><code>--passphrase-file &#x3C;path></code></td><td></td><td>Solo profilo locale: file privato che contiene la passphrase di uno spazio di lavoro protetto. Le stesse regole di <code>--passphrase-env</code>.</td></tr><tr><td><code>--out-file &#x3C;path></code> (<code>-f</code>)</td><td></td><td>Scrive il valore in un file invece che nel terminale. Le stesse regole di <code>devo secret read</code>.</td></tr><tr><td><code>--force</code></td><td>Disattivato</td><td>Sovrascrive il file <code>--out-file</code> se esiste.</td></tr><tr><td><code>--raw</code></td><td>Disattivato</td><td>Con output di testo, scrive esattamente il valore sull’output standard, senza un’interruzione di riga alla fine.</td></tr></tbody></table>

## devo secret set

Scrive un campo segreto di una voce, con il nuovo valore da una variabile d’ambiente o da un file. Il nuovo valore non viene mai stampato.

**Spazio di lavoro:** Tutti i tipi di spazio di lavoro. Devolutions Server scrive qualsiasi proprietà dei dati della voce; Devolutions Cloud e i profili locali scrivono solo `password`.

```bash
devo secret set <field> <entry> --value-env <variable> --yes
devo secret set <field> <entry> --value-file <path> --yes
```

<table><thead><tr><th width="300">OPZIONE</th><th width="130">PREDEFINITO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>&#x3C;field></code></td><td></td><td>Il campo da scrivere. Obbligatorio. Su Devolutions Cloud e su un profilo locale, qualsiasi campo diverso da <code>password</code> è rifiutato con un errore che dice che lo spazio di lavoro accetta scritture solo nel campo della password.</td></tr><tr><td><code>&#x3C;entry></code></td><td></td><td>Il nome della voce, o il suo ID con <code>id:&#x3C;value></code> o <code>--id</code>. Obbligatorio.</td></tr><tr><td><code>--id</code></td><td>Disattivato</td><td>Tratta <code>&#x3C;entry></code> come un ID.</td></tr><tr><td><code>--vault-id &#x3C;id></code></td><td></td><td>Cassaforte della voce, per ID. Su un profilo locale, con un ID di voce e senza <code>--vault-id</code>, è usata la cassaforte predefinita dello spazio di lavoro. Su Devolutions Cloud, senza, è usata la cassaforte corrente.</td></tr><tr><td><code>--value-env &#x3C;variable></code></td><td></td><td>Nome della variabile d’ambiente che contiene il nuovo valore. Usi esattamente uno tra <code>--value-env</code> o <code>--value-file</code>.</td></tr><tr><td><code>--value-file &#x3C;path></code></td><td></td><td>File che contiene il nuovo valore.</td></tr><tr><td><code>--passphrase-env &#x3C;variable></code></td><td></td><td>Solo profilo locale: nome della variabile d’ambiente che contiene la passphrase di uno spazio di lavoro protetto. Rifiutata su Devolutions Cloud e Devolutions Server.</td></tr><tr><td><code>--passphrase-file &#x3C;path></code></td><td><code>&#x3C;workspace file>.passphrase</code></td><td>Solo profilo locale: file privato che contiene la passphrase di uno spazio di lavoro protetto. Senza alcuna opzione di passphrase, viene usato il file <code>&#x3C;workspace file>.passphrase</code> nella cartella del profilo. Rifiutato su Devolutions Cloud e Devolutions Server.</td></tr><tr><td><code>--yes</code> (<code>-y</code>, <code>--confirmed</code>)</td><td>Disattivato</td><td>Conferma la modifica. Obbligatorio: senza di essa non viene scritto nulla.</td></tr></tbody></table>

## devo secret inject

Sostituisce i riferimenti in un testo, dall’input standard o da un file, con i loro valori.

**Spazio di lavoro:** Tutti i tipi di spazio di lavoro

```bash
devo secret inject [--in-file <path>] [--out-file <path> [--force]]
```

<table><thead><tr><th width="300">OPZIONE</th><th width="130">PREDEFINITO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>--in-file &#x3C;path></code> (<code>-i</code>)</td><td>Input standard</td><td>Modello da leggere.</td></tr><tr><td><code>--out-file &#x3C;path></code> (<code>-f</code>)</td><td>Output standard</td><td>File da scrivere. La cartella deve esistere e il percorso non può essere una cartella.</td></tr><tr><td><code>--force</code></td><td>Disattivato</td><td>Sovrascrive il file <code>--out-file</code> se esiste. Senza di essa, un file esistente viene rifiutato.</td></tr></tbody></table>

Se un riferimento nel modello non può essere risolto, non viene scritto nulla e il comando termina con il codice `1`. Con `--output json` o `--output yaml`, il comando stampa un riepilogo invece del testo compilato: usi `--out-file` per ottenere il testo. Consulti [Compilare un file di configurazione da un modello](/cli/it/guide/secrets/fill-a-template.md).

## devo secret shell enter

Stampa codice shell che carica i riferimenti nella sessione Bash o PowerShell corrente. Esegua quel codice con `eval` (Bash) o `Invoke-Expression` (PowerShell). Consulti [Usare i segreti nella shell corrente](/cli/it/guide/secrets/current-shell.md).

**Spazio di lavoro:** Tutti i tipi di spazio di lavoro

```bash
devo secret shell enter --shell <bash|pwsh> --env-ref <NAME>=<reference> [--env-ref ...] [--check --output json]
```

<table><thead><tr><th width="300">OPZIONE</th><th width="130">PREDEFINITO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>--shell &#x3C;shell></code></td><td></td><td>Shell per cui scrivere il codice: <code>bash</code> oppure <code>pwsh</code> (<code>powershell</code> funziona allo stesso modo). Obbligatorio. Qualsiasi altro valore viene rifiutato.</td></tr><tr><td><code>--env-ref &#x3C;NAME>=&#x3C;reference></code></td><td></td><td>Variabile da caricare e il suo riferimento. Ripeta per più variabili. Almeno una è obbligatoria. Ogni nome deve essere univoco, senza distinzione tra maiuscole e minuscole. Il comando non legge l’ambiente né i file <code>.env</code>.</td></tr><tr><td><code>--check</code></td><td>Disattivato</td><td>Controlla i riferimenti, come fa <code>devo secret run --check</code>, senza leggere alcun segreto né scrivere codice di shell. Richiede <code>--output json</code>.</td></tr></tbody></table>

Senza `--check`, il comando ha bisogno di un output di testo, così la shell può eseguire ciò che stampa. Se un riferimento non può essere letto, non viene stampato nulla sull’output standard e il comando esce con un codice diverso da zero.

## devo secret shell leave

Stampa codice di shell che annulla il `devo secret shell enter` più recente, ripristinando ogni variabile com’era prima.

**Spazio di lavoro:** Tutti i tipi di spazio di lavoro

```bash
devo secret shell leave --shell <bash|pwsh>
```

<table><thead><tr><th width="300">OPZIONE</th><th width="130">PREDEFINITO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>--shell &#x3C;shell></code></td><td></td><td>Shell per cui scrivere il codice: <code>bash</code> o <code>pwsh</code> (<code>powershell</code> fa lo stesso). Obbligatorio. Usi lo stesso valore di <code>enter</code>. Il comando ha bisogno di un output di testo.</td></tr></tbody></table>

## devo secret shell status

Mostra se un ambito di `devo secret shell enter` è attivo nella shell corrente, quanti ambiti sono annidati e i nomi delle variabili impostate dal più recente. Non mostra mai i valori.

**Spazio di lavoro:** Tutti i tipi di spazio di lavoro

```bash
devo secret shell status --shell <bash|pwsh> --output json
```

<table><thead><tr><th width="300">OPZIONE</th><th width="130">PREDEFINITO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>--shell &#x3C;shell></code></td><td></td><td>Shell da ispezionare: <code>bash</code> o <code>pwsh</code> (<code>powershell</code> fa la stessa cosa). Obbligatorio. Il comando ha bisogno di <code>--output json</code>.</td></tr></tbody></table>

## devo secret catalog entry

Elenca i riferimenti `devo://` dei campi di una voce, pronti da copiare, senza alcun valore. Uguale a `devo entry references`. Consulti [Trovare il riferimento a un segreto](/cli/it/guide/secrets/find-a-reference.md).

**Spazio di lavoro:** Tutti i tipi di spazio di lavoro

```bash
devo secret catalog entry <entry> [--vault-name <vault> | --vault-id <id>]
```

<table><thead><tr><th width="300">OPZIONE</th><th width="130">PREDEFINITO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>&#x3C;entry></code></td><td></td><td>Il nome della voce, o il suo ID con <code>id:&#x3C;value></code> o <code>--id</code>. Obbligatorio.</td></tr><tr><td><code>--id</code></td><td>Disattivato</td><td>Tratta <code>&#x3C;entry></code> come un ID.</td></tr><tr><td><code>--vault-id &#x3C;id></code></td><td></td><td>Cassaforte della voce, per ID. Su Devolutions Cloud, senza un’opzione di cassaforte, viene usata la cassaforte corrente.</td></tr><tr><td><code>--vault-name &#x3C;name></code></td><td></td><td>Cassaforte della voce, per nome.</td></tr></tbody></table>

## devo secret capabilities

Descrive, per Devolutions Cloud, Devolutions Server e i profili locali, ciò che i comandi dei segreti supportano, come quali campi possono essere letti e scritti. Non viene restituito alcun valore e nessuno spazio di lavoro viene contattato.

**Spazio di lavoro:** Tutti i tipi di spazio di lavoro

```bash
devo secret capabilities --output json
```

Questo comando non ha argomenti né opzioni propri.

## devo secretspec register

Registra questo `devo` come provider SecretSpec per gli URI del provider `devo://`, scrivendo un file di claim `devo.secretspec.json`. Consulti [Usare Devolutions CLI con SecretSpec](/cli/it/guide/secrets/secretspec.md#where-the-claim-file-goes) per sapere dove va il file.

**Spazio di lavoro:** Tutti i tipi di spazio di lavoro

```bash
devo secretspec register [--system] [--executable <path>] [--environment <name>]... [--force] [--dry-run]
```

<table><thead><tr><th width="300">OPZIONE</th><th width="130">PREDEFINITO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>--system</code></td><td>Disattivato</td><td>Scrive il claim per ogni utente del computer invece che solo per lei. Di solito servono diritti di amministratore.</td></tr><tr><td><code>--executable &#x3C;path></code></td><td>Questo <code>devo</code></td><td>L’eseguibile <code>devo</code> da registrare. Il percorso deve essere assoluto e il file deve esistere. Un percorso verso l’host <code>dotnet</code> è rifiutato: registri l’eseguibile <code>devo</code> pubblicato.</td></tr><tr><td><code>--environment &#x3C;name></code> (<code>--env</code>)</td><td></td><td>Variabile d’ambiente aggiuntiva che SecretSpec può passare a <code>devo</code>, per nome esatto o per un prefisso che termina con <code>*</code>, come <code>DEVO_*</code>. La ripeta per più di una. Un nome usa lettere, cifre e trattini bassi e non può iniziare con una cifra; qualsiasi altra cosa è rifiutata. <code>RDM_CONFIG_PATH</code> e <code>DEVO_CLI_CONFIG_HOME</code> sono sempre inclusi.</td></tr><tr><td><code>--force</code></td><td>Disattivato</td><td>Sostituisce un claim esistente che registra un eseguibile che non è un eseguibile <code>devo</code>. Un claim che punta a un altro eseguibile <code>devo</code> è sostituito senza <code>--force</code>.</td></tr><tr><td><code>--dry-run</code></td><td>Disattivato</td><td>Mostra il claim che verrebbe scritto, senza scriverlo.</td></tr></tbody></table>

Se lo stesso claim è già presente, non viene scritto nulla e il comando lo segnala come invariato.

## devo secretspec unregister

Rimuove il claim `devo.secretspec.json`, così SecretSpec non avvia più Devolutions CLI. Se non c’è alcun claim, il comando lo segnala come assente.

**Spazio di lavoro:** Tutti i tipi di spazio di lavoro

```bash
devo secretspec unregister [--system] [--dry-run]
```

<table><thead><tr><th width="300">OPZIONE</th><th width="130">PREDEFINITO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>--system</code></td><td>Disattivato</td><td>Rimuove il claim per ogni utente del computer invece del proprio.</td></tr><tr><td><code>--dry-run</code></td><td>Disattivato</td><td>Mostra il claim che verrebbe rimosso, senza rimuoverlo.</td></tr></tbody></table>

## devo secretspec status

Mostra il claim dell’utente e il claim del computer e, per ciascuno, se punta al `devo` in esecuzione.

**Spazio di lavoro:** Tutti i tipi di spazio di lavoro

```bash
devo secretspec status
```

Questo comando non ha argomenti né opzioni propri.

## devo secretspec uri

Stampa l’URI del provider da mettere in `secretspec.toml` per lo spazio di lavoro selezionato: quello indicato con `--source` o `--context`, oppure il contesto corrente.

**Spazio di lavoro:** Tutti i tipi di spazio di lavoro

```bash
devo secretspec uri --context <context-name> [--vault-id <vault-id>]
devo secretspec uri --source sqlite --workspace-id sqlite:<file-name>.db [--vault-id <vault-id>]
```

<table><thead><tr><th width="300">OPZIONE</th><th width="130">PREDEFINITO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>--vault-id &#x3C;id></code></td><td></td><td>Cassaforte predefinita del provider. Un segreto può ancora nominare la propria cassaforte. Senza di essa, ogni segreto deve nominare la sua cassaforte.</td></tr><tr><td><code>--workspace-id &#x3C;id></code></td><td></td><td>Solo profilo locale, e lì obbligatorio: l’ID dello spazio di lavoro, scritto <code>sqlite:&#x3C;file-name>.db</code>, come <code>sqlite:Connections.db</code>. <code>devo workspace current</code> lo mostra. Rifiutato per Devolutions Cloud e Devolutions Server, i cui URI selezionano invece un contesto.</td></tr></tbody></table>

## devo secretspec provider

Serve il protocollo di provider di SecretSpec su input e output standard. SecretSpec lo avvia da solo tramite il claim registrato; non lo esegue lei.

**Spazio di lavoro:** Tutti i tipi di spazio di lavoro

```bash
devo secretspec provider
```

Questo comando non ha argomenti né opzioni propri.

## devo generate password

Genera una password casuale robusta sul computer. Contiene sempre almeno una lettera minuscola, una lettera maiuscola, una cifra e un simbolo da `!@#$%^&*?`. Come ogni comando `devo generate`, non contatta alcuno spazio di lavoro e non avvia il processo in background.

**Spazio di lavoro:** Tutti i tipi di spazio di lavoro (funziona solo sul computer)

```bash
devo generate password [--length <length>]
```

<table><thead><tr><th width="300">OPZIONE</th><th width="130">PREDEFINITO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>--length &#x3C;length></code></td><td><code>32</code></td><td>Lunghezza della password, da 8 a 4096. <code>0</code> o un valore negativo significa il valore predefinito, 32. Qualsiasi altro valore fuori dall’intervallo viene rifiutato.</td></tr></tbody></table>

## devo generate human-readable

Genera una password facile da leggere: sillabe minuscole pronunciabili, poi cifre, poi simboli.

**Spazio di lavoro:** Tutti i tipi di spazio di lavoro (funziona solo sul computer)

```bash
devo generate human-readable [--syllables <count>] [--numerics <count>] [--symbols <count>]
```

<table><thead><tr><th width="300">OPZIONE</th><th width="130">PREDEFINITO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>--syllables &#x3C;count></code></td><td><code>4</code></td><td>Numero di sillabe, ciascuna una consonante e una vocale, da 1 a 64.</td></tr><tr><td><code>--numerics &#x3C;count></code></td><td><code>1</code></td><td>Numero di cifre aggiunte dopo le sillabe, da 0 a 64.</td></tr><tr><td><code>--symbols &#x3C;count></code></td><td><code>1</code></td><td>Numero di simboli da <code>!@#$%^&#x26;*?</code> aggiunti alla fine, da 0 a 64.</td></tr></tbody></table>

## devo generate passphrase

Genera una passphrase composta da parole casuali di un dizionario.

**Spazio di lavoro:** Tutti i tipi di spazio di lavoro (funziona solo sul computer)

```bash
devo generate passphrase [--words <count>] [--separator <text>] [--dictionary <dictionary>]
```

<table><thead><tr><th width="300">OPZIONE</th><th width="130">PREDEFINITO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>--words &#x3C;count></code></td><td><code>5</code></td><td>Numero di parole, da 1 a 64.</td></tr><tr><td><code>--separator &#x3C;text></code></td><td><code>-</code></td><td>Testo posto tra le parole. Un valore vuoto significa il valore predefinito, <code>-</code>.</td></tr><tr><td><code>--dictionary &#x3C;dictionary></code></td><td><code>English</code></td><td>Elenco di parole: <code>English</code> (o <code>en</code>), <code>French</code> (o <code>fr</code>) o <code>German</code> (o <code>de</code>), in qualsiasi combinazione di maiuscole. Qualsiasi altro valore è rifiutato.</td></tr></tbody></table>

## devo generate pattern

Genera una password da un modello, un carattere per lettera del modello.

**Spazio di lavoro:** Tutti i tipi di spazio di lavoro (funziona solo sul computer)

```bash
devo generate pattern <pattern> [--shuffle]
```

<table><thead><tr><th width="300">OPZIONE</th><th width="130">PREDEFINITO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>&#x3C;pattern></code></td><td></td><td>Lo schema. Obbligatorio, fino a 4096 lettere. Ogni lettera dà un carattere: <code>u</code> lettera maiuscola, <code>l</code> lettera minuscola, <code>d</code> cifra, <code>s</code> simbolo da <code>!@#$%^&#x26;*?</code>, <code>x</code> uno qualsiasi di questi. Le lettere sono accettate in qualsiasi combinazione di maiuscole e minuscole; qualsiasi altro carattere è rifiutato. Per esempio, <code>uulldds</code>.</td></tr><tr><td><code>--shuffle</code></td><td>Disattivato</td><td>Mescola i caratteri generati, così il loro ordine non segue più il modello.</td></tr></tbody></table>

## devo generate ssh-key

Genera una coppia di chiavi RSA sul computer: una chiave privata in formato PEM, cifrata quando indica una passphrase, e una chiave pubblica in formato OpenSSH. Viene stampata anche la chiave pubblica.

**Spazio di lavoro:** Tutti i tipi di spazio di lavoro (funziona solo sul computer)

```bash
devo generate ssh-key --out-file <path> [--bits <bits>] [--comment <text>] [--passphrase-env <variable> | --passphrase-file <path>] [--public-out-file <path>] [--force]
```

<table><thead><tr><th width="300">OPZIONE</th><th width="130">PREDEFINITO</th><th>CHE COSA FA</th></tr></thead><tbody><tr><td><code>--out-file &#x3C;path></code></td><td></td><td>File della chiave privata. Obbligatorio. La cartella deve esistere. Su macOS e Linux, solo l’account utente può leggere il file.</td></tr><tr><td><code>--public-out-file &#x3C;path></code></td><td><code>&#x3C;out-file>.pub</code></td><td>File della chiave pubblica. Deve essere diverso da <code>--out-file</code>.</td></tr><tr><td><code>--algorithm &#x3C;algorithm></code></td><td><code>rsa</code></td><td>Algoritmo della chiave. <code>rsa</code> è l’unico valore supportato.</td></tr><tr><td><code>--bits &#x3C;bits></code></td><td><code>3072</code></td><td>Dimensione della chiave RSA: <code>2048</code>, <code>3072</code> o <code>4096</code>. Qualsiasi altro valore viene rifiutato.</td></tr><tr><td><code>--comment &#x3C;text></code></td><td>Il suo nome utente</td><td>Commento alla fine della chiave pubblica. Non può contenere caratteri di controllo.</td></tr><tr><td><code>--passphrase-env &#x3C;variable></code></td><td></td><td>Nome della variabile d’ambiente che contiene la passphrase che protegge la chiave privata. La variabile deve essere impostata e non vuota. Usi questa opzione o <code>--passphrase-file</code>, non entrambe. Senza nessuna delle due, la chiave privata non è crittografata.</td></tr><tr><td><code>--passphrase-file &#x3C;path></code></td><td></td><td>File che contiene la passphrase. Il file deve esistere e non essere vuoto; le interruzioni di riga alla fine vengono ignorate.</td></tr><tr><td><code>--force</code></td><td>Disattivato</td><td>Sovrascrive i file di chiave se esistono. Senza di essa, un file esistente viene rifiutato.</td></tr></tbody></table>

## Successivo

* [Sign-in and context commands](/cli/it/riferimento/commands/sign-in-and-contexts.md)
* [MCP, background process, and configuration commands](/cli/it/riferimento/commands/mcp-daemon-config.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/riferimento/commands/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.