Skip to main content

django-fido

Build Status codecov

Django application for FIDO protocol

Django-fido provides basic components for FIDO 2 authentication - model to store user's FIDO 2 authenticator data and basic views.

Table of Contents

Dependencies

  • Python 3.5 and higher
  • Django >= 1.11

Configuration

  1. Add django_fido to INSTALLED_APPS.

  2. Add django_fido.backends.Fido2AuthenticationBackend to AUTHENTICATION_BACKENDS.

  3. Link django-fido URLs into your urls.py:

    urlpatterns += [
       url(r'', include('django_fido.urls')),
    ]
    
  4. If you wish, set string variable DJANGO_FIDO_RP_NAME.

One step authentication

You can also decide to use one step authentication. In this case, you will use just one authentication form, that will collect username, password and FIDO2 credentials. In addition to the configuration above, you also need to:

  1. Set DJANGO_FIDO_TWO_STEP_AUTH to False.
  2. Replace django_fido.backends.Fido2AuthenticationBackend with django_fido.backends.Fido2GeneralAuthenticationBackend in AUTHENTICATION_BACKENDS.
  3. Set DJANGO_FIDO_AUTHENTICATION_BACKENDS to the list of your additional authentication backends, if you use others than django.contrib.auth.backends.ModelBackend.
  4. Set data-autosubmit-off attribute on the form element of your login page.

Please note that your login form must have a field named username, even if your USERNAME_FIELD is not username.

Changes

See changelog.

Testing

Use tox to run tests

tox

License

See LICENSE.

Changelog

0.19

  • Added class attribute attestation_types to Fido2ViewMixin to specify allowed attestation types during registration.
  • Set default value of setting DJANGO_FIDO_AUTHENTICATION_BACKENDS to list containing django.contrib.auth.backends.ModelBackend

0.18

  • Fix issue caused by default value of DJANGO_FIDO_AUTHENTICATION_BACKENDS. It is now empty list.

0.17

  • BREAKING Replace Fido2ModelAuthenticationBackend with more general Fido2GeneralAuthenticationBackend.

0.16

  • BREAKING Authenticator label has to be unique for user. This can potentialy break if you have multiple tokens for user.
  • Add authenticator admin.
  • Add one step authentication.

0.15

  • Add DJANGO_FIDO_RP_NAME setting.
  • Add back autosubmit on login view.
  • Display error in login view on server request error.

0.14

  • Add label to Authenticator model.
  • Remove autosubmit on registration view.
  • Update JS dependencies.

0.13

  • Support fido2 0.6-0.8.
  • Add support for python 3.8.
  • Fixup annotations.

0.12

  • Fix dependencies (add webpack-cli).

0.11

  • Fix webpack output path.

0.10

  • Fix dependencies (add webpack).

0.9

  • Refactor JS code.
  • Update setup.
  • Add bumpversion.

0.8

  • Fix JS translation lazynes.
  • For empty values, submit button reload page.

0.7

  • Add credential ID field.
  • Drop credential_data field.
  • Update error messages.
  • Mark django-fido as typed.
  • Add JS hooks.

0.6

  • Use FIDO 2 instead of U2F.
  • Drop python 2.7.
  • Add annotations and mypy check.
  • Move repository to a CZ.NIC account.

0.5

  • Fix JS translation lazynes

0.4

  • Update JS messages.
  • Drop unused polint environment in tox.

0.3

  • Store attestation certificate in database #6
  • Install package data #7

0.2

  • Accept any arguments in BaseU2fRequestView.get
  • Add czech translations
  • Fix links in README

0.1

  • Initial version

Metadata

Release files for django-fido 0.19

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for django-fido 0.19
File Size Uploaded Provenance Actions
django-fido-0.19.tar.gz 322.8 kB Without provenance Details for django-fido-0.19.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for django-fido 0.19
File Interpreter ABI Platform Actions
django_fido-0.19-py3-none-any.whl Python 3 none any Details for django_fido-0.19-py3-none-any.whl

Total release size: 724.2 kB

Release files / django-fido-0.19.tar.gz

Download URL django-fido-0.19.tar.gz
Size 322.8 kB
Tags Source
SHA-256 checksum
How to use checksums
cef137b04ab33ad8572d330d9b5bdb5b58e140c8870957b2d8ee76e5eac4cc7f
BLAKE2b-256 checksum
How to use checksums
b0a12552e4651c1c49ef8cc92a1dcc607fe86701e2e823b1dec79fa1b057f4e0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.12.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/44.0.0 requests-toolbelt/0.9.1 tqdm/4.30.0 CPython/3.7.6

Release files / django_fido-0.19-py3-none-any.whl

Download URL django_fido-0.19-py3-none-any.whl
Size 401.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
238b101947ac337a3f8ce7e692ca495284b49e06429c261f878131b8341f633b
BLAKE2b-256 checksum
How to use checksums
fa5c6158e11f7a72effe0e1e9e45dbbaf7db4ef748fdb100863466929caf2c85
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.12.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/44.0.0 requests-toolbelt/0.9.1 tqdm/4.30.0 CPython/3.7.6

Security for django-fido 0.19

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.19 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page