> ## Documentation index
> The full klickops handbook index is at https://klickops.io/llms.txt
> The HTML of this page is at https://klickops.io/docs/vault
> Language: de

# Vault

Alle Secrets, Einstellungen und Zertifikate, die die Apps deines Projekts lesen, in einer Liste, mit wer was nutzt.

## 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

1. Öffne das Projekt und geh zu **Vault**.
2. Wähl **Add**, dann **Secret** oder **Setting**, und gib einen Namen ein. Namen schreibst du gross und mit Unterstrichen, so wie Umgebungsvariablen.
3. Füg den Wert ein, oder wähl **Generate one** für ein zufälliges Secret mit 32 Zeichen.
4. 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

1. Wähl **Import .env** und füg die Datei ein.
2. Prüf die Art jeder Zeile. Ein Name, der heikel aussieht, startet als Secret. Stell um, was keins ist.
3. 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.

## Verwandt

- [Domains](/docs/domains) bedienen die Zertifikate.
- [Apps](/docs/apps) lesen den Vault als Umgebungsvariablen.