Context Navigation

Version 30 (modified by Antoine Martin, 10 months ago) (diff)
add proxy section, link to apache page

HTML5 Client

The xpra-html5 package should have been installed automatically when you installed xpra.

To setup your xpra server with HTML5 support, simply start a server with a TCP socket (bind-tcp=...) or a websocket (bind-ws=...), ie:

xpra start --bind-tcp=0.0.0.0:10000 --start=xterm

You can then point your browser to http://localhost:10000/ and the xterm should appear in your browser window.

You can also access the latest version of the HTML5 client here: https://xpra.org/html5/connect.html.

Proxying

to use an nginx web server as proxy see here: wiki/Nginx
using apache as proxy: wiki/Apache

Source

The source can be found:

Password Authentication

You can use authentication by supplying the values on the URL.

Connecting to a server started with:

echo -n 123456 > ./password.txt
$ xpra start --bind-tcp=0.0.0.0:10000 --start=xterm --html=on \
    --tcp-auth=file:filename=./password.txt

As user test, you can then connect with the following URL:

http://localhost:10000/index.html?username=test&password=123456

When using the connect page, the credentials are not sent to the server. The javascript client handles authentication client side using HMAC.

Encryption

The easiest and safest way to encrypt traffic is to use SSL (https / wss)

AES

Alternative: the following commands will setup an HTML5 server with AES encryption and password authentication then launch a browser and connect to it:

PASSWORD=YOURPASSWORD
AES_KEY=0123456789ABCDEF
echo -n $PASSWORD > password.txt
echo -n $AES_KEY > aes.txt
xpra start :10 --bind-tcp=0.0.0.0:10000 --html=on --start=xterm \
    --tcp-auth=file:filename=./password.txt \
    --tcp-encryption=AES --tcp-encryption-keyfile=`pwd`/aes.txt
sleep 5
xdg-open "http://localhost:10000/index.html?username=$USER&password=$PASSWORD&encryption=AES&key=$AES_KEY"