WSFederationAuthenticationModule.RedirectToIdentityProvider 方法

定义

将用户重定向至 Issuer 属性指定的安全服务标记 (STS),以使用 WS-Federation 协议获取安全标记。

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 参数值; 但是,该模块在处理签入请求或sign-in反应时不使用它。 您可以将其设置为任何值。 它不必是唯一的。 有关更多信息,请参见 CreateSignInRequest(String, String, Boolean) 方法。

returnUrl
String

模块应返回在身份验证的 URL。

persist
Boolean

WSFAM 保存请求中的 WS-Federation 标志 wctx 参数值; 但是,该模块在处理签入请求或sign-in反应时不使用它。 可以设置该 truefalse

例外

Issuernull 或空字符串。

- 或 -

Realmnull 或空字符串。

- 或 -

Current 属性为 null 或为空。

- 或 -

Response返回的上下文的 Current 属性为 null 或空。

注解

RedirectToIdentityProvider当请求从信赖方 (RP) 或事件处理程序委托提供的网页发出请求时,将从 OnEndRequest 方法调用SignIn,以在授权失败时对标识提供者执行被动重定向。

传递给 方法的参数用于创建 wctx 消息参数。 唯一重要的参数是 returnUrl 参数。 这指定 RP 应将浏览器定向到成功身份验证之后的 URL。 不应将其与 wreply 消息参数混淆,该参数由 Reply 属性指定,后者在 RP 上提供安全令牌服务 (STS) 应将其响应定向到的地址。

方法执行以下操作:

  1. VerifyProperties调用 方法以确保模块可以发出有效的登录请求。

  2. CreateSignInRequest调用 方法以从模块上配置的属性创建登录请求。

  3. OnRedirectingToIdentityProvider调用 方法以引发 RedirectingToIdentityProvider 事件。 可以取消重定向或修改此事件的事件处理程序中的登录请求消息。

适用于