feat(ST-1638): instelbare QR-login sessieduur #316
No reviewers
Labels
No labels
severity/s3
severity/s4
No milestone
No project
No assignees
2 participants
Notifications
Due date
No due date set.
Dependencies
No dependencies set.
Reference
janpeter/Scrum4Me!316
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "feat/qr-login-session-duration"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Een QR-login kreeg altijd 8 uur geldigheid en de eindtijd werd niet op alle cookie-auth-paden afgedwongen. De telefoon kiest nu 1 uur, 8 uur (standaard), 1 dag of 7 dagen; de desktop gebruikt uitsluitend de atomisch goedgekeurde DB-duur. Pagina’s, serveracties, cookie-API’s en alle zeven open realtime-streams respecteren via één lifecyclehelper de absolute deadline. Activiteit verlengt de sessie niet.
Gewone login wist oude QR-markeringen. Misvormde cookies zijn anoniem en verhinderen geen publieke/Bearer-verzoeken of opnieuw inloggen. Bestaande QR-claimvensters, demo-policy en de huidige notify-hub/shutdown-logica blijven behouden.
S-2026-10-06-2 / PBI-186 / ST-1638 / T-2036..T-2039. Afhankelijkheid: janpeter/scrum4me-shared#75 (schema-kolom, pin 2083ae4). Additieve appmigratie geeft bestaande pairings 28800 en een CHECK op de vier keuzes.
Validatie:
Praktijkacceptatie: JP heeft op 6 oktober 2026 gekozen om op productie te testen, omdat de lokale proef op poort 3037 niet werkt. De lokale telefoonproef is daarmee vervangen door een productieproef na gecontroleerde release. Die productieproef is nog niet uitgevoerd.
CI en releasevoorwaarden blijven van toepassing. Het verwijderen van WIP is geen vastlegging van geslaagde productieacceptatie. Tijdelijke LAN-testconfig is niet opgenomen in deze PR.
WIP: feat(ST-1638): instelbare QR-login sessieduurto feat(ST-1638): instelbare QR-login sessieduurREQUEST_CHANGES
Findings
enqueuecontroleert uitsluitendcloseden de hard-close blijft 240 seconden. Een stream die vlak vóór afloop opent, levert dus daarna nog nieuwe issuegegevens. Dit is gereproduceerd op head66e46748: deadline 2000, klok 2001, issue-event afgeleverd metdone: false. Neem deze route mee in de deadlinecontrole vóór iedere payload en de timer/cleanup, met behoud van pg/shutdown-opruiming. Voeg hem ook toe aan de regressiedekking; tests/api/realtime-session-expiry.test.ts:23 bevat nu slechts zes routes.getIronSessionmet alleen eenuserId-check. Dit omzeilt de centrale applicatiedeadline en spreekt de nieuwe instructie onder “QR-deadline en render-veilige readers” tegen. Gebruik ook in het voorbeeldgetSessionuitlib/auth.Plan en standaarden
plan gekoppeld via pr_refs — references: T-2036, T-2039, ST-1638, PBI-186. Geen omitted-bronnen.
De vier duurkeuzes, DB-validatie/default/CHECK, atomische goedkeuring, uitsluitend DB-gestuurde claim, expliciete cookie-TTL/Max-Age en gewone herlogin volgen het plan en de productpatronen. De ontbrekende issues-stream spreekt echter het acceptatiecriterium “op/na deadline geen realtimepayload” en de PR-claim over open realtime-streams tegen; daarom is dit blokkerend, ook al noemt de bestandslijst van taak 3 slechts zes routes.
De PR houdt de productie-telefoonproef en deployment expliciet open en meldt dat de lokale proef is vervangen door een productieproef. Dat zijn open acceptatiepunten, geen afzonderlijke blockers voor deze code-PR. Het reviewdocument noemt nog de oude lokale proef.
Verificatie
PR en exacte head via Forgejo gecontroleerd; volledige cookie-readerinventarisatie en shared-pin bekeken (shared-diff: één schemakolom). Gerichte ESLint-controle groen. De hierboven beschreven issues-reproductie gebruikt de werkelijke routecode met gestubde externe afhankelijkheden, geen echte DB/HTTP-server.
Vitest kon in deze omgeving niet starten: de native rolldown-binding kon niet worden gemapt. Typecheck liep eerst tegen de Node-heaplimiet en werd bij herhaling met 4 GB heap door de omgeving beëindigd (exit 137). De gerapporteerde volledige verify/build/DB-runs uit de PR zijn hier dus niet onafhankelijk bevestigd.
Review PR #316 — instelbare QR-login sessieduur
Oordeel: functioneel correct en mergebaar. Wel kan de PR flink kleiner: ongeveer de helft van de wijzigingen is niet nodig om het doel te halen. Dit is een statische review; de test- en buildresultaten zijn niet opnieuw gedraaid.
Goed
updateManyop status +secret_hash+expires_at. Daarmee is een race opgelost.requireSessionroept geensession.destroy()meer aan. Dat schreef een cookie tijdens het renderen van een Server Component, wat niet mag. Terechte fix.getSession(): ruim 25 lokale kopieën vervangen door één functie. Nette opschoning.2083ae4klopt.Kan simpeler
1. Het verlopen van de sessie regelt iron-session al.
iron-session v8 slaat de
ttlop in de versleutelde cookie zelf (iron-webcryptoexp). Na die tijd faalt het ontsleutelen metExpired sealen krijgt elke lezer{}, zowelgetIronSessionalsunsealDatain de proxy, met maximaal 60 s speling.Met
getPairedSessionOptions(duration)in de claim-route verloopt een nieuwe QR-sessie dus al op álle paden. De gedeeldegetSession()-policy, de importwijzigingen in ~40 bestanden en de uitgebreidere proxy zijn daarvoor niet nodig. Alleen cookies van vóór deze uitrol (oude geldigheid 14 dagen) leunen oppairedExpiresAt, en die zijn hoe dan ook binnen 8 uur na de uitrol verlopen.requireSession-fix, ongeveer 10 bestanden in plaats van 83.getSession()mag blijven als extra bescherming en opschoning. Zeg dan in de PR-beschrijving dat het vooral om het opruimen van dubbele code gaat, niet dat het nodig is om de deadline af te dwingen.2. De wijzigingen aan de realtime-streams zijn grotendeels overbodig.
Een stream sluit al na hooguit
HARD_CLOSE_MS= 240 s, en bij opnieuw verbinden geeftgetSession()een 401. De winst is dus hooguit 4 minuten eerder sluiten. Daarvoor staat nu in 6 routes hetzelfde blok van ~15 regels, plus een controle bij elk verstuurd bericht en extraif (closed)-guards.Voorstel: laat het weg. Wil je het toch, maak dan één helper, bijvoorbeeld
streamLifetimeMs(session), en pas alleen de bestaandesetTimeoutaan. Laat de rest van de stream-code zoals hij was.3. Overbodige regels
session.updateConfig(sessionOptions)inloginActionenregisterActiondoet niets:getSession()opent de sessie al met precies deze opties.delete session.pairedendelete session.pairedExpiresAtinapp/api/auth/pair/claim/route.tszijn overbodig, want twee regels later worden beide velden opnieuw gezet. In login en register zijn ze wél nodig.Bevindingen
app/api/realtime/issues/route.tsheeft de deadline-aanpassing niet gekregen, de andere 6 streams wel. Dat ondersteunt punt 2: het gedrag was blijkbaar ook zonder deze aanpassing goed genoeg.isAdmin = false. Vroeger werd een admin-vlag uit een eerdere login in dezelfde browser meegenomen, dus dit is een verbetering. Noem het wel in de PR-beschrijving.Advies
Maak de PR kleiner: haal de realtime-wijzigingen eruit (of vervang ze door die ene helper) en schrap de no-op-regels uit punt 3. De gedeelde
getSession()kan blijven. De productieproef met een echte telefoon is nog niet gedaan; die blijft nodig voor de Definition of Done.🤖 Generated with Claude Code
Verwerkt in
56e2406e406b9107a2cc0c2813276a94820bb6d1.De blocker uit review 1063 is terecht: de issues-stream ontbrak. Ik heb de reproductie eerst als falende test vastgelegd en daarna de route toegevoegd. Alle zeven streams gebruiken nu één kleine
session-stream-lifetime-helper voor deadline, abort en payloadtoelating. De bestaande pg-/notify-hub-/shutdown-opruiming blijft per route intact. Het documentatievoorbeeld gebruikt nugetSession.Uit review 1064 heb ik de helpervariant gekozen, de dubbele lege regels verwijderd en de no-op-regels geschrapt: gewone login/registratie openen al met
sessionOptions, dusupdateConfig(sessionOptions)voegde niets toe. De deletes in claim waren ook redundant omdat beide QR-velden direct opnieuw worden gezet.Waarom ik oorspronkelijk breder wijzigde: het goedgekeurde criterium is een absolute eindtijd, ook voor cookie-API’s en open streams. Daarom heb ik alle readers naar één getter gebracht, niet alleen de nieuwe sessie-uitgifte aangepast. Dat ruimt dubbele code op, maar voorkomt ook dat afzonderlijke readers de applicatiedeadline omzeilen.
De suggestie dat alleen iron-session-TTL volstaat, neem ik niet over:
getSessionde QR-sessie al weigert.Wat ik anders had moeten doen: de checks eerst per route toevoegen hield de bestaande cleanup intact, maar veroorzaakte onnodige herhaling. Bij het overzetten naar actuele main heb ik vervolgens de nieuwe issues-route gemist. De volledige zeven-route-inventaris en één helper zijn nu de betere uitwerking.
isAdmin=falsebij QR-claim is bewust: een vlag uit een eerdere login in dezelfde browser wordt niet overgenomen. De admin-guards blijven rechten via de gebruiker/DB bepalen.Verificatie:
npm run verifyennpm run buildgroen; 4059 tests geslaagd, 31 bestaande/opt-in skips. Nieuwe dekking: issues-deadline, payload vóór een vertraagde timeoutcallback, gedeelde lifecycle en echte iron-session grace/legacy-seals. Een onafhankelijke code-review van deze delta vond geen actionable bevindingen. CI voor de nieuwe head loopt opnieuw.De praktijkproef op productie blijft open, conform JP’s keuze. Ik claim nog geen geslaagde productieacceptatie. Shared #75 is inmiddels gemerged.
COMMENT
Geen blokkerende codebevindingen gevonden op commit
56e2406e40. Centrale cookie-validatie, atomische pending→approved-transitie, DB-gestuurde sessieduur en gedeelde deadline/abort-afhandeling voor alle zeven realtime-routes passen bij de auth-, QR- en SSE-productstandaarden. De additieve migratie en gepinde shared-schemawijziging zijn onderling consistent.Findings:
plan gekoppeld via pr_refs — references: T-2036, T-2039, ST-1638, PBI-186. Geen omitted onderdelen. De implementatie spreekt de gekoppelde acceptatiecriteria niet tegen; de genoemde UI-testdekking en expliciet uitgestelde praktijkacceptatie zijn nog niet volledig afgerond.
Onafhankelijke verificatie: PR en head-SHA via Forgejo opgelost; diff en huidige cookie-readers geïnspecteerd; git diff --check geslaagd; Prisma-clientgeneratie en typecheck geslaagd (typecheck met 8 GB heap); gerichte ESLint-controle geslaagd. Vitest startte niet doordat /tmp noexec is en de native Rolldown-module niet kan laden. Volledige verify/build en DB-/browserproeven zijn hierdoor niet onafhankelijk bevestigd; de groene aantallen in het implementatieverslag zijn bewijs van de implementator, geen eigen testresultaten. Vanwege deze beperking en de kleine testopmerking kies ik COMMENT.