Configuration

HTTPS & reverse proxy

En production, placez un reverse-proxy (nginx) devant le core, ou activez TLS directement dans le core.

Internet (HTTPS) vers nginx (443, TLS) vers le core sur 127.0.0.1:8080 — nginx termine TLS et relaie vers le core ; les modules ne sont jamais exposés directement.

nginx → core #

server {
  listen 443 ssl;
  server_name cloud.exemple.tld;
  ssl_certificate     /etc/letsencrypt/live/cloud.exemple.tld/fullchain.pem;
  ssl_certificate_key /etc/letsencrypt/live/cloud.exemple.tld/privkey.pem;
  location / {
    proxy_pass http://127.0.0.1:8080;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $remote_addr;
    proxy_set_header X-Forwarded-Proto $scheme;
  }
}

TLS natif dans le core #

KV__SERVER__TLS_ENABLED=true
KV__SERVER__TLS_CERT_PATH=/etc/kubuno/tls/cert.pem
KV__SERVER__TLS_KEY_PATH=/etc/kubuno/tls/key.pem
KV__SERVER__SECURE_COOKIES=true

Astuce

Activez SECURE_COOKIES derrière HTTPS pour que les refresh tokens (cookies HttpOnly) ne transitent qu'en TLS. Les en-têtes HSTS / X-Frame-Options sont gérés par le core.