Imia

Imia (belarussian for "a name") is an authentication library for Starlette and FastAPI (python 3.8+).

Installation

Install imia using PIP or poetry:

pip install imia
# or
poetry add imia

Features

• Login/logout flows
• Pluggable authenticators:
  • WWW-Basic
  • session
  • token
  • bearer token
  • any token (customizable)
  • API key
• Database agnostic user storage
• Authentication middleware
  • with fallback strategies:
    • redirect to an URL
    • raise an exception
    • do nothing
  • with optional URL protection
  • with option URL exclusion from protection
• User Impersonation (stateless and stateful)
• [WIP] Remember me
• [WIP] Two-Factor flow

Quick start

If you are too lazy to read this doc, take a look into examples/ directory. There you will find several files demoing various parts of this library.

Docs

1. Configuration
2. Login/Logout flow
3. User token
4. Request authentication
5. Authenticators
6. User impersontation

Usage

See examples/ directory.