Il existe deux cas ed figure pour lesquels vous aurez besoin d’ajouter vos paramètres de proxy à l’agent NinjaOne . Ce document indique la marche à suivre dans chacun des cas.
Pour plus d’informations sur les fonctionnalités prises en charge par le proxy, veuillez consulter Agent NinjaOne : Fonctionnalités prises en charge par un serveur proxy..
Options :
- L'agent NinjaOne n'a pas de paramètres de proxy configurés
- L'agent NinjaOne a déjà des paramètres de proxy configurés
- Configurer un proxy pour NinjaOne Remote
- Détection automatique de proxy pour Windows
Ressources supplémentaires :
Si l’agent NinjaOne n’a pas de paramètres de proxy configurés :
Dans ce cas de figure, vous avez créé une organisation pour un nouveau client et vous devez ajouter des paramètres de proxy à la base de données de NinjaOne afin que les agents NinjaOne redirigent vers le serveur proxy.
Solutions pour le système d'exploitation Windows uniquement
Ajoutez les clés de registre ci-dessous à chaque appareil.
Remarque importante : Le chemin d'accès est différent selon l'architecture de l'appareil (32 bits, 64 bits)
- 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 chaîne)
- "ProxyPort" = dword:00000c38 (ProxyPort doit être un DWORD (32 bits))
facultatif :
- "ProxyAuthName" = "SomeUserName" (nom d'utilisateur)
- "ProxyAuthPassword" = "aPassword" (mot de passe)
Solutions pour tous les systèmes d'exploitation
Les invites de 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 à partir du 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 tenir compte des nouveaux paramètres de proxy, le logiciel NinjaOne doit être redémarré. Veuillez vous référer à cet article pour redémarrer l’agent à partir d’un script personnalisé.
Si l'agent NinjaOne a déjà des paramètres de proxy configurés :
Dans ce cas de figure, vous devez supprimer ou modifier les paramètres de proxy configurés dans la base de données de NinjaOne ou les modifier.
Solutions pour le système d'exploitation Windows uniquement
Suivez les étapes précédentes pour modifier les clés de registre pour chaque appareil.
Pour tenir compte des nouveaux paramètres de proxy, le logiciel NinjaOne doit être redémarré. Veuillez vous référer à 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.
Solutions pour tous les systèmes d'exploitation
Exécutez la commande suivante à partir de la fenêtre NinjaOne :
- Windows :
.NinjaRMMAgent.exe /removeproxy
- Linux :
./ninjarmm-linagent -remove-proxy
- Mac :
./ninjarmm-macagent -remove-proxy
Puis reprenez les étapes précédentes pour paramétrer le proxy via ligne de commande.
Configurer un proxy pour NinjaOne Remote :
Établir un proxy pour un lecteur ou un streamer nécessite quelques étapes supplémentaires. NinjaOne Remote prend en charge l'utilisation d'un proxy SOCKS5 avec support réseau. Il ne prend cependant pas en charge le proxy HTTP.
Le format de la variable d'environnement système NC_PROXY doit être définie comme suit :
| Paramètres | Description |
|---|---|
|
NC_PROXY |
192.168.1.1:1080:utente:password |
|
192.168.1.1 |
Adresse IP du proxy SOCKS5 |
|
1080 |
Port du proxy SOCKS5 |
|
user |
Nom d'utilisateur pour le proxy |
|
password |
Mot de passe d'un utilisateur donné pour l'accès au proxy |
Au démarrage, le lecteur ou le streamer examine cette variable d'environnement et, si elle existe et si son format est correct, utilise ce paramètre pour établir la connexion via ce proxy.
Exemple d'installation de NC_PROXY pour Windows :
Pour créer une nouvelle variable système, allez dans Paramètres > Système > Informations système > Paramètres avancés du système > Variables d'environnement, puis sous Variables système, cliquez sur Nouveau.
Détection automatique de proxy pour Windows:
- Les clients peuvent désormais déployer des agents plus facilement dans des environnements réseau complexes, alors qu'auparavant la configuration et les scripts étaient manuels. Cela réduira le temps consacré à l'intégration et à la gestion des paramètres de proxy et des déploiements à l'échelle de la flotte pour les départements informatiques, et permettra aux MSP de s'adapter à des environnements uniques et diversifiés.
- Lorsqu'un agent fonctionne sur un système d'exploitation Windows qui prend en charge une configuration proxy native, l'agent détecte et utilise les paramètres natifs pour la connectivité, de sorte que la configuration manuelle de l'agent n'est plus nécessaire.
- Lorsque l'agent n'est pas en mesure de se connecter via les paramètres proxy détectés automatiquement, il se connectera directement au serveur NinjaOne, de sorte que les agents puissent rester connectés 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 fonction, supprimez la valeur ou mettez-la à 0.
Contournement des paramètres du proxy
Lorsque le proxy est configuré, mais qu'il n'y a pas d'accès à l'internet via le proxy, l'Agent/Patcher a la capacité de détecter une connexion directe à l'internet et d'y basculer de manière transparente. Ceci est particulièrement utile dans les scénarios où un utilisateur passe d'un environnement avec un proxy configuré et fonctionnel, tel qu'un bureau, à un autre endroit où il n'y a plus de proxy disponible, ou vice versa.
Comme vous pouvez le lire dans le terminal, pour que la configuration du proxy prenne effet, vous devez redémarrer l'agent NinjaRMM.