6/3/2021 sense-printing/08_sense_printing_proxy.
md at master · qlik-trial/sense-printing
qlik-trial / sense-printing Private
Code Issues 1 Pull requests 1 Actions Projects Wiki Securi
master
sense-printing / docs / 08_sense_printing_proxy.md
enrico-mezzato-qlik Update 08_sense_printing_proxy.md History
1 contributor
53 lines (35 sloc) 2.82 KB
How to set up a proxy for the hidden
Chromium browser used to render images
If after increasing the logging level to TRACE some HTTP responses are empty, the reason
may be an internal proxy blocking outbound requests.
Which proxy settings are supported
The proxy settings are set as command line arguments of the renderer and they are passed
as is to the hidden Chromium. If a proxy needs setting add (or append the string to
webrender-args) a valid setting to the value string in the printing.config file:
<add key="webrenderer-args" value="..." />
Inside the value string all the Chromium proxy settings specified at
https://www.chromium.org/developers/design-documents/network-settings can be used.
The main use cases are:
1. no proxy: <add key="webrenderer-no-proxy-server" value="false" />
2. autodetect: <add key="webrenderer-args" value="--proxy-auto-detect" />
https://github.com/qlik-trial/sense-printing/blob/master/docs/08_sense_printing_proxy.md 1/2
6/3/2021 sense-printing/08_sense_printing_proxy.md at master · qlik-trial/sense-printing
3. proxy server: <add key="webrenderer-args" value="--proxy-server="[<proxy-
scheme>://]<proxy-host>[:<proxy-port>]"" />
Specify the HTTP/SOCKS4/SOCKS5 proxy server to use for requests. An individual
proxy server is specified using the format: [<proxy-scheme>://]<proxy-host>[:<proxy-
port>] , example: socks5://127.0.0.1:8888 default: empty
For instance for myproxy listening on port 8888, scheme HTTP, use:
<add key="webrenderer-args" value="--proxy-server="http://myproxy:8888"
4. In case a script is dynamically blocking HTTP requests based on certain rules. Make
sure the internal proxy script adheres to the Chromium pac proxy settings standards.
A valid pac file can also be generated through the chrome Proxy SwitchyOmega
extension. If the current script is compliant this is not needed.
The pac specifications are at: https://developer.mozilla.org/en-
US/docs/Web/HTTP/Proxy_servers_and_tunneling/Proxy_Auto-
Configuration_(PAC)_file
If a new pac file is required alongside an existing proxy script this can be deployed to
an internal proxy website next to the current script. For the sake of example let us call
this file printing_proxy.pac,it must be reachable at eg:
http://myproxy:8080/printing_proxy.pac
<add key="webrenderer-args" value="--proxy-pac-url=http://myproxy:8080/printing_
Change the config file and restart the printing service
1. Stop the printing service
2. Change the printing config file to use one of the settings of the previous section:
<add key="webrenderer-args" value="..." />
3. Restart the printing service
https://github.com/qlik-trial/sense-printing/blob/master/docs/08_sense_printing_proxy.md 2/2
