En-têtes de la politique de sécurité du contenu
La politique de sécurité du contenu (Content-Security-Policy) renforce la sécurité en limitant la manière dont le contenu peut être chargé sur votre site web, ainsi que l’endroit d’où il provient. Cet article de référence indique quels en-têtes de la politique de sécurité du contenu sont nécessaires avec le SDK Web.

Cet article s’adresse aux développeurs qui travaillent sur des sites web appliquant des règles CSP et intégrés à Braze. Il ne constitue pas un conseil sur la manière d’aborder la sécurité.

Ce guide utilise des exemples de code du SDK Web de Braze 4.0.0+. Pour passer à la dernière version du SDK Web, consultez le Guide de mise à niveau du SDK.
Attributs nonce
Si vous utilisez une valeur nonce dans vos directives script-src ou style-src, transmettez cette valeur à l’option d’initialisation contentSecurityNonce pour la propager aux scripts et styles nouvellement créés par le SDK :
import * as braze from "@braze/web-sdk";
braze.initialize(apiKey, {
baseUrl: baseUrl,
contentSecurityNonce: "YOUR-NONCE-HERE", // assumes a "nonce-YOUR-NONCE-HERE" CSP value
});

La balise d’initialisation Braze pour Google Tag Manager (GTM) ne prend pas actuellement en charge contentSecurityNonce. Consultez la section Environnements CSP stricts (basés sur les nonces) du guide Google Tag Manager pour une solution de contournement utilisant une balise Custom HTML.
Directives
connect-src

Remplacez iad-01.braze.com par le cluster et le domaine de l’endpoint du SDK API correspondant à l’option d’initialisation baseUrl que vous avez choisie. Les clusters européens utilisent braze.eu au lieu de braze.com. Par exemple, si votre endpoint SDK est sdk.fra-01.braze.eu, utilisez connect-src https://*.fra-01.braze.eu.
| URL | Information |
|---|---|
connect-src https://*.iad-01.braze.com |
Permet au SDK de communiquer avec les API et les services en temps réel de Braze. Le caractère générique autorise l’endpoint SDK (par exemple, sdk.iad-01.braze.com) ainsi que les autres hôtes Braze de votre cluster (par exemple, dust2.iad-01.braze.com). Remplacez iad-01.braze.com par le cluster et le domaine de votre endpoint du SDK API. |
script-src
| URL | Information |
|---|---|
script-src https://js.appboycdn.com |
Requis lors de l’utilisation de l’intégration hébergée sur le CDN. |
script-src 'unsafe-eval' |
Requis lors de l’utilisation de l’extrait de code d’intégration qui fait référence à appboyQueue. Pour éviter d’utiliser cette directive, intégrez plutôt le SDK à l’aide de NPM. |
script-src 'nonce-...'ou script-src 'unsafe-inline' |
Requis pour certains messages in-app, comme le HTML personnalisé. |
img-src
| URL | Information |
|---|---|
img-src: appboy-images.com braze-images.com cdn.braze.com cdn.braze.eu |
Requis lors de l’utilisation d’images hébergées sur le CDN de Braze. Incluez les quatre noms d’hôte CDN pour garantir le chargement correct des images sur tous les clusters du tableau de bord. Important : Si vous utilisez des polices personnalisées, vous devez également inclure font-src. |
Noms d’hôte CDN
Ajoutez tous les noms d’hôte suivants à votre directive img-src :
appboy-images.combraze-images.comcdn.braze.comcdn.braze.eu
Font Awesome
Pour désactiver l’inclusion automatique de Font Awesome, utilisez l’option d’initialisation doNotLoadFontAwesome :
import * as braze from "@braze/web-sdk";
braze.initialize(apiKey, {
baseUrl: baseUrl,
doNotLoadFontAwesome: true,
});
Si vous choisissez d’utiliser Font Awesome, les directives CSP suivantes sont requises :
font-src https://use.fontawesome.comstyle-src https://use.fontawesome.comstyle-src 'nonce-...'oustyle-src 'unsafe-inline'