Konfiguration
Die wichtigsten Umgebungsvariablen und Secrets.
Die Konfiguration liegt in .env oder als Umgebungsvariable. Secrets gehören nie ins Repository. In Produktion müssen APP_BASE_URL und OAUTH_ISSUER explizit gesetzt sein.
Die wichtigsten Variablen
| Variable | Bedeutung |
|---|---|
DATABASE_URL | SQLite (Dev) oder PostgreSQL (Prod) |
APP_BASE_URL | Kanonische öffentliche URL |
OAUTH_ISSUER | Issuer für OAuth-Metadaten |
ENCRYPTION_KEY | Fernet-Key für Credentials at rest |
ANTHROPIC_API_KEY | AI-Gruppierung (optional) |
VC_SELLERS_ID | Eigene VeloConnect-Seller-ID |
VC_SELLER_NAME | Anzeigename im Profil |
MCP_ALLOWED_HOSTS | Host-Allowlist für MCP |
DISPATCH_AUDIT_HMAC_KEY | Stabiler Key für Dispatch-Audit |
Secrets
ENCRYPTION_KEY verschlüsselt reversible Credential-Spalten. Bei Verlust sind gespeicherte Secrets unwiederbringlich. Der HMAC-Key für Dispatch-Audits muss stabil bleiben, sonst lassen sich alte Signaturen nicht mehr verifizieren.
Datenbank
Schema-Migrationen laufen über Alembic (alembic upgrade head). SQLite ist für Entwicklung gedacht, PostgreSQL 15 für Produktion. Vor jedem Upgrade ein Backup erstellen.
Auth
OIDC läuft pro Tenant über den Tenant-IdP (Keycloak, PKCE, Back-Channel-Logout). MCP nutzt einen eigenen OAuth-2.1-Authorization-Server mit Discovery, Dynamic Client Registration, PKCE, Refresh-Rotation und Revocation.