Megosztás a következőn keresztül:


Titkos kódok kezelése az Azure Container Appsben

Az Azure Container Apps lehetővé teszi, hogy az alkalmazás biztonságosan tárolja a bizalmas konfigurációs értékeket. Miután a titkos kulcsokat az alkalmazás szintjén definiálta, biztonságos értékek érhetők el a tárolóalkalmazások korrektúrái számára. Emellett a skálázási szabályokon belül hivatkozhat a védett értékekre. A titkos kódok Daprvel való használatáról további információt a Dapr-integrációban talál.

  • A titkos kódok az alkalmazás hatókörén belül érvényesek, az alkalmazás bármely meghatározott verzióján kívül.
  • Az új változatok nem jönnek létre titkos kódok hozzáadásával, eltávolításával vagy módosításával.
  • Az egyes alkalmazásváltozatok egy vagy több titkos kódra mutató hivatkozást tartalmazhatnak.
  • Több változat is tartalmazhat ugyanarra/ugyanazokra a titkos kód(ok)ra mutató hivatkozást.

A frissített vagy törölt titkos kódok nem befolyásolják automatikusan az alkalmazás meglévő változatait. Egy titkos kód frissítésekor vagy törlésekor fellépő változásokra az alábbi két módszer egyikével reagálhat:

  1. Új változatot helyezhet üzembe.
  2. Újraindíthat egy meglévő változatot.

A titkos kód törlése előtt helyezzen üzembe egy új változatot, amely nem tartalmaz hivatkozást a régi kódra. Ezután inaktiválja a titkos kódra hivatkozó összes változatot.

Titkos kódok definiálása

A titkos kulcsok név-érték párok halmazaként vannak definiálva. Az egyes titkos kódok értéke közvetlenül vagy az Azure Key Vaultban tárolt titkos kódra való hivatkozásként van megadva.

Feljegyzés

Ne adja meg a titkos kód értékét közvetlenül éles környezetben. Ehelyett használjon egy, az Azure Key Vaultban tárolt titkos kódra mutató hivatkozást a Tárolóalkalmazások szakaszban található Titkos kulcsok tárolása szakaszban leírtak szerint.

Titkos kód értékének tárolása a Container Appsben

Ha titkos kulcsokat határoz meg a portálon vagy különböző parancssori beállításokon keresztül.

  1. Nyissa meg a tárolóalkalmazást az Azure Portalon.

  2. A Beállítások szakaszban válassza a Titkos kulcsok lehetőséget.

  3. Válassza a Hozzáadás lehetőséget.

  4. A Titkos kód hozzáadása panelen adja meg a következő információkat:

    • Név: A titkos kód neve.
    • Típus: Válassza ki a Container Apps titkos kulcsát.
    • Érték: A titkos kód értéke.
  5. Válassza a Hozzáadás lehetőséget.

Titkos kulcs hivatkozása a Key Vaultból

Titkos kulcs definiálásakor egy, az Azure Key Vaultban tárolt titkos kódra mutató hivatkozást hoz létre. A Container Apps automatikusan lekéri a titkos kulcsot a Key Vaultból, és titkos kódként elérhetővé teszi a tárolóalkalmazásban.

A Key Vault titkos kulcsára való hivatkozáshoz először engedélyeznie kell a felügyelt identitást a tárolóalkalmazásban, és hozzáférést kell adnia az identitásnak a Key Vault titkos kulcsaihoz.

Ha engedélyezni szeretné a felügyelt identitást a tárolóalkalmazásban, olvassa el a Felügyelt identitások című témakört.

A Key Vault titkokhoz való hozzáférés biztosításához rendelje hozzá a felügyelt identitáshoz az Azure RBAC-szerepkör Key Vault Secret User-t.

  1. Nyissa meg a tárolóalkalmazást az Azure Portalon.

  2. A Beállítások szakaszban válassza az Identitás lehetőséget.

  3. A Rendszer által hozzárendelt lapon állítsa be az állapotot Be értékre.

Feljegyzés

Használhat felhasználó által hozzárendelt felügyelt identitást is, amely több erőforráson is újra felhasználható, és az alkalmazás életciklusától függetlenül megmarad. A használatához válassza a Felhasználó által hozzárendelt lapot, és válasszon ki egy meglévő identitást.

  1. Válassza a Mentés lehetőséget a rendszer által hozzárendelt felügyelt identitás engedélyezéséhez.

  2. Megjelenik egy előugró ablak, amely megerősíti, hogy engedélyezni szeretné a rendszer által hozzárendelt felügyelt identitást, és regisztrálja a tárolóalkalmazást a Microsoft Entra-azonosítóval. Válassza az Igen lehetőséget.

  3. A Beállítások szakaszban válassza a Titkos kulcsok lehetőséget.

  4. Válassza a Hozzáadás lehetőséget.

  5. A Titkos kód hozzáadása panelen adja meg a következő információkat:

    • Név: A titkos kód neve.
    • Típus: Válassza ki a Key Vault referenciát.
    • Key Vault titkos URL-címe: A titkos kulcs URI-ja a Key Vaultban. Ez az URI a következő űrlapot tartalmazza: https://<YOUR_KEY_VAULT_NAME>.vault.azure.net/secrets/<YOUR_SECRET_NAME>/<32_DIGIT_HEX_ID>
    • Identitás: Válassza ki a hozzárendelt rendszert.
  6. Válassza a Hozzáadás lehetőséget.

Feljegyzés

Ha az UDR-t az Azure Firewall használatával használja, hozzá kell adnia a szolgáltatáscímkét és a AzureKeyVault teljes tartománynevet a tűzfal engedélyezési listájához. Az UDR és az Azure Firewall konfigurálásával eldöntheti, hogy mely további szolgáltatáscímkékre van szüksége.

Key Vault titkos URI és titkos kulcsok rotálása

A Key Vault titkos URI-jának az alábbi formátumok egyikében kell lennie:

  • https://myvault.vault.azure.net/secrets/mysecret/ec96f02080254f109c51a1f14cdb1931: Hivatkozás egy titkos kód egy adott verziójára.
  • https://myvault.vault.azure.net/secrets/mysecret: Hivatkozás egy titkos kód legújabb verziójára.

Ha nincs megadva verzió az URI-ban, akkor az alkalmazás a key vaultban található legújabb verziót használja. Az újabb verziók elérhetővé válása után az alkalmazás 30 percen belül automatikusan lekéri a legújabb verziót. A környezeti változó titkos kódjára hivatkozó aktív változatok automatikusan újraindulnak az új érték felvételéhez.

A titkos kódok melyik verziójának teljes vezérléséhez adja meg a verziót az URI-ban.

Titkos kódok hivatkozása környezeti változókban

Miután az alkalmazás szintjén deklarálta a titkos kulcsokat a definiáló titkos kódok szakaszban leírtak szerint, környezeti változókban hivatkozhat rájuk, amikor új változatot hoz létre a tárolóalkalmazásban. Amikor egy környezeti változó egy titkos kódra hivatkozik, annak értéke a titkos kódban meghatározott értékkel lesz feltöltve.

Példa

Az alábbi példa egy olyan alkalmazást mutat be, amely az alkalmazás szintjén deklarál egy kapcsolati sztring. Erre a kapcsolatra egy tárolókörnyezet változója és egy méretezési szabály hivatkozik.

Miután definiált egy titkos kulcsot a tárolóalkalmazásban, hivatkozhat rá egy környezeti változóban, amikor új változatot hoz létre.

  1. Nyissa meg a tárolóalkalmazást az Azure Portalon.

  2. Az Alkalmazás szakaszban válassza a Változatok és replikák lehetőséget.

  3. A Változatok és replikák lapon válassza az Új változat létrehozása lehetőséget.

  4. Az Új változat létrehozása és üzembe helyezése lapon, a Tároló lap Tároló lemezkép szakaszában válasszon ki egy tárolót.

  5. Válassza a Szerkesztés lehetőséget.

  6. A Tárolókörnyezet szerkesztése panelen válassza a Környezeti változók lapot.

  7. Válassza a Hozzáadás lehetőséget.

  8. Adja meg a következő adatokat:

    • Név: A környezeti változó neve.
    • Forrás: Válassza a Hivatkozás egy titkos kódra lehetőséget.
    • Érték: Válassza ki a korábban definiált titkos kódot.
  9. Válassza a Mentés lehetőséget.

  10. Az Új változat létrehozása és üzembe helyezése lapon válassza a Létrehozás lehetőséget az új változat létrehozásához.

Titkos kódok csatlakoztatása kötetben

Miután az alkalmazás szintjén deklarálta a titkos kulcsokat a definiáló titkos kódok szakaszban leírtak szerint, kötetcsatlakozásokban hivatkozhat rájuk, amikor új változatot hoz létre a tárolóalkalmazásban. Amikor titkos kulcsokat csatlakoztat egy kötethez, minden titkos kód fájlként van csatlakoztatva a kötethez. A fájlnév a titkos kód neve, a fájl tartalma pedig a titkos kód értéke. Betöltheti az összes titkos elemet egy kötetcsatlakoztatásban, vagy betölthet bizonyos titkos kulcsokat.

Példa

Miután definiált egy titkos kulcsot a tárolóalkalmazásban, egy kötetcsatlakozásban hivatkozhat rá egy új változat létrehozásakor.

  1. Nyissa meg a tárolóalkalmazást az Azure Portalon.

  2. Az Alkalmazás szakaszban válassza a Változatok és replikák lehetőséget.

  3. A Változatok és replikák lapon válassza az Új változat létrehozása lehetőséget.

  4. Az Új változat létrehozása és üzembe helyezése lapon, a Tároló lap Tároló lemezkép szakaszában válasszon ki egy tárolót.

  5. Válassza a Szerkesztés lehetőséget.

  6. A Tárolókörnyezet szerkesztése panelen válassza a Kötet csatlakoztatása lapot.

  7. Válassza az Új kötet létrehozása lehetőséget.

  8. A Kötet hozzáadása panelen adja meg a következő adatokat:

    • Kötet típusa: Válassza a lehetőséget Secret.
    • Név: mysecrets
    • Az összes titkos kód csatlakoztatása: engedélyezve

    Feljegyzés

    Ha konkrét titkos kulcsokat szeretne betölteni, tiltsa le az összes titkos kulcs csatlakoztatását, és válassza ki a betölteni kívánt titkos kulcsokat.

  9. Válassza a Hozzáadás lehetőséget.

  10. A Tárolókörnyezet szerkesztése panel Kötet neve területén válassza ki a mysecrets elemet.

  11. A csatlakoztatási útvonal alatt adja meg a kívánt értéket/mnt/secrets.

  12. Válassza a Mentés lehetőséget.

  13. Az új változat létrehozása és üzembe helyezése lapon válassza a Létrehozás lehetőséget az új változat kötet csatlakoztatásával történő létrehozásához.

Következő lépések