API Management の認証ポリシーAPI Management authentication policies

このトピックでは、次の API Management ポリシーについて説明します。This topic provides a reference for the following API Management policies. ポリシーを追加および構成する方法については、「 Azure API Management のポリシー」をご覧ください。For information on adding and configuring policies, see Policies in API Management.

認証ポリシーAuthentication policies

基本認証Authenticate with Basic

authentication-basic ポリシーを使用し、基本認証を使用してバックエンド サービスで認証します。Use the authentication-basic policy to authenticate with a backend service using Basic authentication. このポリシーでは、HTTP 承認ヘッダーが、ポリシーに指定された資格情報に対応する値に効率よく設定されます。This policy effectively sets the HTTP Authorization header to the value corresponding to the credentials provided in the policy.

ポリシー ステートメントPolicy statement

<authentication-basic username="username" password="password" />  

Example

<authentication-basic username="testuser" password="testpassword" />  

要素Elements

NameName 説明Description 必須Required
authentication-basicauthentication-basic ルート要素。Root element. [はい]Yes

属性Attributes

NameName 説明Description 必須Required 既定値Default
usernameusername 基本認証の資格情報のユーザー名を指定します。Specifies the username of the Basic credential. [はい]Yes 該当なしN/A
passwordpassword 基本認証の資格情報のパスワードを指定します。Specifies the password of the Basic credential. [はい]Yes 該当なしN/A

使用法Usage

このポリシーは、次のポリシー セクションスコープで使用できます。This policy can be used in the following policy sections and scopes.

  • ポリシー セクション: inboundPolicy sections: inbound

  • ポリシー スコープ: APIPolicy scopes: API

クライアント証明書による認証Authenticate with client certificate

authentication-certificate ポリシーを使用し、クライアント証明書を使用してバックエンド サービスで認証します。Use the authentication-certificate policy to authenticate with a backend service using client certificate. 証明書は最初に API Management にインストールする必要があります。サムプリントによって識別されます。The certificate needs to be installed into API Management first and is identified by its thumbprint.

ポリシー ステートメントPolicy statement

<authentication-certificate thumbprint="thumbprint" />  

Example

<authentication-certificate thumbprint="....." />  

要素Elements

NameName 説明Description 必須Required
authentication-certificateauthentication-certificate ルート要素。Root element. [はい]Yes

属性Attributes

NameName 説明Description 必須Required 既定値Default
thumbprintthumbprint クライアント証明書のサムプリント。The thumbprint for the client certificate. [はい]Yes 該当なしN/A

使用法Usage

このポリシーは、次のポリシー セクションスコープで使用できます。This policy can be used in the following policy sections and scopes.

  • ポリシー セクション: inboundPolicy sections: inbound

  • ポリシー スコープ: APIPolicy scopes: API

次の手順Next steps

ポリシーを使用する方法の詳細については、次のトピックを参照してください。For more information working with policies, see: