> 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/quick-start.md). # Avvio rapido Installi Devolutions CLI, acceda alla cassaforte ed esegua un comando con un segreto che non mostra mai, in circa cinque minuti. Alla fine di questa pagina eseguirà un comando che riceve una password dalla cassaforte Devolutions, senza che la password compaia nel terminale, nei file o nella cronologia della shell. Servono circa cinque minuti. Serve un account su Devolutions Cloud o Devolutions Server, oppure un profilo locale di Devolutions Remote Desktop Manager, con almeno una voce che può leggere. {% stepper %} {% step %} ### Installare Devolutions CLI Devolutions CLI arriva come archivio per la piattaforma. Lo estragga in una cartella, aggiunga quella cartella al `PATH`, poi verifichi che il terminale trovi `devo` (`devo.exe` su Windows): ```bash devo --help ``` Altri modi per installarlo, e le piattaforme supportate, sono in [Installare Devolutions CLI](/cli/it/riferimento/installation.md). {% endstep %} {% step %} ### Accedere allo spazio di lavoro Salvi lo spazio di lavoro come **contesto**, un nome che userà d’ora in poi. Il contesto a cui accede diventa quello corrente. {% tabs %} {% tab title="Devolutions Cloud" %} ```bash devo login my-cloud --cloud https://.devolutions.app --oauth ``` Il browser si apre per consentire l’accesso. Su un computer senza browser, acceda invece con una chiave applicazione: veda [Accedere a Devolutions Cloud](/cli/it/guide/connect/devolutions-cloud.md). {% endtab %} {% tab title="Devolutions Server" %} ```bash devo login my-server --server https:// --oauth ``` Il browser si apre per consentire l’accesso. Altri metodi, come una chiave API o l’autenticazione Windows, sono in [Accedere a Devolutions Server](/cli/it/guide/connect/devolutions-server.md). {% endtab %} {% tab title="Local profile" %} ```bash devo login my-local --sqlite ``` Sostituisca `` con la cartella del profilo di Devolutions Remote Desktop Manager che contiene lo spazio di lavoro locale. Non c’è accesso: un contesto locale punta solo a quella cartella. {% endtab %} {% endtabs %} {% endstep %} {% step %} ### Trovare il riferimento di una password Chieda a Devolutions CLI i riferimenti di una voce. L’elenco indica dove si trova ogni segreto, mai il segreto stesso. ```bash devo entry references "" --vault-name "" ``` Copi il riferimento del campo `password`. Inizia con `devo://`. {% hint style="info" %} Possono comparire due tipi di riferimenti. Un **riferimento con nome** usa i nomi dello spazio di lavoro, della cassaforte e della voce, quindi è facile da leggere. Un **riferimento canonico** (`devo://ws/…/vault/…/entry/…/field/…`) usa gli ID, quindi continua a funzionare se una voce viene rinominata. Su Devolutions Server questo comando elenca solo riferimenti canonici. Veda [Trovare il riferimento di un segreto](/cli/it/guide/secrets/find-a-reference.md). {% endhint %} {% endstep %} {% step %} ### Eseguire un comando con il segreto Passi il riferimento a `devo secret run`. Devolutions CLI legge la password dalla cassaforte, la mette in una variabile d’ambiente per quel solo comando e lo avvia. Tutto ciò che segue `--` è il comando. {% tabs %} {% tab title="PowerShell" %} ```powershell devo secret run --env-ref DEMO_SECRET= -- pwsh -NoProfile -Command 'Write-Output $env:DEMO_SECRET' ``` {% endtab %} {% tab title="Bash" %} ```bash devo secret run --env-ref DEMO_SECRET= -- sh -c 'echo "$DEMO_SECRET"' ``` {% endtab %} {% endtabs %} Il comando ha ricevuto la password, ma il terminale mostra ``: Devolutions CLI nasconde i valori risolti in tutto ciò che il comando stampa. Quando il comando termina, la variabile sparisce. Non è mai esistita nella shell. Sostituisca l’esempio con il proprio programma, per esempio una migrazione di database o uno script di distribuzione che legge la password da una variabile d’ambiente. {% hint style="warning" %} Il mascheramento protegge ciò che il comando stampa, non ciò che fa. Un programma che riceve un segreto può comunque scriverlo in un file o inviarlo da qualche parte. Esegua solo programmi a cui affida i segreti. Veda [Che cosa resta nascosto e che cosa no](/cli/it/guide/understand/security-model.md). {% endhint %} {% endstep %} {% step %} ### Controllare prima di eseguire (facoltativo) Aggiunga `--check` per accertarsi che il comando esista e che ogni riferimento sia ben formato, senza leggere alcun segreto né avviare nulla: ```bash devo secret run --check --env-ref DEMO_SECRET= -- ``` Altre opzioni, come più segreti insieme, un limite di tempo o un file di avvio, sono in [Eseguire un comando con i suoi segreti](/cli/it/guide/secrets/run-with-secrets.md). {% endstep %} {% endstepper %} ## Fatto. Che cosa segue?
Ripulire i file .envTenga i file .env nel repository, con riferimenti al posto delle password.Togliere le password da un file .env
Lavorare in sicurezza con gli agenti IALasci che un agente esegua comandi che richiedono credenziali, senza che i valori raggiungano la trascrizione.Dare una credenziale a un agente senza esporla
AutomatizzarloAcceda da una pipeline CI senza un browser e senza una richiesta.Accedere da una pipeline CI
--- # 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/quick-start.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.