Aller au contenu

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.

  • Un nom de domaine (par exemple kiwidesk.ma-boutique.fr) qui pointe vers l’adresse IP publique du serveur (enregistrement DNS A, et AAAA en 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.
  1. Configurer le reverse proxy pour relayer le domaine vers le service web sur le port 3000 (exemples ci-dessous).

  2. Adapter le fichier .env de KiwiDesk :

    APP_PUBLIC_URL=https://kiwidesk.ma-boutique.fr
    CORS_ORIGINS=https://kiwidesk.ma-boutique.fr
    COOKIE_SECURE=true
    # Adresse ou sous-réseau du reverse proxy, vu depuis le conteneur web
    WEB_TRUSTED_PROXIES=172.18.0.0/16
  3. Redémarrer la stack pour appliquer les variables : docker compose -f docker-compose.yml up -d.

  4. 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.

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
}

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 web remplace tout en-tête X-Forwarded-For envoyé par un navigateur par l’adresse réelle de la connexion ;
  • il ne croit l’en-tête X-Forwarded-For que s’il vient d’une adresse listée dans WEB_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.

  • Erreur 502 ou 504 : le reverse proxy ne joint pas le service web. Vérifiez l’adresse (127.0.0.1:3000 si le proxy tourne sur le serveur, web:3000 s’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=true alors que le site est ouvert en HTTP, ou APP_PUBLIC_URL ne 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_PROXIES ne contient pas l’adresse du proxy telle que le conteneur web la voit.