docs: Tim sets auth_client_secret instead of FTPing config.php
@@ -73,7 +73,7 @@ Sprongfysica is parametrisch. Een horizontale match van 3 springt `13 / jumpsToC
73
73
74
74
BlueGit CI (`blue-ci-cd.yml`) draait tests en een build op feature-branches en op `master`. Op `master` volgt daarna `ftp_upload`: `build/` gaat via FTP naar `projectftp` (secret: `$timftproot/meteors`; de job expandeert `$timftproot` zelf en normaliseert dubbele slashes). **Geen `--delete`**. De eerste deploy weigert te schrijven als de doelmap al vreemde bestanden bevat.
75
75
76
Secrets: `timftphost` / `timftpuser` / `timftppassword` / `timftproot` (groep), `projectftp` (dit project).
76
Secrets: `timftphost` / `timftpuser` / `timftppassword` / `timftproot` (groep), `projectftp` (dit project), en `auth_client_secret` (dit project, zie hieronder). De groep en de andere projecten (verhalenboek, microchess) hebben geen auth-geheim; alleen FTP-gegevens.
77
77
78
78
## Online spelen (stage 2)
79
79
@@ -93,10 +93,12 @@ op een stapel weer een kleur krijgt. Wie al zijn kolommen vol heeft, is toeschou
93
93
en geen doelwit meer. De laatste die overblijft wint; 1e/2e/3e staan 5 seconden
94
94
op het podium en daarna ga je terug naar de lobby.
95
95
96
### Wat Tim op de server moet instellen
96
### Wat Tim moet instellen
97
97
98
98
Online werkt pas als OAuth is ingesteld. Zolang dat niet zo is, blijft solo
99
beschikbaar en toont **Online spelen** een duidelijke boodschap.
99
beschikbaar en toont **Online spelen** een duidelijke boodschap. Je hoeft
100
`data/config.php` **niet** via FTP te zetten: de deploy schrijft dat bestand
101
zelf vanuit een CI-geheim.
100
102
101
103
1. Ga naar https://auth.timfalken.com/admin, bij de **bestaande** client
102
104
`projects.timfalken.com` (dezelfde als de andere sites op dit domein).
@@ -104,23 +106,18 @@ beschikbaar en toont **Online spelen** een duidelijke boodschap.
104
106
`https://projects.timfalken.com/meteors/callback.php`.
105
107
3. Kopieer het **bestaande** client-geheim. **Genereer het niet opnieuw** —
106
108
dat breekt de andere sites die dit geheim al gebruiken.
107
4. Zet op de FTP-server, in de map `data/` naast het spel (niet in git, wordt
108
nooit gedeployed), een bestand `config.php`:
109
110
```php
111
<?php
112
return [
113
'auth_url' => 'https://auth.timfalken.com',
114
'base_url' => 'https://projects.timfalken.com/meteors',
115
'client_id' => 'projects.timfalken.com',
116
'client_secret' => 'HIER_HET_BESTAANDE_GEHEIM',
117
];
118
```
119
120
De eerste keer dat de PHP-API draait, maakt ze een sjabloon van dit bestand
121
als het nog niet bestaat. `data/.htaccess` weigert alle toegang tot die map.
122
De deploy raakt `data/config.php` en de SQLite-database nooit aan, en
123
overschrijft `favicon.ico` niet.
109
4. Zet in BlueGit, bij dit project (`projects-timfalken-com/meteors`), een
110
**protected** (alleen `master`) geheim met de naam **`auth_client_secret`**
111
en als waarde dat bestaande geheim. Er is geen groepsgeheim voor dit:
112
de groep en verhalenboek hebben alleen FTP-credentials. Optioneel is
113
`auth_client_id` (standaard `projects.timfalken.com`); dat hoeft Tim
114
niet te zetten.
115
5. De volgende deploy naar `master` schrijft `data/config.php` op de server
116
(alleen als het geheim niet leeg is; de waarde komt nooit in de logs).
117
Zonder geheim blijft een bestaand `data/config.php` ongemoeid. De
118
SQLite-database en sessies worden nooit gewist. `data/.htaccess`
119
weigert alle HTTP-toegang tot die map. `favicon.ico` wordt niet
120
overschreven.
124
121
125
122
Lokaal (alleen op loopback, host én remote-adres) kun je zonder geheim
126
123
inloggen als `auth.php?test=1` of `auth.php?test=2`.
@@ -73,7 +73,7 @@ Sprongfysica is parametrisch. Een horizontale match van 3 springt `13 / jumpsToC73
73
74
BlueGit CI (`blue-ci-cd.yml`) draait tests en een build op feature-branches en op `master`. Op `master` volgt daarna `ftp_upload`: `build/` gaat via FTP naar `projectftp` (secret: `$timftproot/meteors`; de job expandeert `$timftproot` zelf en normaliseert dubbele slashes). **Geen `--delete`**. De eerste deploy weigert te schrijven als de doelmap al vreemde bestanden bevat.74
BlueGit CI (`blue-ci-cd.yml`) draait tests en een build op feature-branches en op `master`. Op `master` volgt daarna `ftp_upload`: `build/` gaat via FTP naar `projectftp` (secret: `$timftproot/meteors`; de job expandeert `$timftproot` zelf en normaliseert dubbele slashes). **Geen `--delete`**. De eerste deploy weigert te schrijven als de doelmap al vreemde bestanden bevat.75
75
76
Secrets: `timftphost` / `timftpuser` / `timftppassword` / `timftproot` (groep), `projectftp` (dit project).76
Secrets: `timftphost` / `timftpuser` / `timftppassword` / `timftproot` (groep), `projectftp` (dit project), en `auth_client_secret` (dit project, zie hieronder). De groep en de andere projecten (verhalenboek, microchess) hebben geen auth-geheim; alleen FTP-gegevens.77
77
78
## Online spelen (stage 2)78
## Online spelen (stage 2)79
79
@@ -93,10 +93,12 @@ op een stapel weer een kleur krijgt. Wie al zijn kolommen vol heeft, is toeschou93
en geen doelwit meer. De laatste die overblijft wint; 1e/2e/3e staan 5 seconden93
en geen doelwit meer. De laatste die overblijft wint; 1e/2e/3e staan 5 seconden94
op het podium en daarna ga je terug naar de lobby.94
op het podium en daarna ga je terug naar de lobby.95
95
96
### Wat Tim op de server moet instellen96
### Wat Tim moet instellen97
97
98
Online werkt pas als OAuth is ingesteld. Zolang dat niet zo is, blijft solo98
Online werkt pas als OAuth is ingesteld. Zolang dat niet zo is, blijft solo99
beschikbaar en toont **Online spelen** een duidelijke boodschap.99
beschikbaar en toont **Online spelen** een duidelijke boodschap. Je hoeft100
`data/config.php` **niet** via FTP te zetten: de deploy schrijft dat bestand101
zelf vanuit een CI-geheim.100
102
101
1. Ga naar https://auth.timfalken.com/admin, bij de **bestaande** client103
1. Ga naar https://auth.timfalken.com/admin, bij de **bestaande** client102
`projects.timfalken.com` (dezelfde als de andere sites op dit domein).104
`projects.timfalken.com` (dezelfde als de andere sites op dit domein).@@ -104,23 +106,18 @@ beschikbaar en toont **Online spelen** een duidelijke boodschap.104
`https://projects.timfalken.com/meteors/callback.php`.106
`https://projects.timfalken.com/meteors/callback.php`.105
3. Kopieer het **bestaande** client-geheim. **Genereer het niet opnieuw** —107
3. Kopieer het **bestaande** client-geheim. **Genereer het niet opnieuw** —106
dat breekt de andere sites die dit geheim al gebruiken.108
dat breekt de andere sites die dit geheim al gebruiken.107
4. Zet op de FTP-server, in de map `data/` naast het spel (niet in git, wordt109
4. Zet in BlueGit, bij dit project (`projects-timfalken-com/meteors`), een108
nooit gedeployed), een bestand `config.php`:110
**protected** (alleen `master`) geheim met de naam **`auth_client_secret`**109
111
en als waarde dat bestaande geheim. Er is geen groepsgeheim voor dit:110
```php112
de groep en verhalenboek hebben alleen FTP-credentials. Optioneel is111
<?php113
`auth_client_id` (standaard `projects.timfalken.com`); dat hoeft Tim112
return [114
niet te zetten.113
'auth_url' => 'https://auth.timfalken.com',115
5. De volgende deploy naar `master` schrijft `data/config.php` op de server114
'base_url' => 'https://projects.timfalken.com/meteors',116
(alleen als het geheim niet leeg is; de waarde komt nooit in de logs).115
'client_id' => 'projects.timfalken.com',117
Zonder geheim blijft een bestaand `data/config.php` ongemoeid. De116
'client_secret' => 'HIER_HET_BESTAANDE_GEHEIM',118
SQLite-database en sessies worden nooit gewist. `data/.htaccess`117
];119
weigert alle HTTP-toegang tot die map. `favicon.ico` wordt niet118
```120
overschreven.119
120
De eerste keer dat de PHP-API draait, maakt ze een sjabloon van dit bestand121
als het nog niet bestaat. `data/.htaccess` weigert alle toegang tot die map.122
De deploy raakt `data/config.php` en de SQLite-database nooit aan, en123
overschrijft `favicon.ico` niet.124
121
125
Lokaal (alleen op loopback, host én remote-adres) kun je zonder geheim122
Lokaal (alleen op loopback, host én remote-adres) kun je zonder geheim126
inloggen als `auth.php?test=1` of `auth.php?test=2`.123
inloggen als `auth.php?test=1` of `auth.php?test=2`.@@ -208,8 +208,9 @@ Aanname:
208
208
- Login via auth.timfalken.com (`/oauth/authorize`, `/oauth/token`, `/api/me`),
209
209
client_id `projects.timfalken.com`. Callback
210
210
`https://projects.timfalken.com/meteors/callback.php`. Het geheim zet Tim
211
zelf in `data/config.php`; wij genereren het nooit opnieuw. Zonder geheim
212
blijft solo werken, met een duidelijke online-melding.
211
als protected projectgeheim `auth_client_secret` (niet opnieuw genereren);
212
de deploy schrijft dan `data/config.php`. Zonder geheim blijft solo
213
werken, met een duidelijke online-melding.
213
214
- Testers `auth.php?test=1` / `?test=2` alleen als `localDev()` waar is:
214
215
loopback-host **én** loopback-remote-adres (zelfde regel als verhalenboek).
215
216
- Sessies staan in `data/sessions`, cookie-pad is de map van het script
@@ -238,7 +239,12 @@ Aanname:
238
239
laatste die overblijft is 1e; de eerder uitgeschakelden 2e, 3e, … Het
239
240
podium blijft **5 seconden** (`METEORS_PODIUM_SECONDS`) en daarna gaat de
240
241
lobby terug naar `waiting` (ready-vlaggen gereset).
241
- `data/` (config, sqlite, sessies) wordt nooit gedeployed of gewist. Alleen
242
- `data/` (sqlite, sessies) wordt nooit gespiegeld of gewist. Alleen
242
243
`data/.htaccess` (Require all denied) wordt na de mirror gezet.
243
`favicon.ico` blijft ongemoeid. `router.php` is alleen voor lokale `php -S`
244
en gaat niet mee naar live.
244
Als het projectgeheim `auth_client_secret` niet leeg is, schrijft de
245
deploy `data/config.php` vanuit dat geheim (waarde nooit in de logs).
246
Is het leeg of afwezig, dan blijft een bestaand bestand staan. De groep
247
`projects-timfalken-com` en verhalenboek hebben dit geheim niet (alleen
248
FTP); Tim zet het op het meteors-project. Optioneel: `auth_client_id`
249
(standaard `projects.timfalken.com`). `favicon.ico` blijft ongemoeid.
250
`router.php` is alleen voor lokale `php -S` en gaat niet mee naar live.
@@ -208,8 +208,9 @@ Aanname:208
- Login via auth.timfalken.com (`/oauth/authorize`, `/oauth/token`, `/api/me`),208
- Login via auth.timfalken.com (`/oauth/authorize`, `/oauth/token`, `/api/me`),209
client_id `projects.timfalken.com`. Callback209
client_id `projects.timfalken.com`. Callback210
`https://projects.timfalken.com/meteors/callback.php`. Het geheim zet Tim210
`https://projects.timfalken.com/meteors/callback.php`. Het geheim zet Tim211
zelf in `data/config.php`; wij genereren het nooit opnieuw. Zonder geheim211
als protected projectgeheim `auth_client_secret` (niet opnieuw genereren);212
blijft solo werken, met een duidelijke online-melding.212
de deploy schrijft dan `data/config.php`. Zonder geheim blijft solo213
werken, met een duidelijke online-melding.213
- Testers `auth.php?test=1` / `?test=2` alleen als `localDev()` waar is:214
- Testers `auth.php?test=1` / `?test=2` alleen als `localDev()` waar is:214
loopback-host **én** loopback-remote-adres (zelfde regel als verhalenboek).215
loopback-host **én** loopback-remote-adres (zelfde regel als verhalenboek).215
- Sessies staan in `data/sessions`, cookie-pad is de map van het script216
- Sessies staan in `data/sessions`, cookie-pad is de map van het script@@ -238,7 +239,12 @@ Aanname:238
laatste die overblijft is 1e; de eerder uitgeschakelden 2e, 3e, … Het239
laatste die overblijft is 1e; de eerder uitgeschakelden 2e, 3e, … Het239
podium blijft **5 seconden** (`METEORS_PODIUM_SECONDS`) en daarna gaat de240
podium blijft **5 seconden** (`METEORS_PODIUM_SECONDS`) en daarna gaat de240
lobby terug naar `waiting` (ready-vlaggen gereset).241
lobby terug naar `waiting` (ready-vlaggen gereset).241
- `data/` (config, sqlite, sessies) wordt nooit gedeployed of gewist. Alleen242
- `data/` (sqlite, sessies) wordt nooit gespiegeld of gewist. Alleen242
`data/.htaccess` (Require all denied) wordt na de mirror gezet.243
`data/.htaccess` (Require all denied) wordt na de mirror gezet.243
`favicon.ico` blijft ongemoeid. `router.php` is alleen voor lokale `php -S`244
Als het projectgeheim `auth_client_secret` niet leeg is, schrijft de244
en gaat niet mee naar live.245
deploy `data/config.php` vanuit dat geheim (waarde nooit in de logs).246
Is het leeg of afwezig, dan blijft een bestaand bestand staan. De groep247
`projects-timfalken-com` en verhalenboek hebben dit geheim niet (alleen248
FTP); Tim zet het op het meteors-project. Optioneel: `auth_client_id`249
(standaard `projects.timfalken.com`). `favicon.ico` blijft ongemoeid.250
`router.php` is alleen voor lokale `php -S` en gaat niet mee naar live.