Zum Inhalt springen
Trainingslager IT-Trainingslager

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 Recipient

sops – 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: 2

Weitere 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.yaml

Entfernen 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 rewrap

Git (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 behalten

Schlü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-secrets

Vorzeitig 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-mac auf eine Datei aus fremder Hand.
  • kubectl apply mit entschlüsselten Secrets (Annotation mit Klartext) – create oder --server-side.
  • kubectl delete sealedsecret ohne --cascade=orphan, wenn das Secret bleiben soll.
  • Sealed-Secrets-Schlüssel löschen, ohne eine aktuelle Sicherung geprüft zu haben.
  • git push --force auf 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