Zum Inhalt springen
Trainingslager IT-Trainingslager

Tag 5: Team – mehrere Empfänger und Rotation

Ziel: Du nimmst eine Kollegin ins Team auf und wieder heraus, rotierst den Datenschlüssel, wechselst deinen eigenen age-Schlüssel und weißt, warum am Ende trotzdem das Geheimnis selbst gewechselt werden muss. · Dauer: ca. 75 min · Voraussetzung: Tag 4

Briefing

  • Zwei Ebenen: Recipients (wer den Datenschlüssel öffnen kann) und der Datenschlüssel (womit die Werte verschlüsselt sind).
  • sops updatekeys gleicht die Recipients einer Datei mit .sops.yaml ab. Der Datenschlüssel und alle ENC[…]-Werte bleiben gleich.
  • sops rotate erzeugt einen neuen Datenschlüssel und verschlüsselt alle Werte neu. Mit --add-age/--rm-age ändert es dabei auch Recipients – an .sops.yaml vorbei.
  • Git vergisst nichts: Alte Commits sind weiter für die alten Recipients lesbar.
Ereignis Befehl reicht das?
Neues Teammitglied .sops.yaml + updatekeys ja
Mitglied geht .sops.yaml + updatekeys + rotate nein: Geheimnis wechseln
Eigener Schlüssel neu neue Identity + updatekeys ja, alter Schlüssel weg

Drill 1: Als Kollegin lesen

Die Kollegin hat seit Tag 1 einen Schlüssel (kollegin.key). Um auf derselben VM „als Kollegin“ zu arbeiten, muss sops deinen Schlüssel übersehen: Es liest keys.txt unter $XDG_CONFIG_HOME/sops/age/ – zeigt die Variable ins Leere, bleibt nur SOPS_AGE_KEY_FILE.

# auf argo
mkdir -p ~/sops/tag05 && cd ~/sops/repo
XDG_CONFIG_HOME=/nirgends SOPS_AGE_KEY_FILE=~/sops/tag01/kollegin.key \
  sops decrypt dev/notes-db.yaml 2>&1 | sed -n '1p;4p'

Erwartet:

Failed to get the data key required to decrypt the SOPS file.
  age126j96yd6te036uya83l76w0afmlaj9vyyluxrmdeheew3u0wzdmslw69y2: FAILED

Die Datei ist nur für dich verschlüsselt, der Schlüssel der Kollegin passt zu keinem Recipient.

Fortschritt speichern? Kostenlos registrieren

Drill 2: Die Kollegin aufnehmen

# auf argo
cd ~/sops/repo
cp dev/notes-db.yaml ~/sops/tag05/vorher.yaml
K=$(age-keygen -y ~/sops/tag01/kollegin.key)
yq -i '(.creation_rules[] | select(.path_regex == "^dev/.*\\.yaml$") | .age)
  += ",'$K'"' .sops.yaml
yq '.creation_rules[1].age' .sops.yaml | tr ',' '\n'
sops updatekeys dev/notes-db.yaml </dev/null; echo "rc=$?"

Erwartet (gekürzt):

age126j96yd6te036uya83l76w0afmlaj9vyyluxrmdeheew3u0wzdmslw69y2
age1yct8f7sq5lpdw2p09h0lmkz3ue65d669c99cnhz4zkzj9hkd7vaqxl7q5s
The following changes will be made to the file's groups:
Group 1
    age126j96yd6te036uya83l76w0afmlaj9vyyluxrmdeheew3u0wzdmslw69y2
+++ age1yct8f7sq5lpdw2p09h0lmkz3ue65d669c99cnhz4zkzj9hkd7vaqxl7q5s
Is this okay? (y/n):rc=1
EOF

updatekeys zeigt erst, was es tun will (+++ neu, --- weg) und fragt. Ohne Antwort (hier: leere Eingabe, daher EOF) passiert nichts. Mit -y geht es ohne Rückfrage:

# auf argo
cd ~/sops/repo
sops updatekeys -y dev/notes-db.yaml 2>&1 | grep -v Syncing
yq '.sops.age[].recipient' dev/notes-db.yaml
XDG_CONFIG_HOME=/nirgends SOPS_AGE_KEY_FILE=~/sops/tag01/kollegin.key \
  sops decrypt --extract '["data"]["password"]' dev/notes-db.yaml | base64 -d; echo

Erwartet (gekürzt):

The following changes will be made to the file's groups:
Group 1
    age126j96yd6te036uya83l76w0afmlaj9vyyluxrmdeheew3u0wzdmslw69y2
+++ age1yct8f7sq5lpdw2p09h0lmkz3ue65d669c99cnhz4zkzj9hkd7vaqxl7q5s
2026/11/20 16:25:29 File /home/ubuntu/sops/repo/dev/notes-db.yaml synced with new keys
age126j96yd6te036uya83l76w0afmlaj9vyyluxrmdeheew3u0wzdmslw69y2
age1yct8f7sq5lpdw2p09h0lmkz3ue65d669c99cnhz4zkzj9hkd7vaqxl7q5s
lab-db-dev-123

Für updatekeys brauchst du selbst Zugriff: sops öffnet den Datenschlüssel mit deiner Identity und verschlüsselt ihn zusätzlich für die Kollegin.

Fortschritt speichern? Kostenlos registrieren

Drill 3: Was updatekeys nicht anfasst

# auf argo
cd ~/sops/repo
diff <(yq '.data' ~/sops/tag05/vorher.yaml) <(yq '.data' dev/notes-db.yaml) \
  && echo "data unverändert"
sops updatekeys -y dev/notes-db.yaml 2>&1 | cut -c21-
sops updatekeys -y dev/app.env 2>&1 | cut -c21-
git diff --stat
git commit -qam "tag05: Kollegin für dev" && git push -q

Erwartet:

data unverändert
Syncing keys for file /home/ubuntu/sops/repo/dev/notes-db.yaml
File /home/ubuntu/sops/repo/dev/notes-db.yaml already up to date
Syncing keys for file /home/ubuntu/sops/repo/dev/app.env
File /home/ubuntu/sops/repo/dev/app.env already up to date
 .sops.yaml        |  2 +-
 dev/notes-db.yaml | 19 ++++++++++++++-----
 2 files changed, 15 insertions(+), 6 deletions(-)

Die Werte bleiben Byte für Byte gleich, nur ein age-Eintrag kommt dazu. dev/app.env ist „up to date“, weil die dotenv-Regel die Kollegin nicht nennt – updatekeys richtet sich nach der Regel, die zum Pfad passt.

Fortschritt speichern? Kostenlos registrieren

Drill 4: Die Kollegin geht

# auf argo
cd ~/sops/repo
ICH=$(age-keygen -y ~/.config/sops/age/keys.txt)
yq -i '(.creation_rules[] | select(.path_regex == "^dev/.*\\.yaml$") | .age)
  = "'$ICH'"' .sops.yaml
sops updatekeys -y dev/notes-db.yaml 2>&1 | grep -E '^(---|\+\+\+)'
XDG_CONFIG_HOME=/nirgends SOPS_AGE_KEY_FILE=~/sops/tag01/kollegin.key \
  sops decrypt dev/notes-db.yaml 2>&1 | head -1

Erwartet:

--- age1yct8f7sq5lpdw2p09h0lmkz3ue65d669c99cnhz4zkzj9hkd7vaqxl7q5s
Failed to get the data key required to decrypt the SOPS file.

Erledigt? Nein. Die Kollegin hat das Repo geklont:

# auf argo
cd ~/sops/repo
git show HEAD:dev/notes-db.yaml > ~/sops/tag05/alt.yaml
XDG_CONFIG_HOME=/nirgends SOPS_AGE_KEY_FILE=~/sops/tag01/kollegin.key \
  sops decrypt --extract '["data"]["password"]' ~/sops/tag05/alt.yaml | base64 -d
echo
diff <(yq '.data' ~/sops/tag05/alt.yaml) <(yq '.data' dev/notes-db.yaml) \
  && echo "data unverändert"

Erwartet:

lab-db-dev-123
data unverändert

Zwei Lecks: Der letzte Commit ist weiter für sie verschlüsselt, und die aktuellen ENC[…]-Werte sind mit demselben Datenschlüssel verschlüsselt, den sie aus dem alten Stand kennt. Mit ihm könnte sie jede künftige Änderung lesen, die sops mit diesem Datenschlüssel macht.

Fortschritt speichern? Kostenlos registrieren

Drill 5: Den Datenschlüssel rotieren

# auf argo
cd ~/sops/repo
sops rotate -i dev/notes-db.yaml; echo "rc=$?"
diff <(yq '.data' ~/sops/tag05/alt.yaml) <(yq '.data' dev/notes-db.yaml) \
  >/dev/null || echo "data neu verschlüsselt"
sops decrypt --extract '["data"]["password"]' dev/notes-db.yaml | base64 -d; echo
git commit -qam "tag05: Kollegin raus, Datenschlüssel rotiert" && git push -q

Erwartet:

rc=0
data neu verschlüsselt
lab-db-dev-123

Jetzt hilft ihr der alte Datenschlüssel bei künftigen Ständen nicht mehr. Aber das Passwort lab-db-dev-123 kennt sie – aus dem alten Commit. Das kann kein Werkzeug zurückholen: Das Geheimnis selbst muss gewechselt werden (Challenge).

Fortschritt speichern? Kostenlos registrieren

Drill 6: rotate am Regelwerk vorbei

sops rotate --add-age fügt einen Recipient direkt in die Datei ein – praktisch für einen Notfallzugriff, aber .sops.yaml weiß nichts davon.

# auf argo
cd ~/sops/repo
ICH=$(age-keygen -y ~/.config/sops/age/keys.txt)
SOPS_AGE_KEY_FILE=~/sops/tag04/prod.key sops rotate -i --add-age $ICH \
  prod/notes-db.yaml
yq '.sops.age[].recipient' prod/notes-db.yaml
sops decrypt prod/notes-db.yaml | yq .data.password | base64 -d; echo
SOPS_AGE_KEY_FILE=~/sops/tag04/prod.key sops updatekeys -y prod/notes-db.yaml \
  2>&1 | grep -E '^(---|\+\+\+)'
yq '.sops.age[].recipient' prod/notes-db.yaml
git checkout prod/notes-db.yaml

Erwartet:

age1r025nv6kv083tjhqa7xpslvkc0m8qm2jljd0aqn55nzr859xqe7q4798ks
age126j96yd6te036uya83l76w0afmlaj9vyyluxrmdeheew3u0wzdmslw69y2
lab-db-prod-123
--- age126j96yd6te036uya83l76w0afmlaj9vyyluxrmdeheew3u0wzdmslw69y2
age1r025nv6kv083tjhqa7xpslvkc0m8qm2jljd0aqn55nzr859xqe7q4798ks
Updated 1 path from the index

Das nächste updatekeys nimmt den Zugriff wieder weg. Merke: Die Wahrheit über Recipients steht in .sops.yaml; Ausnahmen in einzelnen Dateien halten nicht.

Fortschritt speichern? Kostenlos registrieren

Drill 7: Den eigenen Schlüssel wechseln

Dein Laptop wird ausgetauscht oder der Schlüssel ist ein Jahr alt: neuer Schlüssel, alle Dateien umschlüsseln, alter Schlüssel weg. Während des Wechsels stehen beide Identities in keys.txt – eine Datei darf mehrere enthalten.

# auf argo
cd ~/sops/repo
ALT=$(age-keygen -y ~/sops/tag01/ich.key)
age-keygen -o ~/sops/tag05/ich-2026.key
NEU=$(age-keygen -y ~/sops/tag05/ich-2026.key)
cat ~/sops/tag05/ich-2026.key >> ~/.config/sops/age/keys.txt
grep -c AGE-SECRET ~/.config/sops/age/keys.txt
sed -i "s/$ALT/$NEU/g" .sops.yaml
grep -c $NEU .sops.yaml
for f in notes/app.enc.yaml dev/notes-db.yaml dev/app.env; do
  sops updatekeys -y $f 2>&1 | grep -E 'synced|up to date' | cut -c21-; done
grep -rl --exclude-dir=.git $ALT . ; echo "alter Schlüssel noch in Dateien: $?"

Erwartet:

Public key: age1rnz4tqupd0f3lm4kfs564cfgys5j80497rk7ajzn2ekxh3d2g3uqdtdnv2
2
3
File /home/ubuntu/sops/repo/notes/app.enc.yaml synced with new keys
File /home/ubuntu/sops/repo/dev/notes-db.yaml synced with new keys
File /home/ubuntu/sops/repo/dev/app.env synced with new keys
alter Schlüssel noch in Dateien: 1

grep endet mit 1: Keine Datei nennt den alten Schlüssel mehr. Jetzt fliegt er aus keys.txt:

# auf argo
cd ~/sops/repo
cp ~/sops/tag05/ich-2026.key ~/.config/sops/age/keys.txt
for f in notes/app.enc.yaml dev/notes-db.yaml dev/app.env; do
  sops decrypt $f >/dev/null && echo "$f ok"; done
git add -A && git commit -qm "tag05: eigener Schlüssel gewechselt" && git push -q
git log --oneline | head -3

Erwartet:

notes/app.enc.yaml ok
dev/notes-db.yaml ok
dev/app.env ok
83a0c0a tag05: eigener Schlüssel gewechselt
ca110ea tag05: Kollegin raus, Datenschlüssel rotiert
3a19232 tag05: Kollegin für dev

Ab jetzt ist age1rnz4… dein Schlüssel; ~/sops/tag01/ich.key ist der alte. Ein Datenschlüssel-Wechsel ist hier nicht nötig – den alten Schlüssel hattest nur du.

Fortschritt speichern? Kostenlos registrieren

Übung: Speed-Drills

  1. Zähle, für welche Recipients die drei dev- und notes-Dateien verschlüsselt sind. Zeitziel: 30 s
  2. Liste alle Recipients aus .sops.yaml, jeden einmal. Zeitziel: 30 s

Lösung

# auf argo
cd ~/sops/repo
yq '.sops.age[].recipient' dev/notes-db.yaml notes/app.enc.yaml | grep age1 \
  | sort | uniq -c
grep recipient dev/app.env | cut -c1-50
yq '.creation_rules[].age' .sops.yaml | tr ',' '\n' | sort -u

Erwartet:

      2 age1rnz4tqupd0f3lm4kfs564cfgys5j80497rk7ajzn2ekxh3d2g3uqdtdnv2
sops_age__list_0__map_recipient=age1rnz4tqupd0f3lm
age1r025nv6kv083tjhqa7xpslvkc0m8qm2jljd0aqn55nzr859xqe7q4798ks
age1rnz4tqupd0f3lm4kfs564cfgys5j80497rk7ajzn2ekxh3d2g3uqdtdnv2

yq liest keine dotenv-Dateien – dort hilft grep.

Fortschritt speichern? Kostenlos registrieren

Kontrollpunkt

# auf argo
cd ~/sops/repo && git status -sb
grep -c AGE-SECRET ~/.config/sops/age/keys.txt
age-keygen -y ~/.config/sops/age/keys.txt

Erwartet:

## main...origin/main
1
age1rnz4tqupd0f3lm4kfs564cfgys5j80497rk7ajzn2ekxh3d2g3uqdtdnv2

Challenge

Die Kollegin kennt lab-db-dev-123. Wechsle das dev-Passwort auf lab-db-dev-456, ohne Klartextdatei, committe und pushe. Wie viele Commits in der Historie von dev/notes-db.yaml enthalten noch Stände, die das alte Passwort verschlüsseln?

Hinweis: data erwartet Base64 – und sops set erwartet JSON.

Lösung

# auf argo
cd ~/sops/repo
sops set dev/notes-db.yaml '["data"]["password"]' \
  "\"$(printf lab-db-dev-456 | base64)\""
sops decrypt --extract '["data"]["password"]' dev/notes-db.yaml | base64 -d; echo
git commit -qam "tag05: dev-Passwort gewechselt" && git push -q
git log --oneline -- dev/notes-db.yaml | wc -l

Erwartet:

lab-db-dev-456
5

Vier der fünf Stände enthalten das alte Passwort – das ist in Ordnung, weil es jetzt ungültig ist (in echt: in der Datenbank geändert). Historie umschreiben ist selten nötig; Geheimnisse wechseln immer.

Fortschritt speichern? Kostenlos registrieren

Interview-Notiz

  • Ein Entwickler verlässt das Team – was tust du? Recipient aus .sops.yaml entfernen, updatekeys, rotate für einen neuen Datenschlüssel – und vor allem alle Geheimnisse wechseln, die er je lesen konnte. Die Git-Historie bleibt lesbar.
  • Unterschied updatekeys und rotate? updatekeys ändert nur, für wen der Datenschlüssel verschlüsselt ist; rotate erzeugt einen neuen Datenschlüssel und verschlüsselt alle Werte neu.

Enterprise-Notiz

  • Pro Team eine Gruppe in .sops.yaml, Änderungen nur per Review; ein Offboarding-Runbook mit updatekeys + rotate + Secret-Wechsel.
  • Statt vieler Personenschlüssel: ein KMS oder OpenBao Transit (Tag 7), Zugriff über Gruppen im Identitätssystem – dann ist Offboarding eine Gruppenänderung.
  • Schlüsselwechsel planen (z. B. jährlich), alte Identities danach vernichten.
  • updatekeys über das ganze Repo in der CI prüfen: Eine Datei, deren Recipients von .sops.yaml abweichen, ist ein Befund.