IConfidentialClientApplication インターフェイス

定義

名前空間:: Microsoft.Identity.Client

アセンブリ:: Microsoft.Identity.Client.dll

パッケージ:: Microsoft.Identity.Client v4.84.2

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

機密クライアントアプリケーション (Web アプリ、Web API、デーモンアプリケーション) を表します。

public interface IConfidentialClientApplication : Microsoft.Identity.Client.IByUserFederatedIdentityCredential, Microsoft.Identity.Client.IClientApplicationBase

type IConfidentialClientApplication = interface
    interface IClientApplicationBase
    interface IApplicationBase
    interface IByUserFederatedIdentityCredential

Public Interface IConfidentialClientApplication
Implements IByUserFederatedIdentityCredential, IClientApplicationBase

派生: Microsoft.Identity.Client.ConfidentialClientApplication

実装: IApplicationBase IByUserFederatedIdentityCredential IClientApplicationBase

注釈

機密クライアントアプリケーションは、通常、サーバー (Web アプリ、Web API、さらにはサービス/デーモンアプリケーション) で実行されるアプリケーションです。アクセスが困難であると見なされるため、アプリケーションシークレットを保持できます (これらの値をエンドユーザーが抽出するのが困難であるため、構成時のシークレットを保持します)。 Web アプリは、最も一般的な機密クライアントです。クライアント ID は Web ブラウザーを介して公開されますが、シークレットはバックチャネルでのみ渡され、直接公開されることはありません。詳細については、「クライアントアプリケーション」を参照してください。

プロパティ

名前	説明
AppConfig	デバッグ目的での ClientApplication の構成の詳細。 (継承元 IClientApplicationBase)
AppTokenCache	このアプリケーションのアクセストークンを保持するアプリケーショントークンキャッシュ。これは、呼び出し時にサイレントで維持および更新されます AcquireTokenForClient(IEnumerable<String>)
Authority	MSAL.NET がセキュリティトークンを取得する機関の URL、またはセキュリティトークンサービス (STS) を取得します。このプロパティの戻り値は、アプリケーションのコンストラクターで開発者が指定した値か、それ以外の場合は Microsoft.Identity.Client.ApplicationBase.DefaultAuthority 静的メンバーの値 ( `https://login.microsoftonline.com/common/`) です。 (継承元 IClientApplicationBase)
UserTokenCache	アカウントの ID トークン、アクセストークン、更新トークンを保持するユーザートークンキャッシュ。 AcquireTokenSilent(IEnumerable<String>, IAccount)を呼び出すときに必要に応じてサイレントモードで使用および更新されます。アプリケーションキャッシュのみを使用するAcquireTokenForClient(IEnumerable<String>)を除き、各取得トークンメソッドによって更新されます (AppTokenCacheを参照)。 (継承元 IClientApplicationBase)

メソッド

名前	説明
AcquireTokenByAuthorizationCode(IEnumerable<String>, String)	OAuth 2.0 認証コードフローを使用して ID プロバイダーから以前に受信した承認コードを使用して、アプリで構成された機関からトークンを取得します。承認コードフローを参照してください。このフローは通常、ユーザーをサインインさせ、承認コードを要求できる Web アプリ (ASP.NET や ASP.NET Core Web アプリなど) で使用されます。このメソッドはトークンキャッシュを検索しませんが、結果を格納します。このメソッドを呼び出す前に、 AcquireTokenSilent(IEnumerable<String>, IAccount) などの他のメソッドを使用してトークンキャッシュを確認します。
AcquireTokenByUserFederatedIdentityCredential(IEnumerable<String>, Guid, String)	フェデレーション ID 資格情報アサーションを使用して、ユーザーに代わってトークンを取得します。これにより、 `user_fic` 許可の種類が使用されます。ユーザーはオブジェクト ID (OID) で識別されます。 (継承元 IByUserFederatedIdentityCredential)
AcquireTokenByUserFederatedIdentityCredential(IEnumerable<String>, String, String)	フェデレーション ID 資格情報アサーションを使用して、ユーザーに代わってトークンを取得します。これにより、 `user_fic` 許可の種類が使用されます。ユーザーは UPN によって識別されます。 (継承元 IByUserFederatedIdentityCredential)
AcquireTokenForClient(IEnumerable<String>)	クライアント資格情報フローを使用して、(ユーザーではなく) 機密クライアント自体用にアプリで構成された機関からトークンを取得します。「クライアント資格情報フロー」を参照してください。この操作中、MSAL は最初にキャッシュ内で期限切れトークンを検索してから、Microsoft Entra IDから新しいトークンを取得します。
AcquireTokenOnBehalfOf(IEnumerable<String>, UserAssertion)	OAuth 2.0 On-Behalf-Of フローを使用して、ユーザーの代わりにダウンストリームで保護された別の Web API にアクセスするために、アプリケーションで構成された機関から、このアプリケーション (通常は Web API) のアクセストークンを取得します。この操作中、MSAL は最初にキャッシュ内で期限切れトークンを検索してから、Microsoft Entra IDから新しいトークンを取得します。「オンBehalf-Of フロー」を参照してください。
AcquireTokenSilent(IEnumerable<String>, IAccount)	ネットワーク呼び出しを制御する高度なパラメーターを使用して、ユーザートークンキャッシュから `account` のアクセストークンを取得しようとします。「トークンをサイレントで取得する」を参照してください。 (継承元 IClientApplicationBase)
AcquireTokenSilent(IEnumerable<String>, String)	古い. 機密クライアントアプリでは、代わりに AcquireTokenSilent(IEnumerable<String>, IAccount) を使用します。
GetAccountAsync(String)	トークンキャッシュで使用可能なアカウントと、Authorityと同じ環境 (機関ホスト) のアカウントの識別子によってIAccountを取得します。 (継承元 IClientApplicationBase)
GetAccountsAsync()	古い. Web アプリと Web API で GetAccountAsync(String) を使用し、セキュリティとパフォーマンスを向上させるためにトークンキャッシュシリアライザーを使用します。 https://aka.ms/msal-net-cca-token-cache-serializationを参照してください。
GetAccountsAsync(String)	Azure AD B2C シナリオの場合にのみ、ユーザーフローに基づいてトークンキャッシュで使用可能なアカウントの識別子によってIAccount コレクションを取得します。 (継承元 IClientApplicationBase)
GetAuthorizationRequestUrl(IEnumerable<String>)	承認要求の URL を計算して、ユーザーがサインインし、ユーザー名の特定のスコープにアクセスするアプリケーションに同意します。 URL は、アプリケーションで構成された機関の /authorize エンドポイントを対象とします。
RemoveAsync(IAccount)	指定したアカウントのキャッシュ内のすべてのトークンを削除します。 (継承元 IClientApplicationBase)

拡張メソッド

名前	説明
GetCertificate(IConfidentialClientApplication)	この ConfidentialClientApplicationの作成に使用した証明書 (存在する場合) を返します。

適用対象

フィードバック

このページはお役に立ちましたか?