Skip to content

fix(http): fermer les connexions HTTP/2 inactives au-delà du délai #763

Closed

Description

@ccamensuli

Lexique

  • GOAWAY — trame HTTP/2 par laquelle un serveur annonce qu'il n'acceptera plus de nouveaux flux sur une connexion ; les flux déjà acceptés peuvent se terminer.

Le problème

Sur les serveurs HTTP/2 (TLS 5152 et h2c 5153), une connexion restée inactive au-delà de servers.*.timeout (30 s par défaut) n'est jamais fermée par le serveur : elle vit jusqu'à ce que le client la ferme. Un client — ou un tiers — qui ouvre des connexions et n'en fait rien les accumule sans borne, chacune retenant un descripteur de fichier et la mémoire de sa session ; à l'épuisement des descripteurs, plus personne ne se connecte. Le délai configuré ne borne rien, alors que son commentaire affirme le contraire.

Preuve au terrain

  • src/packages/@nodefony/http/nodefony/src/servers/http2Limits.ts#setHttp2SessionTimeout pose server.setTimeout(ms, cb) ; cb émet onTimeout sur ServerH2c / ServerHttps, que personne n'écoute.
  • Mécanisme, lu dans le source de Node 26.13 (lib/internal/http2/core.js) : connectionListener arme chaque session par session.setTimeout(server.timeout, sessionOnTimeout), attaché en once (lib/internal/stream_base_commons.js#setStreamTimeout) ; sessionOnTimeout ne détruit la session que si le serveur n'a AUCUN écouteur timeout (if (!server.emit('timeout', this)) this.destroy()). Un écouteur présent reçoit donc UN avis par session et doit fermer lui-même ; s'il ne le fait pas, la session n'est plus jamais signalée.
  • Essai (Node 26.13, serveur http2 nu, server.setTimeout(300, cb)) : une session vide est encore ouverte à 1 500 ms ; le délai n'a sonné qu'une fois, et ni une nouvelle requête ni un session.setTimeout() rappelé ne le font sonner de nouveau.
  • HTTP/1.1 a déjà la règle : src/packages/@nodefony/http/nodefony/src/context/http/HttpContext.ts#routeSocketTimeout ferme la socket inactive (« un écouteur timeout côté serveur suspend la destruction automatique »). Son commentaire dit qu'une session HTTP/2 « est laissée à son propre délai » — ce délai ne fait rien.
  • Défaut voisin mais distinct, déjà signalé à Node : http2: a destroyed Http2Session keeps its idle timer armed, so every closed session stays in memory until the server timeout fires nodejs/node#66885 (minuteur gardé par une session DÉTRUITE ; correctif http2: clear the session timeout before marking it destroyed nodejs/node#66886 fusionné le 2026-10-28, ABSENT de la 26.13 : closeSession marque la session détruite avant setTimeout(0)). Le contournement de setHttp2SessionTimeout reste donc nécessaire, et la fermeture doit désarmer le délai AVANT de détruire.

Le geste

À l'échéance, fermer la session EN DOUCEUR par GOAWAY, avec l'annonce en deux temps déjà écrite pour l'arrêt (src/packages/@nodefony/http/nodefony/service/servers/serverShutdown.ts#announceShutdown), puis session.close() — une seule implémentation de la règle :

  • RFC 9113 §9.1 : un serveur « permitted to terminate idle connections » ; il « SHOULD first send a GOAWAY » ;
  • RFC 9113 §6.8 : une fermeture gracieuse « SHOULD send an initial GOAWAY frame with the last stream identifier set to 2^31-1 », puis attend au moins un aller-retour avant le GOAWAY définitif ;
  • session.close() laisse finir les flux en cours : un flux long et muet (abonnement gRPC, feat(realtime): s'abonner et publier sur un canal depuis un client gRPC #745) n'est pas coupé ; seuls les NOUVEAUX flux repartent sur une autre connexion, comme tout client gRPC le fait sur GOAWAY (grpc-PROTOCOL-HTTP2.md §GOAWAY Frame).
  • Aucun coût par requête : rien n'est ajouté au chemin d'une requête, tout se passe à l'échéance.

Fini quand

  • Une session HTTP/2 vide est fermée par GOAWAY après le délai, sur 5153 ET 5152 (test unitaire sur le serveur, et sur ServerH2c/ServerHttps), vu ROUGE le geste retiré.
  • Une session qui porte un flux ouvert et muet reçoit le GOAWAY mais le flux continue jusqu'à sa fin (test).
  • Le minuteur est désarmé avant la destruction (rétention de #66885 toujours couverte par http2SessionTimeout.test.ts).
  • cd src/packages/@nodefony/http && npm run test:memory vert.

Lecture du vecteur CVSS : A:H parce que l'épuisement des descripteurs refuse TOUTE connexion neuve tant que l'attaquant garde les siennes (classe des attaques « slowloris ») ; AC:L parce qu'il suffit d'ouvrir des connexions sans rien envoyer. Derrière un proxy inverse qui borne lui-même l'inactivité (cas visé par h2c 5153), l'exposition tombe ; 5152 peut être exposé directement.


Gravité : Major — le délai d'inactivité des connexions HTTP/2 ne ferme rien ; contournement : proxy inverse devant le serveur
CVSS : CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:N/I:N/A:H — 7,5 (High)
Estimation : 0,5 j
Dépend de : rien

Activity

  1. added this to the 10.0.0-beta milestone on Nov 11, 2026
  2. self-assigned this
    on Nov 11, 2026
  3. added theissue type on Nov 11, 2026
  4. moved this from Todo to In Progress in Release nodefony-coreon Nov 11, 2026
  5. ccamensuli commented on Nov 11, 2026

    @ccamensuli
    MemberAuthor

    Commits

    • df64ef163 fix(http) : fermer les connexions HTTP/2 inactives au-delà du délai.
    • 63a93b680 docs(http) : la règle dans src/packages/@nodefony/http/MEMORY.md.

    Fini quand — point par point

    • Session HTTP/2 vide fermée par GOAWAY après le délai : ✅ tests/unit/http2SessionTimeout.test.ts — premier GOAWAY à 2^31-1 (NO_ERROR), puis fermeture ; l'application prévenue une fois (onTimeout). Vu ROUGE fermeture retirée (2 tests) ET annonce retirée (premier GOAWAY à 0). 5152 et 5153 passent par la MÊME fonction (http2Limits.ts#setHttp2SessionTimeout, appelée par ServerH2c.createServer et ServerHttps).
    • Session portant un flux ouvert et muet : ✅ le flux reçoit le GOAWAY, puis échange encore (ping → pong) jusqu'à sa fin.
    • Minuteur désarmé avant destruction : ✅ closeIdleSession appelle session.setTimeout(0) d'abord ; les tests de rétention #66885 restent verts.
    • Gate mémoire : ✅ npm run test:memory exit 0 — h2c session neuve 0,05 Ko/itér., HTTP/2 TLS session neuve 0,01 Ko/itér., partout 0 scope et 0 contexte résiduel.

    Preuves

    • Témoin Node (fige le comportement amont, rougira s'il change) : avec un écouteur timeout qui ne ferme rien, la session survit à l'échéance — PING aller-retour après l'avis, aucun GOAWAY.
    • Garde HTTP/1.1 de 5152 : une connexion TLS négociée http/1.1 qui expire passe par l'écouteur sans avis ni erreur ; garde retirée → TypeError: session.ping is not a function (vu rouge).
    • http unitaire 1 532 verts (93 fichiers) ; intégration 1 020 verts, 33 sautés (Keycloak absent du décor, sans rapport) ; tsgo --noEmit 0 erreur ; prettier, oxlint, cliquet des conversions verts.
    • Perf : aucun coût par requête — un écouteur par SERVEUR, l'action n'a lieu qu'à l'échéance ; l'écouteur goaway par session existait déjà.

    Au-delà du ticket

    • Défaut voisin corrigé dans serverShutdown.ts#announceShutdown (arrêt gracieux) : une session dont le PING ne part pas (maxOutstandingPings atteint) se réglait aussitôt et ramenait le compte à 0 — l'arrêt partait avant que les sessions suivantes soient annoncées, qui recevaient alors un GOAWAY définitif sans annonce. Test ajouté (serverShutdown.test.ts, h2c et TLS), vu rouge avec l'ancien compteur (la seconde session recevait 1 au lieu de 2^31-1).
    • Une règle, une implémentation : l'annonce GOAWAY d'une session est extraite dans src/servers/http2Goaway.ts#announceSessionClose, appelée par l'arrêt ET par l'échéance d'inactivité.
    • Une conversion de type retirée dans serverShutdown.ts (élargissement sûr au lieu de as).
    • Commentaire faux corrigé : HttpContext.ts#routeSocketTimeout disait qu'une session HTTP/2 était « laissée à son propre délai ».
    • Vérifié, PAS un défaut : avec allowHTTP1, une socket HTTP/1.1 en keep-alive sur 5152 prend keepAliveTimeout (+1 s de marge Node, storeHTTPOptions), pas timeout — routeSocketTimeout la ferme à cette échéance.

    Non fait

    • src/packages/@nodefony/http/docs/servers.md, ligne timeout du tableau : page publique, en attente du GO de l'auteur (texte proposé : « En HTTP/2 (5152, h2c), une connexion inactive au-delà de ce délai est fermée par GOAWAY ; les flux en cours vont à leur terme »).
    • Signaler à Node l'asymétrie (HTTP/1.1 rappelle son écouteur à chaque échéance, HTTP/2 l'attache en once) : non ouvert — Node se comporte comme documenté (« timeouts must be handled explicitly »), c'était à nous de fermer.
    • Windows : rien n'a tourné dans le job de la plateforme (la CI le fera au push).
  6. ccamensuli commented on Nov 11, 2026

    @ccamensuli
    MemberAuthor

    Page publique mise à jour avec le GO de l'auteur — 769f19d84 : ligne timeout de src/packages/@nodefony/http/docs/servers.md (« En HTTP/2 (5152, h2c), une connexion inactive au-delà de ce délai est fermée par GOAWAY ; les flux en cours vont à leur terme »). anchor-check 121/121. Le « Non fait » du compte rendu est soldé sur ce point.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

beta-7Lot 7 — servir des services gRPC

Type

Projects

Milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions