WSFederationAuthenticationModule.RedirectToIdentityProvider メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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 -> unitPublic 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のいずれかを設定できます。
例外
注釈
RedirectToIdentityProvider メソッドは、証明書利用者 (RP) によって提示された Web ページから要求が発行されたとき、または承認エラー時に ID プロバイダーへのパッシブ リダイレクトを実行するために OnEndRequest イベント ハンドラー デリゲートから要求が発行されたときに、SignIn メソッドから呼び出されます。
メソッドに渡されるパラメーターは、wctx メッセージ パラメーターの作成に使用されます。 唯一の重要なパラメーターは、 returnUrl パラメーターです。 これは、RP が正常に認証された後にブラウザーに指示する URL を指定します。 wreply メッセージ パラメーターと混同しないでください。wreply メッセージ パラメーターは、 Reply プロパティで指定され、セキュリティ トークン サービス (STS) が応答を送信する RP のアドレスを提供します。
このメソッドでは、次の処理が実行されます。
VerifyProperties メソッドを呼び出して、モジュールが有効なサインイン要求を発行できることを確認します。
CreateSignInRequest メソッドを呼び出して、モジュールで構成されたプロパティからサインイン要求を作成します。
OnRedirectingToIdentityProvider メソッドを呼び出して、RedirectingToIdentityProvider イベントを発生させます。 リダイレクトを取り消すか、このイベントのイベント ハンドラーでサインイン要求メッセージを変更できます。
