Sei già un cliente NinjaOne? Effettua il login per visualizzare le altre guide e gli ultimi aggiornamenti.

Agente Ninja: Configurazione per l’uso di un server proxy

Argomento

Questo articolo illustra come configurare NinjaOne Agent per l'utilizzo tramite un server proxy.

Ambiente

NinjaOne Endpoint management

Descrizione

Un server proxy inoltra il traffico di rete tra un dispositivo e Internet. Le organizzazioni utilizzano spesso un proxy per controllare, filtrare o monitorare il traffico. Quando l'agente NinjaOne viene distribuito in un ambiente controllato da proxy, richiede impostazioni proxy accurate per connettersi alla piattaforma NinjaOne. Impostazioni proxy errate o mancanti impediscono all'agente di comunicare con i servizi NinjaOne.

È necessario configurare le impostazioni proxy nei seguenti casi:

  • L'agente NinjaOne non dispone di impostazioni proxy configurate.
  • L'agente NinjaOne ha già configurate impostazioni proxy errate.

Fare riferimento a NinjaOne Agent: Funzionalità supportate su un server proxy per informazioni sulle funzionalità supportate su un proxy.

Indice

Selezionare un argomento per continuare:

Rilevamento automatico del proxy per Microsoft Windows

Il rilevamento automatico del proxy per Microsoft Windows offre le seguenti funzionalità:

  • La distribuzione semplificata degli agenti elimina la configurazione manuale e la creazione di script personalizzati nelle reti complesse. Questa automazione riduce i tempi di implementazione per i parchi IT e consente ai fornitori di servizi gestiti (MSP) di gestire ambienti specifici su larga scala.
  • Quando un agente è in esecuzione su un sistema operativo Windows che supporta una configurazione proxy nativa, l’agente rileverà e utilizzerà le impostazioni native per la connettività, quindi non sarà più necessario configurare manualmente l’agente.
  • Quando l’agente non è in grado di connettersi tramite le impostazioni proxy rilevate automaticamente, si connetterà direttamente al server NinjaOne, in modo da rimanere connesso alla Dashboard.

Per attivare questa funzionalità, aggiungi un nuovo valore DWORD al Registro di sistema di Windows. Per disattivarla, elimina il valore o impostalo su 0:

[HKEY_LOCAL_MACHINESOFTWAREWOW6432NodeNinjaRMM LLCNinjaRMMAgentServer] ProxyAutoDiscovery = 1
ProxyAuto1.png
Figura 1:Percorso della chiave di registro per il rilevamento automatico del proxy nell’Editor del registro di sistema di Windows (clicca per ingrandire)

Se l’agente NinjaOne non dispone di impostazioni proxy configurate

In questo scenario, è stata creata un’organizzazione per un nuovo cliente ed è necessario aggiungere le impostazioni proxy agli agenti NinjaOne affinché puntino al server proxy.

Soluzione solo per il sistema operativo Windows

Aggiungere le seguenti chiavi di registro a ciascun dispositivo.

Nota importante: il percorso varia a seconda dell’architettura del dispositivo (32 bit, 64 bit).

Dispositivo a 32 bit:

[HKEY_LOCAL_MACHINESOFTWARENinjaRMM LLCNinjaRMMAgentServer]

Dispositivo a 64 bit:

[HKEY_LOCAL_MACHINESOFTWAREWow6432NodeNinjaRMM LLCNinjaRMMAgentServer]

L’esempio seguente mostra i valori del Registro di sistema per un dispositivo a 32 bit o a 64 bit:

  • "ProxyHost" = "192.168.32.144" (ProxyHost deve essere un valore stringa)
  • "ProxyPort" = dword:00000c38 (ProxyPort deve essere un valore DWORD (32 bit))

I seguenti valori di autenticazione sono facoltativi:

  • "ProxyAuthName" = "SomeUserName"
  • "ProxyAuthPassword" = "aPassword"

Soluzione per tutti i sistemi operativi

Le schermate del proxy chiederanno il tipo, l'host e la porta. Nome utente e password sono opzionali.

  1. Eseguire il seguente comando dalla cartella dell'agente NinjaOne:

Windows:

.NinjaRMMAgent.exe /setproxy  -host [IP] -port [PORT] -user [USER] -password [PASSWORD]
Nota importante: questi parametri consentono di applicare le impostazioni del proxy in modo silenzioso e in blocco. È possibile eseguire questo comando da un [VERIFICA: inserire il titolo effettivo dell’articolo] all’interno di NinjaOne.

Esempio

.NinjaRMMAgent.exe /setproxy -host 127.0.0.1 -port 80 -user root -password helloworld

Linux:

./ninjarmm-linagent -set-proxy

Apple macOS:

./ninjarmm-macagent -set-proxy
  1. Riavviare il servizio NinjaOne per applicare le nuove impostazioni proxy. Seguire la procedura "Script personalizzato: Riavvia NinjaRMMAgent" per riavviare l'agente da uno script personalizzato.

Se l'agente NinjaOne dispone già di impostazioni proxy configurate

In questo caso, è necessario rimuovere o modificare le impostazioni proxy configurate nell’agente NinjaOne.

Soluzione solo per il sistema operativo Windows

  1. Seguire i passaggi " Solo per il sistema operativo Windows " nella sezione "Se l’agente NinjaOne non dispone di impostazioni proxy configurate " di questo articolo per modificare le chiavi di registro per ciascun dispositivo.
  2. Riavviare il servizio NinjaOne per applicare le nuove impostazioni proxy. Seguire i passaggi descritti in " Script personalizzato: Riavvia NinjaRMMAgent" per riavviare l’agente tramite uno script personalizzato.

NinjaOne nasconde automaticamente la password del proxy dopo il primo accesso riuscito.

Soluzione per tutti i sistemi operativi

  1. Esegui il seguente comando dalla cartella dell’agente NinjaOne:

Windows:

.NinjaRMMAgent.exe /removeproxy

Linux:

./ninjarmm-linagent -remove-proxy

macOS:

./ninjarmm-macagent -remove-proxy
  1. Seguire i passaggi della sezione "Soluzione per tutti i sistemi operativi " nella sezione "Se l'agente NinjaOne non ha le impostazioni proxy configurate " di questo articolo per configurare il proxy tramite la riga di comando.

Configurazione di un proxy per Ninja Remote

La configurazione di un proxy per un player o uno streamer richiede passaggi aggiuntivi.

Il supporto proxy di Ninja Remote include quanto segue:

  • Ninja Remote supporta l’uso di proxy HTTP, HTTPS e SOCKS5 con supporto di rete. Ninja Remote supporta anche il proxy HTTP, ma si consiglia vivamente di utilizzare invece HTTPS.
  • Ninja Remote utilizza le impostazioni di configurazione del proxy memorizzate in una variabile d’ambiente del sistema Windows.

Procedura di configurazione di NC_PROXY per Windows 11

  1. In Windows 11, digita " Modifica variabili d'ambiente per il tuo account " nella barra di ricerca di Windows.
  2. Si aprirà la finestra " Variabili d'ambiente ". Fare clic su "Nuovo " nella sezione " Variabili del sistema ".
  3. Inserire "NC_PROXY" come nome della variabile e inserire il valore della variabile, come mostrato nella tabella seguente.
Proxy Setup_NinjaOneRemmoteExample.png
Figura 2:Aggiungi nuova variabile d’ambiente di sistema (clicca per ingrandire)

È necessario definire la variabile d’ambiente di sistema NC_PROXY nel formato seguente:

ParametriDescrizione

NC_PROXY

192.168.1.1:1080:Nome utente:Password

192.168.1.1

Indirizzo IP del proxy SOCKS5

http(s)://192.168.1.1

Indirizzo IP del proxy HTTP o HTTPS. 

  • Assicurarsi di includere il prefisso del protocollo (ad esempio, http://192.168.1.1 o https://192.168.1.1). 
  • Senza il prefisso, il Proxy è rilevato come Proxy SOCKS5.

1080

Porta del proxy (8080 è il valore predefinito comune per i proxy HTTPS)

Utenti

Nome utente per il proxy (lasciare vuoto se non è presente alcun utente)

Password

Password per il nome utente (lasciare vuoto se non è presente una password)

Anche in assenza di nome utente o password, includere i due punti finali. (ad esempio, 192.168.1.1:8080:user: o 192.168.1.1:8080:)

All'avvio, il lettore o lo streamer esamina questa variabile d'ambiente e, se esiste e ha un formato corretto, utilizza quel parametro per stabilire la connessione tramite quel Proxy.

Bypass delle impostazioni proxy

Quando il proxy è configurato, ma non è disponibile l’accesso a Internet tramite il proxy, l’agente e il patcher sono in grado di rilevare una connessione diretta a Internet e di passare senza interruzioni alla connessione diretta. Questo comportamento di bypass del proxy è particolarmente utile in scenari in cui un utente passa da un ambiente con un proxy configurato e funzionante, come ad esempio un ufficio, a una sede diversa in cui non è più disponibile un proxy, o viceversa.

Per la configurazione del proxy che abbia effetto, riavviare l’agente NinjaOne.

Risorse aggiuntive

Per altre informazioni sulla configurazione di un proxy per Ninja Remote, consultare la sezione Configurazione di un proxy per Ninja Remote riportata sopra.

Domande frequenti

Passi successivi