콘텐츠 보안 정책 헤더
Content-Security-Policy는 웹사이트에서 콘텐츠를 로드하는 방식과 위치를 제한하여 보안을 강화합니다. 이 참조 문서에서는 웹 SDK를 사용할 때 필요한 콘텐츠 보안 정책 헤더를 다룹니다.

이 문서는 CSP 규칙을 적용하면서 Braze와 통합하는 웹사이트를 작업하는 개발자를 대상으로 합니다. 보안 접근 방식에 대한 조언을 제공하기 위한 문서가 아닙니다.

Nonce 속성
nonce 값을 script-src 또는 style-src 지시문에서 사용하는 경우, 해당 값을 contentSecurityNonce 초기화 옵션에 전달하여 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
});

Google Tag Manager(GTM)용 Braze 초기화 태그는 현재 contentSecurityNonce를 지원하지 않습니다. 커스텀 HTML 태그를 사용하는 우회 방법은 Google Tag Manager 가이드의 엄격한 CSP(nonce 기반) 환경을 참조하세요.
지시문
connect-src

iad-01.braze.com을 선택한 baseUrl 초기화 옵션의 API SDK 엔드포인트에 해당하는 클러스터 및 도메인으로 바꾸세요. EU 클러스터는 braze.com 대신 braze.eu를 사용합니다. 예를 들어 SDK 엔드포인트가 sdk.fra-01.braze.eu라면 connect-src https://*.fra-01.braze.eu를 사용하세요.
| URL | 정보 |
|---|---|
connect-src https://*.iad-01.braze.com |
SDK가 Braze API 및 실시간 서비스와 통신할 수 있도록 허용합니다. 와일드카드를 사용하면 SDK 엔드포인트(예: sdk.iad-01.braze.com)와 클러스터의 다른 Braze 호스트(예: dust2.iad-01.braze.com)가 허용됩니다. iad-01.braze.com을 API SDK 엔드포인트의 클러스터 및 도메인과 일치하도록 변경하세요. |
script-src
| URL | 정보 |
|---|---|
script-src https://js.appboycdn.com |
CDN 호스팅 통합을 사용할 때 필요합니다. |
script-src 'unsafe-eval' |
appboyQueue에 대한 참조가 포함된 통합 스니펫을 사용할 때 필요합니다. 이 지시문을 사용하지 않으려면 대신 NPM을 사용하여 SDK를 통합하세요. |
script-src 'nonce-...'또는 script-src 'unsafe-inline' |
커스텀 HTML과 같은 특정 인앱 메시지에 필요합니다. |
img-src
| URL | 정보 |
|---|---|
img-src: appboy-images.com braze-images.com cdn.braze.com cdn.braze.eu |
Braze CDN 호스팅 이미지를 사용할 때 필요합니다. 모든 대시보드 클러스터에서 이미지가 올바르게 로드되도록 네 개의 CDN 호스트 이름을 모두 포함하세요. 중요: 커스텀 글꼴을 사용하는 경우 font-src도 포함해야 합니다. |
CDN 호스트 이름
다음 호스트 이름을 모두 img-src 지시문에 추가하세요.
appboy-images.combraze-images.comcdn.braze.comcdn.braze.eu
Font Awesome
Font Awesome의 자동 포함을 비활성화하려면 doNotLoadFontAwesome 초기화 옵션을 사용하세요.
import * as braze from "@braze/web-sdk";
braze.initialize(apiKey, {
baseUrl: baseUrl,
doNotLoadFontAwesome: true,
});
Font Awesome을 사용하기로 선택한 경우 다음 CSP 지시문이 필요합니다.
font-src https://use.fontawesome.comstyle-src https://use.fontawesome.comstyle-src 'nonce-...'또는style-src 'unsafe-inline'