.. ACMAD Device Flow Authentication documentation master file, created by
   sphinx-quickstart on Wed Jan 21 14:27:48 2026.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

ACMAD Authentication
====================

ACMAD Authentication provides a small helper layer for Keycloak OIDC device
authorisation flows. It manages device flow prompts, caches tokens, and exposes
an httpx authentication class that injects bearer tokens and refreshes them as
needed.


.. toctree::
   :maxdepth: 3
   :caption: Contents:

   installation
   usage
   configuration
   security

API Documentation
-----------------

.. toctree::
   :maxdepth: 2
   :caption: API Modules:

   modules/acmadauth.auth
   modules/acmadauth.handlers
   modules/acmadauth.tokencaches
   modules/acmadauth.tokenset
   modules/acmadauth.errors
   modules/acmadauth.schemas