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>
@@ -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. Daar26
- **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.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
```php31
```php32
<?php32
<?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
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
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
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
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
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
Fouten zijn `{"error":"…"}`. Validatie die de drie-verhalenregel raakt geeft 422. De menselijke uitleg met dezelfde voorbeelden staat op `docs.php`.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
```sh107
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
## Deploy113
## Deploy104
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.@@ -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 geb14
14
15
## Productie15
## Productie16
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
```php19
```php20
<?php20
<?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
@@ -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);@@ -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 {@@ -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
3
const MONTHS = ['januari', 'februari', 'maart', 'april', 'mei', 'juni', 'juli', 'augustus', 'september', 'oktober', 'november', 'december'];3
const MONTHS = ['januari', 'februari', 'maart', 'april', 'mei', 'juni', 'juli', 'augustus', 'september', 'oktober', 'november', 'december'];4
const ROMAN = ['I', 'II', 'III'];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
let renderToken = 0;6
let renderToken = 0;7
let menuAnchor = null;7
let menuAnchor = null;8
let ignoreCloseUntil = 0;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
function paintKeys(keys) {434
function 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
478
async function render() {487
async 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';@@ -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>@@ -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 @@2
declare(strict_types=1);2
declare(strict_types=1);3
3
4
final class AppException extends RuntimeException {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
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
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
function createApiKey(string $userId, mixed $name): array {357
function 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
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
function listApiKeys(): array {379
function 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
358
function actorFromToken(string $token): array {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
$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
}@@ -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 INTEGER74
revoked INTEGER74
);');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 = <<<PHP119
<?php125
<?php120
// 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/verhaaltjesboek127
// Productie-URL: https://projects.timfalken.com/verhaaltjesboek122
// 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.124
return [131
return [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
130
PHP;138
PHP;@@ -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
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
function baseUrl(): string {196
function 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', 'loca248
}299
}249
300
250
function user(): string {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
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
259
function fail(string $message, int $status = 400): never {310
function 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
288
function authenticate(): array {345
function 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
319
function requireWriter(array $actor): void {376
function 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
324
function requireAdminSession(array $actor): void {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
function requireReader(array $actor): void {385
function requireReader(array $actor): void {@@ -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 payload81
return payload81
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.csrf142
old = admin.csrf131
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 = old146
admin.csrf = old134
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(@@ -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), original31
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 re48
stripped = re.sub(r"\n 'key_secret' => '[a-f0-9]{64}',", '', marked, count=1)49
assert "'key_secret' =>" not in stripped50
config.write_text(stripped)51
startup()52
restored = config.read_text()53
assert 'servercommentaar' in restored and "'client_id' => 'projects.timfalken.com'" in restored54
assert re.search(r"'key_secret' => '[a-f0-9]{64}'", restored), restored46
print('Startup: fresh database, preserved day and preserved config passed.')55
print('Startup: fresh database, preserved day and preserved config passed.')@@ -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 g110
rejects(fn() => saveSettings('auth:2', ['theme' => 'blauw', 'font' => 'serif']), 422, 'Onbekend thema');110
rejects(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');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');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 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();115
check($stored['token_hash'] === hash('sha256', $key['token']) && $stored['token_hash'] !== $key['token'], 'Alleen de hash staat in de database');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(!str_contains(json_encode(listApiKeys(), JSON_THROW_ON_ERROR), $key['token']), 'De lijst toont de sleutel niet opnieuw');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
$actor = actorFromToken($key['token']);118
$actor = actorFromToken($key['token']);118
check($actor['kind'] === 'token' && $actor['userId'] === 'auth:1', 'Bearer-sleutel hoort bij de beheerder');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
revokeApiKey($key['id']);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
$export = exportUser('auth:1');128
$export = exportUser('auth:1');122
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');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
check($export['api_keys'][0]['prefix'] === $key['prefix'] && $export['api_keys'][0]['revoked'] !== null, 'Export toont ingetrokken sleutels zonder geheim');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
$log = $root.'/php-errors.log';137
$log = $root.'/php-errors.log';126
check(!is_file($log) || file_get_contents($log) === '', 'Geen PHP-fouten tijdens de domeintests');138
check(!is_file($log) || file_get_contents($log) === '', 'Geen PHP-fouten tijdens de domeintests');