{"title":"Django의 콘텐츠 보안 정책을 사용하는 방법","version":"6.1","locale":"ko","docname":"howto/csp","url":"/ko/6.1/howto/csp/","canonical":"https://djangodocs.dev/ko/6.1/howto/csp/","summary":"기본 구성 Link to this heading # Django 프로젝트에서 콘텐츠 보안 정책(CSP)을 활성화하려면 다음을 따르세요. MIDDLEWARE 설정에 CSP 미들웨어를 추가합니다: Code Copy MIDDLEWARE = [ # ...…","html":"

Django의 콘텐츠 보안 정책을 사용하는 방법Link to this heading#

\n
\n

기본 구성Link to this heading#

\n

Django 프로젝트에서 콘텐츠 보안 정책(CSP)을 활성화하려면 다음을 따르세요.

\n
    \n

  1. MIDDLEWARE 설정에 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 정책을 설정합니다. :ref:`CSP 설정 문서 <csp-settings>`에서는 두 설정의 차이점을 자세히 설명합니다:

    \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

논스 구성Link to this heading#

\n

CSP 정책에서 논스를 사용하려면 기본 구성 외에도 다음을 수행해야 합니다.

\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. TEMPLATES 설정에 csp() 컨텍스트 프로세서를 추가하세요. 이렇게 하면 생성된 논스 값을 Django 템플릿에서 csp_nonce 컨텍스트 변수로 사용할 수 있습니다:

    \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":"논스 구성","anchor":"nonce-config","children":[]}],"breadcrumbs":[{"docname":"howto/index","title":"How-to 가이드","url":"/ko/6.1/howto/"}],"prev":{"docname":"howto/auth-remote-user","title":"“REMOTE_USER”를 이용해 인증하는 방법","url":"/ko/6.1/howto/auth-remote-user/"},"next":{"docname":"howto/csrf","title":"장고의 CSRF 보호를 사용하는 방법","url":"/ko/6.1/howto/csrf/"},"formats":{"html":"/ko/6.1/howto/csp/","markdown":"/ko/6.1/howto/csp.md","json":"/ko/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/ko/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"]}