Comandi dei segreti
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. Per un aiuto passo dopo passo, consulti Usare i segreti senza esporli, Eseguire un comando con i suoi segreti, Usare i segreti nella shell corrente, Compilare un file di configurazione da un modello, Aggiornare un segreto da uno script, Usare Devolutions CLI con SecretSpec e Generare password e chiavi SSH.
Le opzioni che ogni comando accetta, come --context, --source o --output json, sono in Opzioni globali. La sintassi dei riferimenti devo:// è in Sintassi dei riferimenti al segreto.
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
devo secret run [--env-ref <NAME>=<reference>]... [--env-file <path>] [--stdin-reference <reference>] [--timeout-seconds <seconds>] -- <command> [<arguments>]
devo secret run --manifest <path>-- <command> [<arguments>]
Il comando da eseguire e i suoi argomenti, dopo --. Obbligatorio, a meno che non usi --manifest. Un argomento che è un riferimento viene rifiutato: passi i riferimenti con --env-ref, --stdin-reference, --env-file o --manifest. Un riferimento dentro un argomento più lungo, come --password=devo://…, non viene rifiutato, ma non viene nemmeno risolto.
--env-ref <NAME>=<reference>
Mette il valore di un riferimento nella variabile d’ambiente NAME 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 devo:// esatto.
--env-file <path>
File di ambiente di righe KEY=value. Le righe vuote e le righe che iniziano con # sono ignorate; le virgolette intorno a un valore vengono rimosse. I valori possono essere riferimenti. Una riga senza = ferma il comando con codice di uscita 2. Una variabile del file sostituisce una variabile dell’ambiente con lo stesso nome. Consulti Togliere le password da un file .env.
--stdin-reference <reference>
Riferimento il cui valore è scritto, esattamente, nell’input standard del comando. Deve essere un riferimento devo:// esatto; funzionano sia i riferimenti con nome sia quelli canonici.
--manifest <path>
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 --env-ref, --env-file, --stdin-reference, --timeout-seconds o un comando dopo --. Con un manifesto, le variabili dell’ambiente che contengono un riferimento non vengono risolte.
--timeout-seconds <seconds>
Nessuno
Tempo massimo di esecuzione del comando, maggiore di zero. Quando è superato, il comando è fermato e devo esce con il codice 124. Senza, non c’è un limite di tempo.
--receipt-file <path>
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 devo termina con il codice 1 invece del codice di uscita del comando.
--check
Disattivato
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 --dry-run.
--dry-run
Disattivato
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 --check.
--no-masking
Disattivato
Smette di sostituire i valori risolti con <concealed by Devolutions> in ciò che il comando stampa sul suo output standard e sul suo output di errore.
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 Ctrl+C con 130. Altrimenti devo secret run termina con il codice di uscita del comando. Consulti Codici di uscita ed errori.
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
<reference>
Il riferimento da leggere, come devo://<workspace>/<vault>/<entry>/password. Obbligatorio. Un riferimento mal formato è rifiutato prima di qualsiasi lettura. Consulti Sintassi dei riferimenti al segreto.
--attribute <attribute> (--attr)
Che cosa leggere del campo: value, type, id, title o purpose, senza distinzione tra maiuscole e minuscole. otp è accettato, ma non restituisce nulla. Qualsiasi altro valore è rifiutato. Senza questa opzione si applica il ?attribute= proprio del riferimento, oppure value. Consulti Attributi.
--out-file <path> (-f)
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 --output json, il risultato è stampato senza il valore.
--force
Disattivato
Sovrascrive il file --out-file se esiste. Senza di essa, un file esistente viene rifiutato.
--raw
Disattivato
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.
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
<field>
Il campo da leggere, come password, username, domain, host, otp o privatekey. Obbligatorio. Devolutions Server legge qualsiasi proprietà di dati della voce.
<entry>
Il nome della voce, o il suo ID con id:<value> o --id. Obbligatorio.
--id
Disattivato
Tratta <entry> come un ID.
--workspace <workspace>
Spazio di lavoro corrente
Spazio di lavoro della voce, per nome o per ID.
--vault <vault>
Cassaforte corrente
Cassaforte della voce, per nome o per ID.
--vault-id <id>
Cassaforte della voce, per ID. Ha la priorità su --vault. Con un ID di voce e nessuna opzione di cassaforte, è usata la cassaforte corrente; se nessuna cassaforte è selezionata, il comando chiede --vault-id.
--section <section>
Sezione del campo, quando il campo è in una sezione. Non può essere combinata con un ID di voce né con le opzioni della passphrase.
--attribute <attribute> (--attr)
value
Che cosa leggere sul campo: value, type, id, title o purpose. otp è accettato, ma non restituisce nulla. Con un’opzione di passphrase è accettato solo value.
--passphrase-env <variable>
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 (id:<value> o --id). Con un’opzione di passphrase si può leggere solo il campo password, si può indicare solo una delle due opzioni di passphrase, si accetta solo l’output di testo e, senza --vault-id o --vault, si usa la cassaforte predefinita dello spazio di lavoro.
--passphrase-file <path>
Solo profilo locale: file privato che contiene la passphrase di uno spazio di lavoro protetto. Le stesse regole di --passphrase-env.
--out-file <path> (-f)
Scrive il valore in un file invece che nel terminale. Le stesse regole di devo secret read.
--force
Disattivato
Sovrascrive il file --out-file se esiste.
--raw
Disattivato
Con output di testo, scrive esattamente il valore sull’output standard, senza un’interruzione di riga alla fine.
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.
<field>
Il campo da scrivere. Obbligatorio. Su Devolutions Cloud e su un profilo locale, qualsiasi campo diverso da password è rifiutato con un errore che dice che lo spazio di lavoro accetta scritture solo nel campo della password.
<entry>
Il nome della voce, o il suo ID con id:<value> o --id. Obbligatorio.
--id
Disattivato
Tratta <entry> come un ID.
--vault-id <id>
Cassaforte della voce, per ID. Su un profilo locale, con un ID di voce e senza --vault-id, è usata la cassaforte predefinita dello spazio di lavoro. Su Devolutions Cloud, senza, è usata la cassaforte corrente.
--value-env <variable>
Nome della variabile d’ambiente che contiene il nuovo valore. Usi esattamente uno tra --value-env o --value-file.
--value-file <path>
File che contiene il nuovo valore.
--passphrase-env <variable>
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.
--passphrase-file <path>
<workspace file>.passphrase
Solo profilo locale: file privato che contiene la passphrase di uno spazio di lavoro protetto. Senza alcuna opzione di passphrase, viene usato il file <workspace file>.passphrase nella cartella del profilo. Rifiutato su Devolutions Cloud e Devolutions Server.
--yes (-y, --confirmed)
Disattivato
Conferma la modifica. Obbligatorio: senza di essa non viene scritto nulla.
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
--in-file <path> (-i)
Input standard
Modello da leggere.
--out-file <path> (-f)
Output standard
File da scrivere. La cartella deve esistere e il percorso non può essere una cartella.
--force
Disattivato
Sovrascrive il file --out-file se esiste. Senza di essa, un file esistente viene rifiutato.
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.
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.
Spazio di lavoro: Tutti i tipi di spazio di lavoro
--shell <shell>
Shell per cui scrivere il codice: bash oppure pwsh (powershell funziona allo stesso modo). Obbligatorio. Qualsiasi altro valore viene rifiutato.
--env-ref <NAME>=<reference>
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 .env.
--check
Disattivato
Controlla i riferimenti, come fa devo secret run --check, senza leggere alcun segreto né scrivere codice di shell. Richiede --output json.
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
--shell <shell>
Shell per cui scrivere il codice: bash o pwsh (powershell fa lo stesso). Obbligatorio. Usi lo stesso valore di enter. Il comando ha bisogno di un output di testo.
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
--shell <shell>
Shell da ispezionare: bash o pwsh (powershell fa la stessa cosa). Obbligatorio. Il comando ha bisogno di --output json.
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.
Spazio di lavoro: Tutti i tipi di spazio di lavoro
<entry>
Il nome della voce, o il suo ID con id:<value> o --id. Obbligatorio.
--id
Disattivato
Tratta <entry> come un ID.
--vault-id <id>
Cassaforte della voce, per ID. Su Devolutions Cloud, senza un’opzione di cassaforte, viene usata la cassaforte corrente.
--vault-name <name>
Cassaforte della voce, per nome.
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
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 per sapere dove va il file.
Spazio di lavoro: Tutti i tipi di spazio di lavoro
--system
Disattivato
Scrive il claim per ogni utente del computer invece che solo per lei. Di solito servono diritti di amministratore.
--executable <path>
Questo devo
L’eseguibile devo da registrare. Il percorso deve essere assoluto e il file deve esistere. Un percorso verso l’host dotnet è rifiutato: registri l’eseguibile devo pubblicato.
--environment <name> (--env)
Variabile d’ambiente aggiuntiva che SecretSpec può passare a devo, per nome esatto o per un prefisso che termina con *, come DEVO_*. 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. RDM_CONFIG_PATH e DEVO_CLI_CONFIG_HOME sono sempre inclusi.
--force
Disattivato
Sostituisce un claim esistente che registra un eseguibile che non è un eseguibile devo. Un claim che punta a un altro eseguibile devo è sostituito senza --force.
--dry-run
Disattivato
Mostra il claim che verrebbe scritto, senza scriverlo.
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
--system
Disattivato
Rimuove il claim per ogni utente del computer invece del proprio.
--dry-run
Disattivato
Mostra il claim che verrebbe rimosso, senza rimuoverlo.
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
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
--vault-id <id>
Cassaforte predefinita del provider. Un segreto può ancora nominare la propria cassaforte. Senza di essa, ogni segreto deve nominare la sua cassaforte.
--workspace-id <id>
Solo profilo locale, e lì obbligatorio: l’ID dello spazio di lavoro, scritto sqlite:<file-name>.db, come sqlite:Connections.db. devo workspace current lo mostra. Rifiutato per Devolutions Cloud e Devolutions Server, i cui URI selezionano invece un contesto.
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
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)
--length <length>
32
Lunghezza della password, da 8 a 4096. 0 o un valore negativo significa il valore predefinito, 32. Qualsiasi altro valore fuori dall’intervallo viene rifiutato.
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)
--syllables <count>
4
Numero di sillabe, ciascuna una consonante e una vocale, da 1 a 64.
--numerics <count>
1
Numero di cifre aggiunte dopo le sillabe, da 0 a 64.
--symbols <count>
1
Numero di simboli da !@#$%^&*? aggiunti alla fine, da 0 a 64.
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)
--words <count>
5
Numero di parole, da 1 a 64.
--separator <text>
-
Testo posto tra le parole. Un valore vuoto significa il valore predefinito, -.
--dictionary <dictionary>
English
Elenco di parole: English (o en), French (o fr) o German (o de), in qualsiasi combinazione di maiuscole. Qualsiasi altro valore è rifiutato.
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)
<pattern>
Lo schema. Obbligatorio, fino a 4096 lettere. Ogni lettera dà un carattere: u lettera maiuscola, l lettera minuscola, d cifra, s simbolo da !@#$%^&*?, x uno qualsiasi di questi. Le lettere sono accettate in qualsiasi combinazione di maiuscole e minuscole; qualsiasi altro carattere è rifiutato. Per esempio, uulldds.
--shuffle
Disattivato
Mescola i caratteri generati, così il loro ordine non segue più il modello.
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)
--out-file <path>
File della chiave privata. Obbligatorio. La cartella deve esistere. Su macOS e Linux, solo l’account utente può leggere il file.
--public-out-file <path>
<out-file>.pub
File della chiave pubblica. Deve essere diverso da --out-file.
--algorithm <algorithm>
rsa
Algoritmo della chiave. rsa è l’unico valore supportato.
--bits <bits>
3072
Dimensione della chiave RSA: 2048, 3072 o 4096. Qualsiasi altro valore viene rifiutato.
--comment <text>
Il suo nome utente
Commento alla fine della chiave pubblica. Non può contenere caratteri di controllo.
--passphrase-env <variable>
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 --passphrase-file, non entrambe. Senza nessuna delle due, la chiave privata non è crittografata.
--passphrase-file <path>
File che contiene la passphrase. Il file deve esistere e non essere vuoto; le interruzioni di riga alla fine vengono ignorate.
--force
Disattivato
Sovrascrive i file di chiave se esistono. Senza di essa, un file esistente viene rifiutato.
Successivo
Ultimo aggiornamento
È stato utile?