Reverse proxy et HTTPS
Dès que KiwiDesk est utilisé hors du réseau de la boutique, il doit être servi en HTTPS :
les mots de passe, les codes de déverrouillage et les données des clients circulent entre le
navigateur et le serveur. Le plus simple est de placer un reverse proxy devant le service
web : il reçoit les connexions HTTPS sur le port 443, obtient le certificat automatiquement
(Let’s Encrypt) et relaie vers KiwiDesk.
HTTPS est aussi nécessaire pour la page de suivi des clients, la réception des SMS quand le téléphone est en 4G, la connexion avec Google ou Microsoft et l’appairage d’un Bridge distant.
Avant de commencer
Section intitulée « Avant de commencer »- Un nom de domaine (par exemple
kiwidesk.ma-boutique.fr) qui pointe vers l’adresse IP publique du serveur (enregistrement DNSA, etAAAAen IPv6). - Les ports 80 et 443 ouverts vers le serveur (le port 80 sert à la validation du certificat).
- Seul le reverse proxy doit être joignable depuis Internet : n’ouvrez pas le port
3000.
-
Configurer le reverse proxy pour relayer le domaine vers le service
websur le port3000(exemples ci-dessous). -
Adapter le fichier
.envde KiwiDesk :APP_PUBLIC_URL=https://kiwidesk.ma-boutique.frCORS_ORIGINS=https://kiwidesk.ma-boutique.frCOOKIE_SECURE=true# Adresse ou sous-réseau du reverse proxy, vu depuis le conteneur webWEB_TRUSTED_PROXIES=172.18.0.0/16 -
Redémarrer la stack pour appliquer les variables :
docker compose -f docker-compose.yml up -d. -
Vérifier l’adresse des postes. Connectez-vous depuis un poste de la boutique, puis ouvrez Mon compte > Sécurité > Historique de connexion : la dernière connexion doit montrer l’adresse IP de ce poste (ou de votre box), pas celle du reverse proxy.
Exemples de configuration
Section intitulée « Exemples de configuration »Caddy obtient et renouvelle le certificat tout seul. Fichier Caddyfile :
kiwidesk.ma-boutique.fr { encode zstd gzip request_body { max_size 250MB } reverse_proxy 127.0.0.1:3000}Avec un certificat obtenu par Certbot :
server { listen 443 ssl; http2 on; server_name kiwidesk.ma-boutique.fr;
ssl_certificate /etc/letsencrypt/live/kiwidesk.ma-boutique.fr/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/kiwidesk.ma-boutique.fr/privkey.pem;
# Photos, pièces jointes et vidéos des écrans de la boutique client_max_body_size 250m;
location / { proxy_pass http://127.0.0.1:3000; proxy_http_version 1.1; proxy_set_header Host $host; proxy_set_header X-Forwarded-For $remote_addr; proxy_set_header X-Forwarded-Proto $scheme; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; # Attente longue du téléphone SMS et du temps réel proxy_read_timeout 120s; proxy_buffering off; }}
server { listen 80; server_name kiwidesk.ma-boutique.fr; return 301 https://$host$request_uri;}Ajoutez des étiquettes au service web (dans un fichier docker-compose.override.yml à vous,
ou dans la stack Portainer), Traefik étant sur le même réseau Docker :
services: web: labels: - traefik.enable=true - traefik.http.routers.kiwidesk.rule=Host(`kiwidesk.ma-boutique.fr`) - traefik.http.routers.kiwidesk.entrypoints=websecure - traefik.http.routers.kiwidesk.tls.certresolver=letsencrypt - traefik.http.services.kiwidesk.loadbalancer.server.port=3000Traefik joint alors le conteneur directement : son adresse est celle du réseau Docker, à
indiquer dans WEB_TRUSTED_PROXIES (par exemple 172.18.0.0/16).
Pourquoi régler WEB_TRUSTED_PROXIES
Section intitulée « Pourquoi régler WEB_TRUSTED_PROXIES »KiwiDesk inscrit l’adresse IP de chaque poste dans le journal d’audit et l’historique de connexion, et s’en sert pour limiter les tentatives de connexion et les accès aux pages publiques. Cette adresse ne doit jamais pouvoir être choisie par le navigateur :
- le service
webremplace tout en-têteX-Forwarded-Forenvoyé par un navigateur par l’adresse réelle de la connexion ; - il ne croit l’en-tête
X-Forwarded-Forque s’il vient d’une adresse listée dansWEB_TRUSTED_PROXIES: votre reverse proxy ; - l’API, elle, ne croit que le service
web(TRUST_PROXY=1, réglage par défaut du fichier compose).
Sans WEB_TRUSTED_PROXIES, toutes les connexions semblent venir du reverse proxy : un seul poste
qui se trompe de mot de passe peut alors bloquer la connexion de toute l’équipe.
Si ça ne marche pas
Section intitulée « Si ça ne marche pas »- Erreur 502 ou 504 : le reverse proxy ne joint pas le service
web. Vérifiez l’adresse (127.0.0.1:3000si le proxy tourne sur le serveur,web:3000s’il est dans le même réseau Docker) et que le conteneur est démarré. - La connexion échoue ou la session se perd à chaque rechargement :
COOKIE_SECURE=truealors que le site est ouvert en HTTP, ouAPP_PUBLIC_URLne correspond pas à l’adresse tapée dans le navigateur. - Envoi d’une vidéo refusé (413) : augmentez la taille maximale des requêtes du proxy
(
client_max_body_size,max_size). - L’historique de connexion montre l’adresse du proxy :
WEB_TRUSTED_PROXIESne contient pas l’adresse du proxy telle que le conteneurwebla voit.