WSFederationAuthenticationModule.Realm 屬性

定義

命名空間:

System.IdentityModel.Services

組件:

System.IdentityModel.Services.dll

取得或設定要用於 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

屬性值

String

用來向 Security Token Service (STS) 表明信賴憑證者 (RP) 識別身分的 URI。

例外狀況

ArgumentException

嘗試將屬性設為 null 或空字串。

-或-

嘗試將屬性設為不是有效的絕對 URI 的值。

備註

這是 WS-Federation 登入要求的必要屬性。 如果已啟用被動重新導向，則必須加以設定。 URI 會識別 STS 的 RP。 (若要識別 RP 的 STS，請參閱 Issuer 屬性) 。

此屬性的值會串行化為 WS-Federation 通訊協定中的 wtrealm 查詢字串參數。 它會識別 STS 的 RP。 STS 會使用此原則來決定要套用令牌發行的原則，以及將使用者重新導向至令牌發行之後的位置。 (若要識別 RP 的 STS，請參閱 Issuer.)

您可以藉由新增 事件的處理程式 RedirectingToIdentityProvider ，在每個 HTTP 要求上覆寫此設定。 此事件會在模組重新導向至安全性令牌服務之前引發， (STS) 具有 WS-Federation 登入要求訊息。 STS 是由 屬性所 Issuer 指定。