<a id="configuration"></a>

# Configuration

All the apps share the settings names, some settings for Django framework are
special (like `AUTHENTICATION_BACKENDS`).

Below there’s a main settings document detailing each configuration and its
purpose, plus sections detailed for each framework and their particularities.

Support for more frameworks will be added in the future, pull-requests are very
welcome.

Contents:

* [Configuration](settings.html.md)
  * [Application setup](settings.html.md#application-setup)
  * [Settings name](settings.html.md#settings-name)
  * [Keys and secrets](settings.html.md#keys-and-secrets)
  * [Authentication backends](settings.html.md#authentication-backends)
  * [URLs options](settings.html.md#urls-options)
  * [User model](settings.html.md#user-model)
  * [Tweaking some fields length](settings.html.md#tweaking-some-fields-length)
  * [Username generation](settings.html.md#username-generation)
  * [Extra arguments on auth processes](settings.html.md#extra-arguments-on-auth-processes)
  * [OAuth2 provider URLs override](settings.html.md#oauth2-provider-urls-override)
  * [Configurable User ID Key](settings.html.md#configurable-user-id-key)
  * [Processing requests and redirects](settings.html.md#processing-requests-and-redirects)
  * [Whitelists](settings.html.md#whitelists)
  * [Miscellaneous settings](settings.html.md#miscellaneous-settings)
  * [Account disconnection](settings.html.md#account-disconnection)
* [Django Framework](django.html.md)
  * [Installing](django.html.md#installing)
  * [Quickstart](django.html.md#quickstart)
  * [Register the application](django.html.md#register-the-application)
  * [Database](django.html.md#database)
  * [Authentication backends](django.html.md#authentication-backends)
  * [URLs entries](django.html.md#urls-entries)
  * [Starting Login](django.html.md#starting-login)
  * [Templates](django.html.md#templates)
  * [Template Context Processors](django.html.md#template-context-processors)
  * [Personalized Configuration](django.html.md#personalized-configuration)
  * [ORMs](django.html.md#orms)
  * [Active users filtering](django.html.md#active-users-filtering)
  * [JSON field storage](django.html.md#json-field-storage)
  * [Exceptions Middleware](django.html.md#exceptions-middleware)
  * [Launch Bridge Endpoints](django.html.md#launch-bridge-endpoints)
  * [Django Admin](django.html.md#django-admin)
  * [Authentication storage cleanup](django.html.md#authentication-storage-cleanup)
* [Flask Framework](flask.html.md)
  * [Dependencies](flask.html.md#dependencies)
  * [Installing](flask.html.md#installing)
  * [Enabling the application](flask.html.md#enabling-the-application)
  * [Models Setup](flask.html.md#models-setup)
  * [User model reference](flask.html.md#user-model-reference)
  * [Global user](flask.html.md#global-user)
  * [Flask-Login](flask.html.md#flask-login)
  * [Remembering sessions](flask.html.md#remembering-sessions)
  * [Exceptions handling](flask.html.md#exceptions-handling)
* [Pyramid Framework](pyramid.html.md)
  * [Dependencies](pyramid.html.md#dependencies)
  * [Installing](pyramid.html.md#installing)
  * [Enabling the application](pyramid.html.md#enabling-the-application)
  * [Models Setup](pyramid.html.md#models-setup)
  * [User model reference](pyramid.html.md#user-model-reference)
  * [Global user](pyramid.html.md#global-user)
  * [User login](pyramid.html.md#user-login)
  * [Social auth in templates context](pyramid.html.md#social-auth-in-templates-context)
* [CherryPy Framework](cherrypy.html.md)
  * [Dependencies](cherrypy.html.md#dependencies)
  * [Installing](cherrypy.html.md#installing)
  * [Enabling the application](cherrypy.html.md#enabling-the-application)
  * [Models Setup](cherrypy.html.md#models-setup)
  * [Login mechanism](cherrypy.html.md#login-mechanism)
* [Webpy Framework](webpy.html.md)
  * [Dependencies](webpy.html.md#dependencies)
  * [Installing](webpy.html.md#installing)
  * [Configuration](webpy.html.md#configuration)
  * [URLs](webpy.html.md#urls)
  * [Session](webpy.html.md#session)
  * [User model](webpy.html.md#user-model)
* [Porting from django-social-auth](porting_from_dsa.html.md)
  * [Installed apps](porting_from_dsa.html.md#installed-apps)
  * [URLs](porting_from_dsa.html.md#urls)
  * [Porting settings](porting_from_dsa.html.md#porting-settings)
  * [Authentication backends](porting_from_dsa.html.md#authentication-backends)
  * [Session](porting_from_dsa.html.md#session)