{"title":"How to use Django's Content Security Policy","version":"6.0","locale":"ga","docname":"howto/csp","url":"/ga/6.0/howto/csp/","canonical":"https://djangodocs.dev/ga/6.0/howto/csp/","summary":"Basic config Link to this heading # To enable Content Security Policy (CSP) in your Django project: Add the CSP middleware to your MIDDLEWARE setting: Code Copy…","html":"

How to use Django's Content Security PolicyLink to this heading#

\n
\n

Basic configLink to this heading#

\n

To enable Content Security Policy (CSP) in your Django project:

\n
    \n

  1. Add the CSP middleware to your MIDDLEWARE setting:

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

  2. Configure the CSP policies in your settings.py using either\nSECURE_CSP or SECURE_CSP_REPORT_ONLY (or both). The\nCSP Settings docs provide more details about the\ndifferences between these two:

    \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 configLink to this heading#

\n

To use nonces in your CSP policy, beside the basic config, you need to:

\n
    \n

  1. Include the NONCE placeholder value in the CSP\nsettings. This only applies to script-src or style-src directives:

    \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. Add the csp() context processor to\nyour TEMPLATES setting. This makes the generated nonce value\navailable in the Django templates as the csp_nonce context variable:

    \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 attribute to the relevant inline\n<style> or <script> tags, using the csp_nonce context variable:

    \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
    4. \n
\n\n
","rootId":"how-to-use-django-s-content-security-policy","toc":[{"title":"Basic config","anchor":"basic-config","children":[]},{"title":"Nonce config","anchor":"nonce-config","children":[]}],"breadcrumbs":[{"docname":"howto/index","title":"Treoracha conas","url":"/ga/6.0/howto/"}],"prev":{"docname":"howto/auth-remote-user","title":"Conas fíordheimhniú ag baint úsáide as REMOTE_USER","url":"/ga/6.0/howto/auth-remote-user/"},"next":{"docname":"howto/csrf","title":"Conas cosaint CSRF Django a úsáid","url":"/ga/6.0/howto/csrf/"},"formats":{"html":"/ga/6.0/howto/csp/","markdown":"/ga/6.0/howto/csp.md","json":"/ga/6.0/howto/csp.json"},"source":"https://github.com/django/django/blob/stable/6.0.x/docs/howto/csp.txt","official":"https://docs.djangoproject.com/ga/6.0/howto/csp/","inVersions":["6.1","6.0"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}