Setting Up an Agent Using System Proxy

^{Last Updated: 2022-09-09}

Purpose

This article describes how to set up an agent behind a proxy.

Introduction

In environments where machines must route external traffic through a proxy, Outpost24 agents are not able to enroll, fetch configurations, or send results unless they are configured to use that proxy. The system proxy setup lets you embed the HTTPS_PROXY setting into the agent’s operating-system environment—whether on Linux, Windows or macOS—so that all agent communications pass through the proxy without manual redirection. This ensures agents work correctly behind firewalls or in segmented networks, preserving security while maintaining full functionality.

Configuration

Linux

Edit the /etc/sysconfig/o24-agent file to add a block to specify and HTTPS_PROXY directive.

HTTPS_PROXY="http://<PROXY_IP>:<PROXY_PORT>"

Windows

In the Start menu:

1. Open Settings.

2. Go to About.

3. Click on Advanced System Settings.

4. Click on Environment Variables.

5. Under System Variables click New.

6. Under New System Variable, fill in the new Variable Name and Variable Value.
   

   

7. Click OK to add each new variable.

macOS

Edit the /Library/LaunchDaemons/com.outpost24.agent.plist file to add a block to specify and Launch Service Environment key.

<key>LSEnvironment</key>
<dict>
      <key>HTTPS_PROXY</key>
      <string>http://<PROXY-IP>:<PROXY-PORT></string>
</dict>