mirror of
https://github.com/django/django.git
synced 2025-08-03 10:34:04 +00:00
Fixed #21495 -- Added settings.CSRF_HEADER_NAME
This commit is contained in:
parent
8e744fa150
commit
668d53cd12
7 changed files with 41 additions and 1 deletions
|
@ -92,6 +92,9 @@ protection for your views as outlined above.
|
|||
The CSRF token cookie is named ``csrftoken`` by default, but you can control
|
||||
the cookie name via the :setting:`CSRF_COOKIE_NAME` setting.
|
||||
|
||||
The CSRF header name is ``HTTP_X_CSRFTOKEN`` by default, but you can
|
||||
customize it using the :setting:`CSRF_HEADER_NAME` setting.
|
||||
|
||||
Acquiring the token is straightforward:
|
||||
|
||||
.. code-block:: javascript
|
||||
|
@ -456,3 +459,4 @@ A number of settings can be used to control Django's CSRF behavior:
|
|||
* :setting:`CSRF_COOKIE_PATH`
|
||||
* :setting:`CSRF_COOKIE_SECURE`
|
||||
* :setting:`CSRF_FAILURE_VIEW`
|
||||
* :setting:`CSRF_HEADER_NAME`
|
||||
|
|
|
@ -409,6 +409,23 @@ where ``reason`` is a short message (intended for developers or logging, not for
|
|||
end users) indicating the reason the request was rejected. See
|
||||
:doc:`/ref/csrf`.
|
||||
|
||||
.. setting:: CSRF_HEADER_NAME
|
||||
|
||||
CSRF_HEADER_NAME
|
||||
----------------
|
||||
|
||||
.. versionadded:: 1.9
|
||||
|
||||
Default: ``'HTTP_X_CSRFTOKEN'``
|
||||
|
||||
The name of the request header used for CSRF authentication.
|
||||
|
||||
As with other HTTP headers in ``request.META``, the header name received from
|
||||
the server is normalized by converting all characters to uppercase, replacing
|
||||
any hyphens with underscores, and adding an ``'HTTP_'`` prefix to the name.
|
||||
For example, if your client sends a ``'X-XSRF-TOKEN'`` header, the setting
|
||||
should be ``'HTTP_X_XSRF_TOKEN'``.
|
||||
|
||||
.. setting:: DATABASES
|
||||
|
||||
DATABASES
|
||||
|
@ -3261,6 +3278,7 @@ Security
|
|||
* :setting:`CSRF_COOKIE_PATH`
|
||||
* :setting:`CSRF_COOKIE_SECURE`
|
||||
* :setting:`CSRF_FAILURE_VIEW`
|
||||
* :setting:`CSRF_HEADER_NAME`
|
||||
|
||||
* :setting:`SECRET_KEY`
|
||||
* :setting:`X_FRAME_OPTIONS`
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue