sysnet-audit 0.2.1

Sdilena knihovna pro auditni logovani v SYSNET mikrosluzbach

sysnet-audit

Sdílená Python knihovna pro auditní logování napříč FastAPI mikroslužbami SYSNET s.r.o.

pip install sysnet-audit

---

Distribuční název: sysnet-audit
Import path: audit_lib
Repozitář: github.com/SYSNET-CZ/audit

---

Quick start

from contextlib import asynccontextmanager
from fastapi import FastAPI, Depends
from audit_lib import (
    init_audit, get_audit_backend, get_audit_logger,
    AuditLogger, AuditActor, AuditResource, AuditSettings,
)

@asynccontextmanager
async def lifespan(app: FastAPI):
    client = await init_audit(AuditSettings())
    yield
    await get_audit_backend().aclose()
    if client is not None:
        await client.aclose()

app = FastAPI(lifespan=lifespan)

@app.delete("/users/{user_id}")
async def delete_user(
    user_id: str,
    audit: AuditLogger = Depends(get_audit_logger),
):
    await audit.log(
        actor=AuditActor(sub="user-uuid"),
        action="user.delete",
        resource=AuditResource(type="user", id=user_id),
    )

---

Proměnné prostředí

Prefix: AUDIT_

Proměnná	Výchozí	Popis
AUDIT_SERVICE_NAME	— (povinné)	Identifikace mikroslužby
AUDIT_MONGO_URI	mongodb://localhost:27017	Connection string MongoDB
AUDIT_MONGO_DB	audit	Název databáze
AUDIT_ENABLED	true	Globální vypínač auditování
AUDIT_KAFKA_BOOTSTRAP_SERVERS	None	Adresy Kafka brokerů (pro Topologii B)

---

Vývoj a testování

git clone [e-mail]:SYSNET-CZ/audit.git
cd audit
uv venv .venv --python 3.12
source .venv/bin/activate
uv pip install -e ".[dev,kafka]"
pytest

Licence

AGPLv3+ — SYSNET s.r.o.