Aracılığıyla paylaş

İstemci sertifikası ile kimlik doğrulama

  • Makale

UYGULANANLAR: Tüm API Management katmanları

İstemci sertifikası kullanarak arka uç hizmetiyle kimlik doğrulaması yapmak için ilkeyi authentication-certificate kullanın. Sertifika önce API Management'a yüklendiğinde, önce parmak izi veya sertifika kimliği (kaynak adı) ile tanımlayın.

Dikkat

Sertifika Azure Key Vault'ta depolanan bir sertifikaya başvuruyorsa sertifika kimliğini kullanarak sertifikayı tanımlayın. Anahtar kasası sertifikası döndürüldüğünde API Management'taki parmak izi değişir ve parmak iziyle tanımlanırsa ilke yeni sertifikayı çözümlemez.

Not

İlkenin öğelerini ve alt öğelerini ilke bildiriminde sağlanan sırayla ayarlayın. API Management ilkelerini ayarlama veya düzenleme hakkında daha fazla bilgi edinin.

İlke bildirimi

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

Özellikler

Öznitelik Açıklama Zorunlu Varsayılan
Parmak izi İstemci sertifikasının parmak izi. İlke ifadelerine izin verilir. Ya da thumbprint certificate-id mevcut olabilir. Yok
sertifika kimliği Sertifika kaynak adı. İlke ifadelerine izin verilir. Ya da thumbprint certificate-id mevcut olabilir. Yok
gövde Bayt dizisi olarak istemci sertifikası. Sertifika yerleşik sertifika deposundan alınmazsa kullanın. İlke ifadelerine izin verilir. Hayır YOK
password İstemci sertifikasının parolası. İlke ifadelerine izin verilir. içinde body belirtilen sertifika parola korumalıysa kullanın. Yok

Kullanım

Örnekler

Sertifika kimliğiyle tanımlanan istemci sertifikası

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

Parmak iziyle tanımlanan istemci sertifikası

<authentication-certificate thumbprint="CA06F56B258B7A0D4F2B05470939478651151984" />

yerleşik sertifika deposundan alınmak yerine ilkede ayarlanan istemci sertifikası

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

İlgili içerik

İlkelerle çalışma hakkında daha fazla bilgi için bkz: