Ci sono due casi in cui avrai bisogno di aggiungere le impostazioni del proxy all’agente NinjaOne . Il presente documento illustra le azioni da compiere in entrambi i casi.
Per informazioni sulle funzionalità supportate su proxy, fai riferimento al seguente materiale: Agente NinjaOne: Funzionalità supportate su un server proxy.
Opzioni:
- L'agente NinjaOne non ha le impostazioni del proxy configurate
- L'agente NinjaOne ha già le impostazioni del proxy configurate
- Impostare un proxy per NinjaOne Remote
- Rilevamento automatico dei proxy per Windows
Risorse aggiuntive:
Se l'agente NinjaOne non le impostazioni proxy già configurate:
In questo scenario, hai creato un'organizzazione per un nuovo cliente e hai bisogno di aggiungere le impostazioni del proxy agli agenti NinjaOne in modo che gli agenti NinjaOne puntino al server proxy.
Soluzione valida unicamente per il sistema operativo Windows
Aggiungi a ciascun dispositivo le chiavi di registro riportate di seguito.
Nota importante: Il percorso è diverso a seconda dell'architettura del dispositivo (32 bit, 64 bit)
- Dispositivi a 32 bit:
[HKEY_LOCAL_MACHINESOFTWARENinjaRMM LLCNinjaRMMAgentServer]
- Dispositivi a 64 bit:
[HKEY_LOCAL_MACHINESOFTWAREWow6432NodeNinjaRMM LLCNinjaRMMAgentServer]
Esempio:
- "ProxyHost" = "192.168.32.144" (ProxyHost deve essere un valore stringa)
- "ProxyPort" = dword:00000c38 (ProxyPort deve essere un DWORD (32 bit))
opzionale:
- "ProxyAuthName" = "SomeUserName"
- "ProxyAuthPassword" = "aPassword"
Soluzione valida per tutti i sistemi operativi
I prompt del proxy chiederanno il tipo, l'host e la porta. Il nome utente e la password sono facoltativi.
Esegui il seguente comando dalla cartella dell'agente NinjaOne:
- Windows:
.NinjaRMMAgent.exe /setproxy -host [IP] -port [PORT] -user [USER] -password [PASSWORD]
Esempio:
.NinjaRMMAgent.exe /setproxy -host 127.0.0.1 -port 80 -user root -password helloworld
- Linux:
./ninjarmm-linagent -set-proxy
- Mac:
./ninjarmm-macagent -set-proxy
Prima che tenga conto delle nuove impostazioni del proxy, il servizio NinjaOne deve essere riavviato. Fai riferimento a questo articolo per riavviare l'agente con uno script personalizzato.
Se l'agente NinjaOne ha già le impostazioni proxy configurate:
In questo caso, dovrai rimuovere o modificare le impostazioni del proxy configurate nell’agente NinjaOne .
Soluzione valida unicamente per il sistema operativo Windows
Segui i passaggi forniti sopra per modificare le chiavi di registro per ogni dispositivo.
Prima che tenga conto delle nuove impostazioni del proxy, il servizio NinjaOne deve essere riavviato. Fai riferimento a questo articolo per riavviare l'agente con uno script personalizzato.
La password del proxy viene nascosta automaticamente dopo il primo accesso riuscito con la password in questione.
Soluzione valida per tutti i sistemi operativi
Esegui il seguente comando dalla cartella dell’agente NinjaOne :
- Windows:
.NinjaRMMAgent.exe /removeproxy
- Linux:
./ninjarmm-linagent -remove-proxy
- Mac:
./ninjarmm-macagent -remove-proxy
Quindi, segui i passaggi forniti in precedenza per configurare il proxy tramite riga di comando.
Impostare un proxy per NinjaOne Remote:
La creazione di un proxy per un player o uno streamer richiede ulteriori passaggi. NinjaOne Remote supporta l'uso del proxy SOCKS5 con supporto di rete. Tuttavia, non supporta il proxy HTTP.
La variabile d'ambiente di sistema in formato NC_PROXY deve essere definita come segue:
| Parametro | Descrizione |
|---|---|
|
NC_PROXY |
192.168.1.1:1080:utente:password |
|
192.168.1.1 |
Indirizzo IP del proxy SOCKS5 |
|
1080 |
Porta proxy SOCKS5 |
|
utente |
Nome utente per il proxy |
|
password |
Password per un determinato utente per l'accesso al proxy |
Durante l'avvio, il player o lo streamer esaminano questa variabile d'ambiente e, se esiste e ha un formato corretto, utilizzano questo parametro per stabilire la connessione tramite proxy.
Esempio di impostazione di NC_PROXY per Windows:
Per creare una nuova variabile di sistema, vai su Impostazioni > Sistema > Informazioni su > Impostazioni di sistema avanzate > Variabili d'ambiente, quindi in Variabili di sistema clicca su Nuovo.
Rilevamento automatico dei proxy per Windows
- I clienti possono ora distribuire più facilmente gli agenti in ambienti di rete complessi, dove in precedenza venivano configurati manualmente e gestiti da script. Ciò ridurrà il tempo dedicato all'onboarding e alla gestione delle impostazioni e delle distribuzioni proxy a livello di flotta per i dipartimenti IT e consentirà agli MSP di scalare su ambienti unici e diversi.
- Quando un agente è in esecuzione su un sistema operativo Windows che supporta una configurazione proxy nativa, l'agente rileva e utilizza le impostazioni native per la connettività, per cui non è più necessaria la configurazione manuale dell'agente.
- Quando l'agente non è in grado di connettersi attraverso le impostazioni proxy rilevate automaticamente, si connetterà direttamente al server NinjaOne, in modo che gli agenti possano rimanere connessi al dashboard.
Per abilitare questa funzione, aggiungere un nuovo valore DWORD al registro di Windows:
[HKEY_LOCAL_MACHINESOFTWAREWOW6432NodeNinjaRMM LLCNinjaRMMAgentServer] ProxyAutoDiscovery = 1
Per disattivare questa funzione, eliminare il valore o impostarlo a 0.
Bypassare le impostazioni del proxy
Quando il proxy è configurato, ma non c'è accesso a Internet attraverso il proxy, l'Agente/Patcher ha la capacità di rilevare una connessione Internet diretta e di passare ad essa senza problemi. Ciò è particolarmente utile negli scenari in cui un utente passa da un ambiente con un proxy configurato e funzionante, ad esempio un ufficio, a un altro luogo in cui non è più disponibile un proxy o viceversa.
Come si può leggere nel terminale, affinché la configurazione del proxy abbia effetto, è necessario riavviare l'Agente.