Dieses Dokument befindet sich in aktiver Entwicklung und ist noch nicht finalisiert.
Skip to content

2.5 Key Management ​

2.5.1 Schlüsselverwaltung ​

Die sichere Verwaltung kryptographischer Schlüssel ist essenziell für die Integrität der Signierungsprozesse.

2.5.2 Schlüsseltypen ​

SchlüsselTypSpeicherortZweck
Cosign Private KeyEd25519 / ECDSA P-256GitHub SecretsSignierung von Artefakten
Cosign PasswordPasswortGitHub SecretsSchutz des Private Keys
Cosign Public KeyEd25519 / ECDSA P-256Repository (cosign.pub)Verifikation durch Nutzer

2.5.3 Schlüsselerzeugung ​

bash
# Neues Schlüsselpaar generieren
cosign generate-key-pair

# Ergebnis:
# cosign.key  → Private Key (passwortgeschützt)
# cosign.pub  → Public Key

2.5.4 Schlüsselspeicherung ​

Private Key ​

Der Private Key wird ausschließlich in GitHub Secrets gespeichert:

  • Secret Name: COSIGN_PRIVATE_KEY
  • Zugriff: Nur GitHub Actions Workflows
  • Schutz: GitHub Secrets Encryption (Libsodium sealed box)
  • Sichtbarkeit: Nie in Logs, nie im Code

Passwort ​

  • Secret Name: COSIGN_PASSWORD
  • Zugriff: Nur in Kombination mit COSIGN_PRIVATE_KEY

Public Key ​

  • Speicherort: Repository-Root (cosign.pub)
  • Verfügbarkeit: Öffentlich
  • Zweck: Verifikation durch Nutzer und Systeme

2.5.5 Schlüsselrotation ​

AuslöserAktionFrist
JährlichRoutinemäßige RotationAlle 12 Monate
KompromittierungsverdachtSofortige RotationUnverzüglich
PersonalwechselPrüfung und ggf. RotationInnerhalb 7 Tagen
SicherheitsvorfallRotation im Rahmen des Incident ResponseGem. Playbook

Rotationsprozess ​

1. Neues Schlüsselpaar generieren
   └── cosign generate-key-pair

2. GitHub Secrets aktualisieren
   ├── COSIGN_PRIVATE_KEY → Neuer Private Key
   └── COSIGN_PASSWORD → Neues Passwort

3. Public Key im Repository aktualisieren
   └── cosign.pub → Neuer Public Key

4. Alten Public Key archivieren
   └── keys/cosign-<datum>.pub.archived

5. Dokumentation aktualisieren
   ├── Rotationsdatum
   ├── Key Fingerprint
   └── Grund der Rotation

6. Verifizierung
   └── Test-Signierung und -Verifikation durchführen

2.5.6 Notfallverfahren bei Schlüsselkompromittierung ​

  1. Sofort: GitHub Secrets rotieren (neues Schlüsselpaar)
  2. Innerhalb 1h: Alle seit Kompromittierung signierten Releases identifizieren
  3. Innerhalb 4h: Betroffene Releases mit neuem Schlüssel re-signieren
  4. Innerhalb 24h: Nutzer informieren über Schlüsselwechsel
  5. Dokumentation: Vorfall im Incident-Report dokumentieren

2.5.7 Zugriffsberechtigungen ​

RollePrivate KeyPublic KeyKey-Rotation
Security LeadVerwaltung (GitHub Secrets)LesenDurchführung
DevOps LeadKein direkter Zugriff (nur via Workflow)LesenUnterstützung
Development TeamKein ZugriffLesenKein Zugriff
GitHub ActionsLesen (Runtime)LesenKein Zugriff

Dokumentation lizenziert unter CC BY-NC 4.0 · Code lizenziert unter MIT