Package: django-webauthin
WebAuthin'WARNING: This library is still somewhat of an alpha version, though it should mostly work.AboutWebAuthin' is a Django library for secure, passwordless logins using WebAuthn/FIDO2.It allows users to associate secure keys (from USB keys like Yubikeys, Titan keys, etc
to platform authenticators like OS X's TouchID) with your website and log in just by
plugging the key in. This means they don't need to remember a username/password, there
are no credentials to steal, and they don't need a second factor.WebAuthin' requires user verification, which means that the user will need to enter a
PIN, fingerprint, or some other method of verification locally, to prevent theft of the
physical key from allowing logins.WebAuthn is currently only supported on a few browsers (Chrome on the desktop, somewhat
on Firefox on Android, possibly Safari on iOS).Installing django-webauthinFirst of all, make sure that your site uses theSitesframeworkproperly, as that
is what WebAuthin' currently uses to get your site name and domain. In the future,
settings will be added so you won't need to do this.Install django-webauthin using pip:pip install django-webauthinAddwebauthinto yourINSTALLED_APPS:# settings.pyINSTALLED_APPS=[..."webauthin",...]Add webauthin to your authentication backends:AUTHENTICATION_BACKENDS=("webauthin.auth_backends.WebAuthinBackend","django.contrib.auth.backends.ModelBackend",)Add the webauthin URL to yoururls.py:# urls.pyurlpatterns+=path("auth/",include("webauthin.urls",namespace="webauthin"))You now need two buttons, one for registration and one for login. The registration
button should have an ID ofwebauthin-register. You also need to include a
template that will insert the JS code somewhere:{% include "webauthin_register.html" %}<buttonid="webauthin-register">Register new key</button>Pressing this button will trigger the key registration flow.Add the login button to your login form, as above, this time with an ID ofwebauthin-login:{% include "webauthin_login.html" %}<buttonid="webauthin-login">Log in using hardware key</button>You can also add a table to allow the user to see and delete their registered keys,
though this process is currently somewhat manual:{% for key in request.user.authdata_set.all %}<p>{{ key.name }}: Created on {{ key.created_on }} and last used on
    {{ key.last_used_on }}.<formmethod="POST"action="{% url "webauthin:delete-key"%}"onsubmit="return confirm('Are you sure you want to delete this key?');">{% csrf_token %}<inputtype="hidden"name="key_id"value="{{ key.id }}"/><buttontype="submit">Delete</button></form></p>{% endfor %}You can similarly change the key name by POSTing towebauthin:rename-keywith a
parameter calledname.Do note that you need to have the Django messages framework installed so the library
can show the user error/success messages.SettingsHere are the settings you can change in yoursettings.py:WEBAUTHIN_LOGIN_REDIRECT_URL(default: LOGIN_REDIRECT_URL): Where to redirect after
a successful login.WEBAUTHIN_LOGIN_ERROR_URL(default: LOGIN_URL): Where to redirect after a login
error.WEBAUTHIN_REGISTRATION_REDIRECT_URL(default: LOGIN_REDIRECT_URL): Where to
redirect after a successful key registration.WEBAUTHIN_REGISTRATION_ERROR_URL(default: LOGIN_REDIRECT_URL): Where to redirect
after a key registration error.DemoYou can see a demo of the flow by visitingPastery. Create
an account by logging in with your email address, go to your account to register your
key, then log out and log back in with your key.