{"title":"如何使用 Django 的内容安全策略","version":"6.1","locale":"zh-hans","docname":"howto/csp","url":"/zh-hans/6.1/howto/csp/","canonical":"https://djangodocs.dev/zh-hans/6.1/howto/csp/","summary":"要在Django项目中启用内容安全策略（CSP）：将CSP中间件添加到中间件设置中、在settings.py文件中，使用 SECURE_CSP 或 SECURE_CSP_REPORT_ONLY…","html":"

如何使用 Django 的内容安全策略Link to this heading#

\n
\n

基础配置Link to this heading#

\n

要在Django项目中启用内容安全策略（CSP）：

\n
    \n

  1. 将CSP中间件添加到 中间件 设置中：

    \n
    Code
    MIDDLEWARE = [\n    # ...\n    "django.middleware.csp.ContentSecurityPolicyMiddleware",\n    # ...\n]\n
    \n
    2. \n

  2. 在settings.py文件中，使用 SECURE_CSP 或 SECURE_CSP_REPORT_ONLY （或两者都使用）来配置CSP策略。CSP设置文档 提供了关于这两者之间差异的更多详细信息：

    \n
    Code
    from django.utils.csp import CSP\n\n# To enforce a CSP policy:\nSECURE_CSP = {\n    "default-src": [CSP.SELF],\n    # Add more directives to be enforced.\n}\n\n# Or for report-only mode:\nSECURE_CSP_REPORT_ONLY = {\n    "default-src": [CSP.SELF],\n    # Add more directives as needed.\n    "report-uri": "/path/to/reports-endpoint/",\n}\n
    \n
    3. \n
\n
\n
\n

Nonce配置Link to this heading#

\n

要在CSP策略中使用一次性随机数，即Nonce，除了基本配置外，你还需要：

\n
    \n

  1. 在CSP设置中包含 NONCE 占位符值。这仅适用于 script-src 或 style-src 指令：

    \n
    Code
    from django.utils.csp import CSP\n\nSECURE_CSP = {\n    "default-src": [CSP.SELF],\n    # Allow self-hosted scripts and script tags with matching `nonce` attr.\n    "script-src": [CSP.SELF, CSP.NONCE],\n    # Example of the less secure 'unsafe-inline' option.\n    "style-src": [CSP.SELF, CSP.UNSAFE_INLINE],\n}\n
    \n
    2. \n

  2. 将 csp() 上下文处理器添加到你的 TEMPLATES 设置中。这样，生成的随机数就会作为``csp_nonce``上下文变量在 Django 模板中可用：

    \n
    Code
    TEMPLATES = [\n    {\n        "BACKEND": "django.template.backends.django.DjangoTemplates",\n        "OPTIONS": {\n            "context_processors": [\n                # ...\n                "django.template.context_processors.csp",\n            ],\n        },\n    },\n]\n
    \n
    3. \n

  3. In your templates, add the nonce to elements that require it:

    \n

    For inline <style> or <script> tags, use the csp_nonce context\nvariable directly:

    \n
    Django template
    <style nonce="{{ csp_nonce }}">\n  /* These inline styles will be allowed. */\n</style>\n\n<script nonce="{{ csp_nonce }}">\n  // This inline JavaScript will be allowed.\n</script>\n
    \n

    For external <script src="..."> and <link rel="stylesheet">\nelements, use the csp_nonce_attr template tag:

    \n
    Django template
    <script src="/path/to/script.js" {% csp_nonce_attr %}></script>\n<link rel="stylesheet" href="/path/to/style.css" {% csp_nonce_attr %}>\n
    \n

    To render a Media object's assets with the nonce\napplied to each element, pass the object to the csp_nonce_attr tag:

    \n
    Django template
    {% csp_nonce_attr form.media %}\n
    \n\n
    4. \n
\n\n
","rootId":"how-to-use-django-s-content-security-policy","toc":[{"title":"基础配置","anchor":"basic-config","children":[]},{"title":"Nonce配置","anchor":"nonce-config","children":[]}],"breadcrumbs":[{"docname":"howto/index","title":"如何引导","url":"/zh-hans/6.1/howto/"}],"prev":{"docname":"howto/auth-remote-user","title":"使用 REMOTE_USER 进行身份验证","url":"/zh-hans/6.1/howto/auth-remote-user/"},"next":{"docname":"howto/csrf","title":"如何使用 Django 提供的 CSRF 防护功能","url":"/zh-hans/6.1/howto/csrf/"},"formats":{"html":"/zh-hans/6.1/howto/csp/","markdown":"/zh-hans/6.1/howto/csp.md","json":"/zh-hans/6.1/howto/csp.json"},"source":"https://github.com/django/django/blob/stable/6.1.x/docs/howto/csp.txt","official":"https://docs.djangoproject.com/zh-hans/6.1/howto/csp/","inVersions":["6.1","6.0"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}