SSL
Last updated
Last updated
If you host your webgl build on a HTTPS domain you will need to use the secure web socket protocol (wss://
). WSS requires a SSL certificate set up on your Mirror game server for basic scenarios or on your gateway server for "reverse proxy" scenarios. You will also have to ensure the "Client Use WSS" option is set on the transport.
For the following sections we will demonstrate how to obtain SSL certificates using for the domain simpleweb.example.com
.
You need a domain name and the ability to edit DNS records
A DNS record should point to your webgl game client (normally hosted on port 443)
A DNS record should point to your Mirror game server
Set up virtual machine in the cloud:
Follows guides here:
Find the instructions for your server version. Below is link for Ubuntu 18.04 LTS (bionic)
For instruction 7
After filling in details you will get a result like this
simpleweb.example.com
should be your domain
To create a pfx file that SimpleWebTransport can use run this command in the /etc/letsencrypt/live/simpleweb.example.com/
folder
You will be asked for a password; you can set a password or leave it blank. You might need to be superuser in order to do this.
Note: Currently the mono version shipped with unity is unable to load pfx files generated by OpenSSL version 3. You will have to add the -legacy
command line argument to the openssl command above to generate a compatible pfx file.
You can either copy the cert.pfx file to your server folder or create a symbolic link.
Using Move
Using Symbolic link
Create a cert.json
that SimpleWebTransport can read
Run this command in the ~/path/to/server/
folder
If you left the password blank at cert creation:
If you set up a password "yourPassword" at cert creation:
After the cert.json
and cert.pfx
are in the game server folder like this
Then make the server file executable
To run in the active terminal use
To run in background use
To keep the game server running even after you close your ssh session use
nohup
means: the executable will keep running after you close your ssh session the&
sign means: that your server will run in background
you may need to use
sudo
to run if you created a symbolic link
Test everything is working by connecting a game client to the game server using either the unity editor as a game client or using your deployed webgl build as the game client.
Set your domain (eg simpleweb.example.com
) in the hostname field and then start a client.
To check if your pfx file is working outside of unity you can use pfxTestServer.js
().