HTTPProxy, ProxyUID, ProxyPWD

HTTP/HTTPS proxy and basic-auth credentials for environments that route outbound traffic through a corporate proxy.

Category: connection-string

Syntax

HTTPProxy=<url>;ProxyUID=<user>;ProxyPWD=<password>

Description

## When to set Many corporate networks route outbound traffic through a forward proxy. Set `HTTPProxy=` explicitly when one is required. The supplied URL is forwarded to the underlying HTTP client. ## Authentication `ProxyUID` and `ProxyPWD` are forwarded to the proxy as HTTP basic auth. Only basic-auth proxies are supported; if your proxy requires a different scheme, either provision basic-auth credentials or whitelist the driver's traffic at the proxy.

Parameters

Name	Type	Description
`HTTPProxy`		Full proxy URL including scheme and port, for example `http://corp.proxy.example.com:8080`. Aliases: `ProxyHost` plus `ProxyPort` synthesise to a URL when set together.
`ProxyUID`		Username for proxy basic authentication.
`ProxyPWD`		Password for proxy basic authentication.

Examples

# Proxy with no auth
HTTPProxy=http://corp.proxy.example.com:8080

# Proxy with basic auth
HTTPProxy=http://corp.proxy.example.com:8080;ProxyUID=alice;ProxyPWD=hunter2

# Aliases
ProxyHost=corp.proxy.example.com;ProxyPort=8080

Pitfalls

A typo in `HTTPProxy=` (missing scheme, e.g. `corp.proxy.example.com:8080` without `http://`) will not resolve correctly. Always include the scheme.
Proxy basic-auth credentials show up in process arguments and core dumps if the BI tool crashes; the driver's own logs redact them but third-party tooling may not.