AcquireTokenInteractiveParameterBuilder クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
対話型トークン要求のビルダー。 「https://aka.ms/msal-net-acquire-token-interactively」を参照してください。
public sealed class AcquireTokenInteractiveParameterBuilder : Microsoft.Identity.Client.AbstractPublicClientAcquireTokenParameterBuilder<Microsoft.Identity.Client.AcquireTokenInteractiveParameterBuilder>type AcquireTokenInteractiveParameterBuilder = class
inherit AbstractPublicClientAcquireTokenParameterBuilder<AcquireTokenInteractiveParameterBuilder>Public NotInheritable Class AcquireTokenInteractiveParameterBuilder
Inherits AbstractPublicClientAcquireTokenParameterBuilder(Of AcquireTokenInteractiveParameterBuilder)- 継承
-
AcquireTokenInteractiveParameterBuilder
メソッド
| 名前 | 説明 |
|---|---|
| ExecuteAsync() |
トークン要求を非同期的に実行します。 (継承元 BaseAbstractAcquireTokenParameterBuilder<T>) |
| ExecuteAsync(CancellationToken) |
非同期メソッドを取り消す可能性がある状態で、トークン要求を非同期的に実行します。 (継承元 AbstractPublicClientAcquireTokenParameterBuilder<T>) |
| Validate() |
AcquireToken 操作のパラメーターを検証します。 (継承元 BaseAbstractAcquireTokenParameterBuilder<T>) |
| WithAccount(IAccount) |
トークンを取得するアカウントを設定します。 このメソッドは、 WithLoginHint(String)と相互に排他的です。 両方を使用すると、例外がスローされます |
| WithAdfsAuthority(String, Boolean) |
ADFS サーバーに対応する既知の機関を追加します。 https://aka.ms/msal-net-adfsを参照してください。 (継承元 AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(AadAuthorityAudience, Boolean) |
古い.
重要: 代わりに WithTenantId または WithTenantIdFromAuthority を使用するか、B2C 機関に対して WithB2CAuthority を使用してください。 サインイン対象ユーザー (Azure パブリック クラウドであるクラウド) を指定するサインイン ユーザーに、既知のAzure AD 機関をアプリケーションに追加します。 https://aka.ms/msal-net-application-configurationを参照してください。 (継承元 AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(AzureCloudInstance, AadAuthorityAudience, Boolean) |
古い.
クラウド インスタンスとサインイン対象ユーザーを指定するサインイン ユーザーに、既知のAzure AD 機関をアプリケーションに追加します。 https://aka.ms/msal-net-application-configurationを参照してください。 (継承元 AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(AzureCloudInstance, Guid, Boolean) |
古い.
重要: 代わりに WithTenantId または WithTenantIdFromAuthority を使用するか、B2C 機関に対して WithB2CAuthority を使用してください。 クラウド インスタンスとそのテナント ID によって記述された単一組織 (シングル テナント アプリケーション) のユーザーをサインインさせるために、アプリケーションに既知のAzure AD 機関を追加します。 https://aka.ms/msal-net-application-configurationを参照してください。 (継承元 AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(AzureCloudInstance, String, Boolean) |
古い.
重要: 代わりに WithTenantId または WithTenantIdFromAuthority を使用するか、B2C 機関に対して WithB2CAuthority を使用してください。 クラウド インスタンスとそのドメイン名またはテナント ID で記述された単一組織 (シングル テナント アプリケーション) のユーザーをサインインさせるために、アプリケーションに既知のAzure AD 機関を追加します。 https://aka.ms/msal-net-application-configurationを参照してください。 (継承元 AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(String, Boolean) |
古い.
重要: 代わりに WithTenantId または WithTenantIdFromAuthority を使用するか、B2C 機関に対して WithB2CAuthority を使用してください。 トークンが要求される特定の機関。 アプリケーション コンストラクターで構成されている値とは異なる値を渡すと、選択内容が特定のテナントに絞り込まれます。 これにより、アプリケーションで構成された値は変更されません。 これは、複数のアカウント (複数のメールボックスを持つメール クライアントなど) を管理するアプリケーションに固有です。 https://aka.ms/msal-net-application-configurationを参照してください。 (継承元 AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(String, Guid, Boolean) |
古い.
重要: 代わりに WithTenantId または WithTenantIdFromAuthority を使用するか、B2C 機関に対して WithB2CAuthority を使用してください。 既知の Azure AD 機関をアプリケーションに追加して、そのテナント ID で指定された単一組織 (シングル テナント アプリケーション) のユーザーをサインインさせます。 https://aka.ms/msal-net-application-configurationを参照してください。 (継承元 AbstractAcquireTokenParameterBuilder<T>) |
| WithAuthority(String, String, Boolean) |
古い.
重要: 代わりに WithTenantId または WithTenantIdFromAuthority を使用するか、B2C 機関に対して WithB2CAuthority を使用してください。 ドメイン名で記述された単一の組織 (シングル テナント アプリケーション) のユーザーをサインインさせるために、アプリケーションに既知のAzure AD 機関を追加します。 https://aka.ms/msal-net-application-configurationを参照してください。 (継承元 AbstractAcquireTokenParameterBuilder<T>) |
| WithB2CAuthority(String) |
Azure AD B2C ポリシーに対応する既知の機関を追加します。 「https://aka.ms/msal-net-b2c-specificities」を参照してください。 (継承元 AbstractAcquireTokenParameterBuilder<T>) |
| WithClaims(String) |
クエリの要求を設定します。 AAD 管理者が条件付きアクセスを有効にした場合に使用します。 通常、トークンを取得すると、Claims プロパティが設定されたMsalUiRequiredExceptionになります。 トークンの取得を再試行し、 WithClaims(String) メソッドでこの値を使用します。 詳細とhttps://aka.ms/msal-net-claim-challengeについては、https://aka.ms/msal-exceptionsを参照してください。 (継承元 AbstractAcquireTokenParameterBuilder<T>) |
| WithCorrelationId(Guid) |
認証要求で使用する関連付け ID を設定します。 SDK と ID プロバイダー サービスの両方のログで要求を追跡するために使用されます。 設定されていない場合は、ランダムに生成されます。 (継承元 BaseAbstractAcquireTokenParameterBuilder<T>) |
| WithEmbeddedWebViewOptions(EmbeddedWebViewOptions) |
対話型認証に埋め込み Web ビューを使用するためのオプションを指定します。 |
| WithExtraQueryParameters(Dictionary<String,String>) |
古い.
HTTP 認証要求のクエリ文字列の追加クエリ パラメーターを設定します。 (継承元 BaseAbstractAcquireTokenParameterBuilder<T>) |
| WithExtraQueryParameters(IDictionary<String,ValueTuple<String,Boolean>>) |
キャッシュ キーに含めるパラメーターを制御して、HTTP 認証要求のクエリ文字列の追加クエリ パラメーターを設定します (継承元 BaseAbstractAcquireTokenParameterBuilder<T>) |
| WithExtraQueryParameters(String) |
古い.
HTTP 認証要求のクエリ文字列の追加クエリ パラメーターを設定します。 (継承元 AbstractAcquireTokenParameterBuilder<T>) |
| WithExtraScopesToConsent(IEnumerable<String>) |
対話型トークン要求のビルダー。 「https://aka.ms/msal-net-acquire-token-interactively」を参照してください。 |
| WithLoginHint(String) |
ユーザーが複数の ID でサインインしている場合のアカウントの選択ダイアログを回避するために、 |
| WithParentActivityOrWindow(IntPtr) |
IntPtr への参照を、表示するブラウザーをトリガーするウィンドウに設定します。 このウィンドウにポップアップ表示されるブラウザーを中央に配置するために使用します。 値が構成されている場合は、画面の中央またはフォアグラウンド アプリ。 |
| WithParentActivityOrWindow(Object) |
ViewController (iOS を使用している場合)、アクティビティ (Android を使用している場合) IWin32Window または IntPtr (.Net Framework を使用している場合) への参照を設定します。 ブラウザーの呼び出しに使用されます。 |
| WithPrompt(Prompt) |
ユーザーの対話型エクスペリエンスを指定します。 |
| WithProofOfPossession(String, HttpMethod, Uri) |
取得したトークンがベアラー トークンではなく所有証明トークン (PoP) になるように、トークン取得要求を変更します。 PoP トークンはベアラー トークンに似ていますが、HTTP 要求と暗号化キーにバインドされ、MSAL はWindowsで管理できます。 要求 URI のホスト部分とパス部分のみがバインドされることに注意してください。 「https://aka.ms/msal-net-pop」を参照してください。 |
| 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<を参照してください。 (継承元 AbstractAcquireTokenParameterBuilder<T>) |
| WithSystemWebViewOptions(SystemWebViewOptions) |
システム OS ブラウザーで対話型認証を処理するためのオプションを指定します。 |
| WithTenantId(String) |
アプリケーション レベルで機関で指定されたテナント ID をオーバーライドします。 この操作では、権限ホスト (環境) が保持されます。 権限がアプリケーション・レベルで指定されていない場合、使用されるデフォルトは |
| WithTenantIdFromAuthority(Uri) |
指定された機関 URI からテナント ID を抽出し、アプリケーション レベルで機関で指定されたテナント ID をオーバーライドします。 この操作では、アプリケーション ビルダーに提供された機関ホスト (環境) が保持されます。
権限がアプリケーション ビルダーに提供されていない場合、このメソッドは既定の機関 ( |
| WithUseEmbeddedWebView(Boolean) |
パブリック クライアント アプリケーションで埋め込み Web ブラウザーを使用するか、システムの既定のブラウザーを使用するかを指定します。 ブローカー (WAM、Authenticator、ポータル サイト) が構成されている場合、この設定はブローカーがインストールされていない場合にのみ使用されます。 net8 ウィンドウを含む.NETでは、アプリ開発者はMicrosoftを参照する必要があります。Identity.Client.Desktop を呼び出し、PublicClientApplicationBuilder.WithDesktopFeatures() を呼び出して、埋め込み Web ブラウザーを有効にします。 |
拡張メソッド
| 名前 | 説明 |
|---|---|
| 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) |
キーと値のペアをクエリ パラメーターとして送信せずに、トークン キャッシュ キーに追加します。
これを使用して、キャッシュされたトークンをパーティション分割します (たとえば、同じユーザーの通常のセッションから有効期間の短いセッションを分離する)。 キャッシュされたエントリを照合するには、 |
| WithCustomWebUi(AcquireTokenInteractiveParameterBuilder, ICustomWebUi) |
パブリック クライアント アプリケーションの MSAL.NET エクステンダーがカスタム Web UI を設定できるようにする拡張メソッド。これにより、ユーザーが Azure AD でサインインし、必要に応じて同意を提示し、承認コードを取得できるようになります。 |
| 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) |
トークンをキャッシュ内のキーにバインドします。トークンに対して暗号化操作は実行されません。 |
| WithSSHCertificateAuthenticationScheme(AcquireTokenInteractiveParameterBuilder, String, String) |
ベアラー トークンではなく SSH 証明書を返すように AAD に指示します。 SSH 証明書 (SSH で使用される公開キーと秘密キーのペアと同じではありません) を使用して、SSH 公開キーをコンピューターに安全にデプロイできます。 詳細については、https://aka.ms/msal-net-ssh を参照してください。 |