BlueGit

projects-timfalken-com verhalenboek

feat: toon API-sleutels opnieuw en leg authenticatie uit

Een beheerder kan een bestaande sleutel opnieuw openen. De sleutel
blijft opzoekbaar via de hash en staat versleuteld met key_secret.
401- en relevante 403-antwoorden beschrijven hoe je authenticeert.

Co-authored-by: tim <tim@timfalken.com>

timfa project_87242033_bot_b167a9be22027ad5a4b431d0ad8426c6 · pushed by timfa

Authored 2026-10-05 · 6 weeks ago

Hash
16b40fa3b7f1dd69546e9246750687268b7d3bcf
Parent
799da657
11 files changed +252 −69
README.md +13 −3
@@ -26,7 +26,7 @@ Deploy naar `master` zet de code op de server, maar raakt `data/` niet aan. Daar
26 26 - **client_id:** `projects.timfalken.com` (het domein van de publieke URL, hetzelfde domein als microchess)
27 27 - **callback-pad:** `/verhaaltjesboek/callback.php`
28 28 - Voeg alleen dat pad toe. Genereer het clientgeheim niet opnieuw als microchess hetzelfde domein al gebruikt: een nieuw geheim maakt de andere site stuk. Kopieer het bestaande geheim.
29 4. Vul op de server `data/config.php` in. Dit bestand wordt niet gecommit en niet geüpload:
29 4. Vul op de server `data/config.php` in. Dit bestand wordt niet gecommit en niet geüpload. Laat `key_secret` staan: die maakt de app zelf aan (64 hexadecimale tekens) en versleutelt daarmee API-sleutels, zodat een beheerder ze later opnieuw kan tonen. Ontbreekt hij, dan vult de app hem één keer aan zonder de andere velden te wissen.
30 30
31 31 ```php
32 32 <?php
@@ -34,13 +34,14 @@ return [
34 34 'base_url' => 'https://projects.timfalken.com/verhaaltjesboek',
35 35 'client_id' => 'projects.timfalken.com',
36 36 'client_secret' => 'het-geheim-uit-admin',
37 'key_secret' => 'blijft-de-gegenereerde-waarde',
37 38 ];
38 39 ```
39 40
40 Lege velden vallen terug op `VERHALENBOEK_BASE_URL`, `VERHALENBOEK_CLIENT_ID` en `VERHALENBOEK_CLIENT_SECRET`. Een ingevuld veld wint van de omgeving. `base_url` mag een submap bevatten en heeft geen slash aan het eind.
41 Lege velden voor URL en client vallen terug op `VERHALENBOEK_BASE_URL`, `VERHALENBOEK_CLIENT_ID` en `VERHALENBOEK_CLIENT_SECRET`. Een ingevuld veld wint van de omgeving. `base_url` mag een submap bevatten en heeft geen slash aan het eind. `key_secret` komt niet uit de omgeving.
41 42
42 43 5. Log als eerste zelf in. Die eerste gebruiker wordt beheerder. Iedereen daarna is lezer. Het account-id en de gebruikersnaam komen uit `/api/me`. E-mail wordt niet gelezen en niet opgeslagen.
43 6. Maak onder **Sleutels** een API-sleutel voor de schrijver-agent. De volledige sleutel (`vb_…`) verschijnt één keer.
44 6. Maak onder **Sleutels** een API-sleutel voor de schrijver-agent. De volledige sleutel (`vb_…`) verschijnt meteen, en daarna opnieuw als je op die sleutel tikt. Alleen een ingelogde beheerder ziet dat; de lijst en de export tonen alleen het voorvoegsel.
44 45
45 46 De OAuth-flow is dezelfde als bij microchess: `state`, code wisselen op de server via `POST /oauth/token`, daarna `GET /api/me`, verlengen via `POST /api/session/extend`, en afmelden via `POST /api/logout`. Het bearer-token van het account blijft in de PHP-sessie en komt niet in JavaScript.
46 47
@@ -100,6 +101,15 @@ curl -sS -H 'Authorization: Bearer vb_JOUW_SLEUTEL' \
100 101
101 102 Fouten zijn `{"error":"…"}`. Validatie die de drie-verhalenregel raakt geeft 422. De menselijke uitleg met dezelfde voorbeelden staat op `docs.php`.
102 103
104 Een 401 (geen header, verkeerd formaat, of een onbekende/ingetrokken sleutel) zet `WWW-Authenticate: Bearer` en voegt `how_to_authenticate` toe, met dezelfde tekst in `hint`. Die tekst noemt het geval, de header `Authorization: Bearer vb_…`, Sleutels op `{base_url}/#/sleutels`, en een link naar `docs.php`. Een 403 omdat een lezer iets doet dat een sleutel of beheerder vereist, heeft die uitleg ook, zonder `WWW-Authenticate`. Sleutels zelf beheren kan alleen in de beheerderssessie. Een 403 door een ongeldige CSRF-header blijft alleen `{"error":"…"}`.
105
106 ```sh
107 curl -sS -D - -o - \
108 'https://projects.timfalken.com/verhaaltjesboek/api.php/days/latest'
109 ```
110
111 `GET /api.php/keys/{id}` geeft de volledige sleutel terug aan een ingelogde beheerder. Opzoeken bij een verzoek blijft een hash op `token_hash`.
112
103 113 ## Deploy
104 114
105 115 `.gitlab-ci.yml` is die van microchess: PHP-syntax, domeintests, API-tests, een JavaScript-syntaxcheck, en een echte FTP-fixture. Alleen `master` uploadt, en nooit tegelijk met een andere productie-deploy. [`ci/deploy.py`](ci/deploy.py) spiegelt `web/` met lftp en slaat `data/` (database, WAL, `config.php`, sessies) over, zowel bij upload als bij verwijderen. `data/.htaccess` wordt apart gezet. `tests/`, `router.php` en `README.md` gaan niet mee.
@@ -26,7 +26,7 @@ Deploy naar `master` zet de code op de server, maar raakt `data/` niet aan. Daar
26 - **client_id:** `projects.timfalken.com` (het domein van de publieke URL, hetzelfde domein als microchess)
26 - **client_id:** `projects.timfalken.com` (het domein van de publieke URL, hetzelfde domein als microchess)
27 - **callback-pad:** `/verhaaltjesboek/callback.php`
27 - **callback-pad:** `/verhaaltjesboek/callback.php`
28 - Voeg alleen dat pad toe. Genereer het clientgeheim niet opnieuw als microchess hetzelfde domein al gebruikt: een nieuw geheim maakt de andere site stuk. Kopieer het bestaande geheim.
28 - Voeg alleen dat pad toe. Genereer het clientgeheim niet opnieuw als microchess hetzelfde domein al gebruikt: een nieuw geheim maakt de andere site stuk. Kopieer het bestaande geheim.
294. Vul op de server `data/config.php` in. Dit bestand wordt niet gecommit en niet geüpload:
294. Vul op de server `data/config.php` in. Dit bestand wordt niet gecommit en niet geüpload. Laat `key_secret` staan: die maakt de app zelf aan (64 hexadecimale tekens) en versleutelt daarmee API-sleutels, zodat een beheerder ze later opnieuw kan tonen. Ontbreekt hij, dan vult de app hem één keer aan zonder de andere velden te wissen.
30
30
31```php
31```php
32<?php
32<?php
@@ -34,13 +34,14 @@ return [
34 'base_url' => 'https://projects.timfalken.com/verhaaltjesboek',
34 'base_url' => 'https://projects.timfalken.com/verhaaltjesboek',
35 'client_id' => 'projects.timfalken.com',
35 'client_id' => 'projects.timfalken.com',
36 'client_secret' => 'het-geheim-uit-admin',
36 'client_secret' => 'het-geheim-uit-admin',
37 'key_secret' => 'blijft-de-gegenereerde-waarde',
37];
38];
38```
39```
39
40
40Lege velden vallen terug op `VERHALENBOEK_BASE_URL`, `VERHALENBOEK_CLIENT_ID` en `VERHALENBOEK_CLIENT_SECRET`. Een ingevuld veld wint van de omgeving. `base_url` mag een submap bevatten en heeft geen slash aan het eind.
41Lege velden voor URL en client vallen terug op `VERHALENBOEK_BASE_URL`, `VERHALENBOEK_CLIENT_ID` en `VERHALENBOEK_CLIENT_SECRET`. Een ingevuld veld wint van de omgeving. `base_url` mag een submap bevatten en heeft geen slash aan het eind. `key_secret` komt niet uit de omgeving.
41
42
425. Log als eerste zelf in. Die eerste gebruiker wordt beheerder. Iedereen daarna is lezer. Het account-id en de gebruikersnaam komen uit `/api/me`. E-mail wordt niet gelezen en niet opgeslagen.
435. Log als eerste zelf in. Die eerste gebruiker wordt beheerder. Iedereen daarna is lezer. Het account-id en de gebruikersnaam komen uit `/api/me`. E-mail wordt niet gelezen en niet opgeslagen.
436. Maak onder **Sleutels** een API-sleutel voor de schrijver-agent. De volledige sleutel (`vb_…`) verschijnt één keer.
446. Maak onder **Sleutels** een API-sleutel voor de schrijver-agent. De volledige sleutel (`vb_…`) verschijnt meteen, en daarna opnieuw als je op die sleutel tikt. Alleen een ingelogde beheerder ziet dat; de lijst en de export tonen alleen het voorvoegsel.
44
45
45De OAuth-flow is dezelfde als bij microchess: `state`, code wisselen op de server via `POST /oauth/token`, daarna `GET /api/me`, verlengen via `POST /api/session/extend`, en afmelden via `POST /api/logout`. Het bearer-token van het account blijft in de PHP-sessie en komt niet in JavaScript.
46De OAuth-flow is dezelfde als bij microchess: `state`, code wisselen op de server via `POST /oauth/token`, daarna `GET /api/me`, verlengen via `POST /api/session/extend`, en afmelden via `POST /api/logout`. Het bearer-token van het account blijft in de PHP-sessie en komt niet in JavaScript.
46
47
@@ -100,6 +101,15 @@ curl -sS -H 'Authorization: Bearer vb_JOUW_SLEUTEL' \
100
101
101Fouten zijn `{"error":"…"}`. Validatie die de drie-verhalenregel raakt geeft 422. De menselijke uitleg met dezelfde voorbeelden staat op `docs.php`.
102Fouten zijn `{"error":"…"}`. Validatie die de drie-verhalenregel raakt geeft 422. De menselijke uitleg met dezelfde voorbeelden staat op `docs.php`.
102
103
104Een 401 (geen header, verkeerd formaat, of een onbekende/ingetrokken sleutel) zet `WWW-Authenticate: Bearer` en voegt `how_to_authenticate` toe, met dezelfde tekst in `hint`. Die tekst noemt het geval, de header `Authorization: Bearer vb_…`, Sleutels op `{base_url}/#/sleutels`, en een link naar `docs.php`. Een 403 omdat een lezer iets doet dat een sleutel of beheerder vereist, heeft die uitleg ook, zonder `WWW-Authenticate`. Sleutels zelf beheren kan alleen in de beheerderssessie. Een 403 door een ongeldige CSRF-header blijft alleen `{"error":"…"}`.
105
106```sh
107curl -sS -D - -o - \
108 'https://projects.timfalken.com/verhaaltjesboek/api.php/days/latest'
109```
110
111`GET /api.php/keys/{id}` geeft de volledige sleutel terug aan een ingelogde beheerder. Opzoeken bij een verzoek blijft een hash op `token_hash`.
112
103## Deploy
113## Deploy
104
114
105`.gitlab-ci.yml` is die van microchess: PHP-syntax, domeintests, API-tests, een JavaScript-syntaxcheck, en een echte FTP-fixture. Alleen `master` uploadt, en nooit tegelijk met een andere productie-deploy. [`ci/deploy.py`](ci/deploy.py) spiegelt `web/` met lftp en slaat `data/` (database, WAL, `config.php`, sessies) over, zowel bij upload als bij verwijderen. `data/.htaccess` wordt apart gezet. `tests/`, `router.php` en `README.md` gaan niet mee.
115`.gitlab-ci.yml` is die van microchess: PHP-syntax, domeintests, API-tests, een JavaScript-syntaxcheck, en een echte FTP-fixture. Alleen `master` uploadt, en nooit tegelijk met een andere productie-deploy. [`ci/deploy.py`](ci/deploy.py) spiegelt `web/` met lftp en slaat `data/` (database, WAL, `config.php`, sessies) over, zowel bij upload als bij verwijderen. `data/.htaccess` wordt apart gezet. `tests/`, `router.php` en `README.md` gaan niet mee.
web/README.md +2 −1
@@ -14,7 +14,7 @@ http://127.0.0.1:8080 logt automatisch in als `test_user_1` (beheerder). Dat geb
14 14
15 15 ## Productie
16 16
17 PHP 8.2+, PDO SQLite, cURL, mbstring en een schrijfbare `data/`. De database is `data/verhalenboek.sqlite`. Het eerste verzoek maakt `data/config.php` als het er nog niet is en overschrijft het daarna nooit:
17 PHP 8.2+, PDO SQLite, cURL, mbstring en een schrijfbare `data/`. De database is `data/verhalenboek.sqlite`. Het eerste verzoek maakt `data/config.php` als het er nog niet is. Een bestaand bestand blijft staan; ontbreekt `key_secret`, dan vult de app alleen die waarde aan. Die versleutelt API-sleutels zodat een beheerder ze opnieuw kan tonen.
18 18
19 19 ```php
20 20 <?php
@@ -22,6 +22,7 @@ return [
22 22 'base_url' => 'https://projects.timfalken.com/verhaaltjesboek',
23 23 'client_id' => 'projects.timfalken.com',
24 24 'client_secret' => 'het-geheim-uit-admin',
25 'key_secret' => 'blijft-de-gegenereerde-waarde',
25 26 ];
26 27 ```
27 28
@@ -14,7 +14,7 @@ http://127.0.0.1:8080 logt automatisch in als `test_user_1` (beheerder). Dat geb
14
14
15## Productie
15## Productie
16
16
17PHP 8.2+, PDO SQLite, cURL, mbstring en een schrijfbare `data/`. De database is `data/verhalenboek.sqlite`. Het eerste verzoek maakt `data/config.php` als het er nog niet is en overschrijft het daarna nooit:
17PHP 8.2+, PDO SQLite, cURL, mbstring en een schrijfbare `data/`. De database is `data/verhalenboek.sqlite`. Het eerste verzoek maakt `data/config.php` als het er nog niet is. Een bestaand bestand blijft staan; ontbreekt `key_secret`, dan vult de app alleen die waarde aan. Die versleutelt API-sleutels zodat een beheerder ze opnieuw kan tonen.
18
18
19```php
19```php
20<?php
20<?php
@@ -22,6 +22,7 @@ return [
22 'base_url' => 'https://projects.timfalken.com/verhaaltjesboek',
22 'base_url' => 'https://projects.timfalken.com/verhaaltjesboek',
23 'client_id' => 'projects.timfalken.com',
23 'client_id' => 'projects.timfalken.com',
24 'client_secret' => 'het-geheim-uit-admin',
24 'client_secret' => 'het-geheim-uit-admin',
25 'key_secret' => 'blijft-de-gegenereerde-waarde',
25];
26];
26```
27```
27
28
web/api.php +4 −3
@@ -58,9 +58,10 @@ try {
58 58 fail('Deze methode is hier niet toegestaan.', 405);
59 59 }
60 60 if (preg_match('#^/keys/(\d+)$#', $route, $match)) {
61 if ($method !== 'DELETE') fail('Deze methode is hier niet toegestaan.', 405);
62 61 requireAdminSession($actor);
63 jsonOut(['key' => revokeApiKey((int)$match[1])]);
62 if ($method === 'GET') jsonOut(['key' => revealApiKey((int)$match[1])]);
63 if ($method === 'DELETE') jsonOut(['key' => revokeApiKey((int)$match[1])]);
64 fail('Deze methode is hier niet toegestaan.', 405);
64 65 }
65 66 if ($route === '/days') {
66 67 if ($method === 'GET') jsonOut(['days' => listDays($readerId)]);
@@ -112,7 +113,7 @@ try {
112 113 }
113 114 fail('Onbekend pad.', 404);
114 115 } catch (AppException $e) {
115 fail($e->getMessage(), $e->status);
116 fail($e->getMessage(), $e->status, $e->auth);
116 117 } catch (Throwable $e) {
117 118 error_log($e->getMessage());
118 119 fail('Er ging iets mis.', 500);
@@ -58,9 +58,10 @@ try {
58 fail('Deze methode is hier niet toegestaan.', 405);
58 fail('Deze methode is hier niet toegestaan.', 405);
59 }
59 }
60 if (preg_match('#^/keys/(\d+)$#', $route, $match)) {
60 if (preg_match('#^/keys/(\d+)$#', $route, $match)) {
61 if ($method !== 'DELETE') fail('Deze methode is hier niet toegestaan.', 405);
62 requireAdminSession($actor);
61 requireAdminSession($actor);
63 jsonOut(['key' => revokeApiKey((int)$match[1])]);
62 if ($method === 'GET') jsonOut(['key' => revealApiKey((int)$match[1])]);
63 if ($method === 'DELETE') jsonOut(['key' => revokeApiKey((int)$match[1])]);
64 fail('Deze methode is hier niet toegestaan.', 405);
64 }
65 }
65 if ($route === '/days') {
66 if ($route === '/days') {
66 if ($method === 'GET') jsonOut(['days' => listDays($readerId)]);
67 if ($method === 'GET') jsonOut(['days' => listDays($readerId)]);
@@ -112,7 +113,7 @@ try {
112 }
113 }
113 fail('Onbekend pad.', 404);
114 fail('Onbekend pad.', 404);
114} catch (AppException $e) {
115} catch (AppException $e) {
115 fail($e->getMessage(), $e->status);
116 fail($e->getMessage(), $e->status, $e->auth);
116} catch (Throwable $e) {
117} catch (Throwable $e) {
117 error_log($e->getMessage());
118 error_log($e->getMessage());
118 fail('Er ging iets mis.', 500);
119 fail('Er ging iets mis.', 500);
web/assets/app.css +15 −2
@@ -274,9 +274,22 @@ legend { padding: 0 0.3rem; color: var(--muted); }
274 274 gap: 0.55rem;
275 275 }
276 276 .token-once textarea { font-family: ui-monospace, "Cascadia Mono", "Liberation Mono", monospace; min-height: 5rem; }
277 .key-row { display: flex; justify-content: space-between; gap: 0.8rem; align-items: center; padding: 0.75rem 0; border-bottom: 1px solid var(--line); }
278 .key-row p { margin: 0.15rem 0; }
277 .key-row { display: flex; justify-content: space-between; gap: 0.8rem; align-items: center; padding: 0.35rem 0; border-bottom: 1px solid var(--line); }
278 .key-row p, .key-open span { display: block; margin: 0.15rem 0; }
279 279 .key-row .revoked { color: var(--muted); text-decoration: line-through; }
280 .key-open {
281 flex: 1;
282 min-width: 0;
283 margin: 0;
284 padding: 0.45rem 0.2rem;
285 border: 0;
286 background: transparent;
287 color: inherit;
288 font: inherit;
289 text-align: left;
290 cursor: pointer;
291 }
292 .key-open:hover span:first-child, .key-open:focus-visible span:first-child { text-decoration: underline; }
280 293 .docs { padding-bottom: 3rem; }
281 294 .docs h1 { font-size: clamp(2rem, 5vw, 3rem); }
282 295 .docs pre {
@@ -274,9 +274,22 @@ legend { padding: 0 0.3rem; color: var(--muted); }
274 gap: 0.55rem;
274 gap: 0.55rem;
275}
275}
276.token-once textarea { font-family: ui-monospace, "Cascadia Mono", "Liberation Mono", monospace; min-height: 5rem; }
276.token-once textarea { font-family: ui-monospace, "Cascadia Mono", "Liberation Mono", monospace; min-height: 5rem; }
277.key-row { display: flex; justify-content: space-between; gap: 0.8rem; align-items: center; padding: 0.75rem 0; border-bottom: 1px solid var(--line); }
277.key-row { display: flex; justify-content: space-between; gap: 0.8rem; align-items: center; padding: 0.35rem 0; border-bottom: 1px solid var(--line); }
278.key-row p { margin: 0.15rem 0; }
278.key-row p, .key-open span { display: block; margin: 0.15rem 0; }
279.key-row .revoked { color: var(--muted); text-decoration: line-through; }
279.key-row .revoked { color: var(--muted); text-decoration: line-through; }
280.key-open {
281 flex: 1;
282 min-width: 0;
283 margin: 0;
284 padding: 0.45rem 0.2rem;
285 border: 0;
286 background: transparent;
287 color: inherit;
288 font: inherit;
289 text-align: left;
290 cursor: pointer;
291}
292.key-open:hover span:first-child, .key-open:focus-visible span:first-child { text-decoration: underline; }
280.docs { padding-bottom: 3rem; }
293.docs { padding-bottom: 3rem; }
281.docs h1 { font-size: clamp(2rem, 5vw, 3rem); }
294.docs h1 { font-size: clamp(2rem, 5vw, 3rem); }
282.docs pre {
295.docs pre {
web/assets/app.js +37 −25
@@ -2,7 +2,7 @@
2 2
3 3 const MONTHS = ['januari', 'februari', 'maart', 'april', 'mei', 'juni', 'juli', 'augustus', 'september', 'oktober', 'november', 'december'];
4 4 const ROMAN = ['I', 'II', 'III'];
5 const state = { me: null, csrf: '', local: false, freshKey: null };
5 const state = { me: null, csrf: '', local: false, freshKey: null, revealedKey: null };
6 6 let renderToken = 0;
7 7 let menuAnchor = null;
8 8 let ignoreCloseUntil = 0;
@@ -419,6 +419,18 @@ async function paintBeheer() {
419 419 ]));
420 420 }
421 421
422 function tokenPanel(title, token) {
423 const field = el('textarea', { readonly: 'readonly', rows: '3' });
424 field.value = token;
425 const copy = el('button', { class: 'quiet', type: 'button' }, ['Kopieer']);
426 copy.addEventListener('click', async () => {
427 field.select();
428 try { await navigator.clipboard.writeText(field.value); toast('Gekopieerd.'); }
429 catch (failure) { toast('Selecteer de sleutel en kopieer hem handmatig.'); }
430 });
431 return el('div', { class: 'token-once' }, [el('strong', {}, [title]), field, copy]);
432 }
433
422 434 function paintKeys(keys) {
423 435 const name = el('input', { type: 'text', maxlength: '80', required: 'required' });
424 436 const error = el('p', { class: 'form-error' });
@@ -433,27 +445,31 @@ function paintKeys(keys) {
433 445 try {
434 446 const result = await api('POST', '/keys', { name: name.value });
435 447 state.freshKey = result.key;
448 state.revealedKey = null;
436 449 await render();
437 450 } catch (failure) { error.textContent = failure.message; }
438 451 });
439 452 const section = el('section', { class: 'keys' }, [el('h1', {}, ['API-sleutels']), form]);
440 if (state.freshKey && state.freshKey.token) {
441 const token = el('textarea', { readonly: 'readonly', rows: '3' });
442 token.value = state.freshKey.token;
443 const copy = el('button', { class: 'quiet', type: 'button' }, ['Kopieer']);
444 copy.addEventListener('click', async () => {
445 token.select();
446 try { await navigator.clipboard.writeText(token.value); toast('Gekopieerd.'); }
447 catch (failure) { toast('Selecteer de sleutel en kopieer hem handmatig.'); }
448 });
449 section.append(el('div', { class: 'token-once' }, [
450 el('strong', {}, ['Deze sleutel wordt één keer getoond. Bewaar hem nu.']),
451 token,
452 copy,
453 ]));
453 if (state.revealedKey && state.revealedKey.token) {
454 section.append(tokenPanel('Sleutel van ' + state.revealedKey.name, state.revealedKey.token));
455 } else if (state.freshKey && state.freshKey.token) {
456 section.append(tokenPanel('Nieuwe sleutel. Tik er later opnieuw op om hem te zien.', state.freshKey.token));
454 457 }
455 458 const list = el('div', {});
456 459 keys.forEach((key) => {
460 const open = el('button', { type: 'button', class: 'key-open' }, [
461 el('span', { class: key.revoked ? 'revoked' : '' }, [key.name]),
462 el('span', {}, [key.prefix + '…']),
463 el('span', {}, [key.revoked ? 'Ingetrokken' : 'Actief']),
464 ]);
465 open.addEventListener('click', async () => {
466 try {
467 const result = await api('GET', '/keys/' + key.id);
468 state.freshKey = null;
469 state.revealedKey = result.key;
470 await render();
471 } catch (failure) { toast(failure.message); }
472 });
457 473 const revoke = el('button', { class: 'danger', type: 'button' }, ['Intrekken']);
458 474 revoke.disabled = key.revoked != null;
459 475 revoke.addEventListener('click', async () => {
@@ -461,24 +477,20 @@ function paintKeys(keys) {
461 477 try { await api('DELETE', '/keys/' + key.id); await render(); }
462 478 catch (failure) { toast(failure.message); }
463 479 });
464 list.append(el('div', { class: 'key-row' }, [
465 el('div', {}, [
466 el('p', { class: key.revoked ? 'revoked' : '' }, [key.name]),
467 el('p', {}, [key.prefix + '…']),
468 el('p', {}, [key.revoked ? 'Ingetrokken' : 'Actief']),
469 ]),
470 revoke,
471 ]));
480 list.append(el('div', { class: 'key-row' }, [open, revoke]));
472 481 });
473 482 if (!keys.length) list.append(el('p', { class: 'empty' }, ['Nog geen sleutels.']));
474 section.append(el('h2', {}, ['Bestaande sleutels']), list);
483 section.append(el('h2', {}, ['Bestaande sleutels']), el('p', { class: 'lede' }, ['Tik op een sleutel om de volledige sleutel opnieuw te zien.']), list);
475 484 app.replaceChildren(section);
476 485 }
477 486
478 487 async function render() {
479 488 const token = ++renderToken;
480 489 const path = pathNow();
481 if (path !== '/sleutels') state.freshKey = null;
490 if (path !== '/sleutels') {
491 state.freshKey = null;
492 state.revealedKey = null;
493 }
482 494 closeMenu();
483 495 highlight(path);
484 496 document.title = 'Verhalenboek';
@@ -2,7 +2,7 @@
2
2
3const MONTHS = ['januari', 'februari', 'maart', 'april', 'mei', 'juni', 'juli', 'augustus', 'september', 'oktober', 'november', 'december'];
3const MONTHS = ['januari', 'februari', 'maart', 'april', 'mei', 'juni', 'juli', 'augustus', 'september', 'oktober', 'november', 'december'];
4const ROMAN = ['I', 'II', 'III'];
4const ROMAN = ['I', 'II', 'III'];
5const state = { me: null, csrf: '', local: false, freshKey: null };
5const state = { me: null, csrf: '', local: false, freshKey: null, revealedKey: null };
6let renderToken = 0;
6let renderToken = 0;
7let menuAnchor = null;
7let menuAnchor = null;
8let ignoreCloseUntil = 0;
8let ignoreCloseUntil = 0;
@@ -419,6 +419,18 @@ async function paintBeheer() {
419 ]));
419 ]));
420}
420}
421
421
422function tokenPanel(title, token) {
423 const field = el('textarea', { readonly: 'readonly', rows: '3' });
424 field.value = token;
425 const copy = el('button', { class: 'quiet', type: 'button' }, ['Kopieer']);
426 copy.addEventListener('click', async () => {
427 field.select();
428 try { await navigator.clipboard.writeText(field.value); toast('Gekopieerd.'); }
429 catch (failure) { toast('Selecteer de sleutel en kopieer hem handmatig.'); }
430 });
431 return el('div', { class: 'token-once' }, [el('strong', {}, [title]), field, copy]);
432}
433
422function paintKeys(keys) {
434function paintKeys(keys) {
423 const name = el('input', { type: 'text', maxlength: '80', required: 'required' });
435 const name = el('input', { type: 'text', maxlength: '80', required: 'required' });
424 const error = el('p', { class: 'form-error' });
436 const error = el('p', { class: 'form-error' });
@@ -433,27 +445,31 @@ function paintKeys(keys) {
433 try {
445 try {
434 const result = await api('POST', '/keys', { name: name.value });
446 const result = await api('POST', '/keys', { name: name.value });
435 state.freshKey = result.key;
447 state.freshKey = result.key;
448 state.revealedKey = null;
436 await render();
449 await render();
437 } catch (failure) { error.textContent = failure.message; }
450 } catch (failure) { error.textContent = failure.message; }
438 });
451 });
439 const section = el('section', { class: 'keys' }, [el('h1', {}, ['API-sleutels']), form]);
452 const section = el('section', { class: 'keys' }, [el('h1', {}, ['API-sleutels']), form]);
440 if (state.freshKey && state.freshKey.token) {
453 if (state.revealedKey && state.revealedKey.token) {
441 const token = el('textarea', { readonly: 'readonly', rows: '3' });
454 section.append(tokenPanel('Sleutel van ' + state.revealedKey.name, state.revealedKey.token));
442 token.value = state.freshKey.token;
455 } else if (state.freshKey && state.freshKey.token) {
443 const copy = el('button', { class: 'quiet', type: 'button' }, ['Kopieer']);
456 section.append(tokenPanel('Nieuwe sleutel. Tik er later opnieuw op om hem te zien.', state.freshKey.token));
444 copy.addEventListener('click', async () => {
445 token.select();
446 try { await navigator.clipboard.writeText(token.value); toast('Gekopieerd.'); }
447 catch (failure) { toast('Selecteer de sleutel en kopieer hem handmatig.'); }
448 });
449 section.append(el('div', { class: 'token-once' }, [
450 el('strong', {}, ['Deze sleutel wordt één keer getoond. Bewaar hem nu.']),
451 token,
452 copy,
453 ]));
454 }
457 }
455 const list = el('div', {});
458 const list = el('div', {});
456 keys.forEach((key) => {
459 keys.forEach((key) => {
460 const open = el('button', { type: 'button', class: 'key-open' }, [
461 el('span', { class: key.revoked ? 'revoked' : '' }, [key.name]),
462 el('span', {}, [key.prefix + '…']),
463 el('span', {}, [key.revoked ? 'Ingetrokken' : 'Actief']),
464 ]);
465 open.addEventListener('click', async () => {
466 try {
467 const result = await api('GET', '/keys/' + key.id);
468 state.freshKey = null;
469 state.revealedKey = result.key;
470 await render();
471 } catch (failure) { toast(failure.message); }
472 });
457 const revoke = el('button', { class: 'danger', type: 'button' }, ['Intrekken']);
473 const revoke = el('button', { class: 'danger', type: 'button' }, ['Intrekken']);
458 revoke.disabled = key.revoked != null;
474 revoke.disabled = key.revoked != null;
459 revoke.addEventListener('click', async () => {
475 revoke.addEventListener('click', async () => {
@@ -461,24 +477,20 @@ function paintKeys(keys) {
461 try { await api('DELETE', '/keys/' + key.id); await render(); }
477 try { await api('DELETE', '/keys/' + key.id); await render(); }
462 catch (failure) { toast(failure.message); }
478 catch (failure) { toast(failure.message); }
463 });
479 });
464 list.append(el('div', { class: 'key-row' }, [
480 list.append(el('div', { class: 'key-row' }, [open, revoke]));
465 el('div', {}, [
466 el('p', { class: key.revoked ? 'revoked' : '' }, [key.name]),
467 el('p', {}, [key.prefix + '…']),
468 el('p', {}, [key.revoked ? 'Ingetrokken' : 'Actief']),
469 ]),
470 revoke,
471 ]));
472 });
481 });
473 if (!keys.length) list.append(el('p', { class: 'empty' }, ['Nog geen sleutels.']));
482 if (!keys.length) list.append(el('p', { class: 'empty' }, ['Nog geen sleutels.']));
474 section.append(el('h2', {}, ['Bestaande sleutels']), list);
483 section.append(el('h2', {}, ['Bestaande sleutels']), el('p', { class: 'lede' }, ['Tik op een sleutel om de volledige sleutel opnieuw te zien.']), list);
475 app.replaceChildren(section);
484 app.replaceChildren(section);
476}
485}
477
486
478async function render() {
487async function render() {
479 const token = ++renderToken;
488 const token = ++renderToken;
480 const path = pathNow();
489 const path = pathNow();
481 if (path !== '/sleutels') state.freshKey = null;
490 if (path !== '/sleutels') {
491 state.freshKey = null;
492 state.revealedKey = null;
493 }
482 closeMenu();
494 closeMenu();
483 highlight(path);
495 highlight(path);
484 document.title = 'Verhalenboek';
496 document.title = 'Verhalenboek';
web/docs.php +15 −1
@@ -17,7 +17,21 @@ $base = 'https://projects.timfalken.com/verhaaltjesboek';
17 17 <p><a href="./">← Verhalenboek</a></p>
18 18 <h1>API</h1>
19 19 <p>JSON REST voor een schrijver-agent. Elke aanvraag gaat naar <code>api.php</code> gevolgd door het pad, bijvoorbeeld <code><?= htmlspecialchars($base, ENT_QUOTES) ?>/api.php/days</code>. Lokaal is het pad hetzelfde op de ontwikkelserver.</p>
20 <p>Authenticatie: <code>Authorization: Bearer vb_…</code>. De sleutel maakt een beheerder één keer aan onder Sleutels. Stuur <code>Accept: application/json</code> en, bij een body, <code>Content-Type: application/json</code>. Fouten zijn <code>{"error":"…"}</code> met status 401, 403, 404, 405, 409 of 422.</p>
20 <p>Authenticatie: <code>Authorization: Bearer vb_…</code>. Een beheerder maakt sleutels aan onder Sleutels (<code><?= htmlspecialchars($base, ENT_QUOTES) ?>/#/sleutels</code>) en kan een bestaande sleutel daar opnieuw tonen. Stuur <code>Accept: application/json</code> en, bij een body, <code>Content-Type: application/json</code>. Fouten zijn JSON met status 401, 403, 404, 405, 409 of 422.</p>
21 <h2>Geen of ongeldige authenticatie</h2>
22 <p>Een 401 heeft de header <code>WWW-Authenticate: Bearer</code>. Een 401, en een 403 wanneer een lezer iets doet dat een sleutel of beheerder vereist, bevat naast <code>error</code> ook <code>how_to_authenticate</code> en dezelfde tekst in <code>hint</code>. Die tekst onderscheidt drie gevallen en verwijst naar deze pagina:</p>
23 <ul>
24 <li><strong>Geen header.</strong> Er is geen <code>Authorization</code>-header.</li>
25 <li><strong>Verkeerd formaat.</strong> De header is geen <code>Bearer</code>, of de sleutel is niet <code>vb_</code> plus 64 hexadecimale tekens.</li>
26 <li><strong>Onbekend of ingetrokken.</strong> Het formaat klopt, maar de sleutel bestaat niet of is ingetrokken.</li>
27 </ul>
28 <p>Voorbeeld bij een ontbrekende header:</p>
29 <pre><code>{
30 "error": "Log in om verder te gaan.",
31 "how_to_authenticate": "Er is geen Authorization-header. Stuur de header Authorization: Bearer vb_… met een API-sleutel. Een beheerder maakt sleutels aan onder Sleutels op <?= htmlspecialchars($base, ENT_QUOTES) ?>/#/sleutels. Uitleg: <?= htmlspecialchars($base, ENT_QUOTES) ?>/docs.php",
32 "hint": "…"
33 }</code></pre>
34 <p><code>hint</code> is dezelfde tekst als <code>how_to_authenticate</code>. Een 403 voor een lezer die wil schrijven legt uit dat een API-sleutel of een beheerder nodig is. Sleutels beheren kan alleen in de ingelogde beheerderssessie, niet met de sleutel zelf. Een 403 door een ongeldige sessiecookie (CSRF) heeft deze uitleg niet.</p>
21 35 <h2>Dagen</h2>
22 36 <table>
23 37 <thead><tr><th>Methode</th><th>Pad</th><th>Wat</th></tr></thead>
@@ -17,7 +17,21 @@ $base = 'https://projects.timfalken.com/verhaaltjesboek';
17<p><a href="./">← Verhalenboek</a></p>
17<p><a href="./">← Verhalenboek</a></p>
18<h1>API</h1>
18<h1>API</h1>
19<p>JSON REST voor een schrijver-agent. Elke aanvraag gaat naar <code>api.php</code> gevolgd door het pad, bijvoorbeeld <code><?= htmlspecialchars($base, ENT_QUOTES) ?>/api.php/days</code>. Lokaal is het pad hetzelfde op de ontwikkelserver.</p>
19<p>JSON REST voor een schrijver-agent. Elke aanvraag gaat naar <code>api.php</code> gevolgd door het pad, bijvoorbeeld <code><?= htmlspecialchars($base, ENT_QUOTES) ?>/api.php/days</code>. Lokaal is het pad hetzelfde op de ontwikkelserver.</p>
20<p>Authenticatie: <code>Authorization: Bearer vb_…</code>. De sleutel maakt een beheerder één keer aan onder Sleutels. Stuur <code>Accept: application/json</code> en, bij een body, <code>Content-Type: application/json</code>. Fouten zijn <code>{"error":"…"}</code> met status 401, 403, 404, 405, 409 of 422.</p>
20<p>Authenticatie: <code>Authorization: Bearer vb_…</code>. Een beheerder maakt sleutels aan onder Sleutels (<code><?= htmlspecialchars($base, ENT_QUOTES) ?>/#/sleutels</code>) en kan een bestaande sleutel daar opnieuw tonen. Stuur <code>Accept: application/json</code> en, bij een body, <code>Content-Type: application/json</code>. Fouten zijn JSON met status 401, 403, 404, 405, 409 of 422.</p>
21<h2>Geen of ongeldige authenticatie</h2>
22<p>Een 401 heeft de header <code>WWW-Authenticate: Bearer</code>. Een 401, en een 403 wanneer een lezer iets doet dat een sleutel of beheerder vereist, bevat naast <code>error</code> ook <code>how_to_authenticate</code> en dezelfde tekst in <code>hint</code>. Die tekst onderscheidt drie gevallen en verwijst naar deze pagina:</p>
23<ul>
24<li><strong>Geen header.</strong> Er is geen <code>Authorization</code>-header.</li>
25<li><strong>Verkeerd formaat.</strong> De header is geen <code>Bearer</code>, of de sleutel is niet <code>vb_</code> plus 64 hexadecimale tekens.</li>
26<li><strong>Onbekend of ingetrokken.</strong> Het formaat klopt, maar de sleutel bestaat niet of is ingetrokken.</li>
27</ul>
28<p>Voorbeeld bij een ontbrekende header:</p>
29<pre><code>{
30 "error": "Log in om verder te gaan.",
31 "how_to_authenticate": "Er is geen Authorization-header. Stuur de header Authorization: Bearer vb_… met een API-sleutel. Een beheerder maakt sleutels aan onder Sleutels op <?= htmlspecialchars($base, ENT_QUOTES) ?>/#/sleutels. Uitleg: <?= htmlspecialchars($base, ENT_QUOTES) ?>/docs.php",
32 "hint": "…"
33}</code></pre>
34<p><code>hint</code> is dezelfde tekst als <code>how_to_authenticate</code>. Een 403 voor een lezer die wil schrijven legt uit dat een API-sleutel of een beheerder nodig is. Sleutels beheren kan alleen in de ingelogde beheerderssessie, niet met de sleutel zelf. Een 403 door een ongeldige sessiecookie (CSRF) heeft deze uitleg niet.</p>
21<h2>Dagen</h2>
35<h2>Dagen</h2>
22<table>
36<table>
23<thead><tr><th>Methode</th><th>Pad</th><th>Wat</th></tr></thead>
37<thead><tr><th>Methode</th><th>Pad</th><th>Wat</th></tr></thead>
web/lib/Storybook.php +40 −6
@@ -2,7 +2,7 @@
2 2 declare(strict_types=1);
3 3
4 4 final class AppException extends RuntimeException {
5 public function __construct(string $message, public int $status = 422) {
5 public function __construct(string $message, public int $status = 422, public ?string $auth = null) {
6 6 parent::__construct($message);
7 7 }
8 8 }
@@ -333,15 +333,49 @@ function keyPublic(array $row): array {
333 333 ];
334 334 }
335 335
336 function sealToken(string $token): string {
337 $key = hex2bin((string)config()['key_secret']);
338 if ($key === false || strlen($key) !== 32) throw new RuntimeException('key_secret in data/config.php moet 64 hexadecimale tekens zijn.');
339 $iv = random_bytes(12);
340 $tag = '';
341 $cipher = openssl_encrypt($token, 'aes-256-gcm', $key, OPENSSL_RAW_DATA, $iv, $tag);
342 if ($cipher === false || strlen($tag) !== 16) throw new RuntimeException('De API-sleutel kon niet worden versleuteld.');
343 return base64_encode($iv.$tag.$cipher);
344 }
345
346 function openToken(string $sealed): string {
347 $key = hex2bin((string)config()['key_secret']);
348 $raw = base64_decode($sealed, true);
349 if ($key === false || strlen($key) !== 32 || $raw === false || strlen($raw) < 29) {
350 throw new AppException('Deze sleutel kan niet opnieuw worden getoond. Maak een nieuwe aan.', 409);
351 }
352 $plain = openssl_decrypt(substr($raw, 28), 'aes-256-gcm', $key, OPENSSL_RAW_DATA, substr($raw, 0, 12), substr($raw, 12, 16));
353 if (!is_string($plain) || $plain === '') throw new AppException('Deze sleutel kan niet opnieuw worden getoond. Maak een nieuwe aan.', 409);
354 return $plain;
355 }
356
336 357 function createApiKey(string $userId, mixed $name): array {
337 358 $name = cleanText($name, 80, 'De naam van de sleutel');
338 359 $token = 'vb_'.bin2hex(random_bytes(32));
339 query('INSERT INTO api_keys (user_id, name, token_hash, token_prefix, created, revoked) VALUES (?,?,?,?,?,NULL)', [
340 $userId, $name, hash('sha256', $token), substr($token, 0, 11), time(),
360 query('INSERT INTO api_keys (user_id, name, token_hash, token_prefix, token_cipher, created, revoked) VALUES (?,?,?,?,?,?,NULL)', [
361 $userId, $name, hash('sha256', $token), substr($token, 0, 11), sealToken($token), time(),
341 362 ]);
342 363 return keyPublic(query('SELECT * FROM api_keys WHERE id=?', [(int)db()->lastInsertId()])->fetch()) + ['token' => $token];
343 364 }
344 365
366 function revealApiKey(int $id): array {
367 $row = query('SELECT * FROM api_keys WHERE id=?', [$id])->fetch();
368 if (!$row) throw new AppException('Deze sleutel bestaat niet.', 404);
369 if (!is_string($row['token_cipher'] ?? null) || $row['token_cipher'] === '') {
370 throw new AppException('Deze sleutel kan niet opnieuw worden getoond. Maak een nieuwe aan.', 409);
371 }
372 $token = openToken($row['token_cipher']);
373 if (!hash_equals($row['token_hash'], hash('sha256', $token))) {
374 throw new AppException('Deze sleutel kan niet opnieuw worden getoond. Maak een nieuwe aan.', 409);
375 }
376 return keyPublic($row) + ['token' => $token];
377 }
378
345 379 function listApiKeys(): array {
346 380 return array_map('keyPublic', query('SELECT * FROM api_keys ORDER BY revoked IS NOT NULL, id DESC')->fetchAll());
347 381 }
@@ -356,9 +390,9 @@ function revokeApiKey(int $id): array {
356 390 }
357 391
358 392 function actorFromToken(string $token): array {
359 if (!preg_match('/^vb_[a-f0-9]{64}$/', $token)) throw new AppException('Ongeldige API-sleutel.', 401);
393 if (!preg_match('/^vb_[a-f0-9]{64}$/', $token)) throw new AppException('De API-sleutel heeft het verkeerde formaat.', 401, 'format');
360 394 $row = query('SELECT * FROM api_keys WHERE token_hash=?', [hash('sha256', $token)])->fetch();
361 if (!$row) throw new AppException('Ongeldige API-sleutel.', 401);
362 if ($row['revoked'] !== null) throw new AppException('Deze API-sleutel is ingetrokken.', 401);
395 if (!$row) throw new AppException('Deze API-sleutel is onbekend.', 401, 'rejected');
396 if ($row['revoked'] !== null) throw new AppException('Deze API-sleutel is ingetrokken.', 401, 'rejected');
363 397 return ['kind' => 'token', 'userId' => $row['user_id'], 'role' => 'admin', 'keyId' => (int)$row['id']];
364 398 }
@@ -2,7 +2,7 @@
2declare(strict_types=1);
2declare(strict_types=1);
3
3
4final class AppException extends RuntimeException {
4final class AppException extends RuntimeException {
5 public function __construct(string $message, public int $status = 422) {
5 public function __construct(string $message, public int $status = 422, public ?string $auth = null) {
6 parent::__construct($message);
6 parent::__construct($message);
7 }
7 }
8}
8}
@@ -333,15 +333,49 @@ function keyPublic(array $row): array {
333 ];
333 ];
334}
334}
335
335
336function sealToken(string $token): string {
337 $key = hex2bin((string)config()['key_secret']);
338 if ($key === false || strlen($key) !== 32) throw new RuntimeException('key_secret in data/config.php moet 64 hexadecimale tekens zijn.');
339 $iv = random_bytes(12);
340 $tag = '';
341 $cipher = openssl_encrypt($token, 'aes-256-gcm', $key, OPENSSL_RAW_DATA, $iv, $tag);
342 if ($cipher === false || strlen($tag) !== 16) throw new RuntimeException('De API-sleutel kon niet worden versleuteld.');
343 return base64_encode($iv.$tag.$cipher);
344}
345
346function openToken(string $sealed): string {
347 $key = hex2bin((string)config()['key_secret']);
348 $raw = base64_decode($sealed, true);
349 if ($key === false || strlen($key) !== 32 || $raw === false || strlen($raw) < 29) {
350 throw new AppException('Deze sleutel kan niet opnieuw worden getoond. Maak een nieuwe aan.', 409);
351 }
352 $plain = openssl_decrypt(substr($raw, 28), 'aes-256-gcm', $key, OPENSSL_RAW_DATA, substr($raw, 0, 12), substr($raw, 12, 16));
353 if (!is_string($plain) || $plain === '') throw new AppException('Deze sleutel kan niet opnieuw worden getoond. Maak een nieuwe aan.', 409);
354 return $plain;
355}
356
336function createApiKey(string $userId, mixed $name): array {
357function createApiKey(string $userId, mixed $name): array {
337 $name = cleanText($name, 80, 'De naam van de sleutel');
358 $name = cleanText($name, 80, 'De naam van de sleutel');
338 $token = 'vb_'.bin2hex(random_bytes(32));
359 $token = 'vb_'.bin2hex(random_bytes(32));
339 query('INSERT INTO api_keys (user_id, name, token_hash, token_prefix, created, revoked) VALUES (?,?,?,?,?,NULL)', [
360 query('INSERT INTO api_keys (user_id, name, token_hash, token_prefix, token_cipher, created, revoked) VALUES (?,?,?,?,?,?,NULL)', [
340 $userId, $name, hash('sha256', $token), substr($token, 0, 11), time(),
361 $userId, $name, hash('sha256', $token), substr($token, 0, 11), sealToken($token), time(),
341 ]);
362 ]);
342 return keyPublic(query('SELECT * FROM api_keys WHERE id=?', [(int)db()->lastInsertId()])->fetch()) + ['token' => $token];
363 return keyPublic(query('SELECT * FROM api_keys WHERE id=?', [(int)db()->lastInsertId()])->fetch()) + ['token' => $token];
343}
364}
344
365
366function revealApiKey(int $id): array {
367 $row = query('SELECT * FROM api_keys WHERE id=?', [$id])->fetch();
368 if (!$row) throw new AppException('Deze sleutel bestaat niet.', 404);
369 if (!is_string($row['token_cipher'] ?? null) || $row['token_cipher'] === '') {
370 throw new AppException('Deze sleutel kan niet opnieuw worden getoond. Maak een nieuwe aan.', 409);
371 }
372 $token = openToken($row['token_cipher']);
373 if (!hash_equals($row['token_hash'], hash('sha256', $token))) {
374 throw new AppException('Deze sleutel kan niet opnieuw worden getoond. Maak een nieuwe aan.', 409);
375 }
376 return keyPublic($row) + ['token' => $token];
377}
378
345function listApiKeys(): array {
379function listApiKeys(): array {
346 return array_map('keyPublic', query('SELECT * FROM api_keys ORDER BY revoked IS NOT NULL, id DESC')->fetchAll());
380 return array_map('keyPublic', query('SELECT * FROM api_keys ORDER BY revoked IS NOT NULL, id DESC')->fetchAll());
347}
381}
@@ -356,9 +390,9 @@ function revokeApiKey(int $id): array {
356}
390}
357
391
358function actorFromToken(string $token): array {
392function actorFromToken(string $token): array {
359 if (!preg_match('/^vb_[a-f0-9]{64}$/', $token)) throw new AppException('Ongeldige API-sleutel.', 401);
393 if (!preg_match('/^vb_[a-f0-9]{64}$/', $token)) throw new AppException('De API-sleutel heeft het verkeerde formaat.', 401, 'format');
360 $row = query('SELECT * FROM api_keys WHERE token_hash=?', [hash('sha256', $token)])->fetch();
394 $row = query('SELECT * FROM api_keys WHERE token_hash=?', [hash('sha256', $token)])->fetch();
361 if (!$row) throw new AppException('Ongeldige API-sleutel.', 401);
395 if (!$row) throw new AppException('Deze API-sleutel is onbekend.', 401, 'rejected');
362 if ($row['revoked'] !== null) throw new AppException('Deze API-sleutel is ingetrokken.', 401);
396 if ($row['revoked'] !== null) throw new AppException('Deze API-sleutel is ingetrokken.', 401, 'rejected');
363 return ['kind' => 'token', 'userId' => $row['user_id'], 'role' => 'admin', 'keyId' => (int)$row['id']];
397 return ['kind' => 'token', 'userId' => $row['user_id'], 'role' => 'admin', 'keyId' => (int)$row['id']];
364}
398}
web/lib/bootstrap.php +67 −10
@@ -69,9 +69,14 @@ function db(): PDO {
69 69 name TEXT NOT NULL,
70 70 token_hash TEXT NOT NULL UNIQUE,
71 71 token_prefix TEXT NOT NULL,
72 token_cipher TEXT NOT NULL DEFAULT \'\',
72 73 created INTEGER NOT NULL,
73 74 revoked INTEGER
74 75 );');
76 $columns = array_column($db->query('PRAGMA table_info(api_keys)')->fetchAll(), 'name');
77 if (!in_array('token_cipher', $columns, true)) {
78 $db->exec("ALTER TABLE api_keys ADD COLUMN token_cipher TEXT NOT NULL DEFAULT ''");
79 }
75 80 return $db;
76 81 }
77 82
@@ -115,16 +120,19 @@ function config(): array {
115 120 try {
116 121 if (!flock($lock, LOCK_EX)) throw new RuntimeException('De configuratie kon niet worden vergrendeld.');
117 122 if (!file_exists($path)) {
118 $template = <<<'PHP'
123 $secret = bin2hex(random_bytes(32));
124 $template = <<<PHP
119 125 <?php
120 126 // Vul deze waarden op deze server in. Lege velden gebruiken omgevingsvariabelen.
121 127 // Productie-URL: https://projects.timfalken.com/verhaaltjesboek
122 128 // client_id is het geregistreerde domein, meestal projects.timfalken.com.
123 129 // Het geheim komt uit https://auth.timfalken.com/admin en hoort alleen in dit bestand.
130 // key_secret versleutelt API-sleutels zodat een beheerder ze opnieuw kan tonen. Laat die staan.
124 131 return [
125 132 'base_url' => '',
126 133 'client_id' => '',
127 134 'client_secret' => '',
135 'key_secret' => '$secret',
128 136 ];
129 137
130 138 PHP;
@@ -132,6 +140,7 @@ PHP;
132 140 }
133 141 $values = require $path;
134 142 if (!is_array($values)) throw new RuntimeException('data/config.php moet een array teruggeven.');
143 $values = ensureKeySecret($path, $values);
135 144 } finally {
136 145 flock($lock, LOCK_UN);
137 146 fclose($lock);
@@ -142,6 +151,48 @@ PHP;
142 151 return $values;
143 152 }
144 153
154 function ensureKeySecret(string $path, array $values): array {
155 $secret = $values['key_secret'] ?? '';
156 if (is_string($secret) && preg_match('/^[a-f0-9]{64}$/', $secret)) return $values;
157 $secret = bin2hex(random_bytes(32));
158 $values['key_secret'] = $secret;
159 $raw = file_get_contents($path);
160 if (!is_string($raw)) throw new RuntimeException('data/config.php kon niet worden gelezen.');
161 if (preg_match("/'key_secret'\\s*=>\\s*'[^']*'/", $raw)) {
162 $updated = preg_replace("/'key_secret'\\s*=>\\s*'[^']*'/", "'key_secret' => '".$secret."'", $raw, 1);
163 } else {
164 $updated = preg_replace("/(\\r?\\n)(\\];)/", "$1 'key_secret' => '".$secret."',$1$2", $raw, 1);
165 }
166 if (!is_string($updated) || !str_contains($updated, $secret) || file_put_contents($path, $updated) !== strlen($updated)) {
167 throw new RuntimeException('key_secret kon niet in data/config.php worden gezet.');
168 }
169 return $values;
170 }
171
172 function authPublicBase(): string {
173 if (localDev()) return baseUrl();
174 $base = rtrim((string)(config()['base_url'] ?? ''), '/');
175 if (str_starts_with($base, 'https://')) return $base;
176 $env = getenv('VERHALENBOEK_BASE_URL');
177 if (is_string($env) && str_starts_with($env = rtrim($env, '/'), 'https://')) return $env;
178 return '';
179 }
180
181 function authHint(string $kind): string {
182 $base = authPublicBase();
183 $keys = ($base !== '' ? $base : '').'/#/sleutels';
184 $docs = ($base !== '' ? $base.'/' : '').'docs.php';
185 $how = 'Stuur de header Authorization: Bearer vb_… met een API-sleutel. Een beheerder maakt sleutels aan onder Sleutels op '.$keys.'. Uitleg: '.$docs;
186 return match ($kind) {
187 'missing' => 'Er is geen Authorization-header. '.$how,
188 'format' => 'De Authorization-header heeft het verkeerde formaat. Gebruik Bearer, gevolgd door vb_ en 64 hexadecimale tekens. '.$how,
189 'rejected' => 'Deze API-sleutel is onbekend of ingetrokken. '.$how,
190 'writer' => 'Dit mag alleen met een API-sleutel of als beheerder. '.$how,
191 'admin' => 'Sleutels beheren kan alleen als ingelogde beheerder, niet met een API-sleutel. Open Sleutels op '.$keys.'. Uitleg: '.$docs,
192 default => $how,
193 };
194 }
195
145 196 function baseUrl(): string {
146 197 if (localDev()) {
147 198 $dir = rtrim(str_replace('\\', '/', dirname($_SERVER['SCRIPT_NAME'] ?? '')), '/');
@@ -248,18 +299,24 @@ if (localDev() && !in_array($_SESSION['user'] ?? '', ['local:test_user_1', 'loca
248 299 }
249 300
250 301 function user(): string {
251 if (!isset($_SESSION['user'])) fail('Log in om verder te gaan.', 401);
302 if (!isset($_SESSION['user'])) fail('Log in om verder te gaan.', 401, 'missing');
252 303 if (!localDev() && (($_SESSION['expires'] ?? 0) < time())) {
253 304 unset($_SESSION['user']);
254 fail('Je sessie is verlopen. Log opnieuw in.', 401);
305 fail('Je sessie is verlopen. Log opnieuw in.', 401, 'missing');
255 306 }
256 307 return $_SESSION['user'];
257 308 }
258 309
259 function fail(string $message, int $status = 400): never {
310 function fail(string $message, int $status = 400, ?string $auth = null): never {
260 311 http_response_code($status);
261 312 header('Content-Type: application/json; charset=utf-8');
262 echo json_encode(['error' => $message], JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR);
313 $body = ['error' => $message];
314 if ($auth !== null) {
315 $body['how_to_authenticate'] = authHint($auth);
316 $body['hint'] = $body['how_to_authenticate'];
317 if ($status === 401) header('WWW-Authenticate: Bearer');
318 }
319 echo json_encode($body, JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR);
263 320 exit;
264 321 }
265 322
@@ -282,7 +339,7 @@ function bearerToken(): ?string {
282 339 }
283 340 if ($header === '') return null;
284 341 if (preg_match('/^Bearer\s+(\S+)\s*$/i', $header, $match)) return $match[1];
285 throw new AppException('De Authorization-header moet een Bearer-sleutel zijn.', 401);
342 throw new AppException('De Authorization-header heeft het verkeerde formaat.', 401, 'format');
286 343 }
287 344
288 345 function authenticate(): array {
@@ -299,11 +356,11 @@ function authenticate(): array {
299 356 $_SESSION['validated'] = time();
300 357 } catch (Throwable $e) {
301 358 unset($_SESSION['user']);
302 fail('Log opnieuw in.', 401);
359 fail('Log opnieuw in.', 401, 'missing');
303 360 }
304 361 }
305 362 $row = query('SELECT id, role FROM users WHERE id=?', [$id])->fetch();
306 if (!$row) fail('Log opnieuw in.', 401);
363 if (!$row) fail('Log opnieuw in.', 401, 'missing');
307 364 return ['kind' => 'user', 'userId' => $row['id'], 'role' => $row['role']];
308 365 }
309 366
@@ -318,11 +375,11 @@ function requireCsrf(array $actor): void {
318 375
319 376 function requireWriter(array $actor): void {
320 377 if ($actor['kind'] === 'token') return;
321 if (($actor['role'] ?? '') !== 'admin') fail('Alleen een beheerder mag dit wijzigen.', 403);
378 if (($actor['role'] ?? '') !== 'admin') fail('Alleen een beheerder mag dit wijzigen.', 403, 'writer');
322 379 }
323 380
324 381 function requireAdminSession(array $actor): void {
325 if ($actor['kind'] !== 'user' || ($actor['role'] ?? '') !== 'admin') fail('Alleen een beheerder mag sleutels beheren.', 403);
382 if ($actor['kind'] !== 'user' || ($actor['role'] ?? '') !== 'admin') fail('Alleen een beheerder mag sleutels beheren.', 403, 'admin');
326 383 }
327 384
328 385 function requireReader(array $actor): void {
@@ -69,9 +69,14 @@ function db(): PDO {
69 name TEXT NOT NULL,
69 name TEXT NOT NULL,
70 token_hash TEXT NOT NULL UNIQUE,
70 token_hash TEXT NOT NULL UNIQUE,
71 token_prefix TEXT NOT NULL,
71 token_prefix TEXT NOT NULL,
72 token_cipher TEXT NOT NULL DEFAULT \'\',
72 created INTEGER NOT NULL,
73 created INTEGER NOT NULL,
73 revoked INTEGER
74 revoked INTEGER
74 );');
75 );');
76 $columns = array_column($db->query('PRAGMA table_info(api_keys)')->fetchAll(), 'name');
77 if (!in_array('token_cipher', $columns, true)) {
78 $db->exec("ALTER TABLE api_keys ADD COLUMN token_cipher TEXT NOT NULL DEFAULT ''");
79 }
75 return $db;
80 return $db;
76}
81}
77
82
@@ -115,16 +120,19 @@ function config(): array {
115 try {
120 try {
116 if (!flock($lock, LOCK_EX)) throw new RuntimeException('De configuratie kon niet worden vergrendeld.');
121 if (!flock($lock, LOCK_EX)) throw new RuntimeException('De configuratie kon niet worden vergrendeld.');
117 if (!file_exists($path)) {
122 if (!file_exists($path)) {
118 $template = <<<'PHP'
123 $secret = bin2hex(random_bytes(32));
124 $template = <<<PHP
119<?php
125<?php
120// Vul deze waarden op deze server in. Lege velden gebruiken omgevingsvariabelen.
126// Vul deze waarden op deze server in. Lege velden gebruiken omgevingsvariabelen.
121// Productie-URL: https://projects.timfalken.com/verhaaltjesboek
127// Productie-URL: https://projects.timfalken.com/verhaaltjesboek
122// client_id is het geregistreerde domein, meestal projects.timfalken.com.
128// client_id is het geregistreerde domein, meestal projects.timfalken.com.
123// Het geheim komt uit https://auth.timfalken.com/admin en hoort alleen in dit bestand.
129// Het geheim komt uit https://auth.timfalken.com/admin en hoort alleen in dit bestand.
130// key_secret versleutelt API-sleutels zodat een beheerder ze opnieuw kan tonen. Laat die staan.
124return [
131return [
125 'base_url' => '',
132 'base_url' => '',
126 'client_id' => '',
133 'client_id' => '',
127 'client_secret' => '',
134 'client_secret' => '',
135 'key_secret' => '$secret',
128];
136];
129
137
130PHP;
138PHP;
@@ -132,6 +140,7 @@ PHP;
132 }
140 }
133 $values = require $path;
141 $values = require $path;
134 if (!is_array($values)) throw new RuntimeException('data/config.php moet een array teruggeven.');
142 if (!is_array($values)) throw new RuntimeException('data/config.php moet een array teruggeven.');
143 $values = ensureKeySecret($path, $values);
135 } finally {
144 } finally {
136 flock($lock, LOCK_UN);
145 flock($lock, LOCK_UN);
137 fclose($lock);
146 fclose($lock);
@@ -142,6 +151,48 @@ PHP;
142 return $values;
151 return $values;
143}
152}
144
153
154function ensureKeySecret(string $path, array $values): array {
155 $secret = $values['key_secret'] ?? '';
156 if (is_string($secret) && preg_match('/^[a-f0-9]{64}$/', $secret)) return $values;
157 $secret = bin2hex(random_bytes(32));
158 $values['key_secret'] = $secret;
159 $raw = file_get_contents($path);
160 if (!is_string($raw)) throw new RuntimeException('data/config.php kon niet worden gelezen.');
161 if (preg_match("/'key_secret'\\s*=>\\s*'[^']*'/", $raw)) {
162 $updated = preg_replace("/'key_secret'\\s*=>\\s*'[^']*'/", "'key_secret' => '".$secret."'", $raw, 1);
163 } else {
164 $updated = preg_replace("/(\\r?\\n)(\\];)/", "$1 'key_secret' => '".$secret."',$1$2", $raw, 1);
165 }
166 if (!is_string($updated) || !str_contains($updated, $secret) || file_put_contents($path, $updated) !== strlen($updated)) {
167 throw new RuntimeException('key_secret kon niet in data/config.php worden gezet.');
168 }
169 return $values;
170}
171
172function authPublicBase(): string {
173 if (localDev()) return baseUrl();
174 $base = rtrim((string)(config()['base_url'] ?? ''), '/');
175 if (str_starts_with($base, 'https://')) return $base;
176 $env = getenv('VERHALENBOEK_BASE_URL');
177 if (is_string($env) && str_starts_with($env = rtrim($env, '/'), 'https://')) return $env;
178 return '';
179}
180
181function authHint(string $kind): string {
182 $base = authPublicBase();
183 $keys = ($base !== '' ? $base : '').'/#/sleutels';
184 $docs = ($base !== '' ? $base.'/' : '').'docs.php';
185 $how = 'Stuur de header Authorization: Bearer vb_… met een API-sleutel. Een beheerder maakt sleutels aan onder Sleutels op '.$keys.'. Uitleg: '.$docs;
186 return match ($kind) {
187 'missing' => 'Er is geen Authorization-header. '.$how,
188 'format' => 'De Authorization-header heeft het verkeerde formaat. Gebruik Bearer, gevolgd door vb_ en 64 hexadecimale tekens. '.$how,
189 'rejected' => 'Deze API-sleutel is onbekend of ingetrokken. '.$how,
190 'writer' => 'Dit mag alleen met een API-sleutel of als beheerder. '.$how,
191 'admin' => 'Sleutels beheren kan alleen als ingelogde beheerder, niet met een API-sleutel. Open Sleutels op '.$keys.'. Uitleg: '.$docs,
192 default => $how,
193 };
194}
195
145function baseUrl(): string {
196function baseUrl(): string {
146 if (localDev()) {
197 if (localDev()) {
147 $dir = rtrim(str_replace('\\', '/', dirname($_SERVER['SCRIPT_NAME'] ?? '')), '/');
198 $dir = rtrim(str_replace('\\', '/', dirname($_SERVER['SCRIPT_NAME'] ?? '')), '/');
@@ -248,18 +299,24 @@ if (localDev() && !in_array($_SESSION['user'] ?? '', ['local:test_user_1', 'loca
248}
299}
249
300
250function user(): string {
301function user(): string {
251 if (!isset($_SESSION['user'])) fail('Log in om verder te gaan.', 401);
302 if (!isset($_SESSION['user'])) fail('Log in om verder te gaan.', 401, 'missing');
252 if (!localDev() && (($_SESSION['expires'] ?? 0) < time())) {
303 if (!localDev() && (($_SESSION['expires'] ?? 0) < time())) {
253 unset($_SESSION['user']);
304 unset($_SESSION['user']);
254 fail('Je sessie is verlopen. Log opnieuw in.', 401);
305 fail('Je sessie is verlopen. Log opnieuw in.', 401, 'missing');
255 }
306 }
256 return $_SESSION['user'];
307 return $_SESSION['user'];
257}
308}
258
309
259function fail(string $message, int $status = 400): never {
310function fail(string $message, int $status = 400, ?string $auth = null): never {
260 http_response_code($status);
311 http_response_code($status);
261 header('Content-Type: application/json; charset=utf-8');
312 header('Content-Type: application/json; charset=utf-8');
262 echo json_encode(['error' => $message], JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR);
313 $body = ['error' => $message];
314 if ($auth !== null) {
315 $body['how_to_authenticate'] = authHint($auth);
316 $body['hint'] = $body['how_to_authenticate'];
317 if ($status === 401) header('WWW-Authenticate: Bearer');
318 }
319 echo json_encode($body, JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR);
263 exit;
320 exit;
264}
321}
265
322
@@ -282,7 +339,7 @@ function bearerToken(): ?string {
282 }
339 }
283 if ($header === '') return null;
340 if ($header === '') return null;
284 if (preg_match('/^Bearer\s+(\S+)\s*$/i', $header, $match)) return $match[1];
341 if (preg_match('/^Bearer\s+(\S+)\s*$/i', $header, $match)) return $match[1];
285 throw new AppException('De Authorization-header moet een Bearer-sleutel zijn.', 401);
342 throw new AppException('De Authorization-header heeft het verkeerde formaat.', 401, 'format');
286}
343}
287
344
288function authenticate(): array {
345function authenticate(): array {
@@ -299,11 +356,11 @@ function authenticate(): array {
299 $_SESSION['validated'] = time();
356 $_SESSION['validated'] = time();
300 } catch (Throwable $e) {
357 } catch (Throwable $e) {
301 unset($_SESSION['user']);
358 unset($_SESSION['user']);
302 fail('Log opnieuw in.', 401);
359 fail('Log opnieuw in.', 401, 'missing');
303 }
360 }
304 }
361 }
305 $row = query('SELECT id, role FROM users WHERE id=?', [$id])->fetch();
362 $row = query('SELECT id, role FROM users WHERE id=?', [$id])->fetch();
306 if (!$row) fail('Log opnieuw in.', 401);
363 if (!$row) fail('Log opnieuw in.', 401, 'missing');
307 return ['kind' => 'user', 'userId' => $row['id'], 'role' => $row['role']];
364 return ['kind' => 'user', 'userId' => $row['id'], 'role' => $row['role']];
308}
365}
309
366
@@ -318,11 +375,11 @@ function requireCsrf(array $actor): void {
318
375
319function requireWriter(array $actor): void {
376function requireWriter(array $actor): void {
320 if ($actor['kind'] === 'token') return;
377 if ($actor['kind'] === 'token') return;
321 if (($actor['role'] ?? '') !== 'admin') fail('Alleen een beheerder mag dit wijzigen.', 403);
378 if (($actor['role'] ?? '') !== 'admin') fail('Alleen een beheerder mag dit wijzigen.', 403, 'writer');
322}
379}
323
380
324function requireAdminSession(array $actor): void {
381function requireAdminSession(array $actor): void {
325 if ($actor['kind'] !== 'user' || ($actor['role'] ?? '') !== 'admin') fail('Alleen een beheerder mag sleutels beheren.', 403);
382 if ($actor['kind'] !== 'user' || ($actor['role'] ?? '') !== 'admin') fail('Alleen een beheerder mag sleutels beheren.', 403, 'admin');
326}
383}
327
384
328function requireReader(array $actor): void {
385function requireReader(array $actor): void {
web/tests/integration.py +33 −13
@@ -76,6 +76,7 @@ with tempfile.TemporaryDirectory(prefix='api-', dir=ARTIFACTS) as tmp:
76 76 with response:
77 77 raw = response.read().decode()
78 78 payload = json.loads(raw)
79 self.last_headers = {key.lower(): value for key, value in response.headers.items()}
79 80 check(response.status == expected, f'{method} {path}: verwacht {expected}, kreeg {response.status} {payload}')
80 81 return payload
81 82
@@ -102,8 +103,15 @@ with tempfile.TemporaryDirectory(prefix='api-', dir=ARTIFACTS) as tmp:
102 103 config_path.write_text(configured)
103 104
104 105 anonymous = Client()
105 anonymous.request('GET', '/me', expected=401, extra_headers={'Host': 'verhalenboek.test'})
106 anonymous.request('GET', '/days/latest', expected=401, extra_headers={'Authorization': 'Bearer vb_' + 'ab' * 32})
106 missing = anonymous.request('GET', '/me', expected=401, extra_headers={'Host': 'verhalenboek.test'})
107 check('geen Authorization-header' in missing['how_to_authenticate'] and missing['hint'] == missing['how_to_authenticate'] and 'docs.php' in missing['how_to_authenticate'], '401 zonder header legt authenticatie uit')
108 check(anonymous.last_headers.get('www-authenticate') == 'Bearer', '401 stuurt WWW-Authenticate: Bearer')
109 malformed = anonymous.request('GET', '/days/latest', expected=401, extra_headers={'Authorization': 'Basic abc', 'Host': 'verhalenboek.test'})
110 check('verkeerde formaat' in malformed['how_to_authenticate'] and 'docs.php' in malformed['hint'], 'Verkeerde Authorization-vorm krijgt een eigen uitleg')
111 short = anonymous.request('GET', '/days/latest', expected=401, extra_headers={'Authorization': 'Bearer vb_kort', 'Host': 'verhalenboek.test'})
112 check(short['error'].startswith('De API-sleutel heeft het verkeerde formaat') and 'verkeerde formaat' in short['how_to_authenticate'], 'Een te korte sleutel is het verkeerde formaat')
113 unknown = anonymous.request('GET', '/days/latest', expected=401, extra_headers={'Authorization': 'Bearer vb_' + 'ab' * 32})
114 check(unknown['error'] == 'Deze API-sleutel is onbekend.' and 'onbekend of ingetrokken' in unknown['how_to_authenticate'], 'Onbekende sleutel krijgt de afwijs-uitleg')
107 115
108 116 admin = Client()
109 117 me = admin.me()
@@ -115,7 +123,9 @@ with tempfile.TemporaryDirectory(prefix='api-', dir=ARTIFACTS) as tmp:
115 123 env={**os.environ, 'VERHALENBOEK_BASE_URL': 'https://example.test', 'VERHALENBOEK_CLIENT_ID': 'environment-client', 'VERHALENBOEK_CLIENT_SECRET': 'fixture-secret'},
116 124 text=True,
117 125 )
118 check(json.loads(loaded) == {'base_url': 'https://example.test', 'client_id': 'fixture-client', 'client_secret': 'fixture-secret'}, 'Lege velden gebruiken de omgeving; gevulde velden winnen')
126 loaded_config = json.loads(loaded)
127 check(loaded_config['base_url'] == 'https://example.test' and loaded_config['client_id'] == 'fixture-client' and loaded_config['client_secret'] == 'fixture-secret', 'Lege velden gebruiken de omgeving; gevulde velden winnen')
128 check(__import__('re').fullmatch(r'[a-f0-9]{64}', loaded_config['key_secret']) is not None, 'key_secret blijft de gegenereerde serverwaarde')
119 129
120 130 reader = Client()
121 131 reader.me()
@@ -124,22 +134,28 @@ with tempfile.TemporaryDirectory(prefix='api-', dir=ARTIFACTS) as tmp:
124 134 check(reader.me()['user']['name'] == 'test_user_2' and reader.me()['user']['admin'] is False, 'Tweede gebruiker is alleen lezer')
125 135 check(admin.me()['user']['name'] == 'test_user_1', 'Sessies blijven onafhankelijk')
126 136
127 reader.request('POST', '/days', {'date': '2026-05-01', 'title': 'Verboden', 'stories': stories()}, expected=403)
137 forbidden = reader.request('POST', '/days', {'date': '2026-05-01', 'title': 'Verboden', 'stories': stories()}, expected=403)
138 check('API-sleutel of als beheerder' in forbidden['how_to_authenticate'] and 'docs.php' in forbidden['hint'] and 'www-authenticate' not in reader.last_headers, '403 voor een lezer legt de sleutel uit, zonder WWW-Authenticate')
139 keys_forbidden = reader.request('GET', '/keys', expected=403)
140 check('ingelogde beheerder' in keys_forbidden['how_to_authenticate'] and 'docs.php' in keys_forbidden['hint'], 'Sleutels bekijken mag alleen de beheerder')
128 141 reader.request('POST', '/keys', {'name': 'nee'}, expected=403)
129 reader.request('GET', '/keys', expected=403)
130 142 old = admin.csrf
131 143 admin.csrf = 'fout'
132 admin.request('POST', '/keys', {'name': 'nee'}, expected=403)
144 csrf_denied = admin.request('POST', '/keys', {'name': 'nee'}, expected=403)
145 check('how_to_authenticate' not in csrf_denied and csrf_denied['error'] == 'Ongeldige sessie. Laad de pagina opnieuw.', 'Een CSRF-fout blijft een kale 403')
133 146 admin.csrf = old
134 147
135 148 created = admin.request('POST', '/keys', {'name': 'Schrijver'}, expected=201)['key']
136 149 token = created['token']
137 check(token.startswith('vb_') and created['prefix'] == token[:11], 'Nieuwe sleutel toont het geheim één keer')
150 check(token.startswith('vb_') and created['prefix'] == token[:11], 'Nieuwe sleutel toont het geheim')
138 151 listed = admin.request('GET', '/keys')['keys']
139 152 check(token not in json.dumps(listed) and listed[0]['prefix'] == created['prefix'] and 'token' not in listed[0], 'De lijst verbergt het geheim')
153 revealed = admin.request('GET', '/keys/' + str(created['id']))['key']
154 check(revealed['token'] == token and 'token_cipher' not in revealed, 'De beheerder kan de volledige sleutel opnieuw opvragen')
155 reader.request('GET', '/keys/' + str(created['id']), expected=403)
140 156 with sqlite3.connect(root / 'data/verhalenboek.sqlite') as db:
141 stored = db.execute('SELECT token_hash FROM api_keys WHERE id=?', (created['id'],)).fetchone()[0]
142 check(stored != token and len(stored) == 64, 'De database bewaart alleen een hash')
157 stored_hash, stored_cipher = db.execute('SELECT token_hash, token_cipher FROM api_keys WHERE id=?', (created['id'],)).fetchone()
158 check(stored_hash != token and len(stored_hash) == 64 and token not in stored_cipher and stored_cipher != '', 'De database bewaart een hash en cijfertekst, geen platte sleutel')
143 159
144 160 bearer = Client(token)
145 161 check(bearer.request('GET', '/days/latest', expected=404)['error'], 'Nog geen laatste datum')
@@ -181,7 +197,8 @@ with tempfile.TemporaryDirectory(prefix='api-', dir=ARTIFACTS) as tmp:
181 197 check(bearer.request('GET', '/days/latest')['date'] == '2026-05-04', 'Verwijderen van een middendag laat de laatste datum staan')
182 198 check('2026-05-02' in bearer.request('GET', '/days/gaps')['missing'], 'Een verwijderde dag wordt een gat')
183 199 bearer.request('POST', '/days/2026-05-02/read', expected=403)
184 bearer.request('GET', '/keys', expected=403)
200 bearer_keys = bearer.request('GET', '/keys', expected=403)
201 check('ingelogde beheerder' in bearer_keys['how_to_authenticate'] and token not in json.dumps(bearer_keys), 'Een sleutel mag andere sleutels niet uitlezen')
185 202 bearer.request('DELETE', '/days/2099-01-01', expected=404)
186 203
187 204 check(reader.request('GET', '/days/2026-05-01')['read'] is False, 'Openen via GET markeert de dag nog niet')
@@ -206,8 +223,11 @@ with tempfile.TemporaryDirectory(prefix='api-', dir=ARTIFACTS) as tmp:
206 223 check(admin.request('GET', '/days/2026-05-01')['title'] == 'Herziene titel', 'Beheerder bewerkt een dag in de sessie')
207 224 admin.request('PUT', '/days/2026-05-01', {'stories': stories()[:1]}, expected=422)
208 225 revoked = admin.request('DELETE', '/keys/' + str(created['id']))['key']
209 check(revoked['revoked'] is not None, 'Sleutel intrekken')
210 bearer.request('GET', '/days/latest', expected=401)
226 check(revoked['revoked'] is not None and 'token' not in revoked, 'Sleutel intrekken toont het geheim niet')
227 still = admin.request('GET', '/keys/' + str(created['id']))['key']
228 check(still['token'] == token and still['revoked'] is not None, 'Een ingetrokken sleutel blijft zichtbaar voor de beheerder')
229 rejected = bearer.request('GET', '/days/latest', expected=401)
230 check(rejected['error'] == 'Deze API-sleutel is ingetrokken.' and 'onbekend of ingetrokken' in rejected['how_to_authenticate'] and bearer.last_headers.get('www-authenticate') == 'Bearer', 'Ingetrokken sleutel krijgt 401 met uitleg')
211 231 admin.request('GET', '/days/nope', expected=404)
212 232 admin.request('PUT', '/days/latest', {'title': 'Nee'}, expected=405)
213 233
@@ -220,7 +240,7 @@ with tempfile.TemporaryDirectory(prefix='api-', dir=ARTIFACTS) as tmp:
220 240
221 241 docs = urllib.request.urlopen(base + '/docs.php')
222 242 body = docs.read().decode()
223 check(docs.status == 200 and 'precies drie verhalen' in body and 'days/latest' in body, 'API-documentatie is bereikbaar')
243 check(docs.status == 200 and 'precies drie verhalen' in body and 'days/latest' in body and 'how_to_authenticate' in body and 'WWW-Authenticate' in body, 'API-documentatie legt authenticatie uit')
224 244
225 245 auth_bootstrap = root / 'lib/bootstrap.php'
226 246 auth_bootstrap.write_text(auth_bootstrap.read_text().replace(
@@ -76,6 +76,7 @@ with tempfile.TemporaryDirectory(prefix='api-', dir=ARTIFACTS) as tmp:
76 with response:
76 with response:
77 raw = response.read().decode()
77 raw = response.read().decode()
78 payload = json.loads(raw)
78 payload = json.loads(raw)
79 self.last_headers = {key.lower(): value for key, value in response.headers.items()}
79 check(response.status == expected, f'{method} {path}: verwacht {expected}, kreeg {response.status} {payload}')
80 check(response.status == expected, f'{method} {path}: verwacht {expected}, kreeg {response.status} {payload}')
80 return payload
81 return payload
81
82
@@ -102,8 +103,15 @@ with tempfile.TemporaryDirectory(prefix='api-', dir=ARTIFACTS) as tmp:
102 config_path.write_text(configured)
103 config_path.write_text(configured)
103
104
104 anonymous = Client()
105 anonymous = Client()
105 anonymous.request('GET', '/me', expected=401, extra_headers={'Host': 'verhalenboek.test'})
106 missing = anonymous.request('GET', '/me', expected=401, extra_headers={'Host': 'verhalenboek.test'})
106 anonymous.request('GET', '/days/latest', expected=401, extra_headers={'Authorization': 'Bearer vb_' + 'ab' * 32})
107 check('geen Authorization-header' in missing['how_to_authenticate'] and missing['hint'] == missing['how_to_authenticate'] and 'docs.php' in missing['how_to_authenticate'], '401 zonder header legt authenticatie uit')
108 check(anonymous.last_headers.get('www-authenticate') == 'Bearer', '401 stuurt WWW-Authenticate: Bearer')
109 malformed = anonymous.request('GET', '/days/latest', expected=401, extra_headers={'Authorization': 'Basic abc', 'Host': 'verhalenboek.test'})
110 check('verkeerde formaat' in malformed['how_to_authenticate'] and 'docs.php' in malformed['hint'], 'Verkeerde Authorization-vorm krijgt een eigen uitleg')
111 short = anonymous.request('GET', '/days/latest', expected=401, extra_headers={'Authorization': 'Bearer vb_kort', 'Host': 'verhalenboek.test'})
112 check(short['error'].startswith('De API-sleutel heeft het verkeerde formaat') and 'verkeerde formaat' in short['how_to_authenticate'], 'Een te korte sleutel is het verkeerde formaat')
113 unknown = anonymous.request('GET', '/days/latest', expected=401, extra_headers={'Authorization': 'Bearer vb_' + 'ab' * 32})
114 check(unknown['error'] == 'Deze API-sleutel is onbekend.' and 'onbekend of ingetrokken' in unknown['how_to_authenticate'], 'Onbekende sleutel krijgt de afwijs-uitleg')
107
115
108 admin = Client()
116 admin = Client()
109 me = admin.me()
117 me = admin.me()
@@ -115,7 +123,9 @@ with tempfile.TemporaryDirectory(prefix='api-', dir=ARTIFACTS) as tmp:
115 env={**os.environ, 'VERHALENBOEK_BASE_URL': 'https://example.test', 'VERHALENBOEK_CLIENT_ID': 'environment-client', 'VERHALENBOEK_CLIENT_SECRET': 'fixture-secret'},
123 env={**os.environ, 'VERHALENBOEK_BASE_URL': 'https://example.test', 'VERHALENBOEK_CLIENT_ID': 'environment-client', 'VERHALENBOEK_CLIENT_SECRET': 'fixture-secret'},
116 text=True,
124 text=True,
117 )
125 )
118 check(json.loads(loaded) == {'base_url': 'https://example.test', 'client_id': 'fixture-client', 'client_secret': 'fixture-secret'}, 'Lege velden gebruiken de omgeving; gevulde velden winnen')
126 loaded_config = json.loads(loaded)
127 check(loaded_config['base_url'] == 'https://example.test' and loaded_config['client_id'] == 'fixture-client' and loaded_config['client_secret'] == 'fixture-secret', 'Lege velden gebruiken de omgeving; gevulde velden winnen')
128 check(__import__('re').fullmatch(r'[a-f0-9]{64}', loaded_config['key_secret']) is not None, 'key_secret blijft de gegenereerde serverwaarde')
119
129
120 reader = Client()
130 reader = Client()
121 reader.me()
131 reader.me()
@@ -124,22 +134,28 @@ with tempfile.TemporaryDirectory(prefix='api-', dir=ARTIFACTS) as tmp:
124 check(reader.me()['user']['name'] == 'test_user_2' and reader.me()['user']['admin'] is False, 'Tweede gebruiker is alleen lezer')
134 check(reader.me()['user']['name'] == 'test_user_2' and reader.me()['user']['admin'] is False, 'Tweede gebruiker is alleen lezer')
125 check(admin.me()['user']['name'] == 'test_user_1', 'Sessies blijven onafhankelijk')
135 check(admin.me()['user']['name'] == 'test_user_1', 'Sessies blijven onafhankelijk')
126
136
127 reader.request('POST', '/days', {'date': '2026-05-01', 'title': 'Verboden', 'stories': stories()}, expected=403)
137 forbidden = reader.request('POST', '/days', {'date': '2026-05-01', 'title': 'Verboden', 'stories': stories()}, expected=403)
138 check('API-sleutel of als beheerder' in forbidden['how_to_authenticate'] and 'docs.php' in forbidden['hint'] and 'www-authenticate' not in reader.last_headers, '403 voor een lezer legt de sleutel uit, zonder WWW-Authenticate')
139 keys_forbidden = reader.request('GET', '/keys', expected=403)
140 check('ingelogde beheerder' in keys_forbidden['how_to_authenticate'] and 'docs.php' in keys_forbidden['hint'], 'Sleutels bekijken mag alleen de beheerder')
128 reader.request('POST', '/keys', {'name': 'nee'}, expected=403)
141 reader.request('POST', '/keys', {'name': 'nee'}, expected=403)
129 reader.request('GET', '/keys', expected=403)
130 old = admin.csrf
142 old = admin.csrf
131 admin.csrf = 'fout'
143 admin.csrf = 'fout'
132 admin.request('POST', '/keys', {'name': 'nee'}, expected=403)
144 csrf_denied = admin.request('POST', '/keys', {'name': 'nee'}, expected=403)
145 check('how_to_authenticate' not in csrf_denied and csrf_denied['error'] == 'Ongeldige sessie. Laad de pagina opnieuw.', 'Een CSRF-fout blijft een kale 403')
133 admin.csrf = old
146 admin.csrf = old
134
147
135 created = admin.request('POST', '/keys', {'name': 'Schrijver'}, expected=201)['key']
148 created = admin.request('POST', '/keys', {'name': 'Schrijver'}, expected=201)['key']
136 token = created['token']
149 token = created['token']
137 check(token.startswith('vb_') and created['prefix'] == token[:11], 'Nieuwe sleutel toont het geheim één keer')
150 check(token.startswith('vb_') and created['prefix'] == token[:11], 'Nieuwe sleutel toont het geheim')
138 listed = admin.request('GET', '/keys')['keys']
151 listed = admin.request('GET', '/keys')['keys']
139 check(token not in json.dumps(listed) and listed[0]['prefix'] == created['prefix'] and 'token' not in listed[0], 'De lijst verbergt het geheim')
152 check(token not in json.dumps(listed) and listed[0]['prefix'] == created['prefix'] and 'token' not in listed[0], 'De lijst verbergt het geheim')
153 revealed = admin.request('GET', '/keys/' + str(created['id']))['key']
154 check(revealed['token'] == token and 'token_cipher' not in revealed, 'De beheerder kan de volledige sleutel opnieuw opvragen')
155 reader.request('GET', '/keys/' + str(created['id']), expected=403)
140 with sqlite3.connect(root / 'data/verhalenboek.sqlite') as db:
156 with sqlite3.connect(root / 'data/verhalenboek.sqlite') as db:
141 stored = db.execute('SELECT token_hash FROM api_keys WHERE id=?', (created['id'],)).fetchone()[0]
157 stored_hash, stored_cipher = db.execute('SELECT token_hash, token_cipher FROM api_keys WHERE id=?', (created['id'],)).fetchone()
142 check(stored != token and len(stored) == 64, 'De database bewaart alleen een hash')
158 check(stored_hash != token and len(stored_hash) == 64 and token not in stored_cipher and stored_cipher != '', 'De database bewaart een hash en cijfertekst, geen platte sleutel')
143
159
144 bearer = Client(token)
160 bearer = Client(token)
145 check(bearer.request('GET', '/days/latest', expected=404)['error'], 'Nog geen laatste datum')
161 check(bearer.request('GET', '/days/latest', expected=404)['error'], 'Nog geen laatste datum')
@@ -181,7 +197,8 @@ with tempfile.TemporaryDirectory(prefix='api-', dir=ARTIFACTS) as tmp:
181 check(bearer.request('GET', '/days/latest')['date'] == '2026-05-04', 'Verwijderen van een middendag laat de laatste datum staan')
197 check(bearer.request('GET', '/days/latest')['date'] == '2026-05-04', 'Verwijderen van een middendag laat de laatste datum staan')
182 check('2026-05-02' in bearer.request('GET', '/days/gaps')['missing'], 'Een verwijderde dag wordt een gat')
198 check('2026-05-02' in bearer.request('GET', '/days/gaps')['missing'], 'Een verwijderde dag wordt een gat')
183 bearer.request('POST', '/days/2026-05-02/read', expected=403)
199 bearer.request('POST', '/days/2026-05-02/read', expected=403)
184 bearer.request('GET', '/keys', expected=403)
200 bearer_keys = bearer.request('GET', '/keys', expected=403)
201 check('ingelogde beheerder' in bearer_keys['how_to_authenticate'] and token not in json.dumps(bearer_keys), 'Een sleutel mag andere sleutels niet uitlezen')
185 bearer.request('DELETE', '/days/2099-01-01', expected=404)
202 bearer.request('DELETE', '/days/2099-01-01', expected=404)
186
203
187 check(reader.request('GET', '/days/2026-05-01')['read'] is False, 'Openen via GET markeert de dag nog niet')
204 check(reader.request('GET', '/days/2026-05-01')['read'] is False, 'Openen via GET markeert de dag nog niet')
@@ -206,8 +223,11 @@ with tempfile.TemporaryDirectory(prefix='api-', dir=ARTIFACTS) as tmp:
206 check(admin.request('GET', '/days/2026-05-01')['title'] == 'Herziene titel', 'Beheerder bewerkt een dag in de sessie')
223 check(admin.request('GET', '/days/2026-05-01')['title'] == 'Herziene titel', 'Beheerder bewerkt een dag in de sessie')
207 admin.request('PUT', '/days/2026-05-01', {'stories': stories()[:1]}, expected=422)
224 admin.request('PUT', '/days/2026-05-01', {'stories': stories()[:1]}, expected=422)
208 revoked = admin.request('DELETE', '/keys/' + str(created['id']))['key']
225 revoked = admin.request('DELETE', '/keys/' + str(created['id']))['key']
209 check(revoked['revoked'] is not None, 'Sleutel intrekken')
226 check(revoked['revoked'] is not None and 'token' not in revoked, 'Sleutel intrekken toont het geheim niet')
210 bearer.request('GET', '/days/latest', expected=401)
227 still = admin.request('GET', '/keys/' + str(created['id']))['key']
228 check(still['token'] == token and still['revoked'] is not None, 'Een ingetrokken sleutel blijft zichtbaar voor de beheerder')
229 rejected = bearer.request('GET', '/days/latest', expected=401)
230 check(rejected['error'] == 'Deze API-sleutel is ingetrokken.' and 'onbekend of ingetrokken' in rejected['how_to_authenticate'] and bearer.last_headers.get('www-authenticate') == 'Bearer', 'Ingetrokken sleutel krijgt 401 met uitleg')
211 admin.request('GET', '/days/nope', expected=404)
231 admin.request('GET', '/days/nope', expected=404)
212 admin.request('PUT', '/days/latest', {'title': 'Nee'}, expected=405)
232 admin.request('PUT', '/days/latest', {'title': 'Nee'}, expected=405)
213
233
@@ -220,7 +240,7 @@ with tempfile.TemporaryDirectory(prefix='api-', dir=ARTIFACTS) as tmp:
220
240
221 docs = urllib.request.urlopen(base + '/docs.php')
241 docs = urllib.request.urlopen(base + '/docs.php')
222 body = docs.read().decode()
242 body = docs.read().decode()
223 check(docs.status == 200 and 'precies drie verhalen' in body and 'days/latest' in body, 'API-documentatie is bereikbaar')
243 check(docs.status == 200 and 'precies drie verhalen' in body and 'days/latest' in body and 'how_to_authenticate' in body and 'WWW-Authenticate' in body, 'API-documentatie legt authenticatie uit')
224
244
225 auth_bootstrap = root / 'lib/bootstrap.php'
245 auth_bootstrap = root / 'lib/bootstrap.php'
226 auth_bootstrap.write_text(auth_bootstrap.read_text().replace(
246 auth_bootstrap.write_text(auth_bootstrap.read_text().replace(
web/tests/startup.py +9 −0
@@ -28,6 +28,7 @@ with tempfile.TemporaryDirectory(prefix='startup-', dir=ARTIFACTS) as tmp:
28 28 assert config.is_file(), 'Eerste start maakt config.php'
29 29 original = config.read_text()
30 30 assert all(f"'{key}' => ''" in original for key in ['base_url', 'client_id', 'client_secret'])
31 assert __import__('re').search(r"'key_secret' => '[a-f0-9]{64}'", original), original
31 32 config.write_text(original.replace("'client_id' => ''", "'client_id' => 'projects.timfalken.com'") + '\n// servercommentaar\n')
32 33 marked = config.read_text()
33 34 con = sqlite3.connect(root / 'data/verhalenboek.sqlite')
@@ -43,4 +44,12 @@ with tempfile.TemporaryDirectory(prefix='startup-', dir=ARTIFACTS) as tmp:
43 44 assert con.execute('SELECT body FROM paragraphs').fetchone()[0] == 'Blijft staan.'
44 45 assert 'email' not in [name for _, name, *_ in con.execute('PRAGMA table_info(users)')]
45 46 con.close()
47 import re
48 stripped = re.sub(r"\n 'key_secret' => '[a-f0-9]{64}',", '', marked, count=1)
49 assert "'key_secret' =>" not in stripped
50 config.write_text(stripped)
51 startup()
52 restored = config.read_text()
53 assert 'servercommentaar' in restored and "'client_id' => 'projects.timfalken.com'" in restored
54 assert re.search(r"'key_secret' => '[a-f0-9]{64}'", restored), restored
46 55 print('Startup: fresh database, preserved day and preserved config passed.')
@@ -28,6 +28,7 @@ with tempfile.TemporaryDirectory(prefix='startup-', dir=ARTIFACTS) as tmp:
28 assert config.is_file(), 'Eerste start maakt config.php'
28 assert config.is_file(), 'Eerste start maakt config.php'
29 original = config.read_text()
29 original = config.read_text()
30 assert all(f"'{key}' => ''" in original for key in ['base_url', 'client_id', 'client_secret'])
30 assert all(f"'{key}' => ''" in original for key in ['base_url', 'client_id', 'client_secret'])
31 assert __import__('re').search(r"'key_secret' => '[a-f0-9]{64}'", original), original
31 config.write_text(original.replace("'client_id' => ''", "'client_id' => 'projects.timfalken.com'") + '\n// servercommentaar\n')
32 config.write_text(original.replace("'client_id' => ''", "'client_id' => 'projects.timfalken.com'") + '\n// servercommentaar\n')
32 marked = config.read_text()
33 marked = config.read_text()
33 con = sqlite3.connect(root / 'data/verhalenboek.sqlite')
34 con = sqlite3.connect(root / 'data/verhalenboek.sqlite')
@@ -43,4 +44,12 @@ with tempfile.TemporaryDirectory(prefix='startup-', dir=ARTIFACTS) as tmp:
43 assert con.execute('SELECT body FROM paragraphs').fetchone()[0] == 'Blijft staan.'
44 assert con.execute('SELECT body FROM paragraphs').fetchone()[0] == 'Blijft staan.'
44 assert 'email' not in [name for _, name, *_ in con.execute('PRAGMA table_info(users)')]
45 assert 'email' not in [name for _, name, *_ in con.execute('PRAGMA table_info(users)')]
45 con.close()
46 con.close()
47 import re
48 stripped = re.sub(r"\n 'key_secret' => '[a-f0-9]{64}',", '', marked, count=1)
49 assert "'key_secret' =>" not in stripped
50 config.write_text(stripped)
51 startup()
52 restored = config.read_text()
53 assert 'servercommentaar' in restored and "'client_id' => 'projects.timfalken.com'" in restored
54 assert re.search(r"'key_secret' => '[a-f0-9]{64}'", restored), restored
46print('Startup: fresh database, preserved day and preserved config passed.')
55print('Startup: fresh database, preserved day and preserved config passed.')
web/tests/storybook.php +17 −5
@@ -110,17 +110,29 @@ check(publicUser('auth:1')['theme'] === 'system', 'Instellingen blijven bij de g
110 110 rejects(fn() => saveSettings('auth:2', ['theme' => 'blauw', 'font' => 'serif']), 422, 'Onbekend thema');
111 111
112 112 $key = createApiKey('auth:1', 'Schrijver');
113 check(isset($key['token']) && preg_match('/^vb_[a-f0-9]{64}$/', $key['token']) && $key['prefix'] === substr($key['token'], 0, 11), 'Sleutel wordt één keer volledig teruggegeven');
114 $stored = query('SELECT token_hash, token_prefix FROM api_keys WHERE id=?', [$key['id']])->fetch();
115 check($stored['token_hash'] === hash('sha256', $key['token']) && $stored['token_hash'] !== $key['token'], 'Alleen de hash staat in de database');
116 check(!str_contains(json_encode(listApiKeys(), JSON_THROW_ON_ERROR), $key['token']), 'De lijst toont de sleutel niet opnieuw');
113 check(isset($key['token']) && preg_match('/^vb_[a-f0-9]{64}$/', $key['token']) && $key['prefix'] === substr($key['token'], 0, 11), 'Sleutel wordt volledig teruggegeven');
114 $stored = query('SELECT token_hash, token_prefix, token_cipher FROM api_keys WHERE id=?', [$key['id']])->fetch();
115 check($stored['token_hash'] === hash('sha256', $key['token']) && !str_contains($stored['token_cipher'], $key['token']), 'De database bewaart een hash en een versleutelde sleutel');
116 check(revealApiKey($key['id'])['token'] === $key['token'], 'Een beheerder kan de sleutel opnieuw lezen');
117 check(!str_contains(json_encode(listApiKeys(), JSON_THROW_ON_ERROR), $key['token']), 'De lijst toont de sleutel niet');
117 118 $actor = actorFromToken($key['token']);
118 119 check($actor['kind'] === 'token' && $actor['userId'] === 'auth:1', 'Bearer-sleutel hoort bij de beheerder');
120 try { actorFromToken('vb_kort'); check(false, 'Verkeerd formaat'); }
121 catch (AppException $e) { check($e->status === 401 && $e->auth === 'format', 'Verkeerd formaat is een 401'); }
122 try { actorFromToken('vb_'.str_repeat('ab', 32)); check(false, 'Onbekende sleutel'); }
123 catch (AppException $e) { check($e->status === 401 && $e->auth === 'rejected', 'Onbekende sleutel is een 401'); }
119 124 revokeApiKey($key['id']);
120 rejects(fn() => actorFromToken($key['token']), 401, 'Ingetrokken sleutel werkt niet');
125 check(revealApiKey($key['id'])['token'] === $key['token'], 'Ook een ingetrokken sleutel blijft toonbaar');
126 try { actorFromToken($key['token']); check(false, 'Ingetrokken sleutel'); }
127 catch (AppException $e) { check($e->status === 401 && $e->auth === 'rejected', 'Ingetrokken sleutel werkt niet'); }
121 128 $export = exportUser('auth:1');
122 129 check(!isset($export['profile']['email']) && !str_contains(json_encode($export, JSON_THROW_ON_ERROR), $key['token']), 'Export bevat geen e-mail en geen geheime sleutel');
123 130 check($export['api_keys'][0]['prefix'] === $key['prefix'] && $export['api_keys'][0]['revoked'] !== null, 'Export toont ingetrokken sleutels zonder geheim');
131 $secret = config()['key_secret'] ?? '';
132 check(is_string($secret) && preg_match('/^[a-f0-9]{64}$/', $secret) === 1, 'key_secret wordt automatisch aangemaakt');
133 file_put_contents($root.'/config.php', str_replace("'base_url' => ''", "'base_url' => 'https://projects.timfalken.com/verhaaltjesboek'", (string)file_get_contents($root.'/config.php')));
134 check(str_contains(authHint('missing'), 'geen Authorization-header') && str_contains(authHint('missing'), 'https://projects.timfalken.com/verhaaltjesboek/docs.php'), 'Ontbrekende header legt uit waar de sleutel vandaan komt');
135 check(str_contains(authHint('format'), 'verkeerde formaat') && str_contains(authHint('rejected'), 'onbekend of ingetrokken') && str_contains(authHint('writer'), 'API-sleutel of als beheerder'), 'De uitleg onderscheidt formaat, afwijzing en rechten');
124 136
125 137 $log = $root.'/php-errors.log';
126 138 check(!is_file($log) || file_get_contents($log) === '', 'Geen PHP-fouten tijdens de domeintests');
@@ -110,17 +110,29 @@ check(publicUser('auth:1')['theme'] === 'system', 'Instellingen blijven bij de g
110rejects(fn() => saveSettings('auth:2', ['theme' => 'blauw', 'font' => 'serif']), 422, 'Onbekend thema');
110rejects(fn() => saveSettings('auth:2', ['theme' => 'blauw', 'font' => 'serif']), 422, 'Onbekend thema');
111
111
112$key = createApiKey('auth:1', 'Schrijver');
112$key = createApiKey('auth:1', 'Schrijver');
113check(isset($key['token']) && preg_match('/^vb_[a-f0-9]{64}$/', $key['token']) && $key['prefix'] === substr($key['token'], 0, 11), 'Sleutel wordt één keer volledig teruggegeven');
113check(isset($key['token']) && preg_match('/^vb_[a-f0-9]{64}$/', $key['token']) && $key['prefix'] === substr($key['token'], 0, 11), 'Sleutel wordt volledig teruggegeven');
114$stored = query('SELECT token_hash, token_prefix FROM api_keys WHERE id=?', [$key['id']])->fetch();
114$stored = query('SELECT token_hash, token_prefix, token_cipher FROM api_keys WHERE id=?', [$key['id']])->fetch();
115check($stored['token_hash'] === hash('sha256', $key['token']) && $stored['token_hash'] !== $key['token'], 'Alleen de hash staat in de database');
115check($stored['token_hash'] === hash('sha256', $key['token']) && !str_contains($stored['token_cipher'], $key['token']), 'De database bewaart een hash en een versleutelde sleutel');
116check(!str_contains(json_encode(listApiKeys(), JSON_THROW_ON_ERROR), $key['token']), 'De lijst toont de sleutel niet opnieuw');
116check(revealApiKey($key['id'])['token'] === $key['token'], 'Een beheerder kan de sleutel opnieuw lezen');
117check(!str_contains(json_encode(listApiKeys(), JSON_THROW_ON_ERROR), $key['token']), 'De lijst toont de sleutel niet');
117$actor = actorFromToken($key['token']);
118$actor = actorFromToken($key['token']);
118check($actor['kind'] === 'token' && $actor['userId'] === 'auth:1', 'Bearer-sleutel hoort bij de beheerder');
119check($actor['kind'] === 'token' && $actor['userId'] === 'auth:1', 'Bearer-sleutel hoort bij de beheerder');
120try { actorFromToken('vb_kort'); check(false, 'Verkeerd formaat'); }
121catch (AppException $e) { check($e->status === 401 && $e->auth === 'format', 'Verkeerd formaat is een 401'); }
122try { actorFromToken('vb_'.str_repeat('ab', 32)); check(false, 'Onbekende sleutel'); }
123catch (AppException $e) { check($e->status === 401 && $e->auth === 'rejected', 'Onbekende sleutel is een 401'); }
119revokeApiKey($key['id']);
124revokeApiKey($key['id']);
120rejects(fn() => actorFromToken($key['token']), 401, 'Ingetrokken sleutel werkt niet');
125check(revealApiKey($key['id'])['token'] === $key['token'], 'Ook een ingetrokken sleutel blijft toonbaar');
126try { actorFromToken($key['token']); check(false, 'Ingetrokken sleutel'); }
127catch (AppException $e) { check($e->status === 401 && $e->auth === 'rejected', 'Ingetrokken sleutel werkt niet'); }
121$export = exportUser('auth:1');
128$export = exportUser('auth:1');
122check(!isset($export['profile']['email']) && !str_contains(json_encode($export, JSON_THROW_ON_ERROR), $key['token']), 'Export bevat geen e-mail en geen geheime sleutel');
129check(!isset($export['profile']['email']) && !str_contains(json_encode($export, JSON_THROW_ON_ERROR), $key['token']), 'Export bevat geen e-mail en geen geheime sleutel');
123check($export['api_keys'][0]['prefix'] === $key['prefix'] && $export['api_keys'][0]['revoked'] !== null, 'Export toont ingetrokken sleutels zonder geheim');
130check($export['api_keys'][0]['prefix'] === $key['prefix'] && $export['api_keys'][0]['revoked'] !== null, 'Export toont ingetrokken sleutels zonder geheim');
131$secret = config()['key_secret'] ?? '';
132check(is_string($secret) && preg_match('/^[a-f0-9]{64}$/', $secret) === 1, 'key_secret wordt automatisch aangemaakt');
133file_put_contents($root.'/config.php', str_replace("'base_url' => ''", "'base_url' => 'https://projects.timfalken.com/verhaaltjesboek'", (string)file_get_contents($root.'/config.php')));
134check(str_contains(authHint('missing'), 'geen Authorization-header') && str_contains(authHint('missing'), 'https://projects.timfalken.com/verhaaltjesboek/docs.php'), 'Ontbrekende header legt uit waar de sleutel vandaan komt');
135check(str_contains(authHint('format'), 'verkeerde formaat') && str_contains(authHint('rejected'), 'onbekend of ingetrokken') && str_contains(authHint('writer'), 'API-sleutel of als beheerder'), 'De uitleg onderscheidt formaat, afwijzing en rechten');
124
136
125$log = $root.'/php-errors.log';
137$log = $root.'/php-errors.log';
126check(!is_file($log) || file_get_contents($log) === '', 'Geen PHP-fouten tijdens de domeintests');
138check(!is_file($log) || file_get_contents($log) === '', 'Geen PHP-fouten tijdens de domeintests');