Secrets
Die Zugangsdaten, mit denen Ihre Operationen nach außen aufrufen, liegen in einem Vault im Projekt. Ein Wert wird verschlüsselt gespeichert (die Einzelheiten stehen auf der Sicherheitsseite), über eine Referenz adressiert und aus Ihren Config-Dateien herausgehalten.
Labels und Referenzen
Ein Secret hat ein Label, das Sie wählen, und einen Eigentümer: das Projekt, eine App oder einen Ihrer Nutzer. Beim Anlegen wird eine opake Referenz zurückgegeben, und über diese Referenz wird es fortan adressiert. Sie können eines in der Konsole unter Einstellungen speichern, mit der CLI oder indem Sie eine Datei foir.secrets.ts einchecken, die Labels deklariert und keinen Klartext enthält und die foir secrets push mit dem Projekt abgleicht.
Wie ein Wert gelesen wird
Bei einem Endpunkt, den Sie hosten, gewährt das mit dem Aufruf eintreffende Dispatch-Token das Lesen bereits. Der Handler ruft getSecret mit der Referenz und einem Zweck auf und hält keine eigenen Zugangsdaten. Der Zweck ist erforderlich und wird protokolliert.
Bei einem Aufruf, den Fóir selbst ausführt, verweist das Anfrage-Template über einen Platzhalternamen auf ein Secret, und ein Binding an der Operation ordnet diesen Namen der Referenz zu. Der Wert wird zum Aufrufzeitpunkt aufgelöst und nie an der Operation gespeichert.
Wer Zugriff halten kann
Scopes für Secrets können von geheimen API-Schlüsseln gehalten werden und nie von öffentlichen Schlüsseln. Eine Operation, die einer Ihrer Nutzer auslöst, kann ein Secret speichern, das diesem Nutzer gehört, und nur die Operationen dieses Nutzers lesen es zurück.
Rotation und Löschung
Die Rotation ersetzt den Wert hinter einer bestehenden Referenz. Leser erhalten beim nächsten Lesen den neuen Wert, und nichts muss neu deployt werden. Das Löschen ist weich: Das Secret wird sofort nicht mehr aufgelöst und kann 30 Tage lang wiederhergestellt werden.
Details nachlesen
Der Secrets-Leitfaden behandelt das Speichern, Lesen und Rotieren eines Secrets, Secrets im Besitz eines Nutzers und was protokolliert wird.