Impostazioni

La sezione Settings ti permette di configurare le integrazioni esterne, le API key e le preferenze generali della piattaforma.

Informazioni Server

Stato Sistema

In alto vedi lo stato del server:

• Versione Polipo
• Node.js versione
• Database stato connessione
• Uptime server

Integrazioni

Google PageSpeed API

Per usare l’analisi Lighthouse con limiti più alti:

1. Vai su Google Cloud Console
2. Crea un progetto o seleziona esistente
3. Abilita “PageSpeed Insights API”
4. Crea credenziali → API Key
5. Incolla la key in Polipo
6. Clicca Salva

Vantaggi:

• Rate limit più alto
• Dati più precisi
• Storico completo

Cloudflare

Integra Cloudflare per:

• Gestire DNS
• Configurare SSL
• Gestire WAF
• Cache e CDN

Configurazione:

1. Accedi alla dashboard Cloudflare
2. Vai su My Profile → API Tokens
3. Crea un token con permessi:
   • Zone.Zone (Read)
   • Zone.DNS (Edit)
   • Zone.Firewall Rules (Edit)
4. Copia il token in Polipo
5. Inserisci anche l’Account ID (dalla sidebar CF)
6. Clicca Test Connessione
7. Se OK, clicca Salva

Dopo la configurazione:

• Vedrai le zone disponibili
• Potrai gestire DNS da Polipo
• Security Hub avrà accesso WAF

N8N Integration

Connetti n8n per automazioni avanzate:

Configurazione:

1. Abilita l’integrazione
2. Copia la API Key generata
3. In n8n, crea un nodo Webhook
4. Usa l’URL webhook di Polipo

Usi:

• Trigger n8n da eventi Polipo
• Chiamare Polipo da workflow n8n
• Automazioni cross-platform

AI Agents (MCP)

Configura agenti AI per assistenza:

Agenti Disponibili:

• Claude (Anthropic)
• GPT (OpenAI)
• Gemini (Google)

Configurazione:

1. Seleziona l’agente
2. Inserisci la API Key del provider
3. Configura le opzioni (modello, temperatura, ecc.)
4. Salva

Usi:

• SQL Agent per query in linguaggio naturale
• Assistenza troubleshooting
• Generazione codice

Impostazioni Terminale

Aspetto

Personalizza il terminale integrato:

Comportamento

Webhook

URL Webhook

Polipo espone webhook per ricevere eventi esterni:

POST https://your-polipo-instance/api/webhook/{event-type}

Eventi Supportati

Autenticazione

Includi l’header:

Authorization: Bearer YOUR_API_KEY

Database

Info Database

Visualizza:

• Tipo: SQLite/PostgreSQL
• Percorso/Connessione
• Dimensione

Manutenzione

API Keys

Gestione Chiavi

Per ogni integrazione puoi:

• Visualizzare la chiave (con toggle show/hide)
• Rigenerare una nuova chiave
• Revocare una chiave

Sicurezza

• Le chiavi sono criptate nel database
• Mai condividere le chiavi
• Ruota periodicamente le chiavi sensibili

Notifiche Globali

Destinatari Default

Aggiungi destinatari che ricevono tutti gli alert:

1. Clicca + Aggiungi Destinatario
2. Inserisci email o telefono
3. Seleziona i canali (Email, SMS, WhatsApp)

Preferenze

Backup Impostazioni

Esportare

1. Clicca Esporta Impostazioni
2. Scarica il file JSON
3. Contiene tutte le configurazioni (no chiavi sensibili)

Importare

1. Clicca Importa Impostazioni
2. Seleziona il file JSON
3. Le impostazioni vengono applicate

Reset

Reset Singola Sezione

Per ogni sezione puoi cliccare Reset per tornare ai default.

Reset Completo

⚠️ Attenzione: Ripristina tutte le impostazioni ai valori default!

1. Scorri in fondo alla pagina
2. Clicca Reset Tutte le Impostazioni
3. Conferma due volte

Best Practices

1. Configura Cloudflare - Per funzionalità DNS e Security
2. API key Google - Per Lighthouse senza limiti
3. Backup regolare - Esporta le impostazioni
4. Rotazione chiavi - Ogni 3-6 mesi
5. Test dopo modifiche - Verifica che tutto funzioni
6. Documenta - Annota le configurazioni custom