Secrets
Les identifiants avec lesquels vos opérations appellent l'extérieur sont conservés dans un coffre du projet. Une valeur est stockée chiffrée (le détail est sur la page sécurité), adressée par référence et tenue hors de vos fichiers de config.
Libellés et références
Un secret a un libellé que vous choisissez et un propriétaire : le projet, une app ou l'un de vos utilisateurs. Sa création renvoie une référence opaque, et c'est par cette référence qu'il est adressé ensuite. Vous pouvez en stocker un dans la console sous Settings, avec la CLI, ou en commitant un fichier foir.secrets.ts qui déclare des libellés et ne contient aucun texte en clair, et que foir secrets push réconcilie avec le projet.
Comment une valeur est lue
Pour un endpoint que vous hébergez, le jeton d'envoi qui arrive avec l'appel accorde déjà la lecture. Le gestionnaire appelle getSecret avec la référence et une finalité, et ne détient aucun identifiant propre. La finalité est obligatoire et elle est consignée.
Pour un appel que Fóir effectue lui-même, le modèle de requête désigne un secret par un nom d'emplacement, et une liaison sur l'opération associe ce nom à la référence. La valeur est résolue au moment de l'appel et n'est jamais stockée sur l'opération.
Qui peut détenir l'accès
Les portées pour les secrets peuvent être détenues par des clés API secrètes et jamais par des clés publiques. Une opération qu'un de vos utilisateurs déclenche peut stocker un secret dont cet utilisateur est propriétaire, et seules les opérations de cet utilisateur le relisent.
Renouvellement et suppression
Renouveler remplace la valeur derrière une référence existante. Les lecteurs obtiennent la nouvelle valeur à leur prochaine lecture, et rien n'a besoin d'être redéployé. La suppression est douce : le secret cesse de se résoudre immédiatement et peut être restauré pendant 30 jours.
Lire le détail
Le guide des secrets couvre le stockage, la lecture et le renouvellement d'un secret, les secrets appartenant à un utilisateur et ce qui est audité.