Links

Proxy Support

JFrog Connect allows devices that are connected to the network through a proxy, to be able to communicate with Connect servers.

Overview

Devices that communicate through Web proxy servers, may configure changes on Connect service configs to enable packets to go through.
Proxy configuration may vary between different access points (regular requests, remote control, remote access) please follow the required guidelines below.

Guide

Connect's service configuration file is susceptible, an incorrect input can render the device inaccessible from the platform, please edit it with high care.

Allow Standard communication through Proxy

  1. 1.
    On-device, navigate to /etc/systemd/system/connect.service and edit the file.
  2. 2.
    Under the [Service] section, add these 2 lines:
Environment="http_proxy=<PROTO>://<PROXY ADDRESS>:<PROXY PORT>"
Environment="https_proxy=<PROTO>://<PROXY ADDRESS>:<PROXY PORT>"
3. Before saving, the file should look like this:
System information as of <last change date>
[Unit]
Description=JFrog Connect service
After=network.target
StartLimitIntervalSec=0
[Service]
Environment="http_proxy=<PROTO>://<PROXY ADDRESS>:<PROXY PORT>"
Environment="https_proxy=<PROTO>://<PROXY ADDRESS>:<PROXY PORT>"
Type=simple Restart always
RestartSec=5
StartLimitBurst=5
User=root
ExecStart=/etc/connect/service/ConnectAgent
[Install]
WantedBy=multi-user.target

Allow Remote Connections through Proxy

The proxy protocol needs to be defined where applicable, as shown in the examples below. Available proxies are:
socks4 -> 4 socks5 -> 5 http -> connect
For example (http): ProxyCommand nc -X connect -x 192.168.20.165:8000 %h %p

Remote Control

To enable Remote Control through a proxy, add the following line to the end of /etc/connect/service/remoteA (notice the indentation):
ProxyCommand nc -X <4|5|connect> -x <proxy-host>:<proxy-port> %h %p

Remote Access

To enable Remote Access through a proxy, add the following line to the end of /root/.ssh/config:
Host forwarding.connect.jfrog.io
ProxyCommand nc -X <4|5|connect> -x <proxy-host>:<proxy-port> %h %p