MFA as a Service (FastAPI)

This project provides a simple stateless MFA (TOTP) code generator over an HTTP API using FastAPI.

Features

• Stateless: no secrets are stored
• Simple API interface
• Useful for testing MFA integrations

Usage

Start the service using Docker:

docker build -t mfa-service .
docker run -p 8000:8000 mfa-service

API

GET /mfa

Query Parameters:

• secret (required): Base32-encoded TOTP secret

Response:

{
  "code": "123456",
  "time_remaining": 23,
  "interval": 30
}

Example

curl "http://localhost:8000/mfa?secret=JBSWY3DPEHPK3PXP"

Requirements

• Docker or Python 3.11+