Metadata-Version: 2.4
Name: authfort-service
Version: 0.0.18
Summary: Lightweight JWT verification for AuthFort-powered microservices
Project-URL: Homepage, https://github.com/bhagyajitjagdev/authfort
Project-URL: Repository, https://github.com/bhagyajitjagdev/authfort
Author: Bhagyajit Jagdev
License: MIT
Requires-Python: >=3.11
Requires-Dist: cryptography>=46.0.5
Requires-Dist: httpx>=0.28.1
Requires-Dist: pyjwt[crypto]>=2.11.0
Provides-Extra: fastapi
Requires-Dist: fastapi>=0.104; extra == 'fastapi'
Description-Content-Type: text/markdown

  AuthFort

# authfort-service

[![PyPI](https://img.shields.io/pypi/v/authfort-service)](https://pypi.org/project/authfort-service/)
[![Coverage](https://codecov.io/gh/bhagyajitjagdev/authfort/branch/main/graph/badge.svg?flag=service)](https://codecov.io/gh/bhagyajitjagdev/authfort)
[![Python](https://img.shields.io/badge/Python-3.11+-3776AB?logo=python&logoColor=white)](https://www.python.org/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Docs](https://img.shields.io/badge/Docs-blue?logo=readthedocs&logoColor=white)](https://bhagyajitjagdev.github.io/authfort/service/)

Lightweight JWT verification for microservices powered by AuthFort.

## Install

```bash
pip install authfort-service[fastapi]
```

## Quick Start

```python
from authfort_service import ServiceAuth
from fastapi import FastAPI, Depends

service = ServiceAuth(
    jwks_url="https://auth.example.com/.well-known/jwks.json",
    issuer="authfort",
)

app = FastAPI()

@app.get("/api/data")
async def protected(user=Depends(service.current_user)):
    return {"user_id": user.sub, "roles": user.roles}

@app.get("/api/admin")
async def admin_only(user=Depends(service.require_role("admin"))):
    return {"message": "admin access"}
```

## Features

- JWKS fetching with automatic caching and refresh
- JWT signature verification (RS256)
- Token introspection client (optional real-time validation)
- FastAPI integration (current_user, require_role dependencies)
- No database required

## With Introspection

```python
service = ServiceAuth(
    jwks_url="https://auth.example.com/.well-known/jwks.json",
    issuer="authfort",
    introspect_url="https://auth.example.com/auth/introspect",
    introspect_secret="shared-secret",
)

# Real-time validation (checks ban status, token version, fresh roles)
result = await service.introspect(token)
```

## License

[MIT](../LICENSE)
