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

+154
View File
@@ -0,0 +1,154 @@
import { readFileSync } from 'node:fs'
import { fr } from '@/i18n/fr'
import type { Page } from '@playwright/test'
import { totpCode } from '../../../../packages/supabase/tests/sandbox/totp'
import { expect, test } from '../support/browser'
// Owner trial through its LAN origin (C47): sign-in, TOTP enrolment and challenge, the
// catalogue, a non-equine sheet, an SVG import, save and reload. The request guard of
// support/browser.ts fails on any request outside the origin; the listener below also
// names 127.0.0.1 and localhost. TRIAL_EMAIL and TRIAL_PW_FILE (first line, mode 600).
const dict = fr
const email = process.env.TRIAL_EMAIL ?? ''
const password =
(process.env.TRIAL_PW_FILE ?? '')
? readFileSync(process.env.TRIAL_PW_FILE ?? '', 'utf8').split('\n')[0]
: ''
const SVG =
'<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 400 300">' +
'<style>.a{fill:#c96}</style>' +
'<rect class="a" x="20" y="20" width="360" height="260"/></svg>'
const revisionLine = (page: Page) =>
page.getByRole('status').filter({ hasText: /^Révision \d+/ })
async function revisionShown(page: Page): Promise<number> {
const text = (await revisionLine(page).textContent()) ?? ''
return Number(/Révision (\d+)/.exec(text)?.[1])
}
async function nextCode(secret: string): Promise<string> {
const left = 30_000 - (Date.now() % 30_000)
if (left < 3000) await new Promise((r) => setTimeout(r, left + 200))
return totpCode(secret)
}
async function signIn(page: Page) {
await page.goto('/login')
await page.getByLabel(dict['auth.email']).fill(email)
await page.getByLabel(dict['auth.password'], { exact: true }).fill(password)
await page.getByRole('button', { name: dict['auth.login.submit'] }).click()
await expect(page).toHaveURL(/\/app\/?$/)
}
async function enrol(page: Page): Promise<string> {
await page.goto('/app/account')
await page.getByRole('button', { name: dict['mfa.enrol.start'] }).click()
await page.getByLabel(dict['mfa.enrol.name']).fill('Essai LAN')
await page.getByRole('button', { name: dict['mfa.enrol.continue'] }).click()
const key = page.getByText(/^[A-Z2-7]{16,}$/)
await expect(key).toBeVisible()
const secret = ((await key.textContent()) ?? '').trim()
await page.getByLabel(dict['mfa.code.label']).fill(await nextCode(secret))
await page.getByRole('button', { name: dict['mfa.code.verify'] }).click()
await expect(page.getByText(dict['mfa.enrol.done'])).toBeVisible()
return secret
}
async function challenge(page: Page, secret: string) {
await page.goto('/app/admin')
const field = page.getByRole('main').getByLabel(dict['mfa.code.label'])
await expect(field).toBeVisible()
await page.waitForLoadState('networkidle')
await field.fill(await nextCode(secret))
await page
.getByRole('main')
.getByRole('button', { name: dict['mfa.code.verify'] })
.click()
await expect(field).toBeHidden()
}
async function createNonEquineSheet(page: Page, tag: string) {
await page.goto('/app/admin/sheets')
await expect(
page.getByRole('heading', { name: dict['admin.sheets.title'] }),
).toBeVisible()
await page.getByRole('link', { name: dict['admin.sheets.new'] }).click()
const species = page.getByLabel(dict['admin.sheet_form.species'], {
exact: true,
})
const nonEquine = species.locator(
'option:not([value=""]):not([value="equine"])',
)
await expect(nonEquine.first()).toBeAttached()
await page.waitForLoadState('networkidle')
const chosen = (await nonEquine.first().getAttribute('value')) ?? ''
await species.selectOption(chosen)
await expect(species).toHaveValue(chosen)
await page
.getByLabel(dict['admin.sheet_form.name_fr'])
.fill(`Fiche LAN ${tag}`)
await page
.getByLabel(dict['admin.sheet_form.name_en'])
.fill(`LAN sheet ${tag}`)
await page
.getByRole('button', { name: dict['admin.sheet_form.submit'] })
.click()
await expect(page).toHaveURL(/\/app\/admin\/sheets\/[0-9a-f-]{36}\/draft$/)
}
test('trial through the LAN origin: MFA, new sheet, SVG import, save, reload', async ({
page,
}) => {
test.skip(!email || !password, 'TRIAL_EMAIL and TRIAL_PW_FILE are required')
test.setTimeout(120_000)
const local: string[] = []
page.on('request', (request) => {
if (/\/\/(127\.0\.0\.1|localhost)/.test(request.url()))
local.push(request.url())
})
const tag = Date.now().toString(36)
await signIn(page)
const secret = await enrol(page)
// Enrolment leaves an aal2 session: a new sign-in brings the real challenge.
await page
.getByRole('button', { name: dict['shell.sign_out'] })
.first()
.click()
await expect(page).not.toHaveURL(/\/app/)
await signIn(page)
await challenge(page, secret)
await createNonEquineSheet(page, tag)
await page
.getByRole('tab', { name: dict['editor.tab.views'], exact: true })
.click()
await page
.locator('[data-testid$="-file"]')
.first()
.setInputFiles({
name: 'lan.svg',
mimeType: 'image/svg+xml',
buffer: Buffer.from(SVG),
})
const dialog = page.getByRole('dialog', {
name: dict['editor.cleaning.title'],
})
await expect(dialog).toBeVisible()
await dialog
.getByRole('button', { name: dict['editor.cleaning.confirm'] })
.click()
await expect(page.getByText(dict['editor.upload.done'])).toBeVisible()
const before = await revisionShown(page)
await page.getByRole('button', { name: dict['common.save'] }).click()
await expect(revisionLine(page)).toHaveText(`Révision ${before + 1}`)
await page.reload()
await page
.getByRole('tab', { name: dict['editor.tab.views'], exact: true })
.click()
await expect(
page.getByRole('tabpanel').getByText(dict['editor.views.drawing.ok']),
).toBeVisible()
expect(local, 'requests to 127.0.0.1 or localhost').toEqual([])
})
+28
View File
@@ -0,0 +1,28 @@
/**
* `playwright test -c e2e/playwright.lan.config.ts` (docs/development/V1-2-6_OWNER_TRIAL.md):
* the owner's trial reached through its LAN origin, which is a non-secure context like a
* phone's browser. It needs a running `pnpm db:sandbox trial` and a trial account; the
* page may reach that origin only. No trace, no report: they would hold the session tokens
* and the password. Run by hand, never part of check:all.
*/
import { defineConfig } from '@playwright/test'
import type { GuardOptions } from './support/browser'
const ORIGIN = process.env.TRIAL_ORIGIN ?? 'http://192.168.1.100:5193'
export default defineConfig<GuardOptions>({
testDir: './lan',
outputDir: './test-results/lan',
forbidOnly: true,
retries: 0,
expect: { timeout: 15_000 },
reporter: [['list']],
use: {
baseURL: ORIGIN,
locale: 'fr-FR',
allowedOrigins: [ORIGIN],
trace: 'off',
screenshot: 'off',
viewport: { width: 1280, height: 900 },
},
})
+16 -3
View File
@@ -5,20 +5,33 @@ import base from '../vite.config'
* Dev server of `pnpm db:sandbox trial` (docs/development/V1-2-6_OWNER_TRIAL.md).
* The browser talks to this origin only: the three Supabase routes are
* forwarded to the trial gateway on loopback, so no CORS rule is involved.
* The server binds the one host that scripts/db-sandbox.sh validated (loopback or a private
* address of this machine) and refuses any other Host header.
*/
const target = process.env.FAUNOSTEO_TRIAL_GATEWAY
const url = target ? new URL(target) : null
if (!url || url.protocol !== 'http:' || url.hostname !== '127.0.0.1')
throw new Error('FAUNOSTEO_TRIAL_GATEWAY must be an http://127.0.0.1:<port> URL')
throw new Error(
'FAUNOSTEO_TRIAL_GATEWAY must be an http://127.0.0.1:<port> URL',
)
const host = process.env.FAUNOSTEO_TRIAL_HOST ?? ''
const PRIVATE_IPV4 =
/^(127\.0\.0\.1|10(\.\d{1,3}){3}|172\.(1[6-9]|2\d|3[01])(\.\d{1,3}){2}|192\.168(\.\d{1,3}){2})$/
if (!PRIVATE_IPV4.test(host))
throw new Error(
'FAUNOSTEO_TRIAL_HOST must be 127.0.0.1 or a private IPv4 address',
)
const SUPABASE_ROUTES = ['/auth/v1', '/rest/v1', '/storage/v1']
export default defineConfig((env) =>
mergeConfig(base(env), {
// Loopback even when started by hand: the proxy carries the trial account's session.
// One validated host, never 0.0.0.0: the proxy carries the trial account's session.
server: {
host: '127.0.0.1',
host,
strictPort: true,
allowedHosts: [host],
proxy: Object.fromEntries(
SUPABASE_ROUTES.map((route) => [route, { target }]),
),
+1 -1
View File
@@ -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
+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.
+28 -4
View File
@@ -23,7 +23,8 @@
# pnpm db:sandbox sheet-assets-e2e (= pnpm e2e:sheet-assets) the sheet-asset upload tool against the sandbox:
# a gateway on 127.0.0.1:$PORT_GATEWAY, then scripts/sheet-assets-e2e.sh
# pnpm db:sandbox trial the owner's trial (docs/development/V1-2-6_OWNER_TRIAL.md): a gateway on
# 127.0.0.1:$PORT_TRIAL_GATEWAY and the app on http://127.0.0.1:$PORT_TRIAL_APP,
# 127.0.0.1:$PORT_TRIAL_GATEWAY and the app on http://$FAUNOSTEO_TRIAL_HOST:$PORT_TRIAL_APP
# (default: this machine's LAN address; 127.0.0.1 = host-only),
# foreground, Ctrl+C stops both
# pnpm db:sandbox trial-account <email> a confirmed account, password at a hidden prompt (12 characters min.)
# pnpm db:sandbox trial-grant <email> <catalog_reader|sheet_editor|sheet_reviewer|sheet_publisher>
@@ -385,6 +386,27 @@ cmd_sheet_assets_e2e() {
# ---- Owner trial (docs/development/V1-2-6_OWNER_TRIAL.md) -------------------
port_taken() { (exec 3<>"/dev/tcp/127.0.0.1/$1") 2>/dev/null; }
# The one place the trial host is decided: FAUNOSTEO_TRIAL_HOST, default the DEV host (the LAN
# address); 127.0.0.1 = host-only. Loopback or a private IPv4 of an interface of this machine,
# nothing else (no 0.0.0.0, no name, no public address).
trial_host() {
local host="${FAUNOSTEO_TRIAL_HOST:-$FAUNOSTEO_DEV_HOST}" a b c d
[[ "$host" =~ ^([0-9]{1,3})\.([0-9]{1,3})\.([0-9]{1,3})\.([0-9]{1,3})$ ]] \
|| die "FAUNOSTEO_TRIAL_HOST must be an IPv4 address (not a name, not 0.0.0.0): $host"
a=$((10#${BASH_REMATCH[1]})) b=$((10#${BASH_REMATCH[2]}))
c=$((10#${BASH_REMATCH[3]})) d=$((10#${BASH_REMATCH[4]}))
[ "$a" -le 255 ] && [ "$b" -le 255 ] && [ "$c" -le 255 ] && [ "$d" -le 255 ] \
|| die "FAUNOSTEO_TRIAL_HOST is not an IPv4 address: $host"
[ "$host" = "$a.$b.$c.$d" ] || die "FAUNOSTEO_TRIAL_HOST: write the address without leading zeros"
if [ "$a" -eq 127 ]; then host=127.0.0.1
elif [ "$a" -eq 10 ] || { [ "$a" -eq 172 ] && [ "$b" -ge 16 ] && [ "$b" -le 31 ]; } \
|| { [ "$a" -eq 192 ] && [ "$b" -eq 168 ]; }; then :
else die "FAUNOSTEO_TRIAL_HOST must be loopback or a private address (10/8, 172.16/12, 192.168/16): $host"
fi
ip -4 -o addr | grep -qF "inet $host/" || die "FAUNOSTEO_TRIAL_HOST $host is not an address of this machine"
TRIAL_HOST="$host"
}
trial_email() { # email: one fixed shape, nothing else reaches curl or psql
[[ "${1:-}" =~ ^[A-Za-z0-9._%+-]{1,64}@[A-Za-z0-9.-]{1,120}\.[A-Za-z]{2,24}$ ]] \
|| die "an e-mail address is expected"
@@ -411,6 +433,7 @@ trial_stop() {
# through its environment, never argv.
cmd_trial() {
load_secrets
trial_host
[ -z "$(docker ps -a -q -f "name=^${TRIAL_GATEWAY}\$")" ] \
|| die "$TRIAL_GATEWAY exists (stop the running trial, or pnpm db:sandbox down)"
for port in $PORT_TRIAL_GATEWAY $PORT_TRIAL_APP; do
@@ -419,10 +442,11 @@ cmd_trial() {
trap trial_stop EXIT
trap 'exit 130' INT TERM
start_trial_gateway
echo "== trial: http://127.0.0.1:$PORT_TRIAL_APP (Ctrl+C stops the app and its gateway)"
echo "== trial: http://$TRIAL_HOST:$PORT_TRIAL_APP (Ctrl+C stops the app and its gateway)"
( cd apps/app && FAUNOSTEO_TRIAL_GATEWAY="http://127.0.0.1:$PORT_TRIAL_GATEWAY" \
VITE_SUPABASE_URL="http://127.0.0.1:$PORT_TRIAL_APP" VITE_SUPABASE_ANON_KEY="$SB_ANON_KEY" \
exec node_modules/.bin/vite --config vite/trial.config.ts --host 127.0.0.1 \
FAUNOSTEO_TRIAL_HOST="$TRIAL_HOST" \
VITE_SUPABASE_URL="http://$TRIAL_HOST:$PORT_TRIAL_APP" VITE_SUPABASE_ANON_KEY="$SB_ANON_KEY" \
exec node_modules/.bin/vite --config vite/trial.config.ts --host "$TRIAL_HOST" \
--port $PORT_TRIAL_APP --strictPort ) &
trial_pid=$!
wait "$trial_pid"