Zum Inhalt springen
Trainingslager IT-Trainingslager

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.key ist ab Tag 2 dein Schlüssel, kollegin.key gehö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.key

Erwartet (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.age

Erwartet:

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

Erwartet:

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/null

Symptom:

# 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.age

Erwartet:

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

Erwartet:

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

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

Erwartet:

  - "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-batchpass sagt 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

  1. Zeig den öffentlichen Schlüssel aus ich.key, ohne age-keygen. Zeitziel: 10 s
  2. Verschlüssele db.txt als Text für das ganze Team nach db.team.asc. Zeitziel: 20 s
  3. Zähle mit age-inspect --json, für wie viele Recipients db.txt.asc gilt. 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.asc

Erwartet:

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/.env

Erwartet:

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

Erwartet:

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 -pq verschlüsseln.