django-admin-keycloak

Keycloak

Create Client OpenID with callback url https://keycloak.example.ru/sso/* add client scopes "roles" and set client Backchannel logout URL https://keycloak.example.ru/sso/logout

Settings

# define static config or add provider later in admin management
KEYCLOAK_PROVIDERS = [
    {
        'slug': 'local', # internal django slug
        'name': 'Local', # name on login form
        'client_id': 'local_django',
        'client_secret': 'SECRET',
        'redirect_uri': '/admin', # redirect uri after login
        'server_url': 'https://keycloak.example.ru',
        'realm_name': 'django',
        'role_staff_user': 'dev_staff', # role for staff users
        'role_super_user': 'dev_super_user', # role for superusers
    }
]

Add to INSTALLED_APPS

INSTALLED_APPS = [
    'django_admin_keycloak',
    'django.contrib.admin',
    # ...
]

Add to urls.py

urlpatterns = [
    # ...,
    path('sso/', include('django_admin_keycloak.url')),
    # ...
]

If you define static config, you must execute command for update providers.

python manage.py update_static_providers

Available signals

user_sso_login

On login SSO user

session: KeycloakSession
request: HttpRequest
userinfo: dict
access_token: str

user_sso_logout

On logout SSO user

session: KeycloakSession
request: HttpRequest

Release files for django-admin-keycloak 1.0.3

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-admin-keycloak 1.0.3
File	Size	Uploaded
django_admin_keycloak-1.0.3.tar.gz	66.4 kB	Jul 4, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for django-admin-keycloak 1.0.3
File	Interpreter	ABI	Platform	Reset
django_admin_keycloak-1.0.3-py3-none-any.whl 32.6 kB Jul 4, 2026	Python 3	none	any	Details

Total release size: 99.0 kB

Release files / django_admin_keycloak-1.0.3.tar.gz

Download URL	django_admin_keycloak-1.0.3.tar.gz
Size	66.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`4dba4dc903c26408437cc74e43757cdbbc75f8e9353e9339668839984a19da95`
BLAKE2b-256 checksum How to use checksums	`52bdbe8c77b139c08d40bed72b3aaa7336ae1d4c4a4e7007f0759db9f47adf37`
Upload date	Jul 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / django_admin_keycloak-1.0.3-py3-none-any.whl

Download URL	django_admin_keycloak-1.0.3-py3-none-any.whl
Size	32.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`12e8f963e7da3dd04716b96eb5b7c556e648d1db872a81cf6fe1aee638c751c2`
BLAKE2b-256 checksum How to use checksums	`3b94d2ebe35dc6d0a7ae4472a4cec19d9c03d11602fce7e92937f11bce104501`
Upload date	Jul 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`