Uwierzytelnij za pomocą certyfikatu klienta

  • Artykuł

DOTYCZY: Wszystkie warstwy usługi API Management

authentication-certificate Użyj zasad, aby uwierzytelnić się za pomocą usługi zaplecza przy użyciu certyfikatu klienta. Po zainstalowaniu certyfikatu w usłudze API Management najpierw zidentyfikuj go przy użyciu odcisku palca lub identyfikatora certyfikatu (nazwy zasobu).

Uwaga

Jeśli certyfikat odwołuje się do certyfikatu przechowywanego w usłudze Azure Key Vault, zidentyfikuj go przy użyciu identyfikatora certyfikatu. Po obróceniu certyfikatu magazynu kluczy jego odcisk palca w usłudze API Management zmieni się, a zasady nie rozpoznają nowego certyfikatu, jeśli zostanie zidentyfikowany przy użyciu odcisku palca.

Uwaga

Ustaw elementy zasad i elementy podrzędne w kolejności podanej w instrukcji zasad. Dowiedz się więcej na temat ustawiania lub edytowania zasad usługi API Management.

Instrukcja zasad

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

Atrybuty

Atrybut opis Wymagani Wartość domyślna
Odcisk palca Odcisk palca certyfikatu klienta. Wyrażenia zasad są dozwolone. Albo thumbprint albo certificate-id może być obecny. Nie dotyczy
identyfikator certyfikatu Nazwa zasobu certyfikatu. Wyrażenia zasad są dozwolone. Albo thumbprint albo certificate-id może być obecny. Nie dotyczy
treść Certyfikat klienta jako tablica bajtów. Użyj polecenia , jeśli certyfikat nie został pobrany z wbudowanego magazynu certyfikatów. Wyrażenia zasad są dozwolone. Nie. Nie dotyczy
hasło Hasło certyfikatu klienta. Wyrażenia zasad są dozwolone. Użyj opcji , jeśli certyfikat określony w elemecie body jest chroniony hasłem. Nie dotyczy

Użycie

Przykłady

Certyfikat klienta zidentyfikowany przez identyfikator certyfikatu

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

Certyfikat klienta zidentyfikowany przez odcisk palca

<authentication-certificate thumbprint="CA06F56B258B7A0D4F2B05470939478651151984" />

Certyfikat klienta ustawiony w zasadach, a nie pobrany z wbudowanego magazynu certyfikatów

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

Powiązana zawartość

Aby uzyskać więcej informacji na temat pracy z zasadami, zobacz: