WSFederationAuthenticationModule.RedirectToIdentityProvider メソッド

定義

名前空間:

System.IdentityModel.Services

アセンブリ:

System.IdentityModel.Services.dll

WS-Federation プロトコルを使用してセキュリティ トークンを取得するために、Issuer プロパティで指定されるセキュリティ トークン サービス (STS) にユーザーをリダイレクトします。

public:
 virtual void RedirectToIdentityProvider(System::String ^ uniqueId, System::String ^ returnUrl, bool persist);

public virtual void RedirectToIdentityProvider (string uniqueId, string returnUrl, bool persist);

abstract member RedirectToIdentityProvider : string * string * bool -> unit
override this.RedirectToIdentityProvider : string * string * bool -> unit

Public Overridable Sub RedirectToIdentityProvider (uniqueId As String, returnUrl As String, persist As Boolean)

パラメーター

uniqueId

String

WSFAM は、WS-Federation のサインイン要求の wctx パラメーターにこの値を保存します。ただし、モジュールは、サインイン要求またはサインイン応答を処理するときにこの値を使用しません。 任意の値に設定できます。 一意である必要はありません。 詳細については、CreateSignInRequest(String, String, Boolean) メソッドを参照してください。

returnUrl

String

認証後にモジュールが戻る必要がある URL。

persist

Boolean

WSFAM は、WS-Federation のサインイン要求の wctx パラメーターにこの値を保存します。ただし、モジュールは、サインイン要求またはサインイン応答を処理するときにこの値を使用しません。 true または false に設定できます。

例外

InvalidOperationException

Issuer が null または空の文字列です。

- または -

Realm が null または空の文字列です。

- または -

Current プロパティが null または空です。

- または -

Response によって返されたコンテキストの Current プロパティは、null または空です。

注釈

このメソッドはRedirectToIdentityProvider、証明書利用者 (RP) によって提示された Web ページから要求が発行されたとき、またはイベント ハンドラー デリゲートからメソッドからSignInOnEndRequest呼び出され、承認エラー時に ID プロバイダーへのパッシブ リダイレクトを実行します。

メソッドに渡されるパラメーターは、wctx メッセージ パラメーターの作成に使用されます。 唯一の重要なパラメーターは、 returnUrl パラメーターです。 これは、認証が成功した後に RP がブラウザーに指示する URL を指定します。 プロパティで指定され、セキュリティ トークン サービス (STS) が応答を Reply 送信する RP のアドレスを提供する wreply メッセージ パラメーターと混同しないでください。

メソッドは、次の処理を実行します。

1. メソッドを VerifyProperties 呼び出して、モジュールが有効なサインイン要求を発行できることを確認します。

2. メソッドを CreateSignInRequest 呼び出して、モジュールで構成されたプロパティからサインイン要求を作成します。

3. メソッドを OnRedirectingToIdentityProvider 呼び出して イベントを RedirectingToIdentityProvider 発生させます。 リダイレクトを取り消すか、このイベントのイベント ハンドラーでサインイン要求メッセージを変更できます。