AbstractAcquireTokenParameterBuilder<T> クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定されたパラメーターに基づいてトークンを取得しようとするトークン要求のビルダーの基本クラス。
public abstract class AbstractAcquireTokenParameterBuilder<T> : Microsoft.Identity.Client.BaseAbstractAcquireTokenParameterBuilder<T> where T : BaseAbstractAcquireTokenParameterBuilder<T>type AbstractAcquireTokenParameterBuilder<'T (requires 'T :> BaseAbstractAcquireTokenParameterBuilder<'T>)> = class
inherit BaseAbstractAcquireTokenParameterBuilder<'T (requires 'T :> BaseAbstractAcquireTokenParameterBuilder<'T>)>Public MustInherit Class AbstractAcquireTokenParameterBuilder(Of T)
Inherits BaseAbstractAcquireTokenParameterBuilder(Of T)型パラメーター
- T
- 継承
- 派生
コンストラクター
| 名前 | 説明 |
|---|---|
| AbstractAcquireTokenParameterBuilder<T>() |
AbstractAcquireTokenParameterBuilder の既定のコンストラクター。 |
メソッド
| 名前 | 説明 |
|---|---|
| ExecuteAsync() |
トークン要求を非同期的に実行します。 (継承元 BaseAbstractAcquireTokenParameterBuilder<T>) |
| ExecuteAsync(CancellationToken) |
非同期メソッドを取り消す可能性がある状態で、トークン要求を非同期的に実行します。 (継承元 BaseAbstractAcquireTokenParameterBuilder<T>) |
| Validate() |
AcquireToken 操作のパラメーターを検証します。 (継承元 BaseAbstractAcquireTokenParameterBuilder<T>) |
| WithAdfsAuthority(String, Boolean) |
ADFS サーバーに対応する既知の機関を追加します。 https://aka.ms/msal-net-adfsを参照してください。 |
| WithAuthority(AadAuthorityAudience, Boolean) |
古い.
重要: 代わりに WithTenantId または WithTenantIdFromAuthority を使用するか、B2C 機関に対して WithB2CAuthority を使用してください。 サインイン対象ユーザー (Azure パブリック クラウドであるクラウド) を指定するサインイン ユーザーに、既知のAzure AD 機関をアプリケーションに追加します。 https://aka.ms/msal-net-application-configurationを参照してください。 |
| WithAuthority(AzureCloudInstance, AadAuthorityAudience, Boolean) |
古い.
クラウド インスタンスとサインイン対象ユーザーを指定するサインイン ユーザーに、既知のAzure AD 機関をアプリケーションに追加します。 https://aka.ms/msal-net-application-configurationを参照してください。 |
| WithAuthority(AzureCloudInstance, Guid, Boolean) |
古い.
重要: 代わりに WithTenantId または WithTenantIdFromAuthority を使用するか、B2C 機関に対して WithB2CAuthority を使用してください。 クラウド インスタンスとそのテナント ID によって記述された単一組織 (シングル テナント アプリケーション) のユーザーをサインインさせるために、アプリケーションに既知のAzure AD 機関を追加します。 https://aka.ms/msal-net-application-configurationを参照してください。 |
| WithAuthority(AzureCloudInstance, String, Boolean) |
古い.
重要: 代わりに WithTenantId または WithTenantIdFromAuthority を使用するか、B2C 機関に対して WithB2CAuthority を使用してください。 クラウド インスタンスとそのドメイン名またはテナント ID で記述された単一組織 (シングル テナント アプリケーション) のユーザーをサインインさせるために、アプリケーションに既知のAzure AD 機関を追加します。 https://aka.ms/msal-net-application-configurationを参照してください。 |
| WithAuthority(String, Boolean) |
古い.
重要: 代わりに WithTenantId または WithTenantIdFromAuthority を使用するか、B2C 機関に対して WithB2CAuthority を使用してください。 トークンが要求される特定の機関。 アプリケーション コンストラクターで構成されている値とは異なる値を渡すと、選択内容が特定のテナントに絞り込まれます。 これにより、アプリケーションで構成された値は変更されません。 これは、複数のアカウント (複数のメールボックスを持つメール クライアントなど) を管理するアプリケーションに固有です。 https://aka.ms/msal-net-application-configurationを参照してください。 |
| WithAuthority(String, Guid, Boolean) |
古い.
重要: 代わりに WithTenantId または WithTenantIdFromAuthority を使用するか、B2C 機関に対して WithB2CAuthority を使用してください。 既知の Azure AD 機関をアプリケーションに追加して、そのテナント ID で指定された単一組織 (シングル テナント アプリケーション) のユーザーをサインインさせます。 https://aka.ms/msal-net-application-configurationを参照してください。 |
| WithAuthority(String, String, Boolean) |
古い.
重要: 代わりに WithTenantId または WithTenantIdFromAuthority を使用するか、B2C 機関に対して WithB2CAuthority を使用してください。 ドメイン名で記述された単一の組織 (シングル テナント アプリケーション) のユーザーをサインインさせるために、アプリケーションに既知のAzure AD 機関を追加します。 https://aka.ms/msal-net-application-configurationを参照してください。 |
| WithB2CAuthority(String) |
Azure AD B2C ポリシーに対応する既知の機関を追加します。 「https://aka.ms/msal-net-b2c-specificities」を参照してください。 |
| WithClaims(String) |
クエリの要求を設定します。 AAD 管理者が条件付きアクセスを有効にした場合に使用します。 通常、トークンを取得すると、Claims プロパティが設定されたMsalUiRequiredExceptionになります。 トークンの取得を再試行し、 WithClaims(String) メソッドでこの値を使用します。 詳細とhttps://aka.ms/msal-net-claim-challengeについては、https://aka.ms/msal-exceptionsを参照してください。 |
| WithCorrelationId(Guid) |
認証要求で使用する関連付け ID を設定します。 SDK と ID プロバイダー サービスの両方のログで要求を追跡するために使用されます。 設定されていない場合は、ランダムに生成されます。 (継承元 BaseAbstractAcquireTokenParameterBuilder<T>) |
| WithExtraQueryParameters(Dictionary<String,String>) |
古い.
HTTP 認証要求のクエリ文字列の追加クエリ パラメーターを設定します。 (継承元 BaseAbstractAcquireTokenParameterBuilder<T>) |
| WithExtraQueryParameters(IDictionary<String,ValueTuple<String,Boolean>>) |
キャッシュ キーに含めるパラメーターを制御して、HTTP 認証要求のクエリ文字列の追加クエリ パラメーターを設定します (継承元 BaseAbstractAcquireTokenParameterBuilder<T>) |
| WithExtraQueryParameters(String) |
古い.
HTTP 認証要求のクエリ文字列の追加クエリ パラメーターを設定します。 |
| WithScopes(IEnumerable<String>) |
要求するスコープを指定します。 このメソッドは、アプリケーションが保護された API を呼び出すために必要なスコープを指定する必要がある場合に使用されます。 スコープ、アクセス許可と同意の詳細については、<see>https://docs.microsoft.com/azure/active-directory/develop/v2-permissions-and-consent</see> に関するページを参照してください。また、OAuth2 アクセス許可の公開に使用されるレガシ アプリケーションのスコープを作成する方法については>>https://docs.microsoft.com/azure/active-directory/develop/msal-v1-app-scopes</see<を参照してください。 |
| WithTenantId(String) |
アプリケーション レベルで機関で指定されたテナント ID をオーバーライドします。 この操作では、権限ホスト (環境) が保持されます。 権限がアプリケーション・レベルで指定されていない場合、使用されるデフォルトは |
| WithTenantIdFromAuthority(Uri) |
指定された機関 URI からテナント ID を抽出し、アプリケーション レベルで機関で指定されたテナント ID をオーバーライドします。 この操作では、アプリケーション ビルダーに提供された機関ホスト (環境) が保持されます。
権限がアプリケーション ビルダーに提供されていない場合、このメソッドは既定の機関 ( |
拡張メソッド
| 名前 | 説明 |
|---|---|
| OnBeforeTokenRequest<T>(AbstractAcquireTokenParameterBuilder<T>, Func<OnBeforeTokenRequestData,Task>) |
MSAL がトークン要求を行う前にユーザー指定のデリゲートを実行することで、要求パイプラインに介入します。 デリゲートは、本文パラメーターとヘッダーを追加または削除することで、要求ペイロードを変更できます。 OnBeforeTokenRequestData |
| WithAdditionalCacheParameters<T>(AbstractAcquireTokenParameterBuilder<T>, IEnumerable<String>) |
通常はキャッシュ オブジェクトに含まれていないアクセス トークンを使用してキャッシュされる認証応答から取得される追加のパラメーターを指定します。 これらの値は、 AdditionalResponseParameters パラメーターから読み取ることができます。 |
| WithAuthenticationExtension<T>(AbstractAcquireTokenParameterBuilder<T>, MsalAuthenticationExtension) |
クライアント アプリケーションがトークン取得要求で使用するカスタム認証操作を提供できるようにします。 |
| WithCachePartitionKey<T>(BaseAbstractAcquireTokenParameterBuilder<T>, String, String) |
キーと値のペアをクエリ パラメーターとして送信せずにトークン キャッシュ キーに追加します。
これを使用して、キャッシュされたトークンをパーティション分割します (たとえば、同じユーザーの通常のセッションから有効期間の短いセッションを分離する)。 キャッシュされたエントリを照合するには、 |
| WithExtraClientAssertionClaims<T>(AbstractAcquireTokenParameterBuilder<T>, String) |
クライアント アサーションに含める追加の要求を指定します。 これらの要求は、クライアント アサーションの生成時に既定の要求とマージされます。 これにより、Microsoftなどの上位レベルの API が可能になります。Identity.Web は、クライアント アサーションに追加の要求を提供します。 重要: トークンは、キャッシュ参照に影響を与える追加のクライアント アサーション要求に関連付けられます。 これは拡張 API であり、アプリケーションで直接使用しないでください。 |
| WithExtraHttpHeaders<T>(AbstractAcquireTokenParameterBuilder<T>, IDictionary<String,String>) |
古い.
トークン要求に Http ヘッダーを追加します。 |
| WithExtraHttpHeaders<T>(AbstractAcquireTokenParameterBuilder<T>, IDictionary<String,String>) |
トークン要求に追加の HTTP ヘッダーを追加します。 |
| WithFmiPathForClientAssertion<T>(AbstractAcquireTokenParameterBuilder<T>, String) |
クライアント アサーションに使用する FMI パスを指定します。 これにより、Id.Web などの上位レベルの API は、FMI の機密性の高い資格情報を提供できます。 重要: トークンは資格情報 FMI パスに関連付けられています。これはキャッシュ参照に影響を与えます。これは拡張 API であり、アプリケーションでは使用しないでください。 |
| WithProofOfPosessionKeyId<T>(AbstractAcquireTokenParameterBuilder<T>, String, String) |
トークンをキャッシュ内のキーにバインドします。トークンに対して暗号化操作は実行されません。 |