add tutorial for ssl in docs
This commit is contained in:
Timothy Pogue
parent
106ac2ab4d
commit
edb817e2e6
169
docs/rest-api.md
169
docs/rest-api.md
@ -458,3 +458,172 @@ The correct configuration for this case is `http://localhost:8080` - the main pa
|
||||
|
||||
!!! Note
|
||||
We strongly recommend to also set `jwt_secret_key` to something random and known only to yourself to avoid unauthorized access to your bot.
|
||||
|
||||
|
||||
### Using SSL/TLS
|
||||
|
||||
SSL/TLS is used to provide security and encrypt network traffic. Freqtrade does not directly support SSL, but you can easily accomplish this with a reverse proxy such as Nginx or Traefik. Below are some steps to help you get started on setting one up for your bot. For the sake of simplicity, we will use a native installation of Nginx and certbot.
|
||||
|
||||
|
||||
**Prerequisites**
|
||||
|
||||
Before starting this tutorial, you will need a few things.
|
||||
|
||||
- A Freqtrade bot set up and running
|
||||
- A registered domain name, e.g. myftbot.com
|
||||
- A DNS A record for the top level domain pointing to your server's public IP
|
||||
|
||||
**Step 1: Installing Nginx and Certbot**
|
||||
|
||||
Once you have all of the prerequisites, the first step is to get Nginx installed on your system. This tutorial assumes the use of Ubuntu 20.04, though you can find your linux distro's package commands via a search engine. First, update your local package index so that you have access to the most recent package listings then install Nginx:
|
||||
|
||||
``` bash
|
||||
> sudo apt update
|
||||
> sudo apt install nginx
|
||||
```
|
||||
|
||||
After accepting the installation, Nginx and any dependencies will be installed to your system and automatically started. You can check it is running with `systemd`:
|
||||
|
||||
``` bash
|
||||
> sudo systemctl status nginx
|
||||
|
||||
● nginx.service - A high performance web server and a reverse proxy server
|
||||
Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset: enabled)
|
||||
Active: active (running) since Wed 2022-11-16 12:09:27 MST; 4 days ago
|
||||
Docs: man:nginx(8)
|
||||
Process: 1026 ExecStartPre=/usr/sbin/nginx -t -q -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
|
||||
Process: 1106 ExecStart=/usr/sbin/nginx -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
|
||||
Main PID: 1107 (nginx)
|
||||
Tasks: 5 (limit: 6929)
|
||||
Memory: 5.7M
|
||||
CGroup: /system.slice/nginx.service
|
||||
├─1107 nginx: master process /usr/sbin/nginx -g daemon on; master_process on;
|
||||
├─1108 nginx: worker process
|
||||
├─1109 nginx: worker process
|
||||
├─1110 nginx: worker process
|
||||
└─1111 nginx: worker process
|
||||
```
|
||||
|
||||
Next you need to install certbot which will handle all of the certificate automation for your web server and domain. To install certbot it is required to have `snapd` on Ubuntu. If you haven't installed it yet, please review the instructions on [snapcraft's site for installation](https://snapcraft.io/docs/installing-snapd/).
|
||||
|
||||
Once you are good to go, ensure your snapd version is up to date:
|
||||
|
||||
``` bash
|
||||
> sudo snap install core; sudo snap refresh core
|
||||
```
|
||||
|
||||
If you have any Certbot packages installed via your package manager, you should remove them before installing Certbot:
|
||||
|
||||
``` bash
|
||||
> sudo apt remove certbot
|
||||
```
|
||||
|
||||
Finally, install Certbot and prepare the Certbot command.
|
||||
|
||||
``` bash
|
||||
> sudo snap install --classic certbot
|
||||
> sudo ln -s /snap/bin/certbot /usr/bin/certbot
|
||||
```
|
||||
|
||||
**Step 2: Adjust the firewall**
|
||||
|
||||
The next step is to allow HTTP and HTTPS traffic through your firewall. This is different for each depending on which firewall you use, and how you have it configured. In this example, we are using `ufw`.
|
||||
|
||||
We'll start by enabling `ufw` if it isn't already:
|
||||
|
||||
``` bash
|
||||
> sudo ufw enable
|
||||
```
|
||||
|
||||
You can list the application configurations that ufw knows how to work with
|
||||
|
||||
``` bash
|
||||
> sudo ufw app list
|
||||
|
||||
Available applications:
|
||||
CUPS
|
||||
Nginx Full
|
||||
Nginx HTTP
|
||||
Nginx HTTPS
|
||||
```
|
||||
|
||||
As you can see in the output, there are 3 profiles available for Nginx:
|
||||
|
||||
- **Nginx Full**: This profile opens both port 80 (normal web traffic) and port 443 (SSL/TLS traffic)
|
||||
- **Nginx HTTP**: This profile only opens port 80 (normal web traffic)
|
||||
- **Nginx HTTPS**: This profile only opens port 443 (SSL/TLS traffic)
|
||||
|
||||
We will configure the firewall to allow both port 80 and 443:
|
||||
|
||||
``` bash
|
||||
> sudo ufw allow 'Nginx Full'
|
||||
```
|
||||
|
||||
You can verify the change by typing:
|
||||
|
||||
``` bash
|
||||
> sudo ufw status
|
||||
|
||||
Status: active
|
||||
|
||||
To Action From
|
||||
-- ------ ----
|
||||
Nginx HTTPS ALLOW Anywhere
|
||||
Nginx Full ALLOW Anywhere
|
||||
Nginx HTTPS (v6) ALLOW Anywhere (v6)
|
||||
Nginx Full (v6) ALLOW Anywhere (v6)
|
||||
```
|
||||
|
||||
**Step 3: Configuring Nginx**
|
||||
|
||||
Using your favorite editor, edit the default nginx configuration. In our case, it'll be under `/etc/nginx/conf.d/default.conf`:
|
||||
``` bash
|
||||
> sudo vim /etc/nginx/conf.d/default.conf
|
||||
```
|
||||
|
||||
Add a section to your configuration like this:
|
||||
|
||||
```
|
||||
server {
|
||||
server_name myftbot.com;
|
||||
location / {
|
||||
proxy_pass http://localhost:8080;
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Make sure to change `localhost` and `8080` to what you have set in your `api_server` configuration for your bot.
|
||||
|
||||
Verify your nginx config file syntax and make sure there are no errors:
|
||||
``` bash
|
||||
> sudo nginx -t
|
||||
```
|
||||
|
||||
Finally you can reload nginx to get the new configuration changes:
|
||||
|
||||
``` bash
|
||||
> sudo systemctl reload nginx
|
||||
```
|
||||
|
||||
!!! Note
|
||||
The `reload` command forces Nginx to read the new configuration without interrupting any connections. The `restart` command restarts the whole nginx service.
|
||||
|
||||
**Step 4: Getting the certificates**
|
||||
|
||||
Certbot already comes with an easy way to setup Nginx with SSL/TLS th automatically changes your configuration file with the required fields:
|
||||
|
||||
``` bash
|
||||
> sudo certbot --nginx
|
||||
```
|
||||
|
||||
You will be prompted for some information such as your email (To receive updates about your certificates), the domain you pointed to the server, and agree to the TOS and optional newsletter. You can also set to redirect HTTP traffic to HTTPS, removing HTTP access.
|
||||
|
||||
You can now test your SSL setup by using curl to make a request to your bot's Rest API:
|
||||
|
||||
``` bash
|
||||
> curl https://myftbot.com/api/v1/ping
|
||||
|
||||
{'status': 'pong'}
|
||||
```
|
||||
|
||||
If you see a pong response then everything is working and you have successfully set up SSL/TLS termination for your bot.
|
||||
|
||||
Loading…
Reference in New Issue
Block a user