Configure a proxy server

cancel
Showing results for 
Show  only  | Search instead for 
Did you mean: 
Endpoint Privilege Manager (EPM) Articles
4 min read
L0 Member
No ratings

You can configure a proxy server to limit outbound access from EPM agents to the EPM service only. You can also use any other proxy server that follows the communication methods described below.

The following example shows how a Squid proxy server is used to allow EPM agents installed on an isolated network to communicate with the EPM service.

 

ka3Vy00000Cvpi1IAB__eid=ka3Vy00000Cvpi1&feoid=00N2J000009R3kl&refid=0EMVy00000N3QlV.png

Steps

Configure a Squid proxy server

This section describes how to configure the Squid proxy server and allow it access to the EPM server only.

 

Step 1: Check requirements

As an example, the Squid proxy server could have the following minimum requirements:

Item

Requirement

Hardware or VM

1 CPU core

1G RAM

10G disk

Operating system

RHEL 7 or higher

Port

TCP port 3128 open for LAN connections from EPM agents

Internet

Outbound internet on port 443

Step 2: Install Squid

  1. Install Squid by running the following commands.

    On yum-based Linux (RHEL/Centos/Fedora):

     
    sudo yum install -y squid

    On apt-based Linux (Ubuntu/Debian):

     
    sudo apt-get update
    sudo apt-get install -y squid
  2. Enable, start, and check the status of Squid.

     
    sudo systemctl enable squid 
    sudo systemctl start squid
    sudo systemctl status squid

Step 3: Allow Squid to access the EPM service

Configure Squid to allow access to the EPM service only.

 

  1. Enable the host server and the dispatcher domains, and disable all other domains.

     

    For the host server, specify the domain prefix for your region and the three numbers from the EPM console URL after login. For example, na123.epm.cyberark.com or jp123.epm.cyberark.com.

    For the dispatcher domain, specify the domain prefix for your region. For example, login.epm.cyberark.com or jp.epm.cyberark.com.

  2. Open the Squid configuration file using squid acl.

  1. On a fresh Squid installation, add the following four lines to the top of /etc/squid/squid.conf. Make sure you include the http_access deny all command.

     
    # change na110.epm.cyberark.com to the address of your EPM Manager
    acl allowed_domain_epm_cyberark dstdomain na110.epm.cyberark.com
    acl allowed_domain_epm_cyberark_login dstdomain login.epm.cyberark.com
    http_access allow allowed_domain_epm_cyberark
    http_access allow allowed_domain_epm_cyberark_login

    # denies all others, this is by default
    http_access deny all
  2. After you have updated squid.conf, reload the Squid service.

     
    systemctl reload squid

 

Test configuration

  1. Open the Squid access log.

     
    tail -f /var/log/squid/access.log
  2. View the requests that were issued.

     

    1600975689.552 119942 10.0.1.4 TCP_TUNNEL/200 4495 CONNECT login.epm.cyberark.com:443 - HIER_DIRECT/104.17.195.105 -
    1600975799.556 192753 10.0.1.4 TCP_TUNNEL/200 278838 CONNECT na110.epm.cyberark.com:443 - HIER_DIRECT/104.17.194.105 -
    1600976019.567 217535 10.0.1.4 TCP_TUNNEL/200 21746 CONNECT na110.epm.cyberark.com:443 - HIER_DIRECT/104.17.194.105 -
    1600983924.018 8354226 10.0.1.4 TCP_TUNNEL/200 194881 CONNECT na110.epm.cyberark.com:443 - HIER_DIRECT/104.17.194.105 -
    1600985039.945 61232 10.0.1.4 TCP_TUNNEL/200 5609 CONNECT na110.epm.cyberark.com:443 - HIER_DIRECT/104.17.194.105 -
    1600985233.763 169371 10.0.1.4 TCP_TUNNEL/200 157880 CONNECT na110.epm.cyberark.com:443 - HIER_DIRECT/104.17.194.105 -
    1600985369.959 136195 10.0.1.4 TCP_TUNNEL/200 18797 CONNECT na110.epm.cyberark.com:443 - HIER_DIRECT/104.17.194.105 -

  3. In squid.conf, disable or change epm_cyberark acls, and check that requests are blocked. The following steps lead you through an example check.

    1. Change allowed_domain_epm_cyberark 123.epm.mycompany.com to 456.epm.mycompany.com.

    2. Reload Squid.

       
      systemctl reload squid
    3. Open /var/log/squid/access.log and check that a tcp_denied string was issued.

       

      1600988752.530 0 10.0.1.4 TCP_DENIED/403 3816 CONNECT 123.epm.mycompany.com:443 - HIER_NONE/- text/html

    4. In the EPM Management console > My Computers, your computer now appears as 'disconnected'.

    5. Change allowed_domain_epm_cyberark 456.epm.mycompany.com back to 123.epm.mycompany.com.

    6. Reload Squid again.

       
      systemctl reload squid
  4. Test with shell to check that Google is blocked, but the EPM agent is not.

    1. Try to access Google.

       

      export HTTP_PROXY=10.0.1.5:3128

      export HTTPS_PROXY=10.0.1.5:3128

      curl http://google.com

      The following response should be returned.

       

      HTTP/1.1 403 Forbidden

      Server: squid/3.5.27

    2. Try to access the EPM agent.

       

      curl -I https://123.epm.mycompany.com

      The following response should be returned.

       

      HTTP/1.1 200 Connection established

 

This KB article is provided for educational purposes only and is not actively maintained. As product features may evolve over time, configuring a Squid server should always be done using the official product documentation. For support, please consult the Squid community or your specific software vendor.

Rate this article:
  • 2353 Views
  • 0 comments
  • 0 Likes
Article Dashboard
Version history
Last Updated:
‎11-05-2026 11:44 AM
Updated by: