> 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-server.md).

# Accedere a Devolutions Server

Accedere a Devolutions Server da Devolutions CLI con il browser, una chiave API, un nome utente e una password, oppure l’autenticazione di Windows.

Acceda una volta e Devolutions CLI salva Devolutions Server come contesto, così ogni comando successivo lo usa senza chiedere di nuovo. Devolutions Server offre più metodi di accesso degli altri tipi di spazio di lavoro, quindi scelga quello che corrisponde a chi, o a che cosa, accede.

Le serve l’indirizzo del Devolutions Server, per esempio `https://<your-server-address>`. Usi un indirizzo `https`.

## Scegliere l’opzione giusta

<table><thead><tr><th width="250">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 per l’accesso. 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 API</strong> (<code>--api-key-env</code> o <code>--api-key-file</code>)</td><td>Devolutions CLI accede con una chiave API letta da una variabile d’ambiente o da un file.</td><td>Uno script o una pipeline CI accede senza nessuno presente.</td></tr><tr><td><strong>Nome utente e password</strong> (<code>--username</code> con <code>--password-env</code> o <code>--password-file</code>)</td><td>Devolutions CLI accede con un account di Devolutions Server. La password viene letta da una variabile d’ambiente o da un file.</td><td>Usa un account Devolutions Server, un account di dominio o un utente dell’applicazione.</td></tr><tr><td><strong>Autenticazione Windows</strong> (<code>--windows-auth</code>)</td><td>Devolutions CLI accede come il proprio account Windows corrente. Nessuna password da indicare.</td><td>È su Windows e il proprio Devolutions Server accetta l’autenticazione Windows.</td></tr></tbody></table>

Usi esattamente un metodo per accesso. Devolutions CLI rifiuta un comando che ne combina due.

## Accedere

{% tabs %}
{% tab title="Browser" %}

```bash
devo login <context-name> --server https://<your-server-address> --oauth
```

Il browser si apre. Se non si apre, copi l’indirizzo mostrato nel terminale in un browser.

Su un computer senza browser, aggiunga `--use-device-code` e segua le istruzioni nel terminale per accedere da un altro dispositivo. Se la pagina di accesso chiede un codice di conferma, inserisca il codice mostrato nel terminale.
{% endtab %}

{% tab title="API key" %}
Metta la chiave API in una variabile d’ambiente o in un file che solo lei può leggere, quindi:

```bash
devo login <context-name> --server https://<your-server-address> --api-key-env <VARIABLE_NAME>
```

Oppure, da un file:

```bash
devo login <context-name> --server https://<your-server-address> --api-key-file <path-to-file>
```

{% endtab %}

{% tab title="Username and password" %}
Metta la password in una variabile d’ambiente o in un file che solo lei può leggere, quindi:

```bash
devo login <context-name> --server https://<your-server-address> --username <username> --password-env <VARIABLE_NAME>
```

* Per un account di dominio, aggiunga `--domain-id <domain-id>`.
* Per un utente dell’applicazione, aggiunga `--as-application`.
  {% endtab %}

{% tab title="Windows authentication" %}

```bash
devo login <context-name> --server https://<your-server-address> --windows-auth
```

Disponibile solo su Windows.
{% endtab %}
{% endtabs %}

Devolutions CLI controlla l’accesso con il Devolutions Server prima di salvare il contesto. Il nuovo contesto diventa quello corrente.

{% hint style="info" %}
Devolutions CLI non salva chiavi API né password. Salva il nome della variabile d’ambiente o il percorso del file e rilegge il valore 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 %}

## Verificare e terminare la sessione

* `devo status` mostra il contesto corrente e se ha un accesso. Aggiunga `--online` per contattare Devolutions Server e confermare che l’accesso funziona ancora.
* `devo info` mostra informazioni sul Devolutions Server. Aggiunga `--private` per includere le informazioni che richiedono l’accesso.
* `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 Server è ancora corrente, diventa comunque quello che usa `--source server`.
* Con nome utente e password o autenticazione di Windows, la richiesta di accesso include il nome del computer e il nome utente locale. Consulti [Quali dati invia Devolutions CLI](/cli/it/guide/understand/privacy.md).
* `devo entry references` elenca solo riferimenti canonici per le voci di Devolutions Server. Consulti [Confrontare i tipi di spazio di lavoro](/cli/it/guide/understand/workspace-types.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)
* [Sign in from a CI pipeline](/cli/it/per-devops-e-amministratori/automate/ci-sign-in.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-server.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.