Verifiëren met clientcertificaat

  • Artikel

VAN TOEPASSING OP: Alle API Management-lagen

Gebruik het authentication-certificate beleid om te verifiëren met een back-endservice met behulp van een clientcertificaat. Wanneer het certificaat eerst in API Management is geïnstalleerd, identificeert u het eerst met de vingerafdruk of certificaat-id (resourcenaam).

Let op

Als het certificaat verwijst naar een certificaat dat is opgeslagen in Azure Key Vault, identificeert u het met behulp van de certificaat-id. Wanneer een sleutelkluiscertificaat wordt geroteerd, wordt de vingerafdruk in API Management gewijzigd en wordt het nieuwe certificaat niet omgezet als het wordt geïdentificeerd met vingerafdruk.

Notitie

Stel de elementen en onderliggende elementen van het beleid in de volgorde in die in de beleidsverklaring is opgegeven. Meer informatie over het instellen of bewerken van API Management-beleid.

Beleidsinstructie

<authentication-certificate thumbprint="thumbprint" certificate-id="resource name" body="certificate byte array" password="optional password"/>

Kenmerken

Kenmerk Beschrijving Vereist Standaardinstelling
Vingerafdruk De vingerafdruk voor het clientcertificaat. Beleidsexpressies zijn toegestaan. certificate-id Of thumbprint kan aanwezig zijn. N.v.t.
certificaat-id De naam van de certificaatresource. Beleidsexpressies zijn toegestaan. certificate-id Of thumbprint kan aanwezig zijn. N.v.t.
hoofdtekst Clientcertificaat als bytematrix. Gebruik dit certificaat als het certificaat niet wordt opgehaald uit het ingebouwde certificaatarchief. Beleidsexpressies zijn toegestaan. Nee N.v.t.
password Wachtwoord voor het clientcertificaat. Beleidsexpressies zijn toegestaan. Gebruik het certificaat dat is opgegeven in body is beveiligd met een wachtwoord. N.v.t.

Gebruik

Voorbeelden

Clientcertificaat geïdentificeerd door de certificaat-id

<authentication-certificate certificate-id="544fe9ddf3b8f30fb490d90f" />

Clientcertificaat geïdentificeerd door vingerafdruk

<authentication-certificate thumbprint="CA06F56B258B7A0D4F2B05470939478651151984" />

Clientcertificaat ingesteld in het beleid in plaats van opgehaald uit het ingebouwde certificaatarchief

<authentication-certificate body="@(context.Variables.GetValueOrDefault<byte[]>("byteCertificate"))" password="optional-certificate-password" />

Gerelateerde inhoud

Zie voor meer informatie over het werken met beleid: