BlueGit

projects-timfalken-com meteors

docs: Tim sets auth_client_secret instead of FTPing config.php

timfa Grok Bot · pushed by timfa

Authored 2026-11-13 · 4 days ago

Hash
320eabcc2404034feb96b7101879284eb74c6792
Parent
08b092a4
2 files changed +28 −25
README.md +17 −20
@@ -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 / jumpsToC
73
73
74BlueGit 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.
74BlueGit 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
76Secrets: `timftphost` / `timftpuser` / `timftppassword` / `timftproot` (groep), `projectftp` (dit project).
76Secrets: `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 toeschou
93en geen doelwit meer. De laatste die overblijft wint; 1e/2e/3e staan 5 seconden
93en geen doelwit meer. De laatste die overblijft wint; 1e/2e/3e staan 5 seconden
94op het podium en daarna ga je terug naar de lobby.
94op 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
98Online werkt pas als OAuth is ingesteld. Zolang dat niet zo is, blijft solo
98Online werkt pas als OAuth is ingesteld. Zolang dat niet zo is, blijft solo
99beschikbaar en toont **Online spelen** een duidelijke boodschap.
99beschikbaar en toont **Online spelen** een duidelijke boodschap. Je hoeft
100`data/config.php` **niet** via FTP te zetten: de deploy schrijft dat bestand
101zelf vanuit een CI-geheim.
100
102
1011. Ga naar https://auth.timfalken.com/admin, bij de **bestaande** client
1031. Ga naar https://auth.timfalken.com/admin, bij de **bestaande** client
102 `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`.
1053. Kopieer het **bestaande** client-geheim. **Genereer het niet opnieuw** —
1073. 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.
1074. Zet op de FTP-server, in de map `data/` naast het spel (niet in git, wordt
1094. Zet in BlueGit, bij dit project (`projects-timfalken-com/meteors`), een
108 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```php
112 de groep en verhalenboek hebben alleen FTP-credentials. Optioneel is
111<?php
113 `auth_client_id` (standaard `projects.timfalken.com`); dat hoeft Tim
112return [
114 niet te zetten.
113 'auth_url' => 'https://auth.timfalken.com',
1155. De volgende deploy naar `master` schrijft `data/config.php` op de server
114 '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. De
116 '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 niet
118```
120 overschreven.
119
120De eerste keer dat de PHP-API draait, maakt ze een sjabloon van dit bestand
121als het nog niet bestaat. `data/.htaccess` weigert alle toegang tot die map.
122De deploy raakt `data/config.php` en de SQLite-database nooit aan, en
123overschrijft `favicon.ico` niet.
124
121
125Lokaal (alleen op loopback, host én remote-adres) kun je zonder geheim
122Lokaal (alleen op loopback, host én remote-adres) kun je zonder geheim
126inloggen als `auth.php?test=1` of `auth.php?test=2`.
123inloggen als `auth.php?test=1` of `auth.php?test=2`.
docs/ASSUMPTIONS.md +11 −5
@@ -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`. Callback
209 client_id `projects.timfalken.com`. Callback
210 `https://projects.timfalken.com/meteors/callback.php`. Het geheim zet Tim
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
211 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 solo
213 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 script
216- 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, … Het
239 laatste die overblijft is 1e; de eerder uitgeschakelden 2e, 3e, … Het
239 podium blijft **5 seconden** (`METEORS_PODIUM_SECONDS`) en daarna gaat de
240 podium blijft **5 seconden** (`METEORS_PODIUM_SECONDS`) en daarna gaat de
240 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. Alleen
242- `data/` (sqlite, sessies) wordt nooit gespiegeld of gewist. Alleen
242 `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 de
244 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 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.