🛡️ Database Sentinel

Audit di sicurezza per il tuo backend database. Chiedi "esegui l'audit del mio database" e ottieni un report con punteggio e il codice di correzione esatto.

Funziona come Claude Skill (Supabase, MongoDB), come server MCP in sola lettura per qualsiasi client AI, oppure come agente CLI che usa il tuo modello (entrambi Supabase).

→ Guida alla configurazione e all'uso del server MCP

→ Non vuoi eseguirlo da solo? Locksoup è la versione hosted: un audit di sicurezza Supabase con ricontrolli pianificati e avvisi.

Changelog

2026-10-01 (v1.0.1)

• Corretto: una policy UPDATE senza WITH CHECK non viene più segnalata come se consentisse agli utenti di riassegnare la proprietà delle righe (Postgres riutilizza USING come controllo). L'etichetta di Q8 e il prompt dell'agente dicevano il contrario, il che produceva falsi rilevamenti di mass-assignment su progetti reali.
• Benchmark: nuovo caso di sviluppo 027 da quel progetto. Test F1 invariato (0.836 vs 0.838, stesso giorno). Esecuzioni.

2026-09-30 (docs)

• Flusso MCP sottoposto a benchmark: un modello che pilota il server reale via stdio ha ottenuto test F1 0.865, precisione 0.905, recall critico 1.0 (risultati). Harness: evals/mcp_client.py, sistema di eval m.

v1.0.0 (2026-09-30): rilascio del server MCP

• Server MCP v1.0: quattro strumenti Supabase in sola lettura, un prompt audit e le risorse del catalogo. Sottoposto a benchmark end to end: un modello che pilota il server via stdio ha ottenuto test F1 0.865, con recall critico 1.0.
• Verificato su Supabase hosted: session pooler, ruolo in sola lettura con BYPASSRLS, tutte le 20 query.
• Meno falsi allarmi:
  • Q1 ora controlla i grant API: RLS disattivato con anon/authenticated revocati non viene segnalato come esposto.
  • Il prompt di audit sa che le funzioni SECURITY INVOKER hanno solo i diritti del chiamante.
  • Trovato su un progetto reale; nuovo caso di sviluppo 026.
• Fissa una versione: git+https://github.com/Farenhytee/[email protected] in qualsiasi comando uvx/pipx. Il plugin di Claude Code è fissato automaticamente.
• L'audit standard è ora il default della CLI: un prompt più verifica con anon-probe, ~$0.0007 e ~15s per audit. --deep esegue l'agente che usa gli strumenti, che ha ottenuto lo stesso punteggio sul nostro bench a ~5× il costo.

v0.2.1 (2026-09-30)

• Test F1: agente 0.782 → 0.831, single-prompt 0.766 → 0.849. Nessun crash o timeout (risultati).
• Corretto:
  • Un argomento errato di uno strumento non termina più l'audit; l'errore torna al modello.
  • Le chiamate OpenRouter vengono indirizzate al provider più veloce (quelli lenti causavano timeout).
  • Il passo finale dei risultati dell'agente non elenca più i candidati che aveva scartato.

v0.2.0 (2026-09-29)

• Risultati dei test pubblicati: agente F1 0.782, single-prompt 0.766, regole 0.559 su uno split di test cieco e bloccato di 10 casi, 3 esecuzioni ciascuno (risultati).
• Bench: 25 casi etichettati (15 dev, 10 test ciechi).
• Agente:
  • Passo di verifica: esegue probe come anon per confermare i rilevamenti sfruttabili.
  • --fix: stampa l'SQL di correzione per i rilevamenti che scegli. Non viene mai eseguito.
  • Report dei costi: token, $ e chiamate agli strumenti per ogni audit.
• CI: gate di regressione gratuito basato solo sulle regole.

2026-09-29

• Installazione con un comando: plugin di Claude Code (skill + server MCP, chiede la tua connection string) e un pulsante Add to Cursor.
• Installa da GitHub: un comando per il server MCP (uvx --from git+… sentinel-mcp) e per l'agente (pipx install "database-sentinel[agent] @ git+…").
• sentinel-mcp --role-sql stampa l'SQL di configurazione del ruolo in sola lettura.
• Errori più chiari: il client MCP ora vede perché una chiamata è fallita, e la CLI stampa un errore su una sola riga.

2026-09-28

• Novità: server MCP per Supabase. Quattro strumenti in sola lettura, un prompt audit e il catalogo dei pattern come risorse. L'analisi la fa il tuo LLM, quindi è gratis.
• Novità: agente lite (sentinel-audit). Una pipeline LangGraph che funziona con qualsiasi modello compatibile con OpenAI: OpenRouter, OpenAI o Ollama locale.
• Novità: benchmark + eval. 10 casi Supabase etichettati, con precisione/recall/F1 confrontati tra una baseline a regole, una baseline single-prompt e l'agente.
• Corretto: sei query di audit Supabase. Q8 (UPDATE senza WITH CHECK) non corrispondeva mai a nulla, Q16 e Q19 perdevano righe per i ruoli a privilegio minimo, e Q6, Q13 e Q14 avevano condizioni errate.

Avvio rapido

Claude Code installa la skill di audit e il server MCP in un colpo solo (richiede uv):

claude plugin marketplace add Farenhytee/database-sentinel
claude plugin install database-sentinel@database-sentinel

Utenti Supabase: create il login in sola lettura (passo 1), poi eseguite /plugin configure database-sentinel@database-sentinel in Claude Code. Poi chiedete: Audit my database.

Cursor  

Altri client MCP, e configurazione completa: guida MCP

git clone https://github.com/Farenhytee/database-sentinel.git ~/.claude/skills/database-sentinel

pipx install "database-sentinel[agent] @ git+https://github.com/Farenhytee/database-sentinel"
export SENTINEL_BASE_URL=http://localhost:11434/v1 SENTINEL_MODEL=<model>   # Ollama, o qualsiasi API compatibile con OpenAI + SENTINEL_API_KEY
sentinel-audit --dsn "postgresql://sentinel_auditor:<password>@<host>:5432/postgres" \
  --rest-url https://<ref>.supabase.co --anon-key <anon key> --repo ./my-app

Cosa rileva