Share via


WSFederationAuthenticationModule.Realm 属性

定义

获取或设置 WS 联合身份验证登录请求(“wsignin1.0”)中使用的 wtrealm 参数的值。

public:
 property System::String ^ Realm { System::String ^ get(); void set(System::String ^ value); };
public string Realm { get; set; }
member this.Realm : string with get, set
Public Property Realm As String

属性值

标识安全标志服务 (STS)的该依赖方 (RP) 的 URI。

例外

尝试将此属性设置为 null 或者空字符串。

- 或 -

尝试设置这个属性为一个值,该值不是有效的绝对 URI。

注解

这是 WS-Federation 登录请求的必需属性。 如果启用了被动重定向,则必须设置它。 URI 标识 STS 的 RP。 (若要标识 RP 的 STS,请参阅 Issuer 属性) 。

此属性的值在 WS-Federation 协议中序列化为 wtrealm 查询字符串参数。 它将 RP 标识到 STS。 STS 使用它来确定令牌颁发应用的策略,以及令牌颁发后将用户重定向到的位置。 (若要标识 RP 的 STS,请参阅 Issuer.)

可以通过为 事件添加处理程序来覆盖每个 HTTP 请求的 RedirectingToIdentityProvider 此设置。 此事件是在模块重定向到安全令牌服务之前引发的, (STS) 带有 WS-Federation 登录请求消息。 STS 由 Issuer 属性指定。

适用于