Vault
Alle Secrets, Einstellungen und Zertifikate, die die Apps deines Projekts lesen, in einer Liste, mit wer was nutzt.
Auf dieser Seite
Was das ist
Der Vault ist pro Projekt eine Liste der Werte, die deine Apps lesen: Secrets wie Passwörter, API-Keys und Tokens, Einstellungen wie ein Log-Level, und Zertifikate. Bei jedem Eintrag siehst du, welche Apps, geplanten Jobs und Domains ihn nutzen und unter welchem Namen.
Geteilte Einträge gehören dem Projekt. Die eigenen Werte einer App stehen auch hier, unter dem Namen der App. Ändern kannst du sie im Tab Configuration der App.
Wann du das brauchst
- Ein API-Key, den zwei Apps brauchen, einmal angelegt.
- Du willst wissen, welche Apps einen Key lesen, bevor du ihn tauschst oder löschst.
- Du ziehst ein Projekt um und hast eine
.env-Datei dabei.
Ein Secret oder eine Einstellung anlegen
- Öffne das Projekt und geh zu Vault.
- Wähl Add, dann Secret oder Setting, und gib einen Namen ein. Namen schreibst du gross und mit Unterstrichen, so wie Umgebungsvariablen.
- Füg den Wert ein, oder wähl Generate one für ein zufälliges Secret mit 32 Zeichen.
- Hak die Apps an, die ihn lesen sollen, und wähl Add and restart.
Geteilte Einträge anlegen und ändern dürfen Admins des Projekts. Editoren wählen, welche Apps einen Eintrag lesen.
Eine .env-Datei importieren
- Wähl Import .env und füg die Datei ein.
- Prüf die Art jeder Zeile. Ein Name, der heikel aussieht, startet als Secret. Stell um, was keins ist.
- Wähl Import. Vorher wird nichts gespeichert.
Den Wert eines Secrets sehen
Wähl Reveal neben einem verdeckten Wert. Editoren und Admins können das aus einer angemeldeten Sitzung, ein API-Token nicht. Jedes Anzeigen erscheint in der Aktivität des Projekts, und jede Person kann 30 Werte pro Stunde anzeigen. Der Wert verschwindet wieder, wenn du Hide wählst oder die Seite verlässt.
Im CLI geht das mit klops vault reveal STRIPE_SECRET_KEY.
Einstellungen
| Einstellung | Standard | Was sie tut |
|---|---|---|
| Kind | Secret | Ein Secret wird verschlüsselt gespeichert und nur mit Reveal gezeigt. Eine Einstellung siehst du so, wie sie ist. |
| Name | keiner | Der Name der Umgebungsvariable, im Projekt eindeutig. |
| Value | keiner | Eingefügt, oder bei einem Secret generiert. |
| Use it in | keine | Die Apps, die ihn lesen. Eine Änderung startet sie neu. |
Grenzen und Stolpersteine
- Wer einen Wert ändert, startet neu, was ihn liest. Ein Container liest seine Umgebung beim Start.
- Zugangsdaten einer Datenbank sind keine Einträge. Eine Datenbank gibt ihre Verbindungsdaten als Binding an die App, und das Binding wechselt mit dem Passwort.
- Eine Domain wählt ihr Zertifikat im Abschnitt HTTPS. Hier siehst du den Zustand jedes Zertifikats und ersetzt ein hochgeladenes durch seine Erneuerung.
- Nur was klickops angelegt hat, steht in der Liste. Einen Wert, den eine App aus einem anderswo angelegten Secret liest, siehst du im Tab Configuration der App.