Merge pull request #360 from Juniper/feat/359-proxy-support

Add support for HTTP/HTTPS/SOCKS5 proxies

apstra/provider.go

@@ -266,9 +266,14 @@ func (p *Provider) Configure(ctx context.Context, req provider.ConfigureRequest,
 	// Set the experimental flag according to the configuration
 	clientCfg.Experimental = config.Experimental.ValueBool()
 
-	// Set the TLS InsecureSkipVerify according to the configuration
+	// Set http client transport configuration
 	if transport, ok := clientCfg.HttpClient.Transport.(*http.Transport); ok {
+		// Set the TLS InsecureSkipVerify according to the configuration
 		transport.TLSClientConfig.InsecureSkipVerify = config.TlsNoVerify.ValueBool()
+
+		// Set HTTP/HTTPS proxies according to the environment
+		transport.Proxy = http.ProxyFromEnvironment
+
 		clientCfg.HttpClient.Transport = transport
 	}
 

docs/index.md

@@ -35,6 +35,16 @@ embedding them in the URL string using
 Please consider whether writing credentials to a configuration file is
 acceptable in your environment.
 
+### Proxy Support
+
+HTTP, HTTPS, and SOCKS5 proxies are supported through the `HTTP_PROXY` and
+`HTTPS_PROXY` environment variables or the lowercase versions of those
+variables. The value of each may be either a complete URL or a "host[:port]",
+in which case the "http" scheme is assumed.
+
+Hosts which should be omitted from the proxy configuration may be listed in
+the `NO_PROXY` (or `no_proxy`) environment variable ([details](https://github.com/golang/go/blob/682a1d2176b02337460aeede0ff9e49429525195/src/vendor/golang.org/x/net/http/httpproxy/proxy.go#L38C1-L50C13)).
+
 ### Additional Environment Variables
 
 Provider attributes which have been omitted from the configuration

templates/index.md.tmpl

@@ -28,6 +28,16 @@ embedding them in the URL string using
 Please consider whether writing credentials to a configuration file is
 acceptable in your environment.
 
+### Proxy Support
+
+HTTP, HTTPS, and SOCKS5 proxies are supported through the `HTTP_PROXY` and
+`HTTPS_PROXY` environment variables or the lowercase versions of those
+variables. The value of each may be either a complete URL or a "host[:port]",
+in which case the "http" scheme is assumed.
+
+Hosts which should be omitted from the proxy configuration may be listed in
+the `NO_PROXY` (or `no_proxy`) environment variable ([details](https://github.com/golang/go/blob/682a1d2176b02337460aeede0ff9e49429525195/src/vendor/golang.org/x/net/http/httpproxy/proxy.go#L38C1-L50C13)).
+
 ### Additional Environment Variables
 
 Provider attributes which have been omitted from the configuration