Secret
Le credenziali con cui le tue operazioni chiamano l'esterno sono conservate in un vault nel progetto. Un valore viene memorizzato cifrato (i dettagli sono nella pagina sulla sicurezza), indirizzato per riferimento e tenuto fuori dai tuoi file di configurazione.
Etichette e riferimenti
Un secret ha un'etichetta che scegli tu e un proprietario: il progetto, un'app o uno dei tuoi utenti. Crearlo restituisce un riferimento opaco, ed è con quel riferimento che viene indirizzato da lì in poi. Puoi memorizzarne uno nella console in Settings, con la CLI, o facendo il commit di un file foir.secrets.ts che dichiara le etichette e non contiene testo in chiaro, che foir secrets push riconcilia con il progetto.
Come si legge un valore
Per un endpoint che ospiti tu, il token di dispatch che arriva con la chiamata concede già la lettura. Il gestore chiama getSecret con il riferimento e uno scopo, e non ha credenziali proprie. Lo scopo è obbligatorio e viene registrato.
Per una chiamata che Fóir effettua da sé, il template della richiesta si riferisce a un secret con un nome segnaposto, e un binding sull'operazione associa quel nome al riferimento. Il valore viene risolto al momento della chiamata e non è mai memorizzato sull'operazione.
Chi può avere accesso
Gli scope per i secret possono essere posseduti da chiavi API segrete e mai da chiavi pubbliche. Un'operazione che uno dei tuoi utenti avvia può memorizzare un secret di cui quell'utente è proprietario, e solo le operazioni di quell'utente lo rileggono.
Rotazione ed eliminazione
La rotazione sostituisce il valore dietro un riferimento esistente. I lettori ricevono il nuovo valore alla lettura successiva, e non serve ridistribuire nulla. L'eliminazione è soft: il secret smette subito di essere risolto e può essere ripristinato per 30 giorni.
Approfondisci
La guida ai secret tratta la memorizzazione, la lettura e la rotazione di un secret, i secret di proprietà di un utente e che cosa viene sottoposto ad audit.