Tag 8: sops im Alltag
Ziel: Du gibst Geheimnisse an Programme weiter, ohne dass sie auf der Platte, in der Shell-History oder in deiner Umgebung landen, liest verschlüsselte Diffs im Klartext und lässt deinen Schlüssel auf einem Rechner, während du auf einem anderen arbeitest. · Dauer: ca. 60 min · Voraussetzung: Tag 7
Briefing
sops exec-envstartet einen Befehl mit den entschlüsselten Werten als Umgebungsvariablen – nur für diesen Prozess.sops exec-filereicht die entschlüsselte Datei als temporären Pfad{}weiter, standardmäßig als FIFO (Named Pipe), die nach einmaligem Lesen leer ist.- Mit einem textconv-Treiber zeigt
git diffKlartext stattENC[…]– nur bei dir, nicht im Repo. sops keyservicelässt einen Schlüssel auf einem Rechner und beantwortet Entschlüsselungsanfragen über das Netz.
| Werkzeug | Klartext landet … |
|---|---|
sops decrypt > datei |
auf der Platte (vermeiden) |
sops decrypt \| befehl |
in einer Pipe |
sops exec-env |
in der Umgebung eines Kindprozesses |
sops exec-file |
in einer FIFO unter /tmp |
Drill 1: Variablen nur für einen Prozess
# auf argo
mkdir -p ~/sops/tag08 && cd ~/sops/repo
sops exec-env dev/app.env 'echo "API_KEY hat ${#API_KEY} Zeichen"'
sops exec-env dev/app.env 'env | grep -c API_KEY'
env | grep -c API_KEY
sops exec-env --pristine dev/app.env 'env'Erwartet:
API_KEY hat 11 Zeichen
1
0
API_KEY=lab-key-123
PWD=/home/ubuntu/sops/repo
Der Befehl steht in einfachen Anführungszeichen:
Sonst würde deine Shell $API_KEY schon vorher (leer)
einsetzen. Außerhalb des Kindprozesses gibt es die Variable nicht.
--pristine gibt nur die entschlüsselten Werte weiter –
praktisch, um zu sehen, was genau in der Umgebung landet.
Verschachtelte YAML-Dateien passen nicht in Umgebungsvariablen:
# auf argo
cd ~/sops/repo
sops exec-env notes/app.enc.yaml 'true'; echo "rc=$?"Erwartet:
cannot use complex value in environment; offending key db
rc=1
Fortschritt speichern? Kostenlos registrieren
Drill 2: Eine Datei, die es nur einmal gibt
Manche Programme wollen eine Konfigurationsdatei, keine Variablen.
# auf argo
cd ~/sops/repo
sops exec-file notes/app.enc.yaml 'ls -l {}; head -3 {}'
sops exec-file --no-fifo notes/app.enc.yaml 'ls -l {}'
sops exec-file --output-type json notes/app.enc.yaml 'jq -r .db.user {}'
ls -d /tmp/.sops* 2>/dev/null | wc -lErwartet:
prw------- 1 ubuntu ubuntu 0 Nov 20 16:37 /tmp/.sops1891905312/tmp-file
# Zugangsdaten der App notes (Laborwerte)
db:
host: postgres.notes.svc
-rw------- 1 ubuntu ubuntu 174 Nov 20 16:37 /tmp/.sops1431033768/tmp-file2633480121
notes
0
Das p in prw------- ist die FIFO: Der
Inhalt fließt einmal durch und steht nie auf der Platte. Ein Programm,
das die Datei zweimal öffnet, wartet beim zweiten Mal ewig – dafür gibt
es --no-fifo (eine normale Datei mit Rechten
0600). Beide Varianten räumt sops danach weg;
--output-type wandelt dabei das Format um.
Fortschritt speichern? Kostenlos registrieren
Drill 3: Werte in Pipes
Ein einzelner Wert lässt sich direkt an ein Programm weitergeben, das von der Standardeingabe liest.
# auf argo
cd ~/sops/repo
sops decrypt --extract '["api"]["key"]' notes/app.enc.yaml \
| kubectl create secret generic notes-api --from-file=key=/dev/stdin \
--dry-run=client -o jsonpath='{.data.key}' | base64 -d; echoErwartet:
lab-key-123
--from-file=key=/dev/stdin statt
--from-literal=key=…: Ein Wert als Argument steht für jeden
Benutzer der Maschine sichtbar in ps und landet in der
Shell-History.
Fortschritt speichern? Kostenlos registrieren
Drill 4: git diff im Klartext
Symptom: Ein Diff einer verschlüsselten Datei sagt nur, dass sich etwas geändert hat (Tag 2). Für ein Review willst du sehen, was.
# auf argo
cd ~/sops/repo
git config diff.sopsdiffer.textconv "sops decrypt"
printf '*.yaml diff=sopsdiffer\n*.env diff=sopsdiffer\n' > .gitattributes
sops set notes/app.enc.yaml '["api"]["key"]' '"lab-key-789"'
git diff notes/app.enc.yaml
git diff --stat
git checkout notes/app.enc.yamlErwartet:
diff --git a/notes/app.enc.yaml b/notes/app.enc.yaml
index 902c4fc..ab13a47 100644
--- a/notes/app.enc.yaml
+++ b/notes/app.enc.yaml
@@ -5,5 +5,5 @@ db:
user: notes
password: lab-db-456
api:
- key: lab-key-123
+ key: lab-key-789
debug: false
notes/app.enc.yaml | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
Updated 1 path from the index
.gitattributes gehört ins Repo und sagt nur „diese
Dateien mit dem Treiber sopsdiffer vergleichen“. Der
Treiber selbst steht in deiner lokalen .git/config – wer
keinen Schlüssel hat, sieht weiter ENC[…].
--stat zählt die echten Zeilen der Datei.
# auf argo
cd ~/sops/repo
git add .gitattributes
git commit -q -m "tag08: Klartext-Diff für sops-Dateien" && git push -q
git log --oneline | head -1Erwartet:
4206ff1 tag08: Klartext-Diff für sops-Dateien
Fortschritt speichern? Kostenlos registrieren
Drill 5: Einrückung
sops schreibt YAML mit vier Leerzeichen, kubectl und die
meisten Linter erwarten zwei. --indent ist eine globale
Option, dauerhaft gehört es in .sops.yaml:
# auf argo
cd ~/sops/repo
sops --indent 2 decrypt dev/notes-db.yaml | head -3
cp .sops.yaml ~/sops/tag08/sops.yaml.vorher
yq -i '.stores.yaml.indent = 2' .sops.yaml
sops decrypt dev/notes-db.yaml | head -3Erwartet:
apiVersion: v1
data:
password: bGFiLWRiLWRldi00NTY=
apiVersion: v1
data:
password: bGFiLWRiLWRldi00NTY=
stores.yaml.indent gilt für alles, was sops in diesem
Repo schreibt – auch beim Verschlüsseln. Bestehende Dateien ändern sich
erst beim nächsten Schreiben.
# auf argo
cd ~/sops/repo
git commit -qam "tag08: YAML mit zwei Leerzeichen" && git push -q
yq '.stores' .sops.yamlErwartet:
yaml:
indent: 2
Fortschritt speichern? Kostenlos registrieren
Drill 6: Der Schlüssel bleibt, wo er ist
Szenario: Du arbeitest per SSH auf einem Server, der prod-Schlüssel
liegt auf einem anderen Rechner. sops keyservice
beantwortet dort Anfragen, der Schlüssel verlässt den Rechner nie. Im
Labor spielen beide Rollen auf argo, verbunden über
127.0.0.1:5000 – über Rechner hinweg per
ssh -R 5000:127.0.0.1:5000 getunnelt.
# auf argo
cd ~/sops/repo
SOPS_AGE_KEY_FILE=~/sops/tag04/prod.key XDG_CONFIG_HOME=/nirgends \
sops keyservice --addr 127.0.0.1:5000 --verbose > ~/sops/tag08/ks.log 2>&1 &
sleep 2
VAULT_TOKEN= XDG_CONFIG_HOME=/nirgends sops decrypt prod/notes-db.yaml 2>&1 \
| head -1
VAULT_TOKEN= XDG_CONFIG_HOME=/nirgends sops decrypt \
--keyservice tcp://127.0.0.1:5000 prod/notes-db.yaml | grep password
kill %1
cut -c1-72 ~/sops/tag08/ks.log | grep -E 'Listening|succeeded'Erwartet:
Failed to get the data key required to decrypt the SOPS file.
password: bGFiLWRiLXByb2QtMTIz
[KEYSERVICE] time="2026-11-20T16:37:27Z" level=info msg="Listening on t
[AGE] time="2026-11-20T16:37:29Z" level=info msg="Decryption succeeded"
VAULT_TOKEN= schaltet den Transit-Weg ab,
XDG_CONFIG_HOME deinen eigenen Schlüssel – übrig bleibt nur
der Keyservice. Die Einrückung mit zwei Leerzeichen kommt aus Drill 5.
Der Keyservice entschlüsselt den Datenschlüssel und schickt ihn zurück.
--prompt lässt dort jede Anfrage bestätigen.
Achtung: Der Keyservice hat keine Anmeldung. Er gehört nur an
127.0.0.1oder einen Unix-Socket, nie an eine Netzwerkschnittstelle.
Fortschritt speichern? Kostenlos registrieren
Übung: Speed-Drills
- Gib die Zahl der Variablen in
dev/app.envaus, ohne einen Wert zu zeigen. Zeitziel: 30 s - Zeig die Datei
notes/app.enc.yamlals JSON überexec-file. Zeitziel: 30 s
Lösung
# auf argo
cd ~/sops/repo
sops exec-env --pristine dev/app.env 'env | grep -vc ^PWD='
sops exec-file --output-type json notes/app.enc.yaml 'jq -c .api {}'Erwartet:
1
{"key":"lab-key-123","debug":false}
Fortschritt speichern? Kostenlos registrieren
Kontrollpunkt
# auf argo
cd ~/sops/repo && git status -sb
cat .gitattributes
git config --get diff.sopsdiffer.textconvErwartet:
## main...origin/main
*.yaml diff=sopsdiffer
*.env diff=sopsdiffer
sops decrypt
Challenge
Lass dir mit git log -p alle Passwortwechsel von
dev/notes-db.yaml im Klartext anzeigen. Wie viele siehst
du, und warum nicht alle aus Tag 4 und 5?
Hinweis: git log -p nutzt textconv nur
mit --textconv.
Lösung
# auf argo
cd ~/sops/repo
git log -p --textconv -- dev/notes-db.yaml 2>/dev/null \
| grep -E '^[-+] +password'
git log --format=%h -- dev/notes-db.yaml | wc -lErwartet:
- password: bGFiLWRiLWRldi0xMjM=
+ password: bGFiLWRiLWRldi00NTY=
5
Nur der letzte Wechsel (…dev-123 →
…dev-456) ist lesbar. Die älteren Stände sind für deinen
alten Schlüssel aus Tag 1 verschlüsselt, den du in Tag
5 abgelöst hast; sops decrypt scheitert dort, und git zeigt
nichts an. Für die Kollegin mit ihrem Schlüssel wäre es genau
umgekehrt.
Fortschritt speichern? Kostenlos registrieren
Aufräumen
# auf argo
pgrep -fc 'sops keyservice'
rm -f ~/sops/tag08/ks.logErwartet:
0
Interview-Notiz
- Wie gibst du ein Secret an ein Programm, ohne es auf die Platte
zu schreiben?
sops exec-env(Umgebung eines Kindprozesses),sops exec-file(FIFO) oder eine Pipe; nie als Kommandozeilenargument. - Wie reviewst du Änderungen an verschlüsselten Dateien? Struktur im Diff (welcher Schlüssel), Inhalt lokal per textconv-Treiber – nur wer den Schlüssel hat, sieht ihn.
Enterprise-Notiz
- Umgebungsvariablen sind nicht geheim: Kindprozesse erben sie,
Crash-Dumps und
/proc/<pid>/environ(für denselben Benutzer) zeigen sie. Für langlebige Dienste lieber Dateien mit engen Rechten oder einen Secret-Speicher. - textconv-Treiber in einem Onboarding-Dokument beschreiben;
.gitattributeszentral pflegen. - Keyservice nur für Ausnahmen (Notfall, Shamir-Runde); für den Alltag ist ein KMS mit Identität besser.