Skip to content

fix(security): encoder embeds[].id dans les URL de lecture (#SEC-002) - #87

Merged
izo merged 1 commit into
mainfrom
fix/sec-002-embed-id-encoding
Aug 24, 2026
Merged

fix(security): encoder embeds[].id dans les URL de lecture (#SEC-002)#87
izo merged 1 commit into
mainfrom
fix/sec-002-embed-id-encoding

Conversation

@izo

@izo izo commented Aug 24, 2026

Copy link
Copy Markdown
Owner

Second finding de l'audit blackemperor du 2026-08-24, après #SEC-001 (livré en 0.18.1).

Le défaut

playerUrl() interpolait embed.id directement dans l'URL du lecteur, alors que le schéma le laisse libre (z.string(), src/schema.ts:136) et que playable ne vérifie qu'une chaîne non vide.

Un id valant 1?autoplay=0&x=1 ouvre une query string dans une URL dont le chemin devait s'arrêter à l'identifiant. SoundCloud est le plus fragile : l'id y atterrit dans un paramètre url= déjà encodé, où un & casse la structure.

Ce n'est pas un XSS — Astro échappe les attributs et le préfixe https://<hébergeur>/ reste en place. L'effet se limite au détournement vers une autre ressource du même hébergeur. D'où le P1, et non le P0 de #SEC-001.

Le choix qui porte le correctif

Encoder à la construction, plutôt que contraindre au schéma.

Un z.string().regex(/^[\w-]+$/) ferait échouer un build sur un identifiant qu'un hébergeur vient de changer — alors que §1.11 tient la liste des plateformes pour ouverte. C'est la même raison qui a fait préférer z.string() à z.enum() pour platform en 0.17.0 : le plugin ne refuse pas du contenu que la spec tient pour valide.

encodeURIComponent obtient la sûreté sans ce coût.

Non cassant — vérifié, pas supposé

Les six hébergeurs n'emploient que des caractères qu'encodeURIComponent laisse intacts :

Hébergeur Id réel Après encodage
Vimeo 76979871 inchangé
YouTube dQw4w9WgXcQ inchangé
Dailymotion x8abcde inchangé
SoundCloud 1234567890 inchangé
Bandcamp 3462022220 inchangé
Spotify 4cOdK2wGLETKBW3PvgPWqT inchangé

Les tests

3 tests e2e sur le HTML produit, adossés à la fixture garde-injection déjà créée pour #SEC-001 — un embed Vimeo dont l'id porte ? et &.

Validés par mutation : neutraliser l'encodage fait tomber 2 des 3. Le troisième passe dans les deux cas par construction — il garde contre la régression inverse, un encodage qui casserait playable et ferait perdre la façade au profit d'un simple lien.

Vérification

  • npm run typecheck — 0 erreur
  • npm test274 tests verts (215 unitaires + 59 e2e), dont 3 nouveaux

🤖 Generated with Claude Code

https://claude.ai/code/session_01AgEyJQRrNvugcuu9WsujGy

`playerUrl()` interpolait l'identifiant directement dans l'URL du lecteur, alors
que le schéma le laisse libre (`z.string()`) et que `playable` ne vérifie qu'une
chaîne non vide. Un id valant `1?autoplay=0&x=1` ouvrait une query string dans
une URL dont le chemin devait s'arrêter à l'identifiant. SoundCloud était le plus
fragile : l'id y atterrit dans un paramètre `url=` déjà encodé.

Ce n'est pas un XSS — Astro échappe les attributs, et le préfixe
`https://<hébergeur>/` reste en place. L'effet se limite au détournement vers
une autre ressource du même hébergeur.

La contrainte n'est délibérément pas remontée au schéma. Un `z.string().regex(…)`
ferait échouer un build sur un identifiant qu'un hébergeur vient de changer,
alors que §1.11 tient la liste des plateformes pour ouverte — même raison qui a
fait préférer `z.string()` à `z.enum()` pour `platform` en 0.17.0. Encoder à la
construction obtient la sûreté sans ce coût.

Vérifié non cassant sur les six formats d'id réels : `encodeURIComponent` les
laisse tous intacts.

274 tests verts, dont 3 nouveaux. Validés par mutation : neutraliser l'encodage
fait tomber les 2 tests qui portent dessus. Le 3e passe dans les deux cas par
construction — il garde contre la régression inverse, un encodage qui casserait
`playable` et ferait perdre la façade.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01AgEyJQRrNvugcuu9WsujGy
@izo
izo merged commit 87aecf0 into main Aug 24, 2026
1 check passed
@izo
izo deleted the fix/sec-002-embed-id-encoding branch August 24, 2026 10:31
@izo izo mentioned this pull request Aug 24, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant