Store approval-flow + QR-login

Open staging • verified na auto-scan + handmatig • untrusted = Tier-2 strict • mobile approver+signer • desktop via extension • nooit raw key/seed in QR • status: ontwerp, nog geen code

Keuze in 1 zin: Elke DApp begint als staged (openbaar zichtbaar), wordt verified na automatische scan + handmatige review, onbekende partijen altijd Tier-2; QR-login use mobile approver+signer voor eigen sessie, desktop sesión via extension na mobile goedkeuring.

1. Store states

StatusBetekenisTierGedrag
stagedPas gepubliceerd, openbaar zichtbaar in store, niet gescandTier-2 (default)Iframe sandbox strict, geen allow-same-origin, beperkte capabilities
verifiedAuto-scan + handmatige review doorgekomenTier-1 (na goedkeuring)Iframe + allow-same-origin, preloaded bridge, SW-cache, volledige capabilities volgens manifest
untrustedAuto-scan heeft issues gevonden, handmatig niet goedgekeurdTier-2 (strict)Extra restricties: geen network:fetch, geen wallet:sign, beperkte storage, waarschuwing bij gebruiker

1.1 Statusovergangen

publish (staged) ──▶ auto-scan ──┬── geen issues ──▶ handmatige review ──┬── goedgekeurd ──▶ verified
                                  │                                      │
                                  └── issues gevonden ──────────────────-─┘── afgewezen ──▶ untrusted
                                                                                              │
                                                                  handmatige review ──────────-─┘── alsnog goedgekeurd ──▶ verified

2. Auto-scan deny-list (automatische blokkering)

Elke gepubliceerde DApp wordt automatisch gescand op de volgende patronen. Bij match wordt de DApp direct als untrusted gemarkeerd.

CategoriePatroonWaarom gevaarlijk
eval / Function()eval(...), new Function(...), setTimeout(string), setInterval(string)Willekeurige code-uitvoering, XSS-vector, kan sandbox omzeilen
innerHTML without sanitizer.innerHTML =, .outerHTML =, document.write(...), insertAdjacentHTML(...)Directe HTML-injectie zonder sanitization = XSS
remote fetch outside allowlistfetch(...) naar URLs niet in manifest.allowlist, XMLHttpRequest naar onbekende hostsData-lekken, C2-communicatie, policy-omzeiling
inline remote scripts<script src="https://…">, importScripts(...) met remote URL, dynamisch <script>-elementRemote code loading = supply-chain attack, niet content-addressed

2.1 Scan-implementatie

3. Handmatige review

4. QR-login flow

QR-login stelt gebruikers in staat om sessies te authenticeren met hun mobiele apparaat als approver+signer. Nooit worden raw keys of seeds in de QR-code geplaatst.

4.1 Mobile sessie (eigen apparaat)

Desktop/Mobile browser ──▶ /auth/qr-login ──▶ genereer challenge (random, 32 bytes, expire 120s)
        │
        │ QR-code toont: { type:"maos-session", challenge, sessionId, exp }
        │
Mobile MAOS-app ──scan QR──▶ toon sessie-details (device, IP-range, tijd)
        │
        │ User approve ──▶ app signed challenge met eigen private key (ed25519)
        │
        │ response: { sessionId, signature, pubkey, timestamp }
        │
Desktop browser ──◀── POST /api/auth/session/verify ──◀── server verifieert signature
        │
        └──▶ sessie aangemaakt: cookie + heartbeat + 7d lifetime

4.2 Desktop sessie via extension

Desktop browser ──▶ /auth/qr-login ──▶ genereer challenge
        │
        │ QR-code toont: { type:"maos-session", challenge, sessionId, exp }
        │
Mobile MAOS-app ──scan QR──▶ toon sessie-details + "Open op desktop?"
        │
        │ User approve ──▶ mobile stuurt challenge + approval naar extension via push
        │
Desktop extension ──ontvangen──▶ extension sign challenge met eigen key
        │
        │ response: { sessionId, signature, pubkey, timestamp, extensionId }
        │
Desktop browser ──◀── POST /api/auth/session/verify ──◀── server verifieert
        │
        └──▶ sessie aangemaakt (gekoppeld aan extension)

4.3 Verbod: raw key/seed in QR

VEILIGHEIDSREGEL: QR-code bevat alleen een challenge + sessie-metadata. Nooit private keys, seeds, mnemonics, of andere gevoelige credentials. De handtekening wordt op het mobiele apparaat gezet, de private key verlaat het apparaat nooit.

5. Sessie-lifetime + heartbeat + revoke

ParameterWaardeToelichting
Sessie-lifetime7 dagenNa 7d: sessie verlopen, opnieuw inloggen vereist
HeartbeatElke 5 minutenClient stuurt ping naar server. Bij 3 missed heartbeats: sessie-pauze (niet direct revoke)
Instant revokeDirectGebruiker kan op elk moment sessie intrekken. Server blokkeert alle tokens direct.
Hibernate trigger15 minuten inactiviteitNa 15 min geen interactie: sessie in hibernate-modus (snapshot, iframe uit DOM, port dicht)
Resume na hibernateDirect bij interactieGebruiker klikt/typt → sessie wordt uit hibernate gehaald, snapshot hersteld

5.1 Hibernate + snapshot (koppeling met container-spec)

6. Samenvatting QR + sessie-flow

┌─────────────────────────────────────────────────────────────────┐
│                     QR-LOGIN SESSIE-FLOW                        │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  1. Challenge genereren (random 32B, 120s expiry)               │
│     ↓                                                           │
│  2. QR-code tonen (type, challenge, sessionId, exp)              │
│     ↓                                                           │
│  3. Mobile scan → toon details → user approve                    │
│     ↓                                                           │
│  4a. Mobile sessie: sign challenge op apparaat (ed25519)         │
│  4b. Desktop sessie: push naar extension → extension sign         │
│     ↓                                                           │
│  5. POST /api/auth/session/verify (pubkey + signature)           │
│     ↓                                                           │
│  6. Server verifieert → sessie aangemaakt (7d lifetime)         │
│     ↓                                                           │
│  7. Heartbeat elke 5 min (3 missed = pause)                     │
│     ↓                                                           │
│  8. 15 min inactief → hibernate (snapshot + suspend)            │
│     ↓                                                           │
│  9. Bij logout/revoke: instant kill (cookie + token delete)     │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

7. Verwijzingen naar verwante specs

Volgende stap Na akkoord: P0-tickets voor auto-scan pipeline (AST-analyse) + QR-login API-route + sessie-heartbeat-implementatie.