Configurazione
Le variabili d'ambiente e i secret più importanti.
La configurazione risiede in .env o come variabile d'ambiente. I secret non vanno mai nel repository. In produzione APP_BASE_URL e OAUTH_ISSUER devono essere impostati esplicitamente.
Variabili principali
| Variabile | Significato |
|---|---|
DATABASE_URL | SQLite (dev) o PostgreSQL (prod) |
APP_BASE_URL | URL pubblica canonica |
OAUTH_ISSUER | Issuer per metadati OAuth |
ENCRYPTION_KEY | Chiave Fernet per credenziali at rest |
ANTHROPIC_API_KEY | Raggruppamento AI (opzionale) |
VC_SELLERS_ID | Proprio seller ID VeloConnect |
VC_SELLER_NAME | Nome visualizzato nel profilo |
MCP_ALLOWED_HOSTS | Allowlist host per MCP |
DISPATCH_AUDIT_HMAC_KEY | Chiave stabile per audit dispatch |
Secret
ENCRYPTION_KEY cifra le colonne credenziali reversibili. Se persa, i secret memorizzati sono irrecuperabili. La chiave HMAC per gli audit dispatch deve restare stabile, altrimenti le vecchie firme non sono più verificabili.
Database
Le migrazioni schema usano Alembic (alembic upgrade head). SQLite è per lo sviluppo, PostgreSQL 15 per la produzione. Crea un backup prima di ogni aggiornamento.
Auth
OIDC è per tenant tramite l'IdP del tenant (Keycloak, PKCE, back-channel logout). MCP usa un proprio authorization server OAuth 2.1 con discovery, dynamic client registration, PKCE, refresh rotation e revocation.