Files
xen-orchestra/@xen-orchestra/mixins/docs/HttpProxy.md
T
Julien Fontanet 2a70ebf667 docs: uniformize code blocks
- add missing syntaxes
- don't put prompt if no command outputs to ease copy/paste and use `sh` syntax
- always use `$` as prompt and use `console` syntax
2023-02-06 11:25:12 +01:00

1.7 KiB

This module provides an HTTP and HTTPS proxy for xo-proxy and xo-server.

Set up

The proxy is enabled by default, to disable it, add the following lines to your config:

[http.proxy]
enabled = false

Usage

For safety reasons, the proxy requires authentication to be used.

xo-proxy

Use the authentication token:

$ cat ~/.config/xo-proxy/config.z-auto.json
{"authenticationToken":"J0BgKritQgPxoyZrBJ5ViafQfLk06YoyFwC3fmfO5wU"}

Proxy URL to use:

xo-server

Only available for admin users.

You can use your credentials:

https://user:[email protected]

Or create a dedicated token with xo-cli:

$ xo-cli --createToken xoa.company.lan [email protected]
Password: ********
Successfully logged with [email protected]
Authentication token created

DiYBFavJwf9GODZqQJs23eAx9eh3KlsRhBi8RcoX0KM

And use it in the URL:

Use cases

Access hosts in a private network

To access hosts in a private network, deploy an XO Proxy in this network, expose its port 443 and use it as an HTTP proxy to connect to your servers in XO.

Allow upgrading xo-proxy via xo-server

If your xo-proxy does not have direct Internet access, you can use xo-server as an HTTP proxy to make upgrades possible.