Tag 1: age allein
Ziel: Du erzeugst age-Schlüssel, verschlüsselst Dateien für einen und mehrere Recipients, auch für SSH- und Post-Quanten-Schlüssel, und weißt, was age nicht kann. · Dauer: ca. 60 min · Voraussetzung: Tag 0
Briefing
- age verschlüsselt Dateien. Ein Schlüsselpaar
besteht aus der Identity (privat,
AGE-SECRET-KEY-1…) und dem Recipient (öffentlich,age1…). - Verschlüsselt wird für Recipients, entschlüsselt mit einer Identity. Wer nur den öffentlichen Schlüssel hat, kann verschlüsseln, aber nichts lesen.
- age macht genau eine Sache: Es gibt keine Signaturen, keine Schlüsselserver, keine Konfiguration. SOPS (ab Tag 2) nutzt age als Schlüsselquelle.
- Die Schlüssel dieses Tages bleiben:
ich.keyist ab Tag 2 dein Schlüssel,kollegin.keygehört ab Tag 5 der Kollegin im Team.
Recipient age1… ──► age -r ──► datei.age ──► age -d -i ◄── Identity
(darf jeder haben) (Binärdaten) AGE-SECRET-KEY-1…
Drill 1: Ein Schlüsselpaar
# auf argo
mkdir -p ~/sops/tag01 && cd ~/sops/tag01
age-keygen -o ich.key
ls -l ich.key
cut -c1-40 ich.key
age-keygen -y ich.keyErwartet (gekürzt):
Public key: age126j96yd6te036uya83l76w0afmlaj9vyyluxrmdeheew3u0wzdmslw69y2
-rw------- 1 ubuntu ubuntu 184 Nov 20 16:13 ich.key
# created: 2026-11-20T16:13:21Z
# public key: age126j96yd6te036uya83l76w
AGE-SECRET-KEY-1FG9A49YMS9ESZV0DFC0LXT0T
age126j96yd6te036uya83l76w0afmlaj9vyyluxrmdeheew3u0wzdmslw69y2
Die Datei enthält eine einzige Zeile mit dem privaten Schlüssel,
davor zwei Kommentare. age-keygen legt sie mit
0600 an und überschreibt nie eine vorhandene Datei.
-y rechnet den öffentlichen Schlüssel aus der Identity aus
– du musst ihn nirgends notieren.
Achtung: Den privaten Schlüssel zeigt das Buch nur gekürzt. Bei dir steht er vollständig auf dem Bildschirm – in echten Umgebungen nie in Terminals, die aufgezeichnet oder geteilt werden.
Fortschritt speichern? Kostenlos registrieren
Drill 2: Für einen Recipient verschlüsseln
# auf argo
cd ~/sops/tag01
printf 'lab-db-123\n' > db.txt
age -r $(age-keygen -y ich.key) -o db.txt.age db.txt
ls -l db.txt db.txt.age
head -3 db.txt.age
age-inspect db.txt.age | head -9
age -d -i ich.key db.txt.ageErwartet:
-rw-rw-r-- 1 ubuntu ubuntu 11 Nov 20 16:13 db.txt
-rw-rw-r-- 1 ubuntu ubuntu 211 Nov 20 16:13 db.txt.age
age-encryption.org/v1
-> X25519 nT2v71QVMBGrI8IH0+t9KWgrMcngJUqQ623rc++feT4
t9Qur/pN9/VDCkKZfnaMA2VtW4G4dzgKUHIOMgic+WM
db.txt.age is an age file, version "age-encryption.org/v1".
This file is encrypted to the following recipient types:
- "X25519"
This file does NOT use post-quantum encryption.
Size breakdown (assuming it decrypts successfully):
lab-db-123
Warum 211 Byte für 11 Byte Inhalt? Der Kopf (168 Byte) enthält pro Recipient einen Stanza: den Dateischlüssel, verschlüsselt für genau diesen Recipient. Der öffentliche Schlüssel selbst steht nicht in der Datei – wer sie findet, sieht nicht, für wen sie bestimmt ist. Danach folgen die Nutzdaten, verschlüsselt mit dem Dateischlüssel (ChaCha20-Poly1305).
Fortschritt speichern? Kostenlos registrieren
Drill 3: Mehrere Recipients und ASCII-Armor
Die Kollegin bekommt einen eigenen Schlüssel. Eine Recipients-Datei sammelt alle öffentlichen Schlüssel des Teams.
# auf argo
cd ~/sops/tag01
age-keygen -o kollegin.key
age-keygen -y ich.key > team.txt
age-keygen -y kollegin.key >> team.txt
cat team.txt
age -a -R team.txt -o db.txt.asc db.txt
head -2 db.txt.asc; tail -1 db.txt.asc
age-inspect db.txt.asc | sed -n '3,8p'
age -d -i kollegin.key db.txt.ascErwartet:
Public key: age1yct8f7sq5lpdw2p09h0lmkz3ue65d669c99cnhz4zkzj9hkd7vaqxl7q5s
age126j96yd6te036uya83l76w0afmlaj9vyyluxrmdeheew3u0wzdmslw69y2
age1yct8f7sq5lpdw2p09h0lmkz3ue65d669c99cnhz4zkzj9hkd7vaqxl7q5s
-----BEGIN AGE ENCRYPTED FILE-----
YWdlLWVuY3J5cHRpb24ub3JnL3YxCi0+IFgyNTUxOSByUHhUTUZHM0JkMERXcEta
-----END AGE ENCRYPTED FILE-----
This file is ASCII-armored.
This file is encrypted to the following recipient types:
- "X25519"
- "X25519"
Zwei Stanzas, einer pro Recipient – jeder der beiden kann allein
entschlüsseln. -a (Armor) erzeugt Text statt Binärdaten,
gut für E-Mail, Tickets oder YAML. In der Recipients-Datei sind leere
Zeilen und #-Kommentare erlaubt.
Fortschritt speichern? Kostenlos registrieren
Drill 4: Der falsche Schlüssel
Einbauen: Ein dritter Schlüssel, der nie Recipient war.
# auf argo
cd ~/sops/tag01
age-keygen -o fremd.key 2>/dev/nullSymptom:
# auf argo
cd ~/sops/tag01
age -d -i fremd.key db.txt.age; echo "rc=$?"Erwartet:
age: error: no identity matched any of the recipients
age: report unexpected or unhelpful errors at https://filippo.io/age/report
rc=1
Ursache: Keine der angegebenen Identities passt zu einem Stanza im Kopf. age kann nicht sagen, welcher Schlüssel gefehlt hätte – die Datei verrät ihre Recipients nicht.
Fix und Nachweis: -i darf mehrfach
stehen, unpassende Identities ignoriert age.
# auf argo
cd ~/sops/tag01
age -d -i fremd.key -i ich.key db.txt.ageErwartet:
lab-db-123
Dieselbe Meldung siehst du in Tag 4 (Drill 3) wieder – dann eingepackt in eine sops-Meldung.
Fortschritt speichern? Kostenlos registrieren
Drill 5: SSH-Schlüssel als Recipient
Fast jeder hat schon einen SSH-Schlüssel, und Git-Server
veröffentlichen die öffentlichen Schlüssel ihrer Nutzer. age nimmt
ssh-ed25519 und ssh-rsa direkt.
# auf argo
cd ~/sops/tag01
ssh-keygen -q -t ed25519 -N '' -C lab-ssh -f lab_ssh
age -R lab_ssh.pub -o db.ssh.age db.txt
age-inspect db.ssh.age | sed -n '3,4p'
age -d -i lab_ssh db.ssh.ageErwartet:
This file is encrypted to the following recipient types:
- "ssh-ed25519"
lab-db-123
Warum? Bequem für einmalige Weitergabe („schick mir das Passwort, hier ist mein GitHub-Schlüssel“). Für Teams mit Rotation sind native age-Schlüssel besser: Ein SSH-Schlüssel mit Passphrase muss bei jedem Entschlüsseln entsperrt werden, und SSH-Agenten kann age nicht nutzen.
Fortschritt speichern? Kostenlos registrieren
Drill 6: Post-Quanten-Schlüssel
age 1.3 kennt hybride Schlüssel aus ML-KEM-768 und X25519
(-pq). Sie schützen heute verschlüsselte Daten auch gegen
einen späteren Quantencomputer („jetzt sammeln, später
entschlüsseln“).
# auf argo
cd ~/sops/tag01
age-keygen -pq -o pq.key 2>&1 | cut -c1-60
age-keygen -y pq.key | wc -c
age -r $(age-keygen -y pq.key) -o db.pq.age db.txt
age-inspect db.pq.age | sed -n '3,6p'
ls -l db.pq.age
age -d -i pq.key db.pq.age
age -R team.txt -r $(age-keygen -y pq.key) db.txt 2>&1 >/dev/null | head -1Erwartet (Zeile umbrochen):
Public key: age1pq13rc8akjy9ccupy2ey9d9589yyktt3d9sprwn0yhse
1960
This file is encrypted to the following recipient types:
- "mlkem768x25519"
This file uses post-quantum encryption.
-rw-rw-r-- 1 ubuntu ubuntu 1670 Nov 20 16:13 db.pq.age
lab-db-123
age: error: incompatible recipients: can't mix post-quantum and classic recipients,
or the file would be vulnerable to quantum computers
Der öffentliche Schlüssel ist knapp 2000 Zeichen lang, der Kopf der
Datei entsprechend größer. Mischen verweigert age: Ein klassischer
Recipient wäre die schwächste Stelle. sops 3.13 akzeptiert
age1pq1… ebenfalls; das Buch bleibt bei den kurzen
X25519-Schlüsseln, damit die Ausgaben lesbar bleiben.
Fortschritt speichern? Kostenlos registrieren
Drill 7: Passphrasen und geschützte Identities
age -p verschlüsselt mit einer Passphrase (scrypt) und
fragt sie am Terminal ab. Für Abläufe ohne Terminal liefert age 1.3 das
Plugin age-plugin-batchpass mit, das die Passphrase aus
AGE_PASSPHRASE liest. Damit schützt du auch eine
Identity-Datei:
# auf argo
cd ~/sops/tag01
sudo install -m 0755 ~/sops/tag00/age/age-plugin-batchpass /usr/local/bin/
AGE_PASSPHRASE=lab-pass-123 age -e -j batchpass -o ich.key.age ich.key
age-inspect ich.key.age | sed -n '4p'
AGE_PASSPHRASE=lab-pass-123 age -d -j batchpass ich.key.age | age -d -i - db.txt.age
AGE_PASSPHRASE=falsch-123 age -d -j batchpass ich.key.age | head -1Erwartet:
- "scrypt"
lab-db-123
age: error: batchpass plugin: incorrect passphrase
age: report unexpected or unhelpful errors at https://filippo.io/age/report
-i - liest die Identity von der Standardeingabe – der
private Schlüssel landet nie unverschlüsselt auf der Platte. Am Terminal
geht es ohne Plugin: age -d -i ich.key.age db.txt.age
erkennt die passphrase-geschützte Identity und fragt nach der
Passphrase.
Tipp: Die Hilfe von
age-plugin-batchpasssagt selbst: In 90 % der Fälle brauchst du es nicht. Ein Rechner, der sich eine Passphrase merkt, kann sich genauso gut einen echten Schlüssel merken.
Fortschritt speichern? Kostenlos registrieren
Übung: Speed-Drills
- Zeig den öffentlichen Schlüssel aus
ich.key, ohneage-keygen. Zeitziel: 10 s - Verschlüssele
db.txtals Text für das ganze Team nachdb.team.asc. Zeitziel: 20 s - Zähle mit
age-inspect --json, für wie viele Recipientsdb.txt.ascgilt. Zeitziel: 30 s
Lösung
# auf argo
cd ~/sops/tag01
grep 'public key' ich.key
age -a -R team.txt -o db.team.asc db.txt && head -1 db.team.asc
age-inspect --json db.txt.asc | jq '.stanza_types | length'Erwartet:
# public key: age126j96yd6te036uya83l76w0afmlaj9vyyluxrmdeheew3u0wzdmslw69y2
-----BEGIN AGE ENCRYPTED FILE-----
2
Fortschritt speichern? Kostenlos registrieren
Kontrollpunkt
# auf argo
cd ~/sops/tag01
ls -1 ich.key kollegin.key team.txt
age -d -i ich.key db.txt.asc
age -d -i kollegin.key db.txt.ascErwartet:
ich.key
kollegin.key
team.txt
lab-db-123
lab-db-123
Challenge
Packe einen Ordner projekt mit einer Datei
.env (API_KEY=lab-key-123) und einer
notiz.txt als komprimiertes Archiv, verschlüssele es in
einem Durchgang für das Team und packe es als Kollegin in einen Ordner
ziel wieder aus – ohne unverschlüsselte Zwischendatei.
Hinweis: age liest von der Standardeingabe und schreibt auf die Standardausgabe.
Lösung
# auf argo
cd ~/sops/tag01
mkdir -p projekt && printf 'API_KEY=lab-key-123\n' > projekt/.env
printf 'x\n' > projekt/notiz.txt
tar -czf - projekt | age -R team.txt -o projekt.tar.gz.age
mkdir -p ziel && age -d -i kollegin.key projekt.tar.gz.age | tar -xzf - -C ziel
find ziel -type f | sort
cat ziel/projekt/.envErwartet:
ziel/projekt/.env
ziel/projekt/notiz.txt
API_KEY=lab-key-123
Fortschritt speichern? Kostenlos registrieren
Aufräumen
# auf argo
cd ~/sops/tag01
rm -rf db.txt projekt ziel fremd.key
ls -1Erwartet:
db.pq.age
db.ssh.age
db.team.asc
db.txt.age
db.txt.asc
ich.key
ich.key.age
kollegin.key
lab_ssh
lab_ssh.pub
pq.key
projekt.tar.gz.age
team.txt
ich.key, kollegin.key und
team.txt brauchst du ab Tag 2.
Interview-Notiz
- Was ist der Unterschied zwischen Recipient und Identity? Recipient = öffentlicher Schlüssel zum Verschlüsseln, Identity = privater Schlüssel zum Entschlüsseln. Pro Recipient steht ein Stanza mit dem verschlüsselten Dateischlüssel im Kopf.
- age oder GPG? age: kleine Schlüssel, keine Konfiguration, kein Web of Trust, keine Signaturen. GPG kann signieren und hat Smartcards, ist aber schwer richtig zu bedienen. Für SOPS ist age heute der empfohlene Standard.
- Warum Post-Quanten-Schlüssel? Daten, die heute abgegriffen werden, können später entschlüsselt werden; hybride Schlüssel schützen dagegen, solange einer der beiden Teile hält.
Enterprise-Notiz
- Private age-Schlüssel gehören in einen Passwort-Manager oder auf einen Hardware-Token (age-Plugins für YubiKey/TPM), nicht ungeschützt ins Home-Verzeichnis.
- Recipients-Dateien sind öffentlich und gehören ins Repo – sie dokumentieren, wer lesen darf.
- age signiert nicht: Wer einen Recipient kennt, kann dir Dateien unterschieben. Für Herkunftsnachweise zusätzlich signieren (cosign, minisign, signierte Commits).
- Langfristig gespeicherte Geheimnisse (Backups) mit
-pqverschlüsseln.