Repository navigation
Description
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#setHttp2SessionTimeoutposeserver.setTimeout(ms, cb);cbémetonTimeoutsurServerH2c/ServerHttps, que personne n'écoute.- Mécanisme, lu dans le source de Node 26.13 (
lib/internal/http2/core.js) :connectionListenerarme chaque session parsession.setTimeout(server.timeout, sessionOnTimeout), attaché enonce(lib/internal/stream_base_commons.js#setStreamTimeout) ;sessionOnTimeoutne détruit la session que si le serveur n'a AUCUN écouteurtimeout(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
http2nu,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 unsession.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#routeSocketTimeoutferme la socket inactive (« un écouteurtimeoutcô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
Http2Sessionkeeps 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 :closeSessionmarque la session détruite avantsetTimeout(0)). Le contournement desetHttp2SessionTimeoutreste 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:memoryvert.
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
Metadata
Metadata
Assignees
Labels
Type
Projects
- StatusShow more project fieldsDone
Activity
ccamensuli commentedon Nov 11, 2026
Commits
df64ef163fix(http) : fermer les connexions HTTP/2 inactives au-delà du délai.63a93b680docs(http) : la règle danssrc/packages/@nodefony/http/MEMORY.md.Fini quand — point par point
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 parServerH2c.createServeretServerHttps).ping→pong) jusqu'à sa fin.closeIdleSessionappellesession.setTimeout(0)d'abord ; les tests de rétention #66885 restent verts.npm run test:memoryexit 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
timeoutqui ne ferme rien, la session survit à l'échéance — PING aller-retour après l'avis, aucun GOAWAY.http/1.1qui expire passe par l'écouteur sans avis ni erreur ; garde retirée →TypeError: session.ping is not a function(vu rouge).tsgo --noEmit0 erreur ; prettier, oxlint, cliquet des conversions verts.goawaypar session existait déjà.Au-delà du ticket
serverShutdown.ts#announceShutdown(arrêt gracieux) : une session dont le PING ne part pas (maxOutstandingPingsatteint) 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 recevait1au lieu de2^31-1).src/servers/http2Goaway.ts#announceSessionClose, appelée par l'arrêt ET par l'échéance d'inactivité.serverShutdown.ts(élargissement sûr au lieu deas).HttpContext.ts#routeSocketTimeoutdisait qu'une session HTTP/2 était « laissée à son propre délai ».allowHTTP1, une socket HTTP/1.1 en keep-alive sur 5152 prendkeepAliveTimeout(+1 s de marge Node,storeHTTPOptions), pastimeout—routeSocketTimeoutla ferme à cette échéance.Non fait
src/packages/@nodefony/http/docs/servers.md, lignetimeoutdu 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 »).once) : non ouvert — Node se comporte comme documenté (« timeouts must be handled explicitly »), c'était à nous de fermer.ccamensuli commentedon Nov 11, 2026
Page publique mise à jour avec le GO de l'auteur —
769f19d84: lignetimeoutdesrc/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-check121/121. Le « Non fait » du compte rendu est soldé sur ce point.fix(http): fermer les connexions HTTP/2 inactives au-delà du délai (#763
docs(http): fermeture des sessions HTTP/2 inactives dans la mémoire d…
docs(http): le délai timeout ferme aussi les connexions HTTP/2 inacti…
feat(http): bornes des messages gRPC et fin d'un appel unaire au déla…