← Blog · 19 novembre 2026 · Read in English

Lecteur audio et Content-Security-Policy : les directives exactes à ouvrir, et rien de plus

Votre site applique une politique de sécurité de contenu et le lecteur audio ne s'affiche pas ? Ce que le script charge réellement, les trois directives à compléter, le cas des nonces, et ce qui se passe à l'écran quand une règle bloque.

Sur un site de presse ou d'institution, l'en-tête Content-Security-Policy est souvent posé par quelqu'un qui n'est plus là, ou par un prestataire qui l'a durci après un audit. Il fait son travail : il refuse tout ce qui n'a pas été autorisé nommément. Le jour où l'on colle la ligne d'intégration d'un lecteur audio, rien n'apparaît, et la console du navigateur affiche une phrase qui commence par « Refused to load ».

La tentation, à ce moment-là, est d'ajouter * ou 'unsafe-inline' pour que ça marche. C'est exactement ce qu'il ne faut pas faire. La bonne réponse est de savoir ce que le lecteur charge vraiment, et d'ouvrir cela seulement. Voici la liste, lue dans le script que nous servons, sans arrondi.

Ce que fait la ligne d'intégration, étape par étape

La ligne collée dans la page est un script : <script src="https://wedispatch.fr/player.js" data-article="…" defer></script>, ou la variante data-site="…" posée une fois dans le gabarit d'article. C'est aussi ce que pose l'extension WordPress : les mêmes directives valent donc pour un site WordPress protégé.

Une fois chargé, ce script fait trois choses, et seulement trois :

  • Il crée un cadre (iframe) dont l'adresse est https://wedispatch.fr/embed/<identifiant>. Tout le lecteur vit là-dedans : les boutons, la transcription, et surtout le fichier audio, qui est lu à l'intérieur du cadre, sous notre domaine.
  • En mode automatique seulement (data-site), il interroge https://wedispatch.fr/api/resolve pour savoir si un audio existe pour l'adresse de la page. Avec data-article, cet appel n'a pas lieu.
  • Si vous utilisez l'accès réservé aux abonnés (data-token-url), il appelle l'adresse que vous avez indiquée, sur votre propre site, pour obtenir un jeton. Ce mécanisme est détaillé dans l'article sur l'audio des articles réservés aux abonnés.

Il ne charge pas d'autre script, pas de police, pas d'image hébergée ailleurs. Il communique avec son cadre par postMessage, que la politique de sécurité de contenu ne filtre pas.

Les directives à compléter

Pour un site qui n'autorise aujourd'hui que lui-même, l'ajout tient en trois directives :

  • script-src : ajouter https://wedispatch.fr, pour le fichier player.js.
  • frame-src : ajouter https://wedispatch.fr, pour le cadre du lecteur. Si votre politique n'a pas de frame-src, c'est child-src qui s'applique, puis default-src : ajoutez-le à celle qui est réellement lue.
  • connect-src : ajouter https://wedispatch.fr, uniquement si vous utilisez le mode automatique data-site.

Ce qui donne, pour une politique minimale :

Content-Security-Policy: default-src 'self'; script-src 'self' https://wedispatch.fr; frame-src 'self' https://wedispatch.fr; connect-src 'self' https://wedispatch.fr

Ce qui n'est pas à ajouter : media-src. Le son est lu dans le cadre, pas dans votre page, et c'est notre propre politique qui s'applique à l'intérieur. Pas besoin non plus d'autoriser un stockage de fichiers tiers : votre page ne le voit jamais.

Le cas des nonces et de strict-dynamic

Les politiques les plus récentes n'énumèrent plus de domaines : elles posent un nonce aléatoire sur chaque balise de script légitime, souvent avec 'strict-dynamic'. Dans ce cas, la liste de domaines de script-src est ignorée par les navigateurs modernes, et ajouter https://wedispatch.fr ne sert à rien. Il faut poser le nonce de la page sur la balise elle-même : <script nonce="…" src="https://wedispatch.fr/player.js" …>. Votre gabarit le fait déjà pour vos autres scripts ; c'est la même ligne de code.

frame-src et connect-src, eux, restent des listes de domaines, nonce ou pas.

Ce que vous verrez si une directive manque

Le comportement dépend de la directive bloquée, et il vaut mieux le connaître avant de chercher :

  • script-src bloque : rien ne s'affiche, et la console le dit en une ligne. C'est le cas le plus fréquent.
  • frame-src bloque : l'esquisse du lecteur apparaît là où il devait être, puis s'efface au bout de cinq secondes, faute de réponse du cadre. Le script a fait son travail, le cadre a été refusé.
  • connect-src bloque, en mode data-site : rien ne s'affiche. Le script ne sait pas qu'un audio existe, et par construction il n'insère jamais de cadre vide sur une page sans audio.
  • style-src sans 'unsafe-inline' : c'est le seul effet visible qui ne casse rien. Pendant le chargement, le script dessine une esquisse du lecteur (une pastille, un filet, un reflet animé). Ce dessin passe par des attributs style et une petite feuille de style insérée, que votre politique refuse. La boîte de l'esquisse s'affiche quand même, son dessin intérieur non. Le lecteur arrive ensuite normalement : ses dimensions et sa position sont réglées par le script sans passer par du style en ligne.

Si vous avez un doute, passez d'abord votre politique en Content-Security-Policy-Report-Only le temps d'un essai : le navigateur signale les refus sans rien bloquer. Pour les autres causes possibles d'un lecteur absent (extension de blocage, cache, adresse canonique), la liste de vérification est dans ce que vérifier quand l'audio ne marche pas.

Et de notre côté ?

Un cadre ne s'affiche que si le site encadré l'accepte. Notre site refuse d'être mis dans un cadre (X-Frame-Options: DENY), à une exception près, écrite dans notre configuration : l'adresse /embed, qui est celle du lecteur. Elle seule peut être encadrée par votre domaine. C'est un réglage volontaire et vérifiable : il suffit de regarder les en-têtes d'une page de notre site et ceux d'une adresse /embed.

Les événements d'écoute que le lecteur transmet à votre outil de mesure passent par votre propre page (la couche de données déjà présente), sans directive supplémentaire ; le détail est dans l'article sur le suivi des écoutes dans GA4 ou Matomo.

Si aucune exception n'est acceptable

Certaines politiques interdisent tout script et tout cadre venant d'un autre domaine, sans discussion. Ce n'est pas un caprice, et il existe un chemin pour elles : le lecteur peut être rendu par votre serveur, sans cadre ni script tiers, comme expliqué dans l'intégration par bloc serveur. Le fichier audio est alors lu directement dans votre page : c'est media-src qu'il faudra compléter, avec l'adresse des fichiers que le bloc vous remet, et pour cette seule raison.

Dans tous les cas, la règle est la même : ouvrir ce qui est nécessaire, nommément, et le documenter dans le dépôt du site. Une politique de sécurité qui grossit d'un * à chaque nouvel outil finit par ne plus rien protéger.

Sonorisez vos articles avec WeDispatch

Ce blog sera lui-même sonorisé par WeDispatch. Envie de voir ce que ça donne sur vos contenus ?

Demandez une démo

À lire aussi