Ninja Agent: Konfiguration für die Nutzung über einen Proxy-Server

Thema

In diesem Artikel wird erläutert, wie der NinjaOne-Agent für die Verwendung über einen Proxy-Server konfiguriert wird. 

Umgebung

NinjaOne Endpoint Management

Beschreibung

Ein Proxy-Server leitet den Netzwerkverkehr zwischen einem Gerät und dem Internet weiter. Unternehmen nutzen häufig einen Proxy, um den Datenverkehr zu steuern, zu filtern oder zu überwachen.

In folgenden Fällen müssen Sie Proxy-Einstellungen konfigurieren:

• Für den NinjaOne-Agenten sind keine Proxy-Einstellungen konfiguriert.
• Für den NinjaOne-Agenten sind bereits falsche Proxy-Einstellungen konfiguriert.

Informationen dazu, welche Funktionen über NinjaOne Agent: Unterstützte Funktionen über einen Proxy-Server

Index

• Automatische Proxy-Erkennung für Windows
• Für den NinjaOne-Agenten sind keine Proxy-Einstellungen konfiguriert
  • Lösung nur für Windows-Betriebssysteme
  • Lösung für alle Betriebssysteme
• Für den NinjaOne-Agenten sind bereits Proxy-Einstellungen konfiguriert
  • Lösung nur für Windows-Betriebssysteme
  • Lösung für alle Betriebssysteme

• Proxy für NinjaOne Remote einrichten

Automatische Proxy-Erkennung für Windows

• Die vereinfachte Agent-Bereitstellung macht manuelle Konfigurationen und benutzerdefinierte Skripte in komplexen Netzwerken überflüssig. Diese Automatisierung verkürzt die Einführungszeit für IT-Flotten und ermöglicht es MSPs, einzigartige Umgebungen in großem Maßstab zu verwalten.
• Wenn ein Agent auf einem Windows-Betriebssystem läuft, das eine native Proxy-Konfiguration unterstützt, erkennt der Agent die nativen Einstellungen für die Konnektivität und nutzt diese, sodass eine manuelle Konfiguration des Agenten nicht mehr erforderlich ist.
• Wenn der Agent über die automatisch erkannten Proxy-Einstellungen keine Verbindung herstellen kann, verbindet er sich direkt mit dem NinjaOne-Server, sodass die Agenten mit dem Dashboard verbunden bleiben.

Um diese Funktion zu aktivieren, fügen Sie einen neuen DWORD-Wert zur Windows-Registrierung hinzu:

[HKEY_LOCAL_MACHINESOFTWAREWOW6432NodeNinjaRMM LLCNinjaRMMAgentServer] ProxyAutoDiscovery = 1

Um diese Funktion zu deaktivieren, löschen Sie den Wert oder setzen Sie ihn auf 0.

Wenn für den NinjaOne RMM-Agenten keine Proxy-Einstellungen konfiguriert sind

In diesem Szenario haben Sie eine Organisation für einen neuen Kunden erstellt und müssen den NinjaOne RMM-Agenten Proxy-Einstellungen hinzufügen, damit die NinjaOne-Agenten auf den Proxy-Server verweisen.

Lösung nur für Windows-Betriebssysteme

Fügen Sie die folgenden Registrierungsschlüssel zu jedem Gerät hinzu.

32-Bit-Gerät:

[HKEY_LOCAL_MACHINESOFTWARENinjaRMM LLCNinjaRMMAgentServer]

64-Bit-Gerät:

[HKEY_LOCAL_MACHINESOFTWAREWow6432NodeNinjaRMM LLCNinjaRMMAgentServer]

Beispiel: 

• „ProxyHost“ = „192.168.32.144“(ProxyHost sollte ein Zeichenfolgenwert sein)
• „ProxyPort“ = dword:00000c38 (ProxyPort sollte ein DWORD (32-Bit) sein)

optional:

• "ProxyAuthName" = "SomeUserName"
• „ProxyAuthPassword“ = „aPassword“

Lösung für alle Betriebssysteme

Proxy-Eingabeaufforderungen fragen nach Typ, Host und Port. Benutzername und Passwort sind optional.

Führen Sie den folgenden Befehl aus dem NinjaOne-Agent-Ordner aus:

Windows:

.NinjaRMMAgent.exe /setproxy  -host [IP] -port [PORT] -user [USER] -password [PASSWORD]

Beispiel:

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

Linux:

./ninjarmm-linagent -set-proxy

Mac:

./ninjarmm-macagent -set-proxy

Um die neuen Proxy-Einstellungen zu übernehmen, muss der NinjaOne-Dienst neu gestartet werden. Bitte befolgen Sie die Anweisungen in diesem Artikel, um den Agenten über ein benutzerdefiniertes Skript neu zu starten.

Wenn für den NinjaOne-Agenten bereits Proxy-Einstellungen konfiguriert sind

In diesem Fall müssen Sie die im NinjaOne-Agenten konfigurierten Proxy-Einstellungen entfernen oder ändern.

Lösung nur für Windows-Betriebssysteme

Befolgen Sie die oben genannten Schritte, um die Registrierungsschlüssel für jedes Gerät zu ändern.

Um die neuen Proxy-Einstellungen zu übernehmen, muss der NinjaOne-Dienst neu gestartet werden. Befolgen Sie bitte die Anweisungen in diesem Artikel, um den Agenten über ein benutzerdefiniertes Skript neu zu starten.

Das Proxy-Passwort wird nach der ersten erfolgreichen Anmeldung mit diesem Passwort automatisch ausgeblendet.

Lösung für alle Betriebssysteme

Führen Sie den folgenden Befehl aus dem NinjaOne-Agent-Ordner aus: 

Windows:

 .NinjaRMMAgent.exe /removeproxy

Linux:

 ./ninjarmm-linagent -remove-proxy

Mac:

./ninjarmm-macagent -remove-proxy

Befolgen Sie anschließend die oben genannten Schritte, um den Proxy über die Befehlszeile einzurichten.

Proxy für NinjaOne Remote einrichten

Das Einrichten eines Proxys für einen Spieler oder Streamer erfordert zusätzliche Schritte. NinjaOne Remote unterstützt die Verwendung von HTTP(s)- und SOCKS5-Proxys mit Netzwerkunterstützung. NinjaOne Remote unterstützt auch den HTTP-Proxy, wir empfehlen jedoch dringend, stattdessen HTTP(s) zu verwenden. 

Die Systemumgebungsvariable NC_PROXY muss wie folgt definiert werden:

Hinweis: Auch wenn kein Benutzername und/oder Passwort vorhanden ist, sind die abschließenden Doppelpunkte dennoch erforderlich. (z. B. 192.168.1.1:8080:user: oder 192.168.1.1:8080:

Beim Start überprüft der Player oder Streamer diese Umgebungsvariable und verwendet, sofern sie vorhanden ist und das richtige Format aufweist, diesen Parameter, um die Verbindung über diesen Proxy herzustellen.

Beispiel für die NC_PROXY-Einrichtung unter Windows

Um eine neue Systemvariable zu erstellen, gehen Sie zu Einstellungen > System > Info > Erweiterte Systemeinstellungen > Umgebungsvariablen und klicken Sie dann unter Systemvariablen auf Neu.

Proxy-Einstellungen umgehen 

Wenn der Proxy konfiguriert ist, aber kein Internetzugang über den Proxy besteht, kann der Agent/Patcher eine direkte Internetverbindung erkennen und nahtlos darauf umschalten. Dies ist besonders nützlich in Szenarien, in denen ein Benutzer von einer Umgebung mit einem konfigurierten und funktionierenden Proxy, wie z. B. einer Büroumgebung, an einen anderen Ort wechselt, an dem kein Proxy mehr verfügbar ist, oder umgekehrt.

Wie Sie im Terminal sehen können, müssen Sie den NinjaOne RMM-Agenten neu starten, damit die Proxy-Konfiguration wirksam wird.

Weitere Ressourcen

• Proxy für NinjaOne Remote einrichten