flask-csrf / docs / index.rst

Full commit

Welcome to flask-csrf's documentation!

The internet is a dangerous place. One common type of attack your site's users can fall victim to is Cross-Site Request Forgery attacks.

flask-csrf is a small extension to Flask that makes adding CSRF protection to your Flask application quick and easy. It's based on this snippet from the Flask snippet site.


Install flask-csrf with pip:

pip install -e 'hg+'

Prefer git to Mercurial?

pip install -e 'git+'


To activate CSRF protection for your Flask application you need to do two things. First, call the csrf function with your Flask app as a parameter:

from flaskext.csrf import csrf

Once you do that you'll need to add a CSRF token to every form on your site that makes an HTTP POST request:

<input type="hidden" value="{{ csrf_token() }}">

If you have certain views that need to be excluded from this protection (perhaps they receive POST requests from a third-party site) you can use the csrf_exempt decorator to disable protection:

from flaskext.csrf import csrf, csrf_exempt

def my_receiving_view():
    # ...


If for some reason you want to know when a CSRF attack happens, you can pass a function to the csrf call and it will be called whenever an attack is detected:

from flaskext.csrf import csrf

attacks = 0
def count_csrf_attacks(endpoint, arguments):
    attacks += 1

csrf(app, on_csrf=count_csrf_attacks)

This function must take two parameters:

  • endpoint - A string representing the view that would normally handle this request.
  • arguments - The arguments that would normally be passed (if any) to that view.

You can use this function to do anything you like; counting attacks is just a simple example.


flask-csrf is open source and MIT licensed. If you want to contribute feel free to fork the Mercurial repository or git repository and send a pull request.