> 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/per-devops-e-amministratori/automate/network-and-proxy.md).

# Usare Devolutions CLI dietro un firewall o un proxy

Quali indirizzi contatta Devolutions CLI, perché non ha bisogno di alcuna porta in ingresso, e come timeout, proxy e autenticazione di Windows funzionano su una rete protetta.

Devolutions CLI stesso effettua **richieste HTTPS in uscita verso gli indirizzi di Devolutions Cloud e Devolutions Server a cui accede**, più Devolutions Account per un accesso dal browser a Devolutions Cloud. Non attende connessioni da altri computer. Su una rete bloccata o su un agente di build, di solito è tutto ciò che deve aprire.

## A che cosa si connette Devolutions CLI

<table><thead><tr><th width="220">QUANDO USA</th><th>DEVOLUTIONS CLI SI CONNETTE A</th></tr></thead><tbody><tr><td><strong>Un contesto di Devolutions Cloud</strong></td><td>L’indirizzo che ha indicato con <code>--cloud</code>, per ogni comando che usa questo contesto.</td></tr><tr><td><strong>Accesso tramite browser a Devolutions Cloud</strong> (<code>--oauth</code>)</td><td>Anche <code>https://login.devolutions.com</code>, per accedere, rinnovare la sessione e leggere il profilo. Devolutions CLI rifiuta gli indirizzi di accesso che questo servizio restituisce su un altro host.</td></tr><tr><td><strong>Un contesto di Devolutions Server</strong></td><td>L’indirizzo indicato con <code>--server</code>, per ogni comando che usa questo contesto, compreso l’accesso dal browser. Devolutions CLI rifiuta gli indirizzi di accesso che Devolutions Server restituisce su un altro host.</td></tr><tr><td><strong>Un contesto di profilo locale</strong></td><td>Nessun indirizzo proprio: un profilo locale viene letto da una cartella sul computer.</td></tr><tr><td><code>devo info --cloud &#x3C;url></code> or <code>--server &#x3C;url></code></td><td>Quell’indirizzo, senza un contesto salvato.</td></tr></tbody></table>

Ogni connessione usa HTTPS. Devolutions CLI rifiuta un indirizzo `http` semplice, a meno che non punti al proprio computer.

La preferenza di telemetria (`devo config telemetry`) viene salvata solo sul computer: Devolutions CLI non ha una connessione di telemetria propria.

### Scrivere la regola del firewall

* **Consenta l’HTTPS in uscita** dall’agente o dal computer verso l’indirizzo e la porta di ogni URL di spazio di lavoro e verso `login.devolutions.com` se usa l’accesso dal browser a Devolutions Cloud.
* **Consenta il file `devo`** (`devo.exe` su Windows) se il firewall filtra per programma. I comandi che digita e il processo in background che invia la maggior parte delle richieste allo spazio di lavoro sono lo stesso file. Consulti [Come funziona Devolutions CLI](/cli/it/guide/understand/how-it-works.md).
* **Non apra alcuna porta in ingresso.** Devolutions CLI non ha bisogno di alcuna porta aperta per le connessioni in ingresso.

## Perché non serve alcuna porta in ingresso

<table><thead><tr><th width="220">PARTE</th><th>COME COMUNICA</th></tr></thead><tbody><tr><td><strong>Processo in background</strong></td><td>Su un canale locale del computer: una named pipe su Windows, un file socket su macOS e Linux. Su Windows, le regole di accesso della pipe consentono l’account e l’account di sistema (se Windows rifiuta quelle regole, la pipe mantiene la sicurezza predefinita); su macOS e Linux, solo l’account può aprire il file socket. Ogni richiesta diversa da un controllo dello stato deve anche portare il token della sessione corrente del processo in background. Consulti <a href="/cli/it/guide/understand/platforms.md">Devolutions CLI su Windows, macOS e Linux</a>.</td></tr><tr><td><strong><code>devo mcp</code></strong></td><td>Tramite l’input e l’output standard del processo <code>devo</code> che il client IA avvia. Nessuna porta.</td></tr><tr><td><strong>Accesso dal browser</strong> (<code>--oauth</code>)</td><td>Il browser torna a <code>devo</code> attraverso un listener temporaneo sul computer, aperto al massimo 5 minuti. Per Devolutions Cloud ascolta su <code>localhost</code>, su una porta tra <code>60370</code> e <code>61370</code>. Per Devolutions Server ascolta su <code>127.0.0.1</code>, su una porta libera. Devolutions CLI rifiuta di avviare il listener se <code>localhost</code> non punta solo al computer.</td></tr><tr><td><strong>Accesso con codice dispositivo</strong> (<code>--oauth --use-device-code</code>)</td><td>Nessun listener. Devolutions CLI stampa un indirizzo e un codice, e attende mentre conferma l’accesso in un browser. Lo usi su un computer senza browser.</td></tr></tbody></table>

{% hint style="info" %}
Se le porte da `60370` a `61370` sono tutte in uso, l’accesso dal browser a Devolutions Cloud non può completarsi. Liberi una porta in quell’intervallo, oppure acceda con una chiave dell’applicazione: un accesso con codice dispositivo a Devolutions Cloud non può leggere i dati. Consulti [Accedere a Devolutions Cloud](/cli/it/guide/connect/devolutions-cloud.md).
{% endhint %}

## Impostare il timeout della richiesta

Per impostazione predefinita, Devolutions CLI attende fino a **15 secondi** per ogni richiesta. Su un collegamento lento o attraverso un proxy occupato, dia più tempo a `devo login` con `--timeout`, in secondi, da `3` a `600`:

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

`--timeout` si applica solo alle richieste di quel `devo login`. Non viene salvato nel contesto: i comandi successivi attendono fino a 15 secondi per richiesta. Una richiesta che esaurisce il tempo non riesce con `cloudRequestTimeout` o `serverRequestTimeout`. Consulti [L’accesso non riesce o la sessione è scaduta](/cli/it/aiuto/troubleshooting/sign-in-fails.md).

## Autenticazione di Windows

Con `--windows-auth`, Devolutions CLI accede a Devolutions Server con le credenziali dell’account Windows che esegue `devo`. Non indica una password, e il processo in background usa lo stesso account. Questa opzione è disponibile solo su Windows.

## Proxy

Devolutions CLI non ha **nessuna opzione di proxy** e non imposta un proxy proprio.

Se la rete richiede un proxy, controlli che il computer possa raggiungere l’indirizzo dello spazio di lavoro attraverso di esso prima di accedere, per esempio con `devo info --cloud <url>` o `devo info --server <url>`.

## Certificati

Devolutions CLI non ha un’opzione per saltare la convalida del certificato o per aggiungere un certificato, e non cambia il modo in cui i certificati vengono convalidati.

## Buono a sapersi

* Un contesto di profilo locale non accede ad alcun indirizzo. Consulti [Usare un profilo locale di Devolutions Remote Desktop Manager](/cli/it/guide/connect/local-profile.md).
* Per vedere che cosa invia Devolutions CLI e che cosa resta sul computer, consulti [Quali dati invia Devolutions CLI](/cli/it/guide/understand/privacy.md).
* Se un accesso scade o l’indirizzo non è raggiungibile, consulti [L’accesso non riesce o la sessione è scaduta](/cli/it/aiuto/troubleshooting/sign-in-fails.md).

## Successivo

* [Sign in from a CI pipeline](/cli/it/per-devops-e-amministratori/automate/ci-sign-in.md)
* [Install Devolutions CLI on build agents](/cli/it/per-devops-e-amministratori/automate/install-on-runners.md)
* [Devolutions CLI on Windows, macOS, and Linux](/cli/it/guide/understand/platforms.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/per-devops-e-amministratori/automate/network-and-proxy.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.
QUANDO USA	DEVOLUTIONS CLI SI CONNETTE A
Un contesto di Devolutions Cloud	L’indirizzo che ha indicato con `--cloud`, per ogni comando che usa questo contesto.
Accesso tramite browser a Devolutions Cloud (`--oauth`)	Anche `https://login.devolutions.com`, per accedere, rinnovare la sessione e leggere il profilo. Devolutions CLI rifiuta gli indirizzi di accesso che questo servizio restituisce su un altro host.
Un contesto di Devolutions Server	L’indirizzo indicato con `--server`, per ogni comando che usa questo contesto, compreso l’accesso dal browser. Devolutions CLI rifiuta gli indirizzi di accesso che Devolutions Server restituisce su un altro host.
Un contesto di profilo locale	Nessun indirizzo proprio: un profilo locale viene letto da una cartella sul computer.
`devo info --cloud <url>` or `--server <url>`	Quell’indirizzo, senza un contesto salvato.
PARTE	COME COMUNICA
Processo in background	Su un canale locale del computer: una named pipe su Windows, un file socket su macOS e Linux. Su Windows, le regole di accesso della pipe consentono l’account e l’account di sistema (se Windows rifiuta quelle regole, la pipe mantiene la sicurezza predefinita); su macOS e Linux, solo l’account può aprire il file socket. Ogni richiesta diversa da un controllo dello stato deve anche portare il token della sessione corrente del processo in background. Consulti Devolutions CLI su Windows, macOS e Linux.
`devo mcp`	Tramite l’input e l’output standard del processo `devo` che il client IA avvia. Nessuna porta.
Accesso dal browser (`--oauth`)	Il browser torna a `devo` attraverso un listener temporaneo sul computer, aperto al massimo 5 minuti. Per Devolutions Cloud ascolta su `localhost`, su una porta tra `60370` e `61370`. Per Devolutions Server ascolta su `127.0.0.1`, su una porta libera. Devolutions CLI rifiuta di avviare il listener se `localhost` non punta solo al computer.
Accesso con codice dispositivo (`--oauth --use-device-code`)	Nessun listener. Devolutions CLI stampa un indirizzo e un codice, e attende mentre conferma l’accesso in un browser. Lo usi su un computer senza browser.