共用方式為


WSFederationAuthenticationModule.RedirectToIdentityProvider 方法

定義

將使用者重新導向至 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)

參數

uniqueId
String

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

returnUrl
String

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

persist
Boolean

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

例外狀況

Issuernull 或空字串。

-或-

Realmnull 或空字串。

-或-

Current 屬性為 null 或空的。

-或-

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

備註

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

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

方法會執行下列動作:

  1. 叫用 VerifyProperties 方法,以確保模組可以發出有效的登入要求。

  2. 叫用 CreateSignInRequest 方法,從模組上設定的屬性建立登入要求。

  3. 叫用 OnRedirectingToIdentityProvider 方法來引發 RedirectingToIdentityProvider 事件。 您可以在此事件的事件處理程式中取消重新導向或修改登入要求訊息。

適用於