Gestione dei secrets

Archiviazione sicura delle credenziali

Quando la tua applicazione deve connettersi a servizi esterni, come l'invio di e-mail tramite SendGrid, l'elaborazione di pagamenti con Stripe o l'utilizzo di OpenAI per funzionalità AI, devi archiviare in modo sicuro le chiavi e le credenziali API. Il sistema di gestione dei secrets di Kliv lo gestisce automaticamente.

Cosa rende sicuri i secrets:

  • Archiviazione crittografata nel database
  • Mai visualizzati per intero dopo averli salvati
  • Iniettati automaticamente nelle edge function quando necessario
  • A livello di account, quindi memorizzi ciascuna chiave una sola volta
  • Audit trail che tracciano quando i secrets sono stati creati o aggiornati

Come funzionano i secrets

Quando dici all'AI che desideri integrarti con un servizio esterno, ti chiederà le credenziali necessarie. Una volta fornita una chiave API, l'AI la memorizza in modo sicuro con un nome descrittivo (come OPENAI_API_KEY o STRIPE_SECRET_KEY). Da quel momento in poi, qualsiasi edge function che necessiti di tali credenziali potrà accedervi automaticamente.

Visualizzazione mascherata: dopo aver salvato un segreto, vedrai solo una versione parzialmente mascherata nell'interfaccia utente di amministrazione. Ad esempio, sk-proj-abc123xyz789 appare come sk-p****9789. Ciò ti consente di verificare quale chiave è quale senza esporre il valore completo.

Iniezione automatica: quando viene eseguita una edge function, i secrets a cui fa riferimento vengono iniettati in modo sicuro per quell'esecuzione. L'intelligenza artificiale scrive la funzione in modo che li legga tramite l'interfaccia dei secrets della piattaforma, e la piattaforma fornisce il valore effettivo in fase di esecuzione, così una chiave ruotata ha effetto alla successiva esecuzione della funzione.

Gestire i secrets

Attraverso l'interfaccia di amministrazione è possibile:

  • Visualizzare tutti i tuoi secrets (con valori mascherati)
  • Aggiungere nuovi secrets o aggiornare quelli esistenti
  • Eliminare i secrets che non ti servono più
  • Vedere quando ogni secret è stato creato o aggiornato l'ultima volta

L'intelligenza artificiale può anche creare e aggiornare i secrets per te quando descrivi le integrazioni che desideri creare.

Usi comuni dei secrets

  • Servizi di posta elettronica: credenziali SendGrid, Mailgun o SMTP
  • Elaborazione del pagamento: Stripe, PayPal o altre chiavi API di pagamento
  • Servizi AI: chiavi API OpenAI, Anthropic o Google
  • SMS/chiamate: token di autenticazione Twilio
  • API esterne: qualsiasi servizio di terze parti con cui si integra la tua app
  • Webhook: secrets di firma per la verifica dei webhook in entrata
  • Connessioni al database: stringhe di connessione per database esterni

Buone pratiche

✅ Utilizza nomi descrittivi: nomina i secrets chiaramente come SENDGRID_API_KEY anziché key1 o secret.

✅ Ruota regolarmente - Aggiorna periodicamente i secrets, soprattutto per i servizi critici.

✅ Elimina al termine - Rimuovi i secrets per i servizi che non utilizzi più.

❌ Non condividere i secrets - Ogni ambiente (test, produzione) deve utilizzare chiavi API diverse.

❌ Non inserirli nel codice: i secrets vengono archiviati separatamente dal tuo codice per un motivo. Non inserire mai le chiavi API direttamente nei file sorgente.


Documentazione correlata: