Atlax remplace WHMCS pour un hébergeur tunisien : domaines, hébergement cPanel, SSL, Microsoft 365, facturation et support. Contrairement à Tartib, ce projet est en microservices, et pour une bonne raison : il dépend de fournisseurs externes lents et pas toujours disponibles (le registre ATI, ResellerClub, cPanel/WHM, les moyens de paiement). Un registraire en panne ne doit pas bloquer le paiement d’une facture.
Qui dit microservices dit plus de surface à protéger. Voici les choix que nous avons faits, et pourquoi.
La plateforme : config server, Eureka et passerelle
Trois services techniques portent les autres :
- config-server centralise la configuration de chaque service. Les secrets n’y sont pas écrits en clair : ils viennent de l’environnement, et en production de secrets Docker.
- discovery-server (Eureka) tient la liste des instances. La passerelle route vers
lb://billing-servicesans connaître d’adresse IP. - gateway est la seule porte d’entrée publique. Aucun service métier n’est exposé directement.
Les services métier sont découpés par responsabilité, pas par écran : auth, commerce, billing, domain, hosting, notification, reporting. ATI et ResellerClub sont deux adaptateurs du même service de domaines, puisqu’ils font le même travail.
Les jetons restent côté serveur
L’espace client et le back-office sont deux applications React. Elles auraient pu mener le flux OAuth2 elles-mêmes et garder les jetons dans le navigateur. Nous ne l’avons pas fait : un script injecté par une faille XSS pourrait alors les lire.
La passerelle joue donc le rôle de backend-for-frontend. C’est un client OAuth2 confidentiel du service d’authentification, avec une inscription par application (atlax-web pour les clients, atlax-back-office pour l’équipe). Elle mène le flux « authorization code » avec PKCE, garde les jetons dans une session stockée dans Redis, et ne donne au navigateur qu’un cookie de session HttpOnly et SameSite=Lax. Chaque application a son propre cookie, donc une connexion au back-office ne donne rien côté client, et inversement.
Quand le navigateur appelle l’API, le filtre TokenRelay de la passerelle ajoute le jeton d’accès à la requête vers le service, et le renouvelle si besoin. Les services, eux, valident les JWT comme serveurs de ressources et appliquent leurs propres permissions.
Un service d’authentification que nous maîtrisons
Nous avons écarté Keycloak pour construire auth-service sur Spring Authorization Server. L’équipe voulait comprendre et posséder cette partie, et garder ses propres pages de connexion. Quelques détails qui comptent :
- Le formulaire de connexion est dans React. Le service d’authentification ne rend aucun HTML : il redirige vers la page de connexion de l’application qui a demandé. La page récupère un jeton CSRF, puis envoie un formulaire classique au service.
- Un mauvais mot de passe ne dit rien du compte. L’état d’un compte (e-mail non vérifié, verrouillé, désactivé) n’est signalé qu’après un mot de passe correct.
- La clé de signature est un fichier PEM, lu au démarrage depuis un secret Docker. Le service refuse de démarrer si la clé manque ou fait moins de 2048 bits. Son identifiant (
kid) est son empreinte RFC 7638. Pour une rotation, l’ancienne clé reste publiée dans/oauth2/jwkssans plus rien signer, donc les jetons en cours restent valides jusqu’à leur expiration. - Les secrets des clients OAuth2 sont stockés hachés, et les jetons de rafraîchissement tournent à chaque usage.
Les autres couches
- reCAPTCHA v3 sur les formulaires publics (contact, demande de devis). La vérification exige l’action attendue, un score minimum et un nom d’hôte autorisé. Si Google ne répond pas, le formulaire est refusé : on échoue fermé.
- Une base et un utilisateur PostgreSQL par service. Un service compromis ne lit pas les tables des autres.
- Des erreurs sous forme de codes. Les fronts traduisent les codes ; le détail technique en anglais n’est jamais affiché, ce qui évite d’en dire trop sur l’intérieur du système.
- Kafka avec outbox et inbox. Ce n’est pas de la sécurité au sens strict, mais une commande ne se perd pas quand un service tombe, et un message reçu deux fois n’est traité qu’une fois.
Ce que ça coûte
Tout cela a un prix. Nous avons dû écrire ce que Keycloak donne sans effort : inscription, vérification d’e-mail, mot de passe oublié, protection contre la force brute, MFA pour l’équipe. La rotation de clé se fait à la main. Et il y a plus de processus à faire tourner qu’avec un monolithe.
Mais chaque décision est écrite dans un ADR, avec ce qui a été écarté et pourquoi. Quand quelqu’un rejoint le projet, il n’a pas à deviner pourquoi les jetons ne sont pas dans le localStorage.