İçeriğe atla

Secret Yönetimi Mimarisi: Vault, KMS ve Workload Identity

Secret'lar iş yüklerine uzun ömürlü kimlik bilgileri olmadan nasıl ulaşır: workload identity, kısa TTL'li dinamik secret'lar, KMS envelope encryption, rotasyon, denetim.

· Kurucu ve geliştirici

Yayımlandı:

Projected token, Vault Agent sidecar ve uygulamadan oluşan bir Pod çerçevesinin diyagramı. Numaralı bağlantılar Kubernetes API server, agent, Vault ve PostgreSQL'i birbirine bağlar: login, TokenReview, kimlik bilgisi okuma, CREATE ROLE, bağlantı, DROP ROLE. KMS ve denetim logu sağdadır.

Siparişler veritabanının parolası bir .env dosyasında başladı. Sonra migration'lar için bir CI değişkenine, servis için bir Kubernetes Secret'a ve bir olay sırasında iki dizüstü bilgisayara kopyalandı. İki yıl sonra kimse tüm kopyaları bilmiyor, bu yüzden kimse rotasyona cesaret edemiyor.

GitGuardian, 2025'te herkese açık GitHub commit'lerinde 28,65 milyon yeni sabit kodlanmış secret saydı; bu, bir yılda %34 artış demek. 2022'de geçerli olduğunu doğruladığı secret'ların %64'ünden fazlası Ocak 2026'da hâlâ çalışıyordu (State of Secrets Sprawl 2026).

Bu yazı, uzun ömürlü veritabanı parolaları olmayan bir secret yönetimi mimarisi kuruyor: workload identity, kısa ömürlü dinamik kimlik bilgileri, KMS envelope encryption, rotasyon ve denetim; akışın diyagramıyla birlikte.

Statik secret'lar nerede yanlış gider

Statik bir secret'ın her kopyası, sızabileceği bir yerdir:

  • Git geçmişi, satırı sildikten sonra da değeri saklar.
  • CI değişkenlerini, onları alan bir işi değiştirebilen herkes okuyabilir.
  • Ortam değişkenleri konteynerdeki her süreç tarafından görülür ve loglara ile crash dump'lara düşer. OWASP'ın secret cheat sheet'i, başka çare yoksa dışında bunlara karşı tavsiye veriyor.
  • Kubernetes Secret'ları varsayılan olarak etcd'de şifrelenmeden saklanır ve bir namespace'te Pod oluşturabilen herkes oradaki tüm Secret'ları okuyabilir; Kubernetes dokümantasyonu bunu uyarıyor.

Bir secret yöneticisi depolamayı çözer, bootstrap'i değil: uygulamanın kimlik bilgisini almak için yine bir kimlik bilgisine ihtiyacı vardır. Çözüm, platformun verdiği bir kimliği kendiliğinden süresi dolan kimlik bilgileriyle takas etmektir.

Yapı taşları

Bileşen Görevi Örnekler
Secret yöneticisi Secret'ları saklar ve verir, politikayı uygular, lease'leri izler HashiCorp Vault, OpenBao, AWS Secrets Manager, Google Secret Manager, Azure Key Vault
KMS veya HSM Dışarı çıkmayan anahtar şifreleme anahtarlarını tutar AWS KMS, Google Cloud KMS, Azure Key Vault Managed HSM
Workload identity Kısa ömürlü platform token'larıyla çağıran iş yükünün kim olduğunu kanıtlar Kubernetes service account token'ları, EKS Pod Identity, Workload Identity Federation for GKE, Microsoft Entra Workload ID
Teslimat Secret'ı sürece ulaştırır Vault Agent, Secrets Store CSI Driver, External Secrets Operator, SDK çağrıları
Denetim Kimin neyi ne zaman okuduğunu kaydeder Vault audit device'ları, AWS CloudTrail, bir SIEM

KMS ile envelope encryption

KMS toplu veri için tasarlanmamıştır; AWS KMS Encrypt en fazla 4.096 bayt alır. Envelope encryption işi ikiye böler:

  1. GenerateDataKey, benzersiz bir veri anahtarını iki kez döndürür: düz metin olarak ve KMS anahtarınızla, yani anahtar şifreleme anahtarıyla (KEK) şifrelenmiş olarak.
  2. Veriyi düz metin anahtarla yerelde şifreleyin, sonra anahtarı bellekten silin.
  3. Şifrelenmiş veri anahtarını şifreli metnin yanında saklayın. Okumak için onu Decrypt'e gönderin ve veriyi yerelde çözün.
aws kms generate-data-key --key-id alias/orders-data --key-spec AES_256

KEK, KMS'ten şifresiz olarak asla çıkmaz; bu yüzden her kullanım, yetkilendirip loglayabileceğiniz bir API çağrısıdır (AWS KMS cryptography details). Otomatik rotasyon etkinleştirildiğinde varsayılan olarak yılda bir çalışır ve yalnızca yeni şifrelemeler için anahtar materyalini değiştirir; eski şifreli metin yine çözülür.

Bu desen burada iki kez görünür. Kubernetes KMS provider'ı, etcd'deki Secret'ları şifreleyen veri anahtarlarını sarmalar; KMS v2'yi kullanın, çünkü v1 Kubernetes 1.29'dan itibaren varsayılan olarak devre dışıdır. Vault'un keyring'i bir kök anahtarla şifrelenir ve auto-unseal ile bir bulut KMS'i, Vault başlarken bu kök anahtarı çözer.

Bir Pod kim olduğunu nasıl kanıtlar

Her Pod'un zaten bir kimliği vardır: service account'u; service mesh'te workload identity de bu kimliğe dayanır. Vault Kubernetes auth method ile:

  1. kubelet, TokenRequest API'si üzerinden vault audience'ına sahip projected bir service account token'ı ister. Varsayılan olarak bir saat sürer (en az 10 dakika) ve TTL'sinin %80'inde yenilenir.
  2. Vault Agent, token ve bir Vault role ile login olur.
  3. Vault, token'ı Kubernetes TokenReview API'siyle doğrular. Bound token, süresi dolduğunda veya Pod'u silindiğinde geçersiz olur.
  4. Vault, service account'u, namespace'i ve audience'ı role karşı kontrol eder ve politikalarıyla bir token döndürür.
vault write auth/kubernetes/role/payments \
    bound_service_account_names=payments-api \
    bound_service_account_namespaces=payments \
    audience=vault policies=payments-db token_ttl=1h

Token bir bearer kimlik bilgisidir ve Vault Kubernetes auth dokümantasyonu onu başka servislerle paylaşmaya karşı uyarır. Ayrı bir audience, aud alanını kontrol eden servislerin onu reddetmesini sağlar.

Tablodaki workload identity servisleri, projected bir service account token'ını kısa ömürlü bulut kimlik bilgileriyle takas eder; böylece hiçbir bulut anahtarı saklanmaz. GitHub Actions OIDC, bir CI/CD pipeline'ındaki deploy işleri için aynısını yapar. JWT authentication flow bu tür token'ların nasıl doğrulandığını anlatır.

Dinamik veritabanı kimlik bilgileri

Dinamik bir secret istek üzerine oluşturulur ve lease'i bitince yok edilir. Vault database secrets engine ile database/creds/payments yolunun her okunuşu yeni bir PostgreSQL kullanıcısı oluşturur:

vault write database/roles/payments db_name=orders \
    creation_statements="CREATE ROLE \"{{name}}\" WITH LOGIN PASSWORD '{{password}}' VALID UNTIL '{{expiration}}'; GRANT SELECT ON ALL TABLES IN SCHEMA public TO \"{{name}}\";" \
    default_ttl=1h max_ttl=24h

Lease'ler max_ttl'e kadar yenilenebilir. Vault Agent, yenilenebilir secret'ları lease'in üçte ikisinden sonra yeniler, yenilenemeyen lease'li secret'ları ise TTL'lerinin %90'ında yeniden çeker. Bir lease'in süresi dolduğunda veya iptal edildiğinde Vault, revocation statement'ları çalıştırır; varsayılan olarak genel bir kullanıcı silme ifadesi kullanılır. TTL yoksa Vault'un 768 saatlik (32 gün) sistem varsayılanı geçerli olur.

Kazandıklarınız:

  • Pod başına bir kullanıcı, böylece şüpheli bir sorgu, aynı parolayı paylaşan tüm servisleri değil, tek bir lease'i işaret eder.
  • Sızıntılar sona erer, lease yenilenmediği sürece en geç verilişten bir saat sonra.
  • Tek komutla müdahale: vault lease revoke -prefix database/creds/payments, role ait tüm aktif kimlik bilgilerini iptal eder.

Bir tuzak var: VALID UNTIL parolanın süresini bitirir ve bu, login anında önem taşır. Havuzlanmış bağlantılara lease'ten kısa bir maksimum ömür verin (HikariCP'nin varsayılanı 30 dakikadır) ve Vault Agent dosyayı yeniden yazdığında kimlik bilgilerini yeniden yükleyin.

Teslimat seçenekleri ve ödünleşimler

Teslimat Nasıl çalışır Yeni değerler Dikkat edilecekler
Ortam değişkenleri Konteyner başlarken ayarlanır Yeniden başlatmadan sonra Her süreç tarafından görülür; loglara ve dump'lara sızar
Senkronize Kubernetes Secret External Secrets Operator (varsayılan olarak saatlik yenileme) veya Vault Secrets Operator değerleri bir Secret'a kopyalar Mount edilen volume'lar güncellenir; ortam değişkenleri güncellenmez etcd'de bir kopya: encryption at rest'i ve sıkı RBAC'i etkinleştirin
Agent sidecar Vault Agent Injector, secret'ları /vault/secrets altındaki bellek içi bir volume'a render eder Evet, uygulama dosyayı yeniden okursa Her Pod'da bir sidecar ve bir init container
CSI volume Secrets Store CSI Driver, secret'ları Pod başlarken mount eder Yalnızca alpha auto-rotation ile, varsayılan olarak kapalı Secret'a isteğe bağlı senkronizasyon etcd kopyasını geri getirir
SDK çağrısı Uygulama secret yöneticisinin API'sini çağırır Evet, kodda Her serviste kimlik doğrulama, önbellekleme ve yeniden denemeler

Dinamik kimlik bilgileri için agent'ın render ettiği dosyalar en uygunudur: login'i, yenilemeyi ve yeniden render etmeyi agent halleder. Helm chart'ları bir tane bekliyorsa ya da GitOps deposundaki secret'ları yalnızca referans olarak tutuyorsanız senkronize Secret'ları, Kubernetes dışında ise SDK'yı kullanın.

Kesintisiz rotasyon

Rotasyonun tek bir kuralı vardır: yeni kimlik bilgisi, eskisi durmadan önce çalışmalıdır.

  • Dinamik kimlik bilgileri, tüketiciler zamanında yeniden yüklediği sürece tasarım gereği döner.
  • Statik veritabanı parolaları bir rotasyon işi gerektirir. AWS Secrets Manager'da single-user stratejisi açık bağlantıları korur ama çağrıları kısa süre reddedebilir, bu yüzden istemcilerin yeniden denemesi gerekir; alternating-users stratejisi iki kullanıcı arasında geçiş yapar, böylece rotasyon sırasında secret'ı almış bir istemcinin elinde yine geçerli kimlik bilgileri olur. Rotasyon dört saatte bir kadar sık çalışabilir.
  • API anahtarları: yeni anahtarı dağıtın, trafiğin ona geçtiğini doğrulayın, sonra eskisini iptal edin.

Denetim logları ve break-glass erişimi

Vault, her istek ve yanıt için etkin tüm audit device'larına bir kayıt gönderir ve hiçbir device'ın kaydedemediği istekleri reddeder; bu yüzden HashiCorp en az ikisini etkinleştirmeyi önerir. Dizelerin çoğu HMAC-SHA256 hash'leri olarak loglanır ve /sys/audit-hash, bilinen bir değerin hash'ini hesaplar, böylece onu arayabilirsiniz. Bunu SIEM'inize gönderin ve root token kullanımı ile politika değişikliklerinde alarm kurun.

Break-glass erişimi sıkıcı ve test edilmiş olmalıdır:

  • Kalıcı root token olmasın. HashiCorp, root token'ları yalnızca kurulum veya acil durumlar için önerir ve hemen ardından iptal edilmesini ister. vault operator generate-root, unseal veya recovery anahtarı sahiplerinden oluşan bir çoğunluk (quorum) gerektirir.
  • Sert bağımlılıklarınızı bilin. Auto-unseal ile recovery anahtarları kök anahtarı çözemez, dolayısıyla Vault, KMS anahtarı olmadan unseal olamaz. AWS KMS bir anahtarı silmeden önce 7 ila 30 gün bekler; planlanan her silme için alarm kurun.

Secret akışı diyagramı

Projected token, Vault Agent sidecar ve uygulamadan oluşan bir Pod çerçevesinin diyagramı. Numaralı bağlantılar Kubernetes API server, agent, Vault ve PostgreSQL'i birbirine bağlar: login, TokenReview, kimlik bilgisi okuma, CREATE ROLE, bağlantı, DROP ROLE. KMS ve denetim logu sağdadır.

12 bileşen · 11 bağlantı

Archboard'da aç
Diyagram içeriği
  • Kubernetes API server
  • Pod: payments-api
  • Projected SA token
  • Vault Agent (sidecar)
  • App container
  • Cloud KMS key
  • Vault: auth, policies, leases
  • Vault audit log to SIEM
  • orders DB (PostgreSQL)
  • 1 TokenRequest via kubelet
  • read JWT
  • 2 login: JWT + role payments
  • 3 TokenReview
  • 4 read database/creds/payments
  • 5 CREATE ROLE ... VALID UNTIL
  • 6 render /vault/secrets/db
  • 7 connect as the short-lived user (TLS)
  • 8 lease ends: DROP ROLE
  • at startup: decrypt root key
  • every request and response
Bir Pod, saklanan bir parola olmadan veritabanı kimlik bilgilerini alır. Service account token'ı kimliğini kanıtlar, Vault bir saatlik kiralamayla bir PostgreSQL kullanıcısı oluşturur ve kiralama bitince kullanıcı silinir. KMS, Vault'un kök anahtarını korur ve her istek denetlenir.

Nasıl okunur:

  • Sol: Kubernetes API server'ın altında, projected token'ı, Vault Agent sidecar'ını ve uygulamayı içeren Pod çerçevesi.
  • 1'den 3'e mor bağlantılar, kimlik: TokenRequest (1), payments role ile login (2), TokenReview (3).
  • 4'ten 7'ye turkuaz bağlantılar, kimlik bilgisi: database/creds/payments okuma (4), CREATE ROLE ... VALID UNTIL (5), /vault/secrets/db render etme (6), TLS üzerinden bağlanma (7).
  • 8 numaralı kırmızı kesikli bağlantı: lease biter ve Vault kullanıcıyı siler.
  • Sağ: KMS, Vault'un kök anahtarını başlangıçta çözer; denetim logu her isteği ve yanıtı alır.
  • Markdown bloğu tüm ömürleri listeler.

Secret yönetimi diyagramlarını net çizmek

  • Adımları numaralandırın ve aşamaya göre renklendirin: kimlik, teslimat, iptal.
  • Ömürleri ve audience'ları diyagrama yazın. «aud vault, 1h» incelemeyi davet eder; «kısa ömürlü» tartışmayı davet eder.
  • Düz metnin nerede bulunduğunu gösterin: bellek, bellek içi volume'lar, ortam değişkenleri, etcd.
  • İptal ve denetim yollarını çizin, yalnızca mutlu yolu değil.
  • Diyagrama asla gerçek anahtar, token veya iç hostname koymayın.
  • Vault'un depolama ve küme iç yapısını bir operasyon diyagramına bırakın.

Threat modeling data flow diagram güven sınırları ekler, zero trust modeli erişimin daha geniş çerçevesini gösterir, Kubernetes architecture diagram ise API server'ı ve kubelet'i kapsar.

Archboard'da oluşturun

  1. Google veya GitHub ile giriş yapın ve bir diyagram oluşturun.
  2. Temel pack'inden Pod: payments-api adında bir Çerçeve ekleyin. İçine Güvenlik pack'inden bir Jeton ve Docker pack'inden iki Konteyner node'u yerleştirin: Vault Agent (sidecar) ve App container.
  3. Çerçevenin üstüne Bulut pack'inden bir Kubernetes kümesi ekleyin ve adını Kubernetes API server yapın.
  4. Ortaya Güvenlik pack'inden bir Kasa ekleyin. Sağa, KMS anahtarı için Bulut pack'inden bir Bulut kaynağı, denetim logu için DevOps pack'inden Loglar ve Veri pack'inden Postgres ekleyin.
  5. 1'den 8'e bağlantıları blok oklarla çizin (kimlik için mor, kimlik bilgisi için turkuaz, DROP ROLE için kırmızı kesikli), ayrıca KMS anahtarına başlangıç bağlantısını ve denetim loguna kesikli bir bağlantı ekleyin.
  6. Temel pack'inden ömürleri içeren bir Markdown bloğu ve Vault role ile veritabanı kullanıcısı için iki Temel Metin notu ekleyin.

Kubernetes YAML to diagram aracı mevcut manifest'leri ilk taslağa dönüştürür. Örnek 10 diagram node kullanıyor ve Free planın sınırları içinde kalıyor.

SSS

Secret yöneticisi ile KMS arasındaki fark nedir? KMS, dışarı çıkmayan anahtarları tutar ve veri anahtarları gibi küçük öğeleri şifreler. Secret yöneticisi ise parolalar ve API anahtarları gibi secret'ların kendisini saklar ve verir; çoğu zaman bir KMS ile korunur.

Kubernetes Secret'ları şifreli midir? Varsayılan olarak hayır. etcd için encryption at rest'i, tercihen KMS v2 provider ile etkinleştirin ve RBAC'i kısıtlayın: bir namespace'te Pod oluşturabilen herkes oradaki Secret'ları okuyabilir.

Dinamik secret'lar nedir? İstek üzerine oluşturulan ve lease'leri bitince silinen kimlik bilgileridir; Vault'un database secrets engine'inin her istekte oluşturduğu bir saatlik veritabanı kullanıcıları gibi.

Secret'ları ortam değişkeni olarak geçirmeli miyim? Mümkünse kaçının: konteynerdeki her süreç onları okuyabilir, loglara ve crash dump'lara sızarlar ve yalnızca yeniden başlatmayla değişirler. Agent'ın render ettiği dosyaları korumak ve döndürmek daha kolaydır.

Secret'lar ne sıklıkla döndürülmeli? Dinamik kimlik bilgilerinin süresi saatler içinde dolar ve takvime ihtiyaç duymaz. Statik secret'ları bir takvime göre, ayrıca şüpheli her ifşadan veya personel değişikliğinden sonra döndürün ve rotasyonu önce staging'de test edin.

Ücretsiz başlayın — tek kullanıcı, kredi kartı gerekmez.

İlgili yazılar

← Blog'a dön

Bir dakikada canvas açın

Google veya GitHub ile giriş yapın. Tek koltuk ücretsiz; ekip katılınca planı yükseltin.