GetAuthorizationRequestUrlParameterBuilder クラス

定義

注: AbstractAcquireTokenParameterBuilder (アカウントなど) のメソッドの一部は、ここでは意味がありません。 すべての一般的なメソッドを含むさらにベースを作成し、AcquireToken にのみ使用されるアカウントなどを含む別のベースを作成しますか?

public sealed class GetAuthorizationRequestUrlParameterBuilder : Microsoft.Identity.Client.AbstractConfidentialClientAcquireTokenParameterBuilder<Microsoft.Identity.Client.GetAuthorizationRequestUrlParameterBuilder>
type GetAuthorizationRequestUrlParameterBuilder = class
    inherit AbstractConfidentialClientAcquireTokenParameterBuilder<GetAuthorizationRequestUrlParameterBuilder>
Public NotInheritable Class GetAuthorizationRequestUrlParameterBuilder
Inherits AbstractConfidentialClientAcquireTokenParameterBuilder(Of GetAuthorizationRequestUrlParameterBuilder)
継承

メソッド

名前 説明
ExecuteAsync()

注: AbstractAcquireTokenParameterBuilder (アカウントなど) のメソッドの一部は、ここでは意味がありません。 すべての一般的なメソッドを含むさらにベースを作成し、AcquireToken にのみ使用されるアカウントなどを含む別のベースを作成しますか?

ExecuteAsync(CancellationToken)

注: AbstractAcquireTokenParameterBuilder (アカウントなど) のメソッドの一部は、ここでは意味がありません。 すべての一般的なメソッドを含むさらにベースを作成し、AcquireToken にのみ使用されるアカウントなどを含む別のベースを作成しますか?

Validate()

AcquireToken 操作のパラメーターを検証します。

(継承元 AbstractConfidentialClientAcquireTokenParameterBuilder<T>)
WithAccount(IAccount)

注: AbstractAcquireTokenParameterBuilder (アカウントなど) のメソッドの一部は、ここでは意味がありません。 すべての一般的なメソッドを含むさらにベースを作成し、AcquireToken にのみ使用されるアカウントなどを含む別のベースを作成しますか?

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>)
WithCcsRoutingHint(String, String)

回復性を高めるために、AAD バックアップ認証システムは AAD バックアップとして動作します。 これにより、認証時のパフォーマンス向上に役立つルーティング ヒントが AAD バックアップ認証システムに提供されます。 この API で作成されたヒントは、 WithLoginHint(String)

WithClaims(String)

クエリの要求を設定します。 AAD 管理者が条件付きアクセスを有効にした場合に使用します。 通常、トークンを取得すると、MsalUiRequiredException プロパティが設定されたClaimsになります。 トークンの取得を再試行し、 WithClaims(String) メソッドでこの値を使用します。 詳細とhttps://aka.ms/msal-exceptionsについては、https://aka.ms/msal-net-claim-challengeを参照してください。

(継承元 AbstractAcquireTokenParameterBuilder<T>)
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 認証要求のクエリ文字列の追加クエリ パラメーターを設定します。

(継承元 AbstractAcquireTokenParameterBuilder<T>)
WithExtraScopesToConsent(IEnumerable<String>)

注: AbstractAcquireTokenParameterBuilder (アカウントなど) のメソッドの一部は、ここでは意味がありません。 すべての一般的なメソッドを含むさらにベースを作成し、AcquireToken にのみ使用されるアカウントなどを含む別のベースを作成しますか?

WithLoginHint(String)

注: AbstractAcquireTokenParameterBuilder (アカウントなど) のメソッドの一部は、ここでは意味がありません。 すべての一般的なメソッドを含むさらにベースを作成し、AcquireToken にのみ使用されるアカウントなどを含む別のベースを作成しますか?

WithPkce(String)

Proof of Key for Code Exchange (PKCE) を使用して承認コード付与をセキュリティで保護するために使用されます。 詳細については、PKCE RCF を参照してください。 https://tools.ietf.org/html/rfc7636

WithPrompt(Prompt)

ユーザーの対話型エクスペリエンスを指定します。

WithProofOfPossession(PoPAuthenticationConfiguration)
古い.

取得したトークンがベアラー トークンではなく所有証明トークン (PoP) になるように、トークン取得要求を変更します。 PoP トークンはベアラー トークンに似ていますが、HTTP 要求と暗号化キーにバインドされ、MSAL はWindowsで管理できます。 「https://aka.ms/msal-net-pop」を参照してください。

(継承元 AbstractConfidentialClientAcquireTokenParameterBuilder<T>)
WithRedirectUri(String)

承認要求 URL に追加するリダイレクト URI を設定します

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>)
WithSignedHttpRequestProofOfPossession(PoPAuthenticationConfiguration)

ベアラーではなく、署名済み HTTP 要求 (SHR) 所有証明 (PoP) トークンを取得するように要求を変更します。 SHR PoP トークンは HTTP 要求と暗号化キーにバインドされ、MSAL はWindowsで管理します。 SHR PoP トークンは、相互 TLS (mTLS) 認証に使用される mTLS PoP トークンとは異なります。 詳細については、https://aka.ms/mtls-pop を参照してください。

(継承元 AbstractConfidentialClientAcquireTokenParameterBuilder<T>)
WithTenantId(String)

アプリケーション レベルで機関で指定されたテナント ID をオーバーライドします。 この操作では、権限ホスト (環境) が保持されます。

権限がアプリケーション・レベルで指定されていない場合、使用されるデフォルトは https://login.microsoftonline.com/common

(継承元 AbstractAcquireTokenParameterBuilder<T>)
WithTenantIdFromAuthority(Uri)

指定された機関 URI からテナント ID を抽出し、アプリケーション レベルで機関で指定されたテナント ID をオーバーライドします。 この操作では、アプリケーション ビルダーに提供された機関ホスト (環境) が保持されます。 権限がアプリケーション ビルダーに提供されていない場合、このメソッドは既定の機関 ( https://login.microsoftonline.com/common) のテナント ID を置き換えます。

(継承元 AbstractAcquireTokenParameterBuilder<T>)

拡張メソッド

名前 説明
OnBeforeTokenRequest<T>(AbstractAcquireTokenParameterBuilder<T>, Func<OnBeforeTokenRequestData,Task>)

MSAL がトークン要求を行う前にユーザー指定のデリゲートを実行することで、要求パイプラインに介入します。 デリゲートは、本文パラメーターとヘッダーを追加または削除することで、要求ペイロードを変更できます。 OnBeforeTokenRequestData

WithAdditionalCacheParameters<T>(AbstractAcquireTokenParameterBuilder<T>, IEnumerable<String>)

通常はキャッシュ オブジェクトに含まれていないアクセス トークンを使用してキャッシュされる認証応答から取得される追加のパラメーターを指定します。 これらの値は、 AdditionalResponseParameters パラメーターから読み取ることができます。

WithAttributeTokens<T>(AbstractConfidentialClientAcquireTokenParameterBuilder<T>, IEnumerable<String>)

attributeTokens本文パラメーターとしてattribute_tokensを送信し、キャッシュ キーに含めます。 Null/empty/空白エントリは無視されます。null または空のコレクションは no-opです。

WithAuthenticationExtension<T>(AbstractAcquireTokenParameterBuilder<T>, MsalAuthenticationExtension)

クライアント アプリケーションがトークン取得要求で使用するカスタム認証操作を提供できるようにします。

WithCachePartitionKey<T>(BaseAbstractAcquireTokenParameterBuilder<T>, String, String)

キーと値のペアをクエリ パラメーターとして送信せずに、トークン キャッシュ キーに追加します。 これを使用して、キャッシュされたトークンをパーティション分割します (たとえば、同じユーザーの通常のセッションから有効期間の短いセッションを分離する)。 キャッシュされたエントリを照合するには、 AcquireTokenByAuthorizationCodeAcquireTokenSilent の両方で同じパーティション キーを使用する必要があります。

WithClaimsFromClient<T>(AbstractConfidentialClientAcquireTokenParameterBuilder<T>, String)

トークン要求に含めるクライアント側の要求を指定します。 WithClaims(String) (サーバーが発行した要求チャレンジの場合) とは異なり、クライアント要求で取得されたトークンはキャッシュされ、キャッシュ エントリは要求値にキーが設定されます。 要求値が異なると、キャッシュ エントリが個別に生成されます。 無制限のキャッシュの増加を回避するには、安定した非動的な値を使用します。

WithExtraBodyParameters<T>(AbstractConfidentialClientAcquireTokenParameterBuilder<T>, Dictionary<String,Func<CancellationToken,Task<String>>>)

トークン要求に追加の本文パラメーターを追加します。 これらのパラメーターは、これらのパラメーターを取得したトークンに関連付けるためにキャッシュ キーに追加されます。 機密クライアント フロー (AcquireTokenForClient、AcquireTokenOnBehalfOf、AcquireTokenByAuthorizationCode) で動作します。

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)

トークンをキャッシュ内のキーにバインドします。トークンに対して暗号化操作は実行されません。

適用対象