django-auth-openwebauth 0.0.1

OpenWebAuth authentication

Django authentication using OpenWebAuth

This is a django authentication backend based on OpenWebAuth (https://codeberg.org/fediverse/fep/src/branch/main/fep/61cf/fep-61cf.md). It enables decentralised single sign-on by authenticating a remote user against a remote server.

Repository: https://codeberg.org/abanink/django_auth_openwebauth

OpenWebAuth requires that you can add the /owa endpoint on the webservice root

Installation

$ pip install django-auth-openwebauth

Configuration

In settings.py

• add this app to INSTALLED_APPS

  INSTALLED_APPS = [
      ...
      "django_auth_openwebauth",
      ...
  ]
  

• add Middlewares

  MIDDLEWARE = [
      ...
      "django_auth_openwebauth.middleware.AttemptOpenWebAuthentication",
      "django_auth_openwebauth.middleware.ValidateOpenWebAuthentication",
      ...
      "django.contrib.auth.middleware.PersistentRemoteUserMiddleware",
      ...
  ]   
  

• add Authentication Backend

  AUTHENTICATION_BACKENDS: tuple[str, ...] = (
      ...
      "django.contrib.auth.backends.RemoteUserBackend",
      ...
  )
  
  

In urls.py

• add this package's urls

  if "django_auth_openwebauth" in settings.INSTALLED_APPS:
      urlpatterns.append(
          path("", include("django_auth_openwebauth.urls")),
      )
  

Usage

• The remote server must support OpenWebAuth
• Login on the remote server as [e-mail]
• Login on your django app: https://mydjango.app/?zid=[e-mail]
• You should be logged in as [e-mail] and your remote avatar should be shown