# Secret

## Was es ist

Ein Secret für den Systembetrieb ist ein Wert, mit dem Software oder ihr Betreiber in einem System handeln kann und der jedem anderen, der ihn liest, dieselben Befugnisse gibt. Dazu zählen ein Datenbankpasswort, ein API-Token, der private Schlüssel eines SSH-Schlüsselpaars und die Passphrase, die eine Sicherung verschlüsselt. Im Alltag spricht man meist einfach von Secrets. Das Erstellen, Speichern, Rotieren und Vernichten dieser Werte wird Secrets-Management genannt.

Zwei Dinge unterscheiden sie vom umgebenden Code. Das erste ist der Leser. Ein Benutzerpasswort sitzt im Gedächtnis eines Menschen und wird bei einer Aufforderung eingegeben. Ein Secret für den Betrieb wird dagegen von einem Programm, einem Bereitstellungsskript oder einem geplanten Job gelesen; niemand muss es sich merken. Das OWASP Secrets Management Cheat Sheet weist ihm deshalb einen eigenen Lebenszyklus zu: mit den geringsten nötigen Rechten erzeugt, nach Zeitplan rotiert, bei möglichem Abfluss widerrufen und, wo die Plattform es erlaubt, mit Ablaufdatum versehen. Die Lebensdauer reicht von Minuten bis zu Jahren. Benutzerpasswörter sind von dieser regelmäßigen Rotation ausgenommen. Das zweite ist die Grenze zwischen einem Secret und der darauf verweisenden Konfiguration. Ein Hostname oder ein Pfad zu einem Sicherungsrepository sagt, wo etwas ist. Das Secret verschafft dem Inhaber Zugang und ist der Teil, dessen Kopien gezählt werden müssen.

Auch Secrets sind verschachtelt. Ihr Speicher braucht ein eigenes Secret. Das Cheat Sheet weist darauf hin, dass dieses primäre Secret, etwa die Root-Zugangsdaten eines Cloudanbieters, meist anderswo aufbewahrt werden muss.

## Warum es wichtig ist

Ein Secret funktioniert für jeden, der es vorlegt. Ein Token hält nicht fest, wer es eigentlich besitzen sollte. Jede Kopie erweitert deshalb den Kreis der Menschen und Programme, die es nutzen können. Ein Quelltextrepository ist dafür der schlechteste Ort: Jeder Klon enthält die vollständige Historie. Ein einmal eingecheckter Wert wandert auf jeden Laptop, jeden Build-Runner und jeden Spiegel, der die Änderungen abruft. Er bleibt in dieser Historie, nachdem die betreffende Zeile gelöscht wurde.

Standards machen daraus Anforderungen. Der OWASP Application Security Verification Standard verlangt eine Lösung wie einen Schlüsseltresor, um Backend-Secrets zu erstellen, zu speichern, den Zugriff darauf zu kontrollieren und sie zu vernichten. Secrets dürfen weder im Anwendungsquelltext noch in Build-Artefakten enthalten sein. Für den Zugriff verlangt der Standard das Prinzip der geringsten Rechte; auf der höchsten Stufe müssen sie ablaufen und rotiert werden. NIST SP 800-53 ergänzt die Kontrollerweiterung IA-5(7): Unverschlüsselte statische Authentikatoren dürfen nicht in Anwendungen oder andere statische Speicher eingebettet werden. Die Erläuterung schließt auch ein Schlupfloch: Wird ein Wert genau in der gespeicherten Form verwendet, gilt er als unverschlüsselt, unabhängig von der Datei, in der er liegt.

Dabei gibt es echte Zielkonflikte. Ein zentraler Speicher ist ein weiteres System, das gerade dann laufen muss, wenn es am dringendsten gebraucht wird. Laut Cheat Sheet erwarten Menschen bei einem Vorfall rasch neue Zugangsdaten. Ein gemeinsames Secret für mehrere Dienste spart Arbeit, kostet aber Zuordenbarkeit: Nach einem Abfluss lässt sich nicht sagen, welcher Inhaber es verloren hat. Der manuelle Aufwand wächst mit jedem Secret. Deshalb bevorzugt das Cheat Sheet automatische Rotation. Es warnt außerdem: Gestohlene Zugangsdaten funktionieren auch nach einem Neustart der Anwendung weiter. Erst ihr Widerruf beendet das.

## Wie es in der Praxis aussieht

Diese Website nennt ihre Regel auf [der Seite zur sicheren Arbeitsweise des Unternehmens](/de/security/): Secrets bleiben aus dem Repository heraus. Zugangsdaten liegen in einem Secret-Speicher oder in der Bereitstellungsschicht, weder im Quelltext noch in irgendeinem Build-Erzeugnis. Bei jedem Commit läuft ein automatischer Scan. Ein Fund stoppt den Commit.

Die technischen Hinweise zum Repository erklären das Vorgehen. gitleaks prüft bei jedem Commit den Arbeitsbaum und erneut in der vollständigen Qualitätsprüfung. Ein Treffer ist ein harter Stopp, den niemand mit einer Ausnahmeliste umgehen soll. Der Abhängigkeitsordner und die erzeugten Ausgabebäume sind ausgeschlossen, weil sie von Grund auf neu erzeugte Kopien sind. Die Hinweise dokumentieren auch einen weniger auffälligen Fehler: Verschwindet während des Scans eine Datei, gibt gitleaks eine Fehlerzeile aus und beendet sich trotzdem erfolgreich. Deshalb scheitert die ausführende Task bei jeder Fehlerzeile. Die Website selbst ist statisch, hält keine Anwendungs-Secrets und wird über SSH mit Schlüsseln bereitgestellt, die die Eigentümerin verwahrt.

Secrets aus dem Repository herauszuhalten verlagert sie an einen Ort außerhalb seiner Prüfungen. [Ein Preflight-Play für Secrets](/de/portfolio/added-a-one-second-preflight-for-secrets/) schließt diese Lücke. Die Secrets waren gerade pro Host aufgeteilt worden, und der Code war richtig. Der verschlüsselte Tresor auf dem eigenen Rechner des Betreibers, für die verbindliche Qualitätsprüfung unsichtbar, enthielt aber noch den alten Wert für einen einzelnen Host. Der erste Konvergenzlauf erreichte den Live-Host, erledigte acht Tasks und brach bei der neunten ab, nachdem die Swap-Einstellungen schon in Produktion geschrieben waren. Die Antwort war ein Play, das keinen Host kontaktiert, keine Systemdaten erfasst und zur Prüfung des Tresors dieselben zwei Taskdateien wie der echte Konvergenzlauf ausführt, in etwa einer Sekunde, bevor die Bereitstellung irgendetwas anderes tut. Derselbe Code statt einer erneuten Formulierung derselben Regel verhindert, dass Prüfung und Konvergenz auseinanderlaufen. Ein falsches Secret führt jetzt nach zwei Sekunden zu einer Ablehnung auf einem Laptop.

Die Aufteilung selbst ist [der Wechsel zu einem eigenen Wert pro Host für jedes Secret des Betriebs](/de/portfolio/split-every-operational-secret-per-host/). Die Plattform hatte einen Host und sollte bald zwei haben. Mehrere Secrets waren als Einzelwerte geschrieben, darunter das Sicherungsrepository, seine Passphrase und ein Alarmschalter. Jeder Wert wurde zu einer Map mit dem Inventory-Hostnamen als Schlüssel. Zwei Gründe stehen neben der Konfiguration. Ein von zwei Hosts geteilter Totmannschalter bleibt grün, solange einer noch ein Lebenszeichen sendet. Der zweite verdeckt so den Ausfall des ersten. Getrennte restic-Repositories können verschiedene Masterschlüssel haben, auch wenn sie dieselbe Passphrase verwenden. Wer diese Passphrase erlangt und die verschlüsselten Daten und Schlüsseldateien beider Repositories lesen kann, kann aber beide entsperren. Die gemeinsame Passphrase gefährdet dadurch beide zugleich, statt die Hosts voneinander zu isolieren. Der vorhandene Host steht in allen vier Maps mit leeren Werten für sein Repository und beide Schalter. Das sagt: Die Einbindung besteht, der Betreiber muss den Wert aber noch liefern.

## Wo es schiefgeht

**Ein Secret landet in einem Commit.** Ein Scanner findet einen Wert in einem Diff, oder jemand entdeckt ein Token in einer bereits hochgeladenen Datei. Beim Commit stand es in einer Konfigurationsdatei oder einer Testfixture. Das OWASP Cheat Sheet gibt die Reihenfolge vor: erst den offengelegten Wert widerrufen, dann rotieren und erst danach aus Code oder Protokollen entfernen. Die Historie zum Entfernen des Commits umzuschreiben verändert alle späteren Commits und bricht ihre Links. Das muss deshalb geplant werden. Erkennung gehört vor den Commit, in einen Pre-Commit-Hook oder den Editor, wo ein Fund nichts kostet.

**Der Scan bleibt grün, obwohl er Dateien nie gelesen hat.** Ein Lauf endet grün, obwohl ein Teil des Baums ungeprüft blieb: Eine Datei verschwand während des Durchlaufs, ein Ausschluss war zu weit gefasst, oder das Secret hat kein erkennbares Muster. Musterregeln erkennen Tokens mit festem Format und übersehen ein von einem Menschen erfundenes Passwort. Deshalb empfiehlt das Cheat Sheet mehr als ein Werkzeug. Behandeln Sie jeden Scannerfehler als Fehlschlag und beschränken Sie Ausschlüsse auf Kopien, die ein Build neu erzeugt.

**Ein Secret dient vielen Inhabern.** Zwei Hosts, zwei Dienste oder ein ganzes Team verwenden denselben Wert. Nach einem Abfluss können Protokolle nicht sagen, welche Kopie betroffen war. Für einen Austausch muss der Wert bei allen Inhabern gleichzeitig ersetzt werden. SP 800-53 verlangt, Authentikatoren von Gruppen- oder Rollenkonten bei jeder Änderung der Mitgliedschaft zu ändern. Mit einem eigenen Secret je Inhaber wird daraus ein einzelner Austausch statt einer koordinierten Aktion.

**Das Secret wird mit dem Build ausgeliefert oder gelangt in ein Protokoll.** Ein Containerimage, ein gebündeltes Skript oder eine Debugzeile trägt den Wert aus seinem vorgesehenen Ort heraus. ASVS nennt Build-Artefakte neben dem Quelltext. Das Cheat Sheet verlangt, Secrets aus Protokollen herauszuhalten und zu maskieren, wo eine Zeile auf eines verweisen muss. Scannen Sie neben dem Repository auch die Build-Erzeugnisse.

## Weiterführende Lektüre

- [OWASP Secrets Management Cheat Sheet](https://cheatsheetseries.owasp.org/cheatsheets/Secrets_Management_Cheat_Sheet.html) — Lebenszyklus eines Secrets, Erkennung vor dem Commit und Reihenfolge der Behebung nach einem Abfluss.
- [OWASP Application Security Verification Standard](https://owasp.org/www-project-application-security-verification-standard/) — Die Anforderungen zur Secret-Verwaltung in Gruppe 13.3: Tresor, geringste Rechte und Rotation.
- [NIST SP 800-53, Revision 5](https://csrc.nist.gov/pubs/sp/800/53/r5/upd1/final) — Authentikatorenverwaltung in IA-5 mit IA-5(7) gegen eingebettete statische Authentikatoren.
- [Gitleaks](https://github.com/gitleaks/gitleaks) — Der Scanner, den diese Website bei jedem Commit über ihren Arbeitsbaum laufen lässt.

<https://engineer.company/de/glossary/secret/>
