feat(supabase): owner trial served on the LAN address, sandbox kept on loopback

This commit is contained in:
bchanot committed 2026-11-04 22:36:50 +01:00
1 parent a69eba569b
commit d74c54ed05
6 files changed
+260 -21

No files matched your search

+33 -13
View File
@@ -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.