Erreur 153 sur une vidéo YouTube intégrée : pourquoi et comment la corriger

L'erreur 153 apparaît quand le lecteur YouTube ne sait pas quel site l'a intégré, faute d'en-tête Referer. La correction pour les sites, les WebView et les apps.

Vous intégrez une vidéo YouTube, le lecteur se charge et, à la place de la vidéo, vous obtenez un cadre noir avec « Error 153. Video player configuration error » (erreur 153, erreur de configuration du lecteur vidéo), souvent avec un lien « Regarder sur YouTube ». La vidéo va bien, le code d'intégration aussi. Ce qui manque, c'est l'information sur qui intègre la vidéo.

La cause : le lecteur ne sait pas quel site l'a intégré

Les conditions de YouTube pour les développeurs sont claires. Leur page Required Minimum Functionality indique que tout ce qui utilise le lecteur intégré, y compris l'API IFrame Player, doit s'identifier via l'en-tête HTTP Referer. Les navigateurs l'envoient normalement d'eux-mêmes ; la page demande de ne pas utiliser de réglages qui le suppriment et recommande la politique de référent strict-origin-when-cross-origin.

Quand le lecteur se charge sans Referer, ou avec un Referer qui n'identifie pas de site, il refuse de lire la vidéo et affiche l'erreur 153. Les développeurs qui l'ont déboguée, comme Simon Willison, sont remontés exactement là. La page de Google ne mentionne pas le numéro 153, mais la correction qu'elle décrit est celle qui fait disparaître l'erreur.

Ce qui supprime le Referer sur un site

  • Un en-tête Referrer-Policy réglé sur no-referrer ou same-origin. Certains frameworks et configurations de sécurité en ajoutent un par défaut ; chez Willison, c'était le SecurityMiddleware de Django, qui envoie same-origin.
  • Une balise meta dans le <head> de la page : <meta name="referrer" content="no-referrer">.
  • Un attribut referrerpolicy sur l'iframe elle-même, parfois ajouté par une extension d'intégration.
  • noreferrer sur une fenêtre ouverte pour héberger le lecteur, ce que la page de YouTube déconseille.

La correction sur un site

Envoyez la politique recommandée par YouTube, en en-tête :

Referrer-Policy: strict-origin-when-cross-origin

ou en balise meta, si vous ne pouvez pas modifier les en-têtes :

<meta name="referrer" content="strict-origin-when-cross-origin">

Vérifiez ensuite que rien de plus spécifique ne la remplace : retirez l'attribut referrerpolicy de l'iframe, ou donnez-lui la même valeur. Cette politique n'envoie que votre origine (par exemple https://exemple.fr) aux autres sites, jamais le chemin complet : vous ne sacrifiez rien d'important côté confidentialité. Willison a aussi constaté que passer l'intégration sur youtube-nocookie.com n'aidait que parfois ; c'est la correction de la politique qui a réglé le problème.

La correction dans une app (WebView, Electron, Tauri)

Les apps y sont plus exposées, car leurs pages ne viennent pas d'un site web. Une page chargée depuis un fichier local ou un schéma personnalisé (file://, app://, tauri://localhost) n'a pas d'origine web à envoyer : le lecteur ne reçoit aucun Referer exploitable. La page de YouTube donne la marche à suivre par plateforme :

  • WebView mobile qui charge du HTML local : définissez le paramètre baseUrl, qui fixe le Referer.
  • SFSafariViewController sur iOS : il ne peut pas définir de Referer, utilisez plutôt le paramètre origin du lecteur.
  • Apps de bureau : ajoutez le Referer comme en-tête HTTP de la requête, ou configurez la WebView pour qu'elle en envoie un.

Dernière option, quand vous ne contrôlez pas les en-têtes de la WebView : hébergez sur un vrai domaine https qui vous appartient une petite page qui intègre le lecteur, et affichez cette page dans votre app. Le lecteur voit alors votre domaine comme l'intégrateur.

Comment nous sommes tombés dessus

Nous développons Webstarted Toolbox, une app de barre des menus construite avec Tauri, et son widget Media lit des vidéos YouTube. Son interface tourne sur tauri://localhost, qui n'est pas une origine web valide : une iframe youtube.com/embed directe échouait avec l'erreur 153 à chaque fois. Nous avons corrigé avec la dernière option : le widget affiche une petite page hébergée sur notre propre domaine https, qui envoie un Referer correct et intègre le lecteur. La vidéo elle-même est diffusée directement de Google vers la personne qui regarde ; seule cette petite page passe par notre serveur.

Si vous voulez juste regarder la vidéo

L'erreur vient du site ou de l'app qui a intégré la vidéo, pas de chez vous. Le lien « Regarder sur YouTube » la lit sur youtube.com. Une exception à vérifier : une extension de navigateur ou un réglage de confidentialité qui supprime le Referer de toutes les requêtes enlève ce même en-tête, et peut provoquer l'erreur 153 sur des sites bien configurés.

Sources