This explains how to configure a proxy for remote scans in Embold. Follow the steps below to set up proxy-related environment variables to enable seamless integration.
1. Setting Up Proxy Environment Variables
To enable the use of a proxy for Embold remote scans, set the following environment variables:
Required Proxy Variables
EMB_PROXY_HOST: The hostname of your proxy server (e.g., proxy.example.com).
EMB_PROXY_PORT: The port number used by the proxy server (e.g., 8080).
EMB_PROXY_USERNAME: The username for proxy authentication (if required).
EMB_PROXY_PASSWORD: The password for proxy authentication (if required).
Alternatively, you can use the standard HTTP/HTTPS proxy variables:
HTTP_PROXY: The URL of your HTTP proxy, including authentication details if necessary (e.g., http://proxy_user:password@proxy.example.com:8080).
HTTPS_PROXY: The URL of your HTTPS proxy, including authentication details if necessary (e.g., https://proxy_user:password@proxy.example.com:8080).
2. Excluding Hosts from Proxy
If there are specific hosts or servers that should bypass the proxy, you can configure the following variables:
no_proxy or NO_PROXY: A list of hostnames, IP addresses, or domains that should bypass the proxy. For example:
localhost,127.0.0.1,.example.com
Excluding Multiple Servers
To exclude multiple servers, use the | separator within double quotes. For example:
no_proxy="http://localhost:3000|http://3.72.41.7:3128"
3. Example Configuration
For Unix/Linux Systems
Open your shell configuration file (e.g., .bashrc or .zshrc).
Add the following lines:
export EMB_PROXY_HOST="proxy.example.com"
export EMB_PROXY_PORT="8080"
export EMB_PROXY_USERNAME="proxy_user"
export EMB_PROXY_PASSWORD="password123"
# Alternatively
export HTTP_PROXY="http://proxy_user:password@proxy.example.com:8080"
export HTTPS_PROXY="https://proxy_user:password@proxy.example.com:8080"
# Exclude specific servers
export no_proxy="http://localhost:3000|http://3.72.41.7:3128"
Save the file and reload the configuration:
source ~/.bashrc
For Windows Systems
Open the Environment Variables settings.
Add the required variables under User Variables or System Variables:
For example:
Variable Name: EMB_PROXY_HOST
Variable Value: proxy.example.com
Add no_proxy or NO_PROXY to exclude specific hosts as needed.
4. Verification
To confirm that the proxy settings are applied:
Run a remote scan with Embold and check the logs to verify the proxy connection.
Monitor network traffic to ensure it routes through the specified proxy.
Note: Use your proxy host and port by replacing text “PROXY_IP” and “PROXY_PORT” respectively.