Zum Inhalt springen
Trainingslager IT-Trainingslager

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-env startet einen Befehl mit den entschlüsselten Werten als Umgebungsvariablen – nur für diesen Prozess.
  • sops exec-file reicht 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 diff Klartext statt ENC[…] – nur bei dir, nicht im Repo.
  • sops keyservice lä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 -l

Erwartet:

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; echo

Erwartet:

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.yaml

Erwartet:

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

Erwartet:

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

Erwartet:

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.yaml

Erwartet:

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.1 oder einen Unix-Socket, nie an eine Netzwerkschnittstelle.

Fortschritt speichern? Kostenlos registrieren

Übung: Speed-Drills

  1. Gib die Zahl der Variablen in dev/app.env aus, ohne einen Wert zu zeigen. Zeitziel: 30 s
  2. Zeig die Datei notes/app.enc.yaml als JSON über exec-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.textconv

Erwartet:

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

Erwartet:

-  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.log

Erwartet:

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; .gitattributes zentral pflegen.
  • Keyservice nur für Ausnahmen (Notfall, Shamir-Runde); für den Alltag ist ein KMS mit Identität besser.