armasec-lite

Injectable FastAPI auth via OIDC, with three dependencies instead of ten.

Build Status GitHub Issues Pull Requests GitHub Contributors

armasec-lite validates bearer tokens against your identity provider's JWKS, checks scopes and issuer/audience claims, and guards a route with a single Depends(). It is a dependency-minimal reimplementation of armasec 3.x with the same public API, built almost entirely on the standard library. Runtime dependencies are fastapi, cryptography and pydantic.

Install

uv add armasec-lite

The pytest fixtures, including the mock OIDC provider, live behind an extra:

uv add "armasec-lite[test]"

Usage

"""Secure a single route against one OIDC domain."""

import os

from armasec_lite import Armasec
from fastapi import Depends, FastAPI

app = FastAPI()
armasec = Armasec(
    domain=os.environ.get("ARMASEC_DOMAIN"),
    audience=os.environ.get("ARMASEC_AUDIENCE"),
)


@app.get("/stuff", dependencies=[Depends(armasec.lockdown("read:stuff"))])
async def check_access():
    return {"message": "Successfully authenticated!"}

Runnable variants, including multiple domains, match_keys, permission extractors and the plugin system, are in examples/.

Documentation

docs.vantagecompute.ai/developer/armasec-lite

Installation
Quickstart
Migrating from armasec covers every behavior difference from upstream 3.x, and what each one requires of you.
Security covers the JWT verification order, the threat model, and what the attack suite defends.
Architecture covers the request lifecycle, the caching model and the threading model.
API Reference

License

MIT. See LICENSE.

Development Status
- 3 - Alpha
Framework
- FastAPI
Intended Audience
- Developers
License
- OSI Approved :: MIT License
Programming Language
- Python :: 3.12
- Python :: 3.13
Topic
- Internet :: WWW/HTTP
- Security

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

armasec_lite-0.1.4.tar.gz (996.2 kB view details)

Uploaded Sep 6, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

armasec_lite-0.1.4-py3-none-any.whl (76.6 kB view details)

Uploaded Sep 6, 2026 Python 3

File details

Details for the file armasec_lite-0.1.4.tar.gz.

File metadata

Download URL: armasec_lite-0.1.4.tar.gz
Upload date: Sep 6, 2026
Size: 996.2 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for armasec_lite-0.1.4.tar.gz
Algorithm	Hash digest
SHA256	`b577e3869f3d5c410e9945a36df5a9ae4fe206f098e384aaa88362ecb8c9ecbf`
MD5	`e25bb657c9e2c4172ceeed39d514ad84`
BLAKE2b-256	`1e92d6996bc76d28a38ceb5bb2dc2c18f57a8c4064574b1d07c3d532146c4f94`

See more details on using hashes here.

Provenance

The following attestation bundles were made for armasec_lite-0.1.4.tar.gz:

Publisher: release.yml on vantagecompute/armasec-lite

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: armasec_lite-0.1.4.tar.gz
- Subject digest: b577e3869f3d5c410e9945a36df5a9ae4fe206f098e384aaa88362ecb8c9ecbf
- Sigstore transparency entry: 2742374184
- Sigstore integration time: Sep 6, 2026
Source repository:
- Permalink: vantagecompute/armasec-lite@279b25ed975acd59c55208941030e328fd49398b
- Branch / Tag: refs/tags/v0.1.4
- Owner: https://github.com/vantagecompute
- Access: private
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@279b25ed975acd59c55208941030e328fd49398b
- Trigger Event: push