Azure Container Apps'de gizli bilgileri yönetme

Azure Container Apps, uygulamanızın hassas yapılandırma değerlerini güvenli bir şekilde depolamasını sağlar. Gizli diziler uygulama düzeyinde tanımlandıktan sonra güvenli değerler kapsayıcı uygulamalarınızdaki düzeltmeler için kullanılabilir. Ayrıca, ölçek kuralları içinde güvenli değerlere başvurabilirsiniz. Dapr ile gizli bilgiler kullanma hakkında bilgi için Dapr tümleştirmesine bakın.

  • Uygulama kapsamındaki sırlar, uygulamanın belirli bir revizyonunun dışında yer alır.
  • Yeni düzeltmeler gizli dizi ekleme, kaldırma veya değiştirme yoluyla oluşturulmaz.
  • Her uygulama düzeltmesi bir veya birden fazla gizli bilgiye başvurabilir.
  • Birden çok revizyon aynı sırları referans alabilir.

Güncellenmiş veya silinmiş bir gizli anahtar, uygulamanızdaki mevcut düzeltmeleri otomatik olarak etkilemez. Sır güncellendiğinde veya silindiğinde, değişikliklere iki şekilde karşılık verebilirsiniz:

  1. Yeni bir revizyon dağıt.
  2. Mevcut düzeltmeyi yeniden başlatma.

Gizli bir sırrı silmeden önce, artık eski sırrı referans vermeyen yeni bir revizyon dağıtın. Ardından gizli diziye başvuran tüm düzeltmeleri devre dışı bırakın.

Sırları tanımlama

Gizli bilgiler bir dizi ad/değer çifti olarak tanımlanır. Her gizli bilginin değeri doğrudan veya Azure Key Vault'ta depolanan bir gizli bilgiye başvuru olarak belirtilir.

Not

Üretim ortamında bir gizlinin değerini doğrudan belirtmekten kaçının. Bunun yerine, Gizli değer depolama başlıklı Container Apps bölümünde açıklandığı gibi, Azure Key Vault'ta depolanan gizli bir diziye referans kullanın.

Container Apps'te gizli değeri depolama

Portal aracılığıyla veya farklı komut satırı seçenekleriyle gizli dizileri tanımlarken aşağıdakiler kullanılır.

  1. Azure portalında kapsayıcı uygulamanıza gidin.

  2. Güvenlik bölümünde Sırlar'ı seçin.

  3. Ekle'yi seçin.

  4. Sır ekle bağlam bölmesine aşağıdaki bilgileri girin:

    • Ad: Gizlinin adı.
    • Tür: Container Apps Gizli Anahtar'ı seçin.
    • Değer: Gizli anahtarın değeri.
  5. Ekle'yi seçin.

Key Vault'tan gizli öğeye referans verin

Bir gizli tanımladığınızda, Azure Key Vault'ta depolanmış bir gizliye referans oluşturursunuz. Container Apps gizli değeri Key Vault'tan otomatik olarak alır ve kapsayıcı uygulamanızda gizli olarak kullanılabilir hale getirir.

Bir Key Vault gizli öğesine başvurmak için, öncelikle kapsayıcı uygulamanızda yönetilen kimlik doğrulamayı etkinleştirmeniz ve kimliğe Key Vault'taki gizli öğelere erişim izni vermeniz gerekir.

Kapsayıcı uygulamanızda yönetilen kimliği etkinleştirmek için bkz . Yönetilen kimlikler.

Key Vault gizli dizilere erişim vermek için yönetilen kimliğe Azure RBAC rolünü Key Vault Gizli Dizi Kullanıcısı verin.

  1. Azure portalında kapsayıcı uygulamanıza gidin.

  2. Güvenlik bölümünde Kimlik'i seçin.

  3. Sistem tarafından atanan sekmesinde DurumuAçık olarak ayarlayın.

Not

Ayrıca, birden çok kaynakta yeniden kullanılabilen ve uygulama yaşam döngüsünden bağımsız olarak kalıcı olan, kullanıcı tarafından atanan yönetilen kimliği de kullanabilirsiniz. Bunu kullanmak için Kullanıcı tarafından atanan sekmesini seçin ve mevcut bir kimliği seçin.

  1. Sistem tarafından atanan yönetilen kimliği etkinleştirmek için Kaydet'i seçin.

  2. Sistem tarafından atanan yönetilen kimliği etkinleştirmek ve kapsayıcı uygulamanızı Microsoft Entra ID'ye kaydetmek istediğinizi onaylayan bir açılır pencere görüntülenir. Evet'i seçin.

  3. Güvenlik bölümünde Sırlar'ı seçin.

  4. Ekle'yi seçin.

  5. Sır ekle bağlam bölmesine aşağıdaki bilgileri girin:

    • Ad: Gizlinin adı.
    • Type: Key Vault referansı seçin.
    • Key Vault gizli URL: Key Vault'taki gizlinizin URI'si. Bu URI aşağıdaki forma sahiptir: https://<YOUR_KEY_VAULT_NAME>.vault.azure.net/secrets/<YOUR_SECRET_NAME>/<32_DIGIT_HEX_ID>
    • Kimlik: Sistem tarafından atanan'ı seçin.
  6. Ekle'yi seçin.

Not

Azure Güvenlik Duvarı ile UDR kullanıyorsanız hizmet etiketini ve login.microsoft.com FQDN'sini güvenlik duvarınızın izin verme listesine eklemeniz gerekir. hangi ek hizmet etiketlerine ihtiyacınız olduğunu belirlemek için configuring UDR ile Azure Güvenlik Duvarı bölümüne bakın.

Key Vault gizli URI'si ve gizli yenileme

Key Vault gizli dizi URI'sinin aşağıdaki biçimlerden birinde olması gerekir:

  • https://myvault.vault.azure.net/secrets/mysecret/ec96f02080254f109c51a1f14cdb1931: Bir sırrın belirli bir sürümüne başvurun.
  • https://myvault.vault.azure.net/secrets/mysecret: Gizli dizinin en son sürümüne başvurun.

URI'de bir sürüm belirtilmezse, uygulama anahtar kasasında bulunan en son sürümü kullanır. Daha yeni sürümler kullanıma sunulduğunda, uygulama 30 dakika içinde en son sürümü otomatik olarak alır. Ortam değişkeninde gizli bilgiye atıfta bulunan tüm aktif revizyonlar, yeni değeri alması için otomatik olarak yeniden başlatılır.

Gizli dizinin hangi sürümünün kullanıldığına ilişkin tam denetim için URI'deki sürümü belirtin.

Ortam değişkenlerinde gizli bilgileri kullanma

Gizli dizileri tanımlama bölümünde açıklandığı gibi uygulama düzeyinde gizli dizileri bildirdikten sonra, kapsayıcı uygulamanızda yeni bir düzeltme oluşturduğunuzda bunlara ortam değişkenlerinde başvurabilirsiniz. Ortam değişkeni bir gizli diziye başvurduğunda, değeri gizli dizide tanımlanan değerle doldurulur.

Örnek

Aşağıdaki örnekte, uygulama düzeyinde bir bağlantı dizesi bildiren bir uygulama gösterilmektedir. Bu bağlantıya kapsayıcı ortam değişkeninde ve ölçek kuralında başvurulur.

Kapsayıcı uygulamanızda bir gizli dizi tanımladıktan sonra, yeni bir düzeltme oluşturduğunuzda bir ortam değişkeninde bu gizli diziye başvurabilirsiniz.

  1. Azure portalında kapsayıcı uygulamanıza gidin.

  2. Uygulama bölümünde Düzeltmeler ve çoğaltmalar'ı seçin.

  3. Düzeltmeler ve çoğaltmalar sayfasında Yeni düzeltme oluştur'u seçin.

  4. Yeni düzenleme oluştur ve dağıt sayfasındaki Kapsayıcı sekmesinde, Kapsayıcı görüntüsü bölümünün altında bir kapsayıcı seçin.

  5. Düzenle'yi seçin.

  6. Kapsayıcı bağlamını düzenle bölmesinde Ortam değişkenleri sekmesini seçin.

  7. Ekle'yi seçin.

  8. Aşağıdaki bilgileri girin:

    • Ad: Ortam değişkeninin adı.
    • Kaynak: Gizli öğeye başvur'u seçin.
    • Değer: Daha önce tanımladığınız gizliyi seçin.
  9. Kaydet'i seçin.

  10. Yeni düzeltme oluştur ve dağıt sayfasında Oluştur'u seçerek yeni düzeltmeyi oluşturun.

Birime gizlileri monte etme

Gizli bilgileri tanımlama bölümünde açıklandığı gibi uygulama düzeyinde gizli bilgileri bildirdikten sonra, kapsayıcı uygulamanızda yeni bir revizyon oluşturduğunuzda bunlara birim bağlamaları içinde başvurabilirsiniz. Gizli dizileri bir birime bağladığınızda, her gizli dizi birime bir dosya olarak bağlanır. Dosya adı gizli dizinin adıdır ve dosya içeriği de gizli dizinin değeridir. Birim bağlantısında tüm gizli bilgileri veya belirli gizli bilgileri yükleyebilirsiniz.

Örnek

Kapsayıcı uygulamanızda bir gizli bilgi tanımladıktan sonra, yeni bir yenileme oluşturduğunuzda birim bağlamasında bu gizli bilgiye başvurabilirsiniz.

  1. Azure portalında kapsayıcı uygulamanıza gidin.

  2. Uygulama bölümünde Düzeltmeler ve çoğaltmalar'ı seçin.

  3. Düzeltmeler ve çoğaltmalar sayfasında Yeni düzeltme oluştur'u seçin.

  4. Yeni düzenleme oluştur ve dağıt sayfasındaki Kapsayıcı sekmesinde, Kapsayıcı görüntüsü bölümünün altında bir kapsayıcı seçin.

  5. Düzenle'yi seçin.

  6. Kapsayıcıyı düzenle bağlam bölmesinde, Birim bağlamaları sekmesini seçin.

  7. Yeni birim oluştur'u seçin.

  8. Birim Ekle bölmesinde şu bilgileri girin:

    • Birim türünü seçin Secret.
    • Ad: mysecrets
    • Tüm gizli anahtarları bağla: etkin

    Not

    Belirli gizli verileri yüklemek istiyorsanız, Tüm gizli verileri bağla'yı devre dışı bırakın ve yüklemek istediğiniz gizli verileri seçin.

  9. Ekle'yi seçin.

  10. Bir kapsayıcıyı düzenle bağlam bölmesinde, Birim adı altında, mysecrets öğesini seçin.

  11. "Bağlama Yolu altında, /mnt/secretsgirin."

  12. Kaydet'i seçin.

  13. Yeni düzeltme oluştur ve dağıt sayfasında, Oluştur'u seçerek birim bağlama ile yeni düzeltmeyi oluşturun.

Key Vault referans sorunlarını giderme

Azure Key Vault'tan gizli anahtarlara başvurduğunuzda, gizli anahtarları geri alma veya eşitleme sürecinde sorunlarla karşılaşabilirsiniz. Yaygın hatalar ve çözümler şunlardır:

Error Nedeni Çözünürlük
Yönetilen kimlik etkinleştirilmedi Kapsayıcı uygulamasına yönetilen bir kimlik atanmadı. Kapsayıcı uygulamanızda sistem tarafından atanan veya kullanıcı tarafından atanan yönetilen kimliği etkinleştirin. Yönetilen kimlikler bölümünü inceleyin.
Kimlik bulunamadı Belirtilen yönetilen kimlik mevcut değil veya kapsayıcı uygulamaya atanmadı. Kimlik bölümünde kimliğin oluşturulduğunu ve kapsayıcı uygulamasına atandığını doğrulayın.
Gizli Key Vault'ta devre dışı Gizli, Key Vault kaynağında devre dışı bırakıldı. Azure portalında Anahtar Kasası'na gidin ve gizli anahtarı etkinleştirin.
Kimlik doğrulaması başarısız oldu Yönetilen kimlikte gizli bilgiyi okumak için gerekli izinler yok. Key Vault yönetilen kimliğe Key Vault Gizli Dizi Kullanıcısı rolünü verin. Bkz. Key Vault Gizli Kullanıcısı.
RBAC izni reddedildi Yönetilen kimlik, Key Vault'a erişmek için yeterli izinlere sahip değil. Key Vault üzerinde RBAC rolü atamasını doğrulayın ve sırlar için okuma yetkilerini içerdiğinden emin olunuz.

Sonraki adımlar