> 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/connect/devolutions-cloud.md).

# Accedere a Devolutions Cloud

Accedere a Devolutions Cloud da Devolutions CLI con il browser, oppure con una chiave dell’applicazione e un segreto per script e pipeline.

Acceda una volta e Devolutions CLI salva Devolutions Cloud come contesto, così ogni comando successivo lo usa senza chiedere di nuovo. Usi il browser quando lavora al computer, e una chiave dell’applicazione quando uno script o una pipeline accede al posto suo.

Le serve l’indirizzo del Devolutions Cloud, per esempio `https://<your-organization>.devolutions.app`. Usi un indirizzo `https`.

## Scegliere l’opzione giusta

<table><thead><tr><th width="230">SCELGA</th><th>CHE COSA SUCCEDE</th><th>LO USI QUANDO</th></tr></thead><tbody><tr><td><strong>Accesso dal browser</strong> (<code>--oauth</code>)</td><td>Il browser si apre su Devolutions Account. Devolutions CLI conserva la sessione nell’archivio sicuro del sistema operativo e la rinnova da solo.</td><td>Lavora al suo computer.</td></tr><tr><td><strong>Chiave dell’applicazione</strong> (<code>--application-key</code>)</td><td>Devolutions CLI accede con una chiave dell’applicazione e il suo segreto. Il segreto è letto da una variabile d’ambiente o da un file, mai digitato sulla riga di comando.</td><td>Uno script, un’attività pianificata o una pipeline CI accede senza che ci sia nessuno.</td></tr></tbody></table>

## Accedere con il suo browser

1. Esegua `devo login` con un nome di contesto a sua scelta:

   ```bash
   devo login <context-name> --cloud https://<your-organization>.devolutions.app --oauth
   ```
2. Il browser si apre. Acceda al proprio account Devolutions. Se il browser non si apre, o si apre in background, copi l’indirizzo mostrato nel terminale in un browser.

Il terminale conferma l’accesso e il nuovo contesto diventa quello corrente.

{% hint style="warning" %}
`--use-device-code` consente di accedere da un altro dispositivo, per esempio su un computer remoto senza browser. Ma un accesso con codice dispositivo a Devolutions Cloud non riceve la chiave che apre i dati della cassaforte: può solo controllarne lo stato e disconnettersi. Per lavorare con casseforti e segreti, acceda con il browser sullo stesso computer, oppure usi una chiave dell’applicazione.

La variabile d’ambiente `DEVO_CLI_USE_DEVICE_CODE` ha lo stesso effetto: quando è impostata su un valore diverso da vuoto, `0` o `false`, ogni accesso `--oauth` usa un codice dispositivo, anche senza `--use-device-code`. La cancelli prima di accedere a Devolutions Cloud con il browser.
{% endhint %}

## Accedere con una chiave dell’applicazione

1. Metta il segreto dell’applicazione in una variabile d’ambiente o in un file che solo lei può leggere. Non lo digiti sulla riga di comando.
2. Esegua `devo login` con la chiave dell’applicazione e il nome della variabile, oppure il percorso del file:

{% tabs %}
{% tab title="Environment variable" %}

```bash
devo login <context-name> --cloud https://<your-organization>.devolutions.app --application-key <application-key> --application-secret-env <VARIABLE_NAME>
```

{% endtab %}

{% tab title="File" %}

```bash
devo login <context-name> --cloud https://<your-organization>.devolutions.app --application-key <application-key> --application-secret-file <path-to-file>
```

{% endtab %}
{% endtabs %}

Devolutions CLI verifica la chiave e il segreto con il proprio Devolutions Cloud prima di salvare il contesto.

{% hint style="info" %}
Devolutions CLI non salva il segreto dell’applicazione. Salva il nome della variabile o il percorso del file e rilegge il segreto ogni volta che un comando ne ha bisogno. Tenga impostata quella variabile, o quel file al suo posto, per tutto il tempo in cui usa il contesto.
{% endhint %}

Per le pipeline, consulti [Accedere da una pipeline CI](/cli/it/per-devops-e-amministratori/automate/ci-sign-in.md).

## Verificare e terminare la sessione

* `devo status` mostra il contesto corrente e se ha un accesso. Aggiunga `--online` per contattare Devolutions Cloud e confermare che l’accesso funziona ancora.
* `devo logout` cancella l’accesso del contesto corrente, o del contesto che nomina. Il contesto resta, quindi può accedere di nuovo con lo stesso nome.
* `devo context delete <context-name> --yes` rimuove il contesto e la sua sessione memorizzata.

## Buono a sapersi

* `--timeout` imposta per quanto tempo, in secondi, Devolutions CLI attende ogni richiesta di accesso: da `3` a `600`, `15` per impostazione predefinita.
* `--no-set-current` salva il contesto senza renderlo quello corrente. Se nessun contesto di Devolutions Cloud è ancora corrente, diventa comunque quello che usa `--source cloud`.
* Un nome di contesto può essere usato da un solo tipo di spazio di lavoro. Se il nome esiste già per un profilo locale o un Devolutions Server, scelga un altro nome oppure elimini prima l’altro contesto.
* L’accesso dal browser ha bisogno dell’archivio sicuro del sistema operativo. Consulti [Quali dati invia Devolutions CLI](/cli/it/guide/understand/privacy.md).
* L’accesso non riesce o la sessione è scaduta? Consulti [L’accesso non riesce o la sessione è scaduta](/cli/it/aiuto/troubleshooting/sign-in-fails.md).

## Successivo

* [Find the reference to a secret](/cli/it/guide/secrets/find-a-reference.md)
* [Switch between workspaces](/cli/it/guide/connect/switch-workspaces.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/connect/devolutions-cloud.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.