通过

WSFederationAuthenticationModule.Realm 属性

定义

命名空间:
System.IdentityModel.Services
程序集:
System.IdentityModel.Services.dll

获取或设置要用于 WS-Federation 登录请求（“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

属性值

String

一个 URI，用于标识安全令牌服务（STS）的信赖方（RP）。

例外

ArgumentException

尝试将属性 null 设置为空字符串或发生空字符串。

-或-

尝试将属性设置为无效的绝对 URI 的值。

注解

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

此属性的值序列化为 WS-Federation 协议中的 wtrealm 查询字符串参数。 它标识 STS 的 RP。 STS 使用它来确定要申请令牌颁发的策略，以及如何在令牌颁发后将用户重定向到何处。 （有关标识 RP 的 STS，请参阅 Issuer.）

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

适用于