Háttérszolgáltatások védelme ügyféltanúsítvány-hitelesítéssel az Azure API Managementben
A KÖVETKEZŐRE VONATKOZIK: Minden API Management-szint
Az API Management lehetővé teszi az API háttérszolgáltatásához való hozzáférést ügyféltanúsítványok és kölcsönös TLS-hitelesítés használatával. Ez az útmutató bemutatja, hogyan kezelheti a tanúsítványokat egy Azure API Management szolgáltatáspéldányban az Azure Portal használatával. Azt is ismerteti, hogyan konfigurálhat egy API-t úgy, hogy tanúsítványt használjon egy háttérszolgáltatás eléréséhez.
Az API Management REST API használatával is kezelheti az API Management-tanúsítványokat.
Tanúsítványbeállítások
Az API Management két lehetőséget kínál a háttérszolgáltatásokhoz való hozzáférés biztonságossá tételéhez használt tanúsítványok kezelésére:
- Az Azure Key Vaultban felügyelt tanúsítványra való hivatkozás
- Tanúsítványfájl hozzáadása közvetlenül az API Managementben
A Key Vault-tanúsítványok használata azért ajánlott, mert segít az API Management biztonságának javításában:
- A kulcstartókban tárolt tanúsítványok a szolgáltatások között újra felhasználhatók
- Részletes hozzáférési szabályzatok alkalmazhatók a kulcstartókban tárolt tanúsítványokra
- A kulcstartóban frissített tanúsítványok automatikusan el lesznek forgatva az API Managementben. A key vault frissítése után az API Management tanúsítványa 4 órán belül frissül. Manuálisan is frissítheti a tanúsítványt az Azure Portalon vagy a felügyeleti REST API-val.
Előfeltételek
Feljegyzés
Javasoljuk, hogy az Azure Az PowerShell modult használja az Azure-ral való interakcióhoz. Első lépésként tekintse meg az Azure PowerShell telepítését ismertető témakört. Az Az PowerShell-modulra történő migrálás részleteiről lásd: Az Azure PowerShell migrálása az AzureRM modulból az Az modulba.
Ha még nem hozott létre API Management szolgáltatáspéldányt, olvassa el az API Management szolgáltatáspéldány létrehozása című témakört.
Az ügyféltanúsítvány-hitelesítéshez konfigurálnia kell a háttérszolgáltatást. A tanúsítványhitelesítés Azure-alkalmazás szolgáltatásban való konfigurálásához tekintse meg ezt a cikket.
Hozzá kell férnie a tanúsítványhoz és a jelszóhoz egy Azure-kulcstartóban való felügyelethez, vagy fel kell töltenie az API Management szolgáltatásba. A tanúsítványnak PFX formátumban kell lennie. Önaláírt tanúsítványok engedélyezettek.
Ha önaláírt tanúsítványt használ:
Telepítse a megbízható legfelső szintű és köztes hitelesítésszolgáltatói tanúsítványokat az API Management-példányban.
Feljegyzés
A hitelesítésszolgáltatói tanúsítványok a tanúsítványérvényesítéshez nem támogatottak a használatszinten.
A Key Vault integrációjának előfeltételei
Ha még nincs kulcstartója, hozzon létre egyet. A kulcstartó létrehozásának lépéseit a rövid útmutatóban találja : Kulcstartó létrehozása az Azure Portal használatával.
A tanúsítvány kulcstartóba való létrehozásához vagy importálásához tekintse meg a következő rövid útmutatót: Tanúsítvány beállítása és lekérése az Azure Key Vaultból az Azure Portal használatával.
Engedélyezze a rendszer által hozzárendelt vagy felhasználó által hozzárendelt felügyelt identitást az API Management-példányban.
A Key Vaulthoz való hozzáférés konfigurálása
A portálon keresse meg a kulcstartót.
A bal oldali menüben válassza az Access-konfigurációt, és jegyezze fel a konfigurált engedélymodellt.
Az engedélymodelltől függően konfiguráljon kulcstartó-hozzáférési szabályzatot vagy Azure RBAC-hozzáférést egy API Management által felügyelt identitáshoz.
Kulcstartó hozzáférési szabályzatának hozzáadása:
- A bal oldali menüben válassza az Access-szabályzatok lehetőséget.
- Az Access-szabályzatok lapon válassza a + Létrehozás lehetőséget.
- Az Engedélyek lap Titkos engedélyek csoportjában válassza a Beolvasás és a Lista lehetőséget, majd a Tovább gombot.
- Az Egyszerű lapon válassza ki az egyszerű nevet, keresse meg a felügyelt identitás erőforrásnevét, majd válassza a Tovább gombot. Ha rendszer által hozzárendelt identitást használ, az egyszerű az API Management-példány neve.
- Kattintson ismét a Tovább gombra. A Véleményezés + létrehozás lapon válassza a Létrehozás lehetőséget.
Az Azure RBAC-hozzáférés konfigurálása:
- A bal oldali menüben válassza a Hozzáférés-vezérlés (IAM) lehetőséget.
- A Hozzáférés-vezérlés (IAM) lapon válassza a Szerepkör-hozzárendelés hozzáadása lehetőséget.
- A Szerepkör lapon válassza a Key Vault tanúsítványfelhasználója lehetőséget.
- A Tagok lapon válassza a Felügyelt identitás>+ Tagok kijelölése lehetőséget.
- A Felügyelt identitás kiválasztása lapon válassza ki a rendszer által hozzárendelt felügyelt identitást vagy az API Management-példányhoz társított felhasználó által hozzárendelt felügyelt identitást, majd válassza a Kiválasztás lehetőséget.
- Válassza az Áttekintés + hozzárendelés lehetőséget.
A Key Vault tűzfalának követelményei
Ha a Key Vault tűzfala engedélyezve van a kulcstartón, a következő további követelmények teljesülnek:
A kulcstartó eléréséhez az API Management-példány rendszer által hozzárendelt felügyelt identitását kell használnia.
A Key Vault tűzfalában engedélyezze a Megbízható Microsoft-szolgáltatások engedélyezését a tűzfal lehetőség megkerüléséhez.
Győződjön meg arról, hogy a helyi ügyfél IP-címe átmenetileg hozzáférhet a kulcstartóhoz, miközben kiválaszt egy tanúsítványt vagy titkos kulcsot, amelyet fel szeretne adni az Azure API Managementbe. További információ: Az Azure Key Vault hálózati beállításainak konfigurálása.
A konfiguráció befejezése után letilthatja az ügyfél címét a Key Vault tűzfalán.
A virtuális hálózatra vonatkozó követelmények
Ha az API Management-példány virtuális hálózaton van üzembe helyezve, konfigurálja a következő hálózati beállításokat is:
- Szolgáltatásvégpont engedélyezése az Azure Key Vaultban az API Management alhálózaton.
- Konfiguráljon egy hálózati biztonsági csoportot (NSG- szabályt) az AzureKeyVault és az AzureActiveDirectory szolgáltatáscímkék kimenő forgalmának engedélyezéséhez.
További információ: Hálózati konfiguráció az Azure API Management virtuális hálózaton való beállításakor.
Key Vault-tanúsítvány hozzáadása
Tekintse meg a Key Vault integrációjának előfeltételeit.
Fontos
Amikor kulcstartó-tanúsítványt ad hozzá az API Management-példányhoz, rendelkeznie kell a kulcstartó titkos kulcsainak listázásához szükséges engedélyekkel.
Figyelemfelhívás
Ha key vault-tanúsítványt használ az API Managementben, ügyeljen arra, hogy ne törölje a kulcstartó eléréséhez használt tanúsítványt, kulcstartót vagy felügyelt identitást.
Key Vault-tanúsítvány hozzáadása az API Managementhez:
Az Azure Portalon keresse meg az API Management-példányt.
A Biztonság területen válassza a Tanúsítványok lehetőséget.
Válassza a Tanúsítványok>+ Hozzáadás lehetőséget.
Az Azonosító mezőben adjon meg egy tetszőleges nevet.
A Tanúsítvány területen válassza a Key Vault lehetőséget.
Adja meg egy kulcstartó-tanúsítvány azonosítóját, vagy válassza a Kiválasztás lehetőséget egy tanúsítvány kulcstartóból való kiválasztásához.
Fontos
Ha saját maga adja meg a key vault tanúsítványazonosítóját, győződjön meg arról, hogy nem rendelkezik verzióinformációval. Ellenkező esetben a tanúsítvány nem forog automatikusan az API Managementben a kulcstartó frissítését követően.
Az ügyfélidentitásban válasszon ki egy rendszer által hozzárendelt vagy egy meglévő, felhasználó által hozzárendelt felügyelt identitást. Megtudhatja, hogyan vehet fel vagy módosíthat felügyelt identitásokat az API Management szolgáltatásban.
Feljegyzés
Az identitásnak engedélyekre van szüksége a tanúsítvány kulcstartóból való lekéréséhez és listázásához. Ha még nem konfigurálta a kulcstartóhoz való hozzáférést, az API Management kéri, hogy automatikusan konfigurálhassa az identitást a szükséges engedélyekkel.
Válassza a Hozzáadás lehetőséget.
Válassza a Mentés lehetőséget.
Tanúsítvány feltöltése
Ügyféltanúsítvány feltöltése az API Managementbe:
Az Azure Portalon keresse meg az API Management-példányt.
A Biztonság területen válassza a Tanúsítványok lehetőséget.
Válassza a Tanúsítványok>+ Hozzáadás lehetőséget.
Az Azonosító mezőben adjon meg egy tetszőleges nevet.
A Tanúsítvány területen válassza az Egyéni lehetőséget.
Tallózással válassza ki a tanúsítvány .pfx fájlját, és adja meg a jelszavát.
Válassza a Hozzáadás lehetőséget.
Válassza a Mentés lehetőséget.
A tanúsítvány feltöltése után megjelenik a Tanúsítványok ablakban. Ha sok tanúsítványsal rendelkezik, jegyezze fel a kívánt tanúsítvány ujjlenyomatát annak érdekében, hogy egy API-t ügyféltanúsítvány használatára konfiguráljon az átjáróhitelesítéshez.
API konfigurálása ügyféltanúsítvány használatára átjáróhitelesítéshez
Az Azure Portalon keresse meg az API Management-példányt.
Az API-k alatt válassza az API-kat.
Válasszon egy API-t a listából.
A Tervezés lapon válassza a Szerkesztő ikont a Háttér szakaszban.
Az átjáró hitelesítő adatai között válassza az Ügyféltanúsítvány lehetőséget , és válassza ki a tanúsítványt a legördülő listából.
Válassza a Mentés lehetőséget.
Figyelemfelhívás
Ez a módosítás azonnal érvénybe lép, és az API műveleteinek hívásai a tanúsítványt használják a háttérkiszolgálón való hitelesítéshez.
Tipp.
Ha egy API háttérszolgáltatásának átjáróhitelesítéséhez tanúsítványt ad meg, az az API szabályzatának részévé válik, és megtekinthető a szabályzatszerkesztőben.
Tanúsítványlánc érvényesítésének letiltása önaláírt tanúsítványok esetén
Ha önaláírt tanúsítványokat használ, le kell tiltania a tanúsítványlánc érvényesítését az API Management számára a háttérrendszerrel való kommunikációhoz. Ellenkező esetben egy 500-os hibakódot ad vissza. Ennek konfigurálásához használhatja az New-AzApiManagementBackend
(új háttérrendszerhez) vagy Set-AzApiManagementBackend
(meglévő háttérrendszerhez) PowerShell-parancsmagokat, és beállíthatja a paramétert a -SkipCertificateChainValidation
következőre True
.
$context = New-AzApiManagementContext -resourcegroup 'ContosoResourceGroup' -servicename 'ContosoAPIMService'
New-AzApiManagementBackend -Context $context -Url 'https://contoso.com/myapi' -Protocol http -SkipCertificateChainValidation $true
A tanúsítványlánc érvényesítését a háttérbeli REST API-val is letilthatja.
Ügyféltanúsítvány törlése
Ha törölni szeretne egy tanúsítványt, jelölje ki, majd válassza a Törlés lehetőséget a helyi menüben (...).
Fontos
Ha a tanúsítványra bármilyen szabályzat hivatkozik, megjelenik egy figyelmeztető képernyő. A tanúsítvány törléséhez először el kell távolítania a tanúsítványt a használatára konfigurált szabályzatokból.
Következő lépések
- API-k biztonságossá tétele ügyféltanúsítvány-alapú hitelesítéssel az API Managementben
- Egyéni hitelesítésszolgáltatói tanúsítvány hozzáadása az Azure API Managementben
- Tudnivalók az API Management szabályzatairól
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: