Abderrahman Khalladi
← Tous les articles

DevOps · · 3 min de lecture

Deux applications, deux VPS, une seule connexion : pipelines et SSO entre Orbit et VM Manager

Comment un utilisateur d'Orbit ouvre VM Manager sans repasser par un écran de connexion, et comment les deux applications partent en production.

EO Orbit et EO VM Manager sont deux applications distinctes. Orbit est le portail d’exploitation, écrit en NestJS. VM Manager pilote les hyperviseurs, écrit en FastAPI. Elles tournent sur deux VPS différents, avec chacune sa base et son cycle de livraison.

Pour l’utilisateur, ça ne devait pas se voir. Quelqu’un connecté à Orbit doit pouvoir ouvrir VM Manager avec les mêmes droits, sans ressaisir de mot de passe. Et les deux applications doivent pouvoir partir en production sans se marcher dessus.

Des pipelines identiques pour les deux projets

Les deux dépôts suivent le même schéma GitLab CI :

  1. test : lint et tests unitaires à chaque push.
  2. build : une image Docker étiquetée avec le SHA du commit, poussée dans le registre GitLab.
  3. deploy-preprod : automatique sur la branche principale.
  4. deploy-prod : un job manuel, déclenché après vérification en préproduction.

Le déploiement lui-même est volontairement simple. Le job se connecte en SSH au VPS avec un utilisateur dédié qui n’a que les droits Docker, met à jour l’étiquette de l’image, puis lance docker compose pull et docker compose up -d. Il attend ensuite que le point de santé de l’application réponde. S’il ne répond pas, le job échoue et l’étiquette précédente est remise en place.

Les VPS sont chez des fournisseurs comme OVHcloud. Sur chacun, la même préparation : connexion SSH par clé uniquement, pare-feu qui n’ouvre que le SSH, le HTTP et le HTTPS, Docker, et Nginx en reverse proxy avec des certificats Let’s Encrypt renouvelés automatiquement. Les secrets (clés, mots de passe de base, jetons d’API) sont des variables protégées de GitLab, injectées au déploiement, jamais écrites dans le dépôt.

Avoir le même pipeline pour deux technologies différentes a un avantage simple : quand quelque chose casse, on sait où regarder.

La connexion unique

Orbit authentifie déjà ses utilisateurs, avec un JWT et l’authentification à deux facteurs. Plutôt que d’installer un fournisseur d’identité complet pour deux applications, nous avons mis en place un passage de relais signé.

Le principe :

  1. Dans Orbit, l’utilisateur clique sur « Infrastructure ».
  2. Le back-end d’Orbit crée un jeton de passage très court (une minute) signé avec sa clé privée. Il contient l’identifiant de l’utilisateur, son locataire, ses rôles, un aud qui vaut vm-manager et un identifiant unique jti.
  3. Le navigateur est redirigé vers le point d’entrée SSO de VM Manager avec ce jeton.
  4. VM Manager vérifie la signature avec la clé publique d’Orbit, puis l’émetteur, l’audience et l’expiration.
  5. Il vérifie que le jti n’a jamais servi, en l’inscrivant dans Redis avec une durée de vie égale à celle du jeton. Un jeton intercepté ne peut donc pas être rejoué.
  6. Il retrouve l’utilisateur local correspondant, ou le crée au premier passage, ouvre sa propre session et redirige vers le tableau de bord en retirant le jeton de l’adresse.
claims = jwt.decode(token, ORBIT_PUBLIC_KEY, algorithms=["RS256"],
                    audience="vm-manager", issuer="eo-orbit")
if not redis.set(f"sso:jti:{claims['jti']}", 1, nx=True, ex=120):
    raise HTTPException(401, "token already used")
user = users.get_or_create_from_orbit(claims)
return start_session(user)

Chaque application garde ensuite sa propre session. La déconnexion d’un côté ne déconnecte pas l’autre, ce qui est acceptable ici puisque les sessions de VM Manager sont courtes.

Les pièges que nous avons rencontrés

  • L’heure des serveurs. Avec un jeton d’une minute, deux VPS dont les horloges divergent de quelques dizaines de secondes suffisent à tout casser. NTP sur les deux machines, et une tolérance de quelques secondes à la vérification.
  • Les journaux. Un jeton passé dans l’URL se retrouve dans les logs d’accès de Nginx. Sur la route SSO, le format de log n’écrit pas la chaîne de requête.
  • Les rôles. VM Manager ne fait pas confiance aveuglément aux rôles reçus : il les traduit vers ses propres permissions, et un rôle inconnu ne donne aucun droit.

Bilan

Le passage de relais signé nous a donné la connexion unique sans ajouter un serveur de plus à faire tourner. Si une troisième application rejoint l’ensemble, ce sera le bon moment pour passer à un vrai fournisseur OpenID Connect. Pour deux applications, ce mécanisme reste simple à comprendre, à tester et à expliquer.

Article suivant Tartib 2.0 : pourquoi un monolithe modulaire, et comment il est découpé →