CSRFProtectionDisabled.qhelp

<!DOCTYPE qhelp PUBLIC
 "-//Semmle//qhelp//EN"
 "qhelp.dtd">
<qhelp>

  <overview>
    <p>
      Cross-site request forgery (CSRF) is a type of vulnerability in which an
      attacker is able to force a user to carry out an action that the user did
      not intend.
    </p>

    <p>
      The attacker tricks an authenticated user into submitting a request to the
      web application. Typically this request will result in a state change on
      the server, such as changing the user's password. The request can be
      initiated when the user visits a site controlled by the attacker. If the
      web application relies only on cookies for authentication, or on other
      credentials that are automatically included in the request, then this
      request will appear as legitimate to the server.
    </p>

    <p>
      A common countermeasure for CSRF is to generate a unique token to be
      included in the HTML sent from the server to a user. This token can be
      used as a hidden field to be sent back with requests to the server, where
      the server can then check that the token is valid and associated with the
      relevant user session.
    </p>
  </overview>

  <recommendation>
    <p>
      In many web frameworks, CSRF protection is enabled by default. In these
      cases, using the default configuration is sufficient to guard against most
      CSRF attacks.
    </p>
  </recommendation>

  <example>
    <p>
      The following example shows a case where CSRF protection is disabled by
      overriding the default middleware stack and not including the one protecting against CSRF.
    </p>

    <sample src="examples/settings.py"/>

    <p>
      The protecting middleware was probably commented out during a testing phase, when server-side token generation was not set up.
      Simply commenting it back in will enable CSRF protection.
    </p>

  </example>

  <references>
    <li>Wikipedia: <a href="https://en.wikipedia.org/wiki/Cross-site_request_forgery">Cross-site request forgery</a></li>
    <li>OWASP: <a href="https://owasp.org/www-community/attacks/csrf">Cross-site request forgery</a></li>
  </references>

</qhelp>