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 updatekeysgleicht die Recipients einer Datei mit.sops.yamlab. Der Datenschlüssel und alleENC[…]-Werte bleiben gleich.sops rotateerzeugt einen neuen Datenschlüssel und verschlüsselt alle Werte neu. Mit--add-age/--rm-ageändert es dabei auch Recipients – an.sops.yamlvorbei.- 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; echoErwartet (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 -qErwartet:
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 -1Erwartet:
--- 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 -qErwartet:
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.yamlErwartet:
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 -3Erwartet:
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
- Zähle, für welche Recipients die drei dev- und notes-Dateien verschlüsselt sind. Zeitziel: 30 s
- 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 -uErwartet:
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.txtErwartet:
## 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 -lErwartet:
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.yamlentfernen,updatekeys,rotatefür einen neuen Datenschlüssel – und vor allem alle Geheimnisse wechseln, die er je lesen konnte. Die Git-Historie bleibt lesbar. - Unterschied
updatekeysundrotate?updatekeysändert nur, für wen der Datenschlüssel verschlüsselt ist;rotateerzeugt 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 mitupdatekeys+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.yamlabweichen, ist ein Befund.