Key Management System (KMS)

Il KMS di Donutwork è la cassaforte crittografica del tuo SaaS. Fornisce un sistema centralizzato per l'archiviazione di credenziali sensibili, segreti applicativi e chiavi master che non dovrebbero mai essere scritte nel codice o salvate in testo semplice.

Struttura delle Chiavi

Ogni voce del KMS è progettata per l'accesso programmatico e un'alta sicurezza:

• Handler: Un alias univoco utilizzato dalle tue API o script per recuperare la chiave senza esporne il contenuto reale.
• Content: Il valore segreto effettivo (es. Stripe Secret Key, AWS Access Key o un certificato privato).
• Whitelist (Isolamento di Rete): Limita il reveal del segreto a indirizzi IPv4 o IPv6 esatti. I range CIDR non sono supportati. Una whitelist vuota non impone restrizioni IP; una lista non vuota blocca il reveal da altri indirizzi.

Gestire le chiavi tramite API pubblica

Usa POST /2026-02-01/kms.json per creare una chiave e PUT /2026-02-01/kms/{handler}.json per modificare i metadati o ruotare il contenuto. Entrambi richiedono una API key server-side con kms:write e un body JSON racchiuso in KMSEntry. I campi omessi nella modifica restano invariati. La company deriva dalla API key e le risposte di scrittura contengono soltanto metadati. Le chiavi non rivelabili non sono modificabili tramite questi endpoint.

Consulta la guida API KMS per esempi, validazione, permessi ed errori.

Audit di Sicurezza

La tracciabilità è integrata nel cuore del KMS. Ogni volta che una chiave viene letta o modificata, viene generato un Audit Log.

Dettagli dell'Audit Log:

• Identità del Richiedente: Chi ha effettuato l'accesso alla chiave.
• Timestamp: Esattamente quando è avvenuto l'accesso.
• IP di Origine: L'origine di rete della richiesta.
• Esito: Se la richiesta è andata a buon fine o è stata bloccata dalla policy di whitelist.