WSFederationAuthenticationModule.RedirectToIdentityProvider 方法

定義

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

將使用者重新導向至 Issuer 屬性指定的安全性權杖服務 (STS)，以取得使用 WS-同盟通訊協定的安全性權杖。

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)

WSFAM 會將這個值儲存在 WS-同盟登入要求中的 wctx 參數，但是模組不會在處理登入要求或登入回應時使用該值。您可以將它設定為任何值。這不需要是唯一的。如需詳細資訊，請參閱 CreateSignInRequest(String, String, Boolean) 方法。

在驗證時模組應該傳回的 URL。

WSFAM 會將這個值儲存在 WS-同盟登入要求中的 wctx 參數，但是模組不會在處理登入要求或登入回應時使用該值。您可以將它設定為 true 或 false。

Issuer 為 null 或空字串。

-或-

Realm 為 null 或空字串。

-或-

Current 屬性為 null 或空的。

-或-

由 Response 傳回的內容的 Current 屬性是 null 或空白。

RedirectToIdentityProvider當信賴憑證者 (RP) 或事件處理程式委派所呈現的網頁發出要求時，會從 SignIn OnEndRequest 方法呼叫方法，以在授權失敗時對識別提供者執行被動重新導向。

傳遞至方法的參數可用來建立 wctx 訊息參數。唯一的重要參數是 returnUrl 參數。這會指定 RP 應指示瀏覽器遵循成功驗證的 URL。它不應該與屬性所 Reply 指定的 wreply 訊息參數混淆，該參數會提供安全性令牌服務 (STS) 的 RP 位址。

方法會執行下列動作：

叫用 VerifyProperties 方法，以確保模組可以發出有效的登入要求。
叫用 CreateSignInRequest 方法，從模組上設定的屬性建立登入要求。
叫用 OnRedirectingToIdentityProvider 方法來引發 RedirectingToIdentityProvider 事件。您可以在此事件的事件處理程式中取消重新導向或修改登入要求訊息。