django-fido
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
-
Add
django_fidotoINSTALLED_APPS. -
Add
django_fido.backends.Fido2AuthenticationBackendtoAUTHENTICATION_BACKENDS. -
Link django-fido URLs into your
urls.py:urlpatterns += [ url(r'', include('django_fido.urls')), ] -
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:
- Set
DJANGO_FIDO_TWO_STEP_AUTHtoFalse. - Replace
django_fido.backends.Fido2AuthenticationBackendwithdjango_fido.backends.Fido2GeneralAuthenticationBackendinAUTHENTICATION_BACKENDS. - Set
DJANGO_FIDO_AUTHENTICATION_BACKENDSto the list of your additional authentication backends, if you use others thandjango.contrib.auth.backends.ModelBackend. - Set
data-autosubmit-offattribute 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.20
- Fix Django 3.0 compatibility issues in templates
0.19
- Added class attribute
attestation_typestoFido2ViewMixinto specify allowed attestation types during registration. - Set default value of setting
DJANGO_FIDO_AUTHENTICATION_BACKENDSto list containingdjango.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
Fido2ModelAuthenticationBackendwith more generalFido2GeneralAuthenticationBackend.
0.16
- BREAKING Authenticator
labelhas 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_NAMEsetting. - 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_datafield. - 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
polintenvironment 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.20
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| django-fido-0.20.tar.gz | 291.1 kB | Without provenance | Details for django-fido-0.20.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| django_fido-0.20-py3-none-any.whl | Python 3 | none | any | Details for django_fido-0.20-py3-none-any.whl |
Total release size: 556.5 kB
Release files / django-fido-0.20.tar.gz
| Download URL | django-fido-0.20.tar.gz |
|---|---|
| Size | 291.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8e6e73921f32da65921e675e7208c2d9e4fb2f86198eca04f7770d96d31936c1
|
|
BLAKE2b-256 checksum How to use checksums |
d311c14fac389fd37073834c8f084bcb10ce7f0c3934bda497ed1d8cab395068
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/45.2.0 requests-toolbelt/0.9.1 tqdm/4.43.0 CPython/3.7.5
|
Release files / django_fido-0.20-py3-none-any.whl
| Download URL | django_fido-0.20-py3-none-any.whl |
|---|---|
| Size | 265.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f7ce1100fd79215ddec767a32a869c34e00b99c48c6dcba9cab22f1440eac689
|
|
BLAKE2b-256 checksum How to use checksums |
cad9dd98b8195cd3a50c48259b01e3d35845b6fad770d333ae10e79e6f24030b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/45.2.0 requests-toolbelt/0.9.1 tqdm/4.43.0 CPython/3.7.5
|
Security for django-fido 0.20
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.