1.7.0 - 2021-06-07


  • Setting to block guest users from authenticating.
  • Setting to set the Azure AD endpoint version

1.6.1 - 2021-03-25


  • Raise PermissionDenied when token is lacking information needed to create a user. #116 #149
  • Documentation error for JWT_LEEWAY. #147

1.6.0 - 2021-01-25


  • New parameter called CUSTOM_FAILED_RESPONSE_VIEW, allowing you to set a custom django function view to handle login failures. #136

1.5.0 - 2021-01-18


  • New parameter called LEEWAY_JWT, allowing you to set a leeway for validating the JWT token. #128

1.4.1 - 2021-01-16


  • AADSTS50076 error fixed. #101

1.4.0 - 2021-01-16


  • Added support for enterprice app SSO certificates. #87
  • Added setting to disable user creation. #96


  • Dependency compatibility for PyJWT 2.0. #120
  • Django 4.0 deprecation cleanup.
  • Fixed a bug where IntegrityError could occur if a users groups changed, and multiple requests were done quickly. #95

1.3.1 - 2019-11-06


  • Fix retries towards ADFS in situations where ADFS didn’t respond in time.

1.3.0 - 2019-11-01


From this release onwards, compatibility with python 2.7 and 3.4 is not guaranteed anymore.


  • Python 2.7 and 3.4 tests
  • Django Rest Framework 3.7 tests


  • The URLs file to override the django rest framework login (, was not a valid python module name. It was changed to Th old name is still there but will be removed in a next release.


  • Added setting SETTINGS_CLASS, defaulting to django_auth_adfs.config.Settings. This provides a mechanism to load the AUTH_ADFS config from sources other than Django settings.
  • Python 3.8 tests
  • Django Rest Framework 3.10 tests

1.2.0 - 2019-03-01


  • Django 1.8, 1.9 and 1.10 support. They are end of extended support and keeping support for them was becoming too complex.


  • The django templates were missing in the wheel

1.1.2 - 2018-12-11


  • Added views to selectively disable SSO for login links


  • Existing users with an empty password raised an exception

1.1.1 - 2018-12-07


  • Add a setting to force a login screen and disable SSO on ADFS.
  • Documentation about how to enable SSO for other browsers than IE & Edge.


  • Prevent username field from being overwritten by a claim mapping.
  • Prevent traceback upon logout when ADFS config is not yet loaded.
  • Fix fields in log messages being swapped.


  • Don’t allow the audience claim to be ignored. Preventing access token reuse.
  • Set an unusable password on newly created user instead of leaving it empty.

1.0.0 - 2018-12-05

This version contains backwards incompatible changes. Make sure to read the entire release notes


  • Windows 2016 (a.k.a. ADFS 4.0) Support
  • AzureAD support (check the setting TENANT_ID)
  • Django Rest Framework support.
  • Add a RETRIES and TIMEOUT setting for requests towards the ADFS server.
  • Add the CLIENT_SECRET setting to support client secrets in the OAuth2 Flow.
  • Users are now redirected back to the page that triggered the login instead of the main page.
  • Groups a user belongs to can now be automatically created in Django (check the MIRROR_GROUPS setting)


  • Django 2.1 support
  • All settings that can be determined automatically are now set automatically
  • When a claim mapped to a non-required field in the user model is missing, a warning is logged instead of an exception raised

Incompatible changes

  • Because of the login and logout views that were added, the redirect URI back from ADFS should now point to /oauth2/callback. Keeping it at /oauth2/login would have caused a potential redirect loop.


  • these settings are now loaded from ADFS metadata automatically and have been deprecated:

    • ISSUER

0.2.1 - 2017-10-20

  • Django 2.0 support and tests.

0.2.0 - 2017-09-14

  • Fixed a bug were authentication failed when the last ADFS signing key was not the one that signed the JWT token.
  • Django 1.11 support and tests.
  • Proper handling the absence of ‘code’ query parameter after ADFS redirect.
  • Added ADFS configuration guide to docs.
  • Allow boolean user model fields to be set based on claims.
  • The namespace argument for include() is not needed anymore on Django >=1.9.
  • Fixed some Django 2.0 deprecation warnings, improving future django support.

0.1.2 - 2017-03-11

  • Support for django 1.10 new style middleware using the MIDDLEWARE setting.

0.1.1 - 2016-12-13

  • Numerous typos fixed in code and documentation.
  • Proper handling of class variables to allow inheriting from the class AdfsBackend.

0.1.0 - 2016-12-11

  • By default, the ADFS signing certificate is loaded from the FederationMetadata.xml file every 24 hours. Allowing to automatically follow certificate updates when the ADFS settings for AutoCertificateRollover is set to True (the default).
  • Group assignment optimisation. Users are not removed and added to all groups anymore. Instead only the groups that need to be removed or added are handled.

Backwards incompatible changes

  • The redundant ADFS_ prefix was removed from the configuration variables.

0.0.5 - 2016-12-10

  • User update code in authentication backend split into separate functions.

0.0.4 - 2016-03-14

  • Made the absence of the group claim non-fatal to allow users without a group.

0.0.3 - 2016-02-21

  • ADFS_REDIR_URI is now a required setting
  • Now supports Python 2.7, 3.4 and 3.5
  • Now supports Django 1.7, 1.8 and 1.9
  • Added debug logging to aid in troubleshooting
  • Added unit tests
  • Lot’s of code cleanup

0.0.2 - 2016-02-11

  • Fixed a possible issue with the cryptography package when used with apache + mod_wsgi.
  • Added a optional context processor to make the ADFS authentication URL available as a template variable (ADFS_AUTH_URL).
  • Added a optional middleware class to be able force an anonymous user to authenticate.

0.0.1 - 2016-02-09

  • Initial release