Anhang A: Spickzettel
Alle Befehle stammen aus den Tagen dieses Buchs; die Tagesnummer steht in der Überschrift. Pfade und Schlüssel wie im Labor.
age (Tag 1)
# auf argo
age-keygen -o ich.key # Schlüsselpaar, privater Teil in der Datei
age-keygen -y ich.key # öffentlichen Schlüssel ausgeben
age -r age1… -o geheim.age klartext.txt # für einen Recipient
age -R team.txt -o geheim.age klartext.txt # für alle Recipients aus einer Datei
age -a -r age1… klartext.txt # ASCII-Armor statt binär
age -d -i ich.key geheim.age # entschlüsseln
age -R ~/.ssh/id_ed25519.pub -o x.age x.txt # SSH-Schlüssel als Recipientsops – Grundbefehle (Tag 2, 3, 8)
# auf argo
sops encrypt -i datei.yaml # an Ort und Stelle verschlüsseln
sops decrypt datei.yaml # Klartext auf stdout
sops edit datei.yaml # im Editor, Exit 200 = nichts geändert
sops decrypt --extract '["data"]["password"]' datei.yaml
sops set datei.yaml '["data"]["password"]' '"wert"' # Zeichenkette in Anführung
sops unset datei.yaml '["data"]["alt"]'
sops filestatus datei.yaml # {"encrypted":true|false}
sops --input-type dotenv --output-type dotenv decrypt app.env
sops exec-env app.env 'echo "$API_KEY"' # Werte als Umgebung, nie auf der Platte
sops exec-file --no-fifo app.yaml 'cat {}' # Werte als temporäre Datei
sops --indent 2 decrypt datei.yaml # globale Option vor dem Unterbefehl
sops decrypt --ignore-mac f.yaml \
| sops encrypt --filename-override f.yaml /dev/stdin > neu.yaml # MAC neu (Tag 14).sops.yaml (Tag 4, 6, 7, 8)
creation_rules: # erste passende Regel gewinnt
- path_regex: ^prod/.*\.yaml$
encrypted_regex: ^(data|stringData)$ # nur diese Schlüssel verschlüsseln
age: age1prod…,age1ich…
hc_vault_transit_uri: http://172.16.0.182:30820/v1/transit/keys/sops
- path_regex: ^tresor/.*\.yaml$
shamir_threshold: 2
key_groups:
- age: [age1anna…, age1ich…]
- age: [age1ben…]
- age: [age1dora…]
stores:
yaml:
indent: 2Weitere Schalter einer Regel: unencrypted_suffix,
encrypted_suffix, unencrypted_regex,
mac_only_encrypted: true (Tag 3, 4).
Schlüssel finden (Tag 4)
| Quelle | Wirkung |
|---|---|
~/.config/sops/age/keys.txt |
Standard, über XDG_CONFIG_HOME verschiebbar |
SOPS_AGE_KEY_FILE |
zusätzliche Schlüsseldatei |
SOPS_AGE_KEY |
Schlüssel direkt in der Variable (auch mehrere Zeilen) |
VAULT_ADDR, VAULT_TOKEN |
OpenBao/Vault Transit (Tag 7) |
Team und Rotation (Tag 5, 6)
# auf argo
sops updatekeys -y datei.yaml # Recipients aus .sops.yaml übernehmen
sops rotate -i datei.yaml # neuer Datenschlüssel, alle Werte neu
sops rotate -i --add-age age1… datei.yaml # an .sops.yaml vorbei (nur vorübergehend)
sops rotate -i --rm-age age1… datei.yamlEntfernen heißt immer: updatekeys und
rotate und das Geheimnis selbst wechseln –
die Git-Historie kennt den alten Stand.
OpenBao Transit (Tag 7)
# auf argo
bao secrets enable transit
bao write -f transit/keys/sops
bao policy write sops sops-policy.hcl # nur transit/encrypt|decrypt/sops
bao token create -policy=sops -ttl=8h -field=token
sops encrypt --hc-vault-transit http://…:30820/v1/transit/keys/sops datei.yaml
bao write -f transit/keys/sops/rotate # neue Schlüsselversion, kein rewrapGit (Tag 8, 9)
# auf argo
printf '*.yaml diff=sopsdiffer\n' > .gitattributes
git config diff.sopsdiffer.textconv "sops decrypt"
git config core.hooksPath hooks # versionierter Hook
gitleaks git --no-banner --log-opts="--no-textconv --all" .
GIT_CONFIG_COUNT=1 GIT_CONFIG_KEY_0=diff.sopsdiffer.textconv GIT_CONFIG_VALUE_0=cat \
gitleaks git --pre-commit --staged --redact ..gitleaks.toml mit Ausnahme für versiegelte Werte (Tag
12):
[extend]
useDefault = true
[[allowlists]]
regexTarget = "secret"
regexes = ['''^Ag[A-Za-z0-9+/]{300,}={0,2}$''']
Flux (Tag 10)
# auf argo
kubectl -n flux-system create secret generic sops-age --from-file=ich.agekey=keys.txt
kubectl -n flux-system create secret generic sops-bao \
--from-file=sops.vault-token=sops.token
flux create kustomization dev --source=GitRepository/secrets --path=./dev \
--prune=true --decryption-provider=sops --decryption-secret=sops-age --export
kubectl -n flux-system get kustomization dev \
-o jsonpath='{.status.conditions[?(@.type=="Ready")].message}'Argo CD mit KSOPS (Tag 11)
configs:
cm:
kustomize.buildOptions: --enable-alpha-plugins --enable-exec
repoServer:
initContainers: # ksops install --with-kustomize
env: [{name: SOPS_AGE_KEY_FILE, value: /sops/keys.txt}]apiVersion: viaduct.ai/v1
kind: ksops
metadata:
name: dev-secrets
annotations:
config.kubernetes.io/function: |
exec:
path: ksops
files: [../../dev/notes-db.yaml]
secretFrom:
- metadata: {name: app-env}
envs: [../../dev/app.env]Application mit syncOptions: [ServerSideApply=true] –
sonst Klartext in last-applied-configuration.
Sealed Secrets (Tag 12, 13)
# auf argo
kubeseal -f secret.yaml -w secret.sealed.yaml # online
kubeseal --fetch-cert > cert.pem # Zertifikat holen
kubeseal --cert cert.pem -o yaml < secret.yaml # offline
kubeseal --scope namespace-wide|cluster-wide -o yaml < secret.yaml
printf wert | kubeseal --raw --namespace ns --name n --from-file=/dev/stdin
kubeseal --merge-into datei.sealed.yaml -o yaml < neu.yaml
kubeseal --validate < datei.sealed.yaml
kubeseal --re-encrypt -o yaml < alt.yaml > neu.yaml
kubeseal --recovery-unseal --recovery-private-key k1.pem,k2.pem -o yaml < s.yaml
kubectl annotate secret x sealedsecrets.bitnami.com/managed=true # übernehmen
kubectl delete sealedsecret x --cascade=orphan # Secret behaltenSchlüssel sichern und zurückspielen:
# auf argo
kubectl -n kube-system get secret -l sealedsecrets.bitnami.com/sealed-secrets-key \
-o yaml | yq 'del(.items[].metadata.uid, .items[].metadata.resourceVersion,
.items[].metadata.creationTimestamp, .items[].metadata.managedFields,
.items[].metadata.annotations)' > backup/sealed-secrets-keys.yaml
sops encrypt -i backup/sealed-secrets-keys.yaml
sops decrypt backup/sealed-secrets-keys.yaml | kubectl create -f - # nicht apply!
kubectl -n kube-system delete pod -l app.kubernetes.io/name=sealed-secretsVorzeitig erneuern:
printf 'keycutofftime: "%s"\n' "$(date -R)" > cutoff.yaml
und helm upgrade … --reuse-values -f cutoff.yaml (nicht
--set-string: Komma).
Niemals ohne Nachdenken
- Privaten Schlüssel in ein Repo, ein Ticket oder einen Chat kopieren.
--ignore-macauf eine Datei aus fremder Hand.kubectl applymit entschlüsselten Secrets (Annotation mit Klartext) –createoder--server-side.kubectl delete sealedsecretohne--cascade=orphan, wenn das Secret bleiben soll.- Sealed-Secrets-Schlüssel löschen, ohne eine aktuelle Sicherung geprüft zu haben.
git push --forceauf ein Repo, das andere klonen – im Labor ja, im Team nein.
Fehlerbilder
| Meldung | Ursache | Tag |
|---|---|---|
no identity matched any of the recipients |
age: falscher Schlüssel | 1, 4 |
MAC mismatch. File has …, computed … |
Klartext außerhalb von sops geändert | 3, 14 |
Could not decrypt with AES_GCM: … message authentication failed |
ENC[…]-Wert beschädigt |
14 |
illegal base64 data at input byte 3 |
verschlüsselte Datei direkt mit kubectl angewendet | 3, 16 |
error loading config: no matching creation rules found |
path_regex passt nicht, falsches Verzeichnis |
4, 15, 16 |
Group 0: FAILED + Recipient-Liste |
Schlüssel fehlt; Liste = Recipients der Datei | 4, 5, 14 |
0 successful groups required, got 0 |
KSOPS/sops ohne Schlüssel | 11 |
Code: 403. … permission denied |
OpenBao-Token fehlt, abgelaufen oder widerrufen | 7, 10, 14 |
Code: 400 (Transit) |
Transit-Schlüssel neu/anders, Version gesperrt | 7 |
sops metadata not found |
Datei nicht verschlüsselt | 14 |
contains a top-level entry called 'sops' |
Datei schon verschlüsselt | 14 |
… is SOPS encrypted, configuring decryption is required |
Flux-Kustomization ohne decryption |
10 |
external plugins disabled; unable to load external plugin 'ksops' |
kustomize.buildOptions fehlt |
11 |
no key could decrypt secret (…) |
Scope, fremdes Zertifikat oder Schlüssel weg | 12, 13, 14 |
Resource "x" already exists and is not managed by SealedSecret |
fremdes Secret, Annotation managed |
12 |
failed parsing --set-string data: key " 20 Nov …" has no value |
Komma in date -R |
13 |
leaks found beim Commit |
Klartext oder Schlüssel gestaged; bei SealedSecrets Fehlalarm | 9, 12 |
Versionen
| Komponente | Version | ab Tag |
|---|---|---|
| Ubuntu (VM) | 24.04 LTS | 0 |
| k3s (Kubernetes) | v1.37.2+k3s1 | 0 |
| sops | v3.13.3 | 0 |
| age | v1.3.2 | 0 |
| Helm | v4.3.2 | 0 |
| yq | v4.54.3 | 0 |
| Forgejo (rootless) | 17.0.2 | 0 |
| OpenBao (Server und CLI) | v2.7.3 | 7 |
| gitleaks | v8.30.1 | 9 |
| Flux | v2.10.0 | 10 |
| Argo CD (Chart 10.18.2) | v3.6.2 | 11 |
| KSOPS | v4.5.1 | 11 |
| Sealed Secrets (Chart 2.22.0), kubeseal | v0.41.2 | 12 |
Doku
- sops: getsops.io/docs
- age: github.com/FiloSottile/age
- Sealed Secrets: github.com/bitnami-labs/sealed-secrets
- KSOPS: github.com/viaduct-ai/kustomize-sops
- Flux und sops: fluxcd.io/flux/guides/mozilla-sops
- Argo CD Secret Management: argo-cd.readthedocs.io (Operator Manual)
- OpenBao Transit: openbao.org/docs/secrets/transit
- gitleaks: github.com/gitleaks/gitleaks