Signing images and Helm charts, producing SBOMs, and verifying in the cluster
Keyless signing with cosign, SBOMs as attestations, and where each kind of signature is actually checked.
Talos Mühendislik
Güvenlik Ekibi
English translation of this article is in progress — content shown below is in Turkish.
Registry'deki api:v1.2.0 tag'i bir işaretçiden ibaret. Push yetkisi olan herkes, ya da o yetkiyi ele geçiren biri, aynı tag'in altına başka bir image koyabilir ve cluster bir sonraki pull'da onu çalıştırır. Supply chain güvenliğinde ilk iş bu yüzden çalıştırdığınız şeyin gerçekten sizin pipeline'ınızdan çıktığını kanıtlayabilmek.
İmza bu soruya cevap verir. İçinde ne olduğu sorusuna cevap vermez, o SBOM'un işi. Log4Shell'de kimse kimsenin image'ını değiştirmemişti. Ekipler kendi elleriyle build ettikleri image'ın içinde o kütüphanenin olup olmadığını bilmiyordu. İkisini ayrı araçlar olarak düşünmek, hangisinden ne bekleyeceğinizi netleştirir.
İmzayı digest'e atmak
Anahtar çiftiyle başlamak en kısa yol:
cosign generate-key-pair
IMAGE="registry.example.com/api@$(crane digest registry.example.com/api:v1.2.0)"
cosign sign --key cosign.key "$IMAGE"
cosign verify --key cosign.pub "$IMAGE"
Tag yerine digest imzalamanın sebebi girişteki sorunun aynısı. Tag'i imzalarsanız build ile imza arasında tag başka bir image'a kaydırılmış olabilir, cosign da bu yüzden tag verildiğinde uyarır. İmza registry'de image'ın yanında ayrı bir nesne olarak durur, image'ın kendisi değişmez.
cosign.key parolayla korunur, CI'da parolayı COSIGN_PASSWORD değişkeniyle verirsiniz. Anahtarı dosya yerine bir KMS'te ya da Vault'ta tutmak da mümkün ve kalıcı kurulumda bence doğrusu o.
Öteki yol keyless imza. --key vermezseniz cosign bir OIDC kimliği ister, Sigstore'un Fulcio servisinden o kimliğe bağlı kısa ömürlü bir sertifika alır ve imzayı Rekor şeffaflık kaydına yazar. GitLab CI'da kimlik job'a şöyle verilir:
sign-image:
id_tokens:
SIGSTORE_ID_TOKEN:
aud: sigstore
script:
- cosign sign --yes "$IMAGE"
Yönetecek anahtar kalmaz, doğrulama tarafında da --certificate-identity ve --certificate-oidc-issuer ile "şu projenin şu pipeline'ı imzalamış olmalı" dersiniz. Bedeli şu: genel Sigstore servislerini kullanıyorsanız imzalayan kimlik, yani proje yolunuz, herkese açık bir kayda yazılır ve pipeline internete çıkabilmek zorundadır. Kapalı ağda ya kendi Sigstore altyapınızı kurarsınız ya da anahtarlı yolda kalırsınız.
Helm chart'ı aynı yoldan geçirmek
Helm'in kendi imza mekanizması var. helm package --sign GPG ile bir .prov dosyası üretir, helm verify onu denetler. Çalışır, ama image'lar için kurduğunuz düzenden kopuk kalır. Chart'ları OCI registry'ye koyuyorsanız onlar da registry'de birer artifact olur ve aynı cosign komutuyla imzalanır:
helm package ./charts/api
helm push api-1.2.0.tgz oci://registry.example.com/charts
# helm push çıktısındaki "Digest:" değerini kullanın
cosign sign --key cosign.key "registry.example.com/charts/api@${CHART_DIGEST}"
Chart imzası yalnızca şablonları ve varsayılan değerleri kapsar. Chart'ın işaret ettiği image'lar hakkında bir şey söylemez, onları ayrıca imzalamanız gerekir. Doğrulama da image'larla aynı yerde yapılmaz. Admission controller pod'u görür, chart'ı görmez, dolayısıyla chart imzası chart çekilirken denetlenmelidir. Pipeline'da cosign verify çalıştırabilirsiniz. Flux kullanıyorsanız OCIRepository ve HelmChart kaynaklarındaki spec.verify alanı bunu sizin yerinize yapar.
SBOM üretmek ve attestation olarak eklemek
syft "$IMAGE" -o cyclonedx-json=sbom.cdx.json
cosign attest --key cosign.key --type cyclonedx \
--predicate sbom.cdx.json "$IMAGE"
cosign verify-attestation --key cosign.pub --type cyclonedx "$IMAGE"
Eski örneklerde göreceğiniz cosign attach sbom komutu kullanımdan kaldırılma yolunda. O komut SBOM'u registry'ye imzasız bir ek olarak yüklüyordu. Attestation ise SBOM'u image digest'ine bağlayan imzalı bir beyandır.
SBOM'un faydası yeni bir CVE duyurulduğunda ortaya çıkar. Image'ları yeniden çekip taramak yerine elinizdeki dosyaları tararsınız, örneğin trivy sbom sbom.cdx.json. Bunun işlemesi için SBOM'ların aranabilir bir yerde birikmesi lazım. Registry'deki attestation tek bir image için iyi bir kanıt, ama "bu kütüphane hangi servislerimizde var" sorusuna cevap vermez. Pipeline'ın SBOM'u ayrıca bir depoya göndermesini baştan planlayın.
Pipeline'da sıra da önemli: build ve push, digest'i alma, zafiyet taraması, tarama geçerse imza, sonra SBOM attestation. Taramayı imzadan sonraya koyarsanız, taramadan kalan image imzalanmış hâlde registry'de kalır ve cluster onu kabul eder.
Cluster'da imzasız image'ı reddetmek
İmzalamak, doğrulayan biri olmadıkça bir şey değiştirmez. Kyverno'nun verifyImages kuralı bunu admission aşamasında yapar:
apiVersion: kyverno.io/v1
kind: ClusterPolicy
metadata:
name: require-image-signature
spec:
background: false
rules:
- name: verify-images
match:
any:
- resources:
kinds:
- Pod
verifyImages:
- imageReferences:
- "registry.example.com/*"
failureAction: Enforce
attestors:
- entries:
- keys:
publicKeys: |-
-----BEGIN PUBLIC KEY-----
<cosign.pub içeriği>
-----END PUBLIC KEY-----
failureAction alanının yeri Kyverno sürümüne göre değişti. Eski sürümlerde spec.validationFailureAction olarak policy düzeyinde yazılıyordu, yeni sürümlerde image doğrulama için ayrı policy türleri de geliyor. Kurulu sürümünüzün belgesine bakmadan kopyalamayın.
Bu policy yalnızca registry.example.com altındaki image'ları denetler. Docker Hub'dan çekilen bir image eşleşmediği için hiçbir kontrole takılmadan geçer. "Bilinmeyen image cluster'a giremez" diyebilmek için izinli registry'leri sınırlayan ikinci bir policy şart. Kyverno'yu üretimde işletmenin öteki ayrıntıları için Pod Security ve Kyverno yazısına bakabilirsiniz.
Doğrulama geçtiğinde Kyverno varsayılan olarak pod'daki tag'i digest ile değiştirir. Her pod yaratılışında registry'ye gidildiği için registry'nin erişilemediği anda yeni pod açılamaz. Önce Audit ile başlayıp raporları bir süre izlemenizi, sistem namespace'lerini kapsam dışında tutmanızı ve Kyverno'yu birden fazla replica ile çalıştırmanızı öneririm. Bunları atlarsanız ilk kesintiyi büyük ihtimalle kendi policy'niz çıkarır.