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 esthttps://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 interrogehttps://wedispatch.fr/api/resolvepour savoir si un audio existe pour l'adresse de la page. Avecdata-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: ajouterhttps://wedispatch.fr, pour le fichierplayer.js.frame-src: ajouterhttps://wedispatch.fr, pour le cadre du lecteur. Si votre politique n'a pas deframe-src, c'estchild-srcqui s'applique, puisdefault-src: ajoutez-le à celle qui est réellement lue.connect-src: ajouterhttps://wedispatch.fr, uniquement si vous utilisez le mode automatiquedata-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-srcbloque : rien ne s'affiche, et la console le dit en une ligne. C'est le cas le plus fréquent.frame-srcbloque : 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-srcbloque, en modedata-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-srcsans'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 attributsstyleet 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