This document is for CakePHP's development version, which can be significantly different from previous releases.
You may want to read current stable release documentation instead.

Page Contents

コンテンツセキュリティポリシーミドルウェア

CspMiddleware を使用すると、Content-Security-Policyヘッダーをアプリケーションに簡単に追加できます。使用する前に paragonie/csp-builder をインストールしておく必要があります

composer require paragonie/csp-builder

次に、配列を使用するか、ビルドされた CSPBuilder オブジェクトを渡すことで、ミドルウェアを構成できます。:

use Cake\Http\Middleware\CspMiddleware;

$csp = new CspMiddleware([
    'script-src' => [
        'allow' => [
            'https://www.google-analytics.com',
        ],
        'self' => true,
        'unsafe-inline' => false,
        'unsafe-eval' => false,
    ],
]);

$middlewareQueue->add($csp);

厳密なCSP構成を使用したい場合は、 scriptNonce および styleNonce オプションを 使用してノンス(ナンス)ベースのCSPルールを有効にできます。 これらのオプションを有効にすると、CSPポリシーが変更され、 リクエストに cspScriptNonce 属性と``cspStyleNonce`` 属性が設定されます。 これらの属性は、 HtmlHelper によって作成されたすべてのスクリプトおよびCSSリンク要素のnonce属性に適用されます。 これにより nonce-base64 と strict-dynamic を使用するポリシーの採用が簡素化され、セキュリティが強化され、メンテナンスが容易になります。:

$policy = [
    // script-srcにノンスを設定するには、内容が空の場合でも作成する必要があります
    'script-src' => [],
    'style-src' => [],
];
// スクリプトとCSSリンクタグへのナンス自動追加を有効にします。
$csp = new CspMiddleware($policy, [
    'scriptNonce' => true,
    'styleNonce' => true,
]);
$middlewareQueue->add($csp);

バージョン 4.3.0 で追加: ナンス自動追加機能が実装されました。