Agent Ninja : Configuration pour utilisation sur un serveur proxy

Sujet

Cet article explique comment configurer l'agent NinjaOne pour une utilisation via un serveur proxy. 

Environnement

Gestion des terminaux NinjaOne

Description

Un serveur proxy achemine le trafic réseau entre un appareil et Internet. Les entreprises utilisent souvent un proxy pour contrôler, filtrer ou surveiller le trafic.

Vous devez configurer les paramètres de proxy dans les cas suivants :

• L'agent NinjaOne ne dispose pas de paramètres de proxy configurés.
• L'agent NinjaOne dispose déjà de paramètres de proxy incorrects.

Consultez la section Agent NinjaOne : fonctionnalités prises en charge via un serveur proxy pour savoir quelles fonctionnalités sont prises en charge via un proxy

Index

• L'agent NinjaOne ne dispose pas de paramètres de proxy configurés
  • Solution pour le système d'exploitation Windows uniquement
  • Solution pour tous les systèmes d'exploitation
• L'agent NinjaOne dispose déjà de paramètres de proxy configurés
  • Solution pour le système d'exploitation Windows uniquement
  • Solution pour tous les systèmes d'exploitation
• Configurer un proxy pour NinjaOne Remote
• Détection automatique du proxy pour Windows

Si l'agent RMM NinjaOne ne dispose pas de paramètres de proxy configurés

Dans ce scénario, vous avez créé une organisation pour un nouveau client et devez ajouter des paramètres de proxy aux agents RMM NinjaOne afin que ceux-ci pointent vers le serveur proxy.

Solution pour le système d'exploitation Windows uniquement

Ajoutez les clés de registre ci-dessous à chaque appareil.

Appareil 32 bits :

[HKEY_LOCAL_MACHINESOFTWARENinjaRMM LLCNinjaRMMAgentServer]

Appareil 64 bits :

[HKEY_LOCAL_MACHINESOFTWAREWow6432NodeNinjaRMM LLCNinjaRMMAgentServer]

Exemple : 

• « ProxyHost » = « 192.168.32.144 »(ProxyHost doit être une valeur de type chaîne)
• « ProxyPort » = dword:00000c38 (ProxyPort doit être un DWORD (32 bits))

facultatif :

• « ProxyAuthName » = « SomeUserName »
• « ProxyAuthPassword » = « aPassword »

Solution pour tous les systèmes d'exploitation

Les invites du proxy vous demanderont le type, l'hôte et le port. Le nom d'utilisateur et le mot de passe sont facultatifs.

Exécutez la commande suivante depuis le dossier de l'agent NinjaOne :

Windows :

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

Exemple :

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

Linux :

./ninjarmm-linagent -set-proxy

Mac :

./ninjarmm-macagent -set-proxy

Pour que les nouveaux paramètres de proxy soient pris en compte, le service NinjaOne doit être redémarré. Veuillez suivre les instructions de cet article pour redémarrer l'agent à partir d'un script personnalisé.

Si l'agent NinjaOne dispose déjà de paramètres de proxy configurés

Dans ce cas, vous devez supprimer ou modifier les paramètres de proxy configurés dans l'agent NinjaOne.

Solution pour le système d'exploitation Windows uniquement

Suivez les étapes ci-dessus pour modifier les clés de registre de chaque appareil.

Pour que les nouveaux paramètres de proxy soient pris en compte, le service NinjaOne doit être redémarré. Veuillez suivre cet article pour redémarrer l'agent à partir d'un script personnalisé.

Le mot de passe du proxy est automatiquement masqué après la première connexion réussie à l'aide de ce mot de passe.

Solution pour tous les systèmes d'exploitation

Exécutez la commande suivante à partir du dossier de l'agent NinjaOne : 

Windows :

 .NinjaRMMAgent.exe /removeproxy

Linux :

 ./ninjarmm-linagent -remove-proxy

Mac :

./ninjarmm-macagent -remove-proxy

Ensuite, suivez les étapes ci-dessus pour configurer le proxy via la ligne de commande.

Configurer un proxy pour NinjaOne Remote

La configuration d'un proxy pour un joueur ou un streamer nécessite des étapes supplémentaires. NinjaOne Remote prend en charge l'utilisation de proxys HTTP(s) et SOCKS5 avec prise en charge réseau. Cependant, il ne prend pas en charge le proxy HTTP. 

Le format de la variable d'environnement système NC_PROXY doit être défini comme suit :

Remarque : même s'il n'y a pas de nom d'utilisateur et/ou de mot de passe, les deux points à la fin sont toujours obligatoires. (par exemple : 192.168.1.1:8080:user: ou 192.168.1.1:8080:

Au démarrage, le lecteur ou le diffuseur examine cette variable d'environnement et, si elle existe et est au format correct, utilise ce paramètre pour établir la connexion via ce proxy.

Exemple de configuration de NC_PROXY pour Windows

Pour créer une nouvelle variable système, allez dans Paramètres > Système > À propos > Paramètres système avancés > Variables d'environnement, puis sous Variables système, cliquez sur Nouveau.

Détection automatique du proxy pour Windows

• Les clients peuvent désormais déployer des agents plus facilement dans des environnements réseau complexes où, auparavant, cela nécessitait une configuration manuelle et l'utilisation de scripts. Cela permettra aux services informatiques de réduire le temps consacré à la mise en place et à la gestion des paramètres de proxy et des déploiements à l'échelle du parc, et permettra aux MSP de s'adapter à des environnements uniques et variés. 
• Lorsqu'un agent s'exécute sur un système d'exploitation Windows prenant en charge une configuration de proxy native, l'agent détecte et utilise les paramètres natifs pour la connectivité, de sorte qu'aucune configuration manuelle de l'agent n'est plus nécessaire.
• Lorsque l'agent ne parvient pas à se connecter via les paramètres de proxy détectés automatiquement, il se connecte directement au serveur NinjaOne, ce qui lui permet de rester connecté au tableau de bord.

Pour activer cette fonctionnalité, ajoutez une nouvelle valeur DWORD au registre Windows :

[HKEY_LOCAL_MACHINESOFTWAREWOW6432NodeNinjaRMM LLCNinjaRMMAgentServer] ProxyAutoDiscovery = 1

Pour désactiver cette fonctionnalité, supprimez la valeur ou définissez-la sur 0.

Contournement des paramètres de proxy 

Lorsque le proxy est configuré, mais qu'il n'y a pas d'accès à Internet via ce proxy, l'Agent/Patcher est capable de détecter une connexion Internet directe et de basculer vers celle-ci de manière transparente. Cela est particulièrement utile dans les cas où un utilisateur passe d'un environnement avec un proxy configuré et fonctionnel, tel qu'un bureau, à un autre endroit où le proxy n'est plus disponible, ou inversement.

Comme vous pouvez le voir dans le terminal, pour que la configuration du proxy prenne effet, vous devez redémarrer l'agent NinjaOne RMM.

Ressources supplémentaires

• Configurer un proxy pour NinjaOne Remote