feat(supabase): owner trial served on the LAN address, sandbox kept on loopback
This commit is contained in:
1 parent
a69eba569b
commit
d74c54ed05
6 files changed
+260
-21
No files matched your search
@@ -805,7 +805,7 @@ Docker.
|
||||
| `pnpm db:sandbox e2e-shell` (= `pnpm e2e:shell`) | the authenticated `/app` shell in Chromium (`apps/app/e2e/shell`, `docs/development/BROWSER_TESTS.md`): a loopback dev server whose Supabase calls are replayed on the sandbox, fictitious accounts per test |
|
||||
| `pnpm db:sandbox verify-e2e` | V1-2.3: a gateway (`nginx:1.31-alpine`, sandbox network only, no host port) and the real verification worker `faunosteo_worker:dev run --jobs sheet-verify` against the sandbox, then `packages/supabase/tests/sandbox/sheet-verification.sandbox.ts`; both containers removed at the end, the service key passed through a 600 file deleted at start |
|
||||
| `pnpm db:sandbox avatar-e2e` | V1-2.3: the same gateway, published on `127.0.0.1:57800` only and routing `/auth/v1/` too, the real worker `faunosteo_worker:dev run` (default mode: avatars and sweep, 5 s sweep, no quarantine grace, 512 MiB as the compose `worker`) against the sandbox, then `packages/supabase/tests/e2e/avatar-flow.e2e.ts` through that port; the suite's psql calls go to the sandbox database container, which it requires by name; its two accounts are made per run with random passwords and deleted after; both containers removed at the end |
|
||||
| `pnpm db:sandbox trial` / `trial-account <email>` / `trial-grant <email> <kind>` | V1-2.6 owner trial (`docs/development/V1-2-6_OWNER_TRIAL.md`): the app on `127.0.0.1:5193` behind a trial gateway on `127.0.0.1:57801` (refuses to start when `faunosteo_dbsandbox_trial_gateway` exists), a confirmed account (hidden password prompt), a catalogue right (email and kind checked, passed as psql variables; editor and publisher also get the admin role) |
|
||||
| `pnpm db:sandbox trial` / `trial-account <email>` / `trial-grant <email> <kind>` | V1-2.6 owner trial (`docs/development/V1-2-6_OWNER_TRIAL.md`): the app on `http://$FAUNOSTEO_TRIAL_HOST:5193` (default the LAN address of this machine, `127.0.0.1` = host-only; loopback or private IPv4 of an interface only, Host header allowlisted) behind a trial gateway on `127.0.0.1:57801` (refuses to start when `faunosteo_dbsandbox_trial_gateway` exists), a confirmed account (hidden password prompt), a catalogue right (email and kind checked, passed as psql variables; editor and publisher also get the admin role) |
|
||||
| `pnpm db:sandbox sql` / `down` | psql as postgres on stdin / remove the stack |
|
||||
|
||||
Every CLI call passes `--db-url` with `sslmode=disable` (the sandbox has no
|
||||
|
||||
@@ -50,14 +50,34 @@ Dans un terminal que vous laissez ouvert :
|
||||
pnpm db:sandbox trial
|
||||
```
|
||||
|
||||
Attendu : `== trial: http://127.0.0.1:5193`, puis les lignes de Vite. L'application est servie sur
|
||||
`http://127.0.0.1:5193` et la même adresse relaie `/auth/v1`, `/rest/v1` et `/storage/v1` vers une passerelle
|
||||
de l'essai, publiée sur `127.0.0.1:57801` uniquement : le navigateur ne parle qu'à une seule origine. La
|
||||
commande refuse de démarrer si la passerelle de l'essai existe déjà ou si l'un des ports est pris.
|
||||
Attendu : `== trial: http://192.168.1.100:5193`, puis les lignes de Vite. L'adresse d'essai est celle de cette
|
||||
machine sur le réseau local, déduite comme pour DEV (`FAUNOSTEO_DEV_HOST`). Pour la fixer, ou pour un essai
|
||||
limité à cette machine :
|
||||
|
||||
Ouvrez `http://127.0.0.1:5193/login` et connectez-vous avec le compte de l'étape 2. Le site n'est joignable que
|
||||
depuis cette machine (pas depuis un téléphone du réseau local). Pour l'ouvrir depuis un autre ordinateur, voir
|
||||
la section « Accès depuis une autre machine (tunnel SSH) ».
|
||||
```bash
|
||||
FAUNOSTEO_TRIAL_HOST=127.0.0.1 pnpm db:sandbox trial
|
||||
```
|
||||
|
||||
Seules sont acceptées l'adresse de bouclage ou une adresse privée (`10/8`, `172.16/12`, `192.168/16`) portée par
|
||||
une interface de cette machine ; `0.0.0.0`, un nom et une adresse publique sont refusés avec un message.
|
||||
|
||||
Un seul port est ouvert au réseau local : **5193**, sur cette adresse uniquement (pas sur `0.0.0.0`). Vite relaie
|
||||
`/auth/v1`, `/rest/v1` et `/storage/v1` vers une passerelle de l'essai publiée sur `127.0.0.1:57801` ; tous les
|
||||
services de la pile jetable restent sur `127.0.0.1`. Vite refuse tout en-tête `Host` autre que l'adresse d'essai.
|
||||
La commande refuse de démarrer si la passerelle de l'essai existe déjà ou si l'un des ports est pris.
|
||||
|
||||
Ouvrez `http://192.168.1.100:5193/login`, depuis cette machine ou depuis un appareil du réseau local (téléphone
|
||||
compris), et connectez-vous avec le compte de l'étape 2. Si `192.168.1.100:5193` ne répond pas depuis un autre
|
||||
appareil, un pare-feu de la machine peut demander une règle pour ce port depuis le réseau local ; la commande
|
||||
est la vôtre, elle n'est jamais lancée par les outils :
|
||||
|
||||
```bash
|
||||
sudo ufw allow from 192.168.1.0/24 to any port 5193 proto tcp
|
||||
```
|
||||
|
||||
Protections : réseau local de confiance uniquement (jamais d'exposition publique), compte à mot de passe et
|
||||
double authentification pour l'administration, RLS sur toutes les tables, pile jetable. DEV (`supabase_*_faunosteo`)
|
||||
n'est ni lu ni arrêté. Le site est servi en HTTP simple : ne réutilisez pas ici un mot de passe qui compte.
|
||||
|
||||
### Double authentification (TOTP)
|
||||
|
||||
@@ -200,6 +220,7 @@ une annotation sur cette vue (onglet Annotations).
|
||||
- Risque résiduel RR-12 : les opérations du catalogue lisent la mention `aal2` du jeton, pas la session vivante.
|
||||
Un jeton émis à `aal2` reste accepté après la suppression du facteur, jusqu'à son expiration (une heure).
|
||||
- Les e-mails ne partent nulle part (l'interface de courrier de la pile jetable est sur `127.0.0.1:57025`).
|
||||
- Un appareil du réseau local ne reçoit pas de contexte sécurisé (HTTP) : l'essai n'en a pas besoin.
|
||||
- Les mots de passe créés ici n'ont de valeur que pour cette pile.
|
||||
- La pile est jetable : tout ce que vous créez (comptes, fiches, brouillons) est perdu à `down`.
|
||||
- Juste après un `down`, `up fresh` peut échouer sur `address already in use` (un port pas encore libéré par
|
||||
@@ -212,17 +233,16 @@ une annotation sur cette vue (onglet Annotations).
|
||||
au centre du cadre (« Remplacer par un polygone ») : sa forme est perdue. Ce cas ne s'obtient pas depuis une
|
||||
fiche construite avec ce guide : il n'a pas d'étape et n'est couvert que par les tests automatiques.
|
||||
|
||||
## Accès depuis une autre machine (tunnel SSH)
|
||||
Le serveur d'essai n'écoute que sur `127.0.0.1` (`apps/app/vite/trial.config.ts`). Depuis un autre ordinateur,
|
||||
ouvrez un tunnel :
|
||||
## Repli facultatif : tunnel SSH
|
||||
Le réseau local suffit normalement. Hors de ce réseau, ou si l'essai tourne en `FAUNOSTEO_TRIAL_HOST=127.0.0.1`,
|
||||
ouvrez un tunnel depuis l'autre ordinateur :
|
||||
|
||||
```bash
|
||||
ssh -N -L 5193:127.0.0.1:5193 <utilisateur>@<machine>
|
||||
```
|
||||
|
||||
Puis ouvrez `http://127.0.0.1:5193` sur cet ordinateur. Seul le port 5193 est nécessaire : Vite relaie les trois
|
||||
routes Supabase vers la passerelle de l'essai sur `127.0.0.1:57801`. Laissez ce terminal ouvert ; Ctrl+C ferme
|
||||
le tunnel. N'exposez jamais le port sur le réseau.
|
||||
Puis ouvrez `http://127.0.0.1:5193` sur cet ordinateur. Laissez ce terminal ouvert ; Ctrl+C ferme le tunnel.
|
||||
Ce repli ne marche que si l'essai écoute sur `127.0.0.1`.
|
||||
|
||||
## 6. Arrêt et nettoyage
|
||||
1. Dans le terminal de `trial` : Ctrl+C. Vite et la passerelle de l'essai s'arrêtent ensemble.
|
||||
|
||||
Reference in new issue
Block a user