搭配內容安全政策使用代碼管理工具

內容安全政策 (CSP) 是廣泛支援的網路安全標準，可讓開發人員控管應用程式載入的資源，藉此防範特定類型的注入攻擊。請參閱本指南，瞭解如何在使用 CSP 的網站上部署 Google 代碼管理工具。

注意： 為確保 CSP 能正常運作，建議您使用 report-uri 和/或 report-to 指令取得政策違規報告。

啟用容器標記以使用 CSP

如要在含有 CSP 的網頁上使用 Google 代碼管理工具，CSP 必須允許執行代碼管理工具容器程式碼。這個程式碼會建構為內嵌 JavaScript 程式碼，用於插入 gtm.js 指令碼。您可以透過多種方式執行這項操作，例如使用 Nonce 或雜湊。建議的方法是使用 nonce，這應該是伺服器針對每則回應個別產生不可猜的隨機值。在 Content-Security-Policy script-src 指令中提供 Nonce 值：

Content-Security-Policy:
script-src 'nonce-{SERVER-GENERATED-NONCE}';
img-src www.googletagmanager.com;
connect-src www.googletagmanager.com

接著，使用內嵌代碼管理工具容器程式碼的 Nonce 版本。將內嵌指令碼元素的 nonce 屬性設為相同的值：

<!-- Google Tag Manager -->
<script nonce='{SERVER-GENERATED-NONCE}'>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
'https://www.googletagmanager.com/gtm.js?id='+i+dl;var n=d.querySelector('[nonce]');
n&&j.setAttribute('nonce',n.nonce||n.getAttribute('nonce'));f.parentNode.insertBefore(j,f);
})(window,document,'script','dataLayer','GTM-XXXXXX');</script>
<!-- End Google Tag Manager -->

接著，代碼管理工具會將 Nonce 套用至網頁中加入的所有指令碼。

您也可以透過其他方式啟用內嵌指令碼的執行作業，例如在 CSP 中提供內嵌指令碼的雜湊值。

如果建議的 Nonce 或雜湊方法不可行，您可以將 'unsafe-inline' 指令新增至 CSP 的 script-src 區段，啟用代碼管理工具內嵌指令碼。

不建議使用「unsafe-inline」。使用這個方法前，請先仔細考量在 CSP 中加入這個指示的安全性影響。

如要使用這種方法，CSP 中必須包含下列指令：

script-src 'unsafe-inline' https://www.googletagmanager.com
img-src www.googletagmanager.com
connect-src www.googletagmanager.com

注意： 某些標記會從其他來源載入內容或向其他來源提出要求，因此需要使用額外的 CSP 指示才能正常運作。

自訂 JavaScript 變數

由於 自訂 JavaScript 變數的導入方式，在 CSP 存在的情況下，這些變數會評估為 undefined，除非在 CSP 的 script-src 部分提供 'unsafe-eval' 指令。

為避免潛在的安全漏洞，請僅在絕對必要時使用 `unsafe-eval`。

script-src 'unsafe-eval'

注意： 建議您改用自訂範本，而非自訂 JavaScript 變數。可用來建立不需要使用 'unsafe-eval' 的自訂代碼和變數。

預覽模式

如要使用 Google 代碼管理工具的預覽模式，CSP 必須包含下列指令：

script-src https://googletagmanager.com https://tagmanager.google.com
style-src https://googletagmanager.com https://tagmanager.google.com https://fonts.googleapis.com
img-src https://googletagmanager.com https://ssl.gstatic.com https://www.gstatic.com
font-src https://fonts.gstatic.com data:

注意： 如果網頁是透過非安全連線提供，script-src 指令應改為包含非安全的 http://googletagmanager.com http://tagmanager.google.com 網址。

Google Analytics 4 (Google Analytics)

如要使用 Google Analytics 4 (Google Analytics) 代碼，CSP 必須包含下列指令：

script-src  https://*.googletagmanager.com
img-src     https://*.google-analytics.com https://*.googletagmanager.com
connect-src https://*.google-analytics.com https://*.analytics.google.com https://*.googletagmanager.com

使用 Google 信號部署 Google Analytics 4 (Google Analytics) 時，CSP 必須包含下列指令：

script-src  https://*.googletagmanager.com
img-src     https://*.google-analytics.com https://*.analytics.google.com https://*.googletagmanager.com
             https://*.g.doubleclick.net https://*.google.com https://*.google.<TLD>
connect-src https://*.google-analytics.com https://*.analytics.google.com
             https://*.googletagmanager.com https://*.g.doubleclick.net https://*.google.com https://*.google.<TLD>
frame-src   https://td.doubleclick.net

注意： 每個 Google 頂層網域 (TLD) 都必須個別指定，因為 CSP 語法不允許在主機名稱右側使用萬用字元。如要查看所有支援的 Google 頂層網域清單，請前往 https://www.google.com/supported_domains。

Google Ads 轉換

如要使用 Google Ads 轉換代碼，CSP 必須包含下列指令：

安全連線：

script-src https://www.googleadservices.com https://www.google.com https://www.googletagmanager.com
img-src https://googleads.g.doubleclick.net https://www.google.com https://google.com https://pagead2.googlesyndication.com
frame-src https://www.googletagmanager.com https://td.doubleclick.net
connect-src https://pagead2.googlesyndication.com

針對不安全的連線：

script-src www.googleadservices.com www.google.com www.googletagmanager.com
img-src googleads.g.doubleclick.net www.google.com google.com pagead2.googlesyndication.com
connect-src pagead2.googlesyndication.com

Google Ads 再行銷

如要使用 Google Ads 再行銷代碼，CSP 必須包含下列指令。

安全連線：

script-src https://www.googleadservices.com https://googleads.g.doubleclick.net https://www.google.com
img-src https://www.google.com https://google.com
frame-src https://td.doubleclick.net

針對不安全的連線：

script-src www.googleadservices.com googleads.g.doubleclick.net www.google.com
img-src www.google.com google.com
frame-src td.doubleclick.net

Google Ads 使用者資料信標

如要在安全內容中使用 Google Ads 使用者資料信標，CSP 必須包含下列指令：

script-src https://www.googletagmanager.com
frame-src https://www.googletagmanager.com

Google Ads 使用者資料信標不會在不安全的情況下執行，因此在這些情況下不適用 CSP 設定。

泛光燈

Floodlight 使用者可以使用下列設定啟用 CSP。將 <FLOODLIGHT-CONFIG-ID> 值替換為特定 Floodlight 廣告主 ID，或 * 以允許任何廣告主 ID：

適用於所有使用者：

img-src https://<FLOODLIGHT-CONFIG-ID>.fls.doubleclick.net
frame-src https://td.doubleclick.net

代碼管理工具中的「自訂指令碼」信標：

frame-src https://<FLOODLIGHT-CONFIG-ID>.fls.doubleclick.net

如為圖片代碼：

img-src https://ad.doubleclick.net

同意聲明模式：

img-src https://ade.googlesyndication.com