WSFederationAuthenticationModule.Realm 屬性

定義

命名空間:

System.IdentityModel.Services

組件:

System.IdentityModel.Services.dll

取得或設定用於 WS-Federation 登入請求的 wtrealm 參數值（「wsignin1.0」）。

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

一個用來識別安全令牌服務（STS）依賴方（RP）的 URI。

例外狀況

ArgumentException

嘗試將屬性設為 或 null 空字串時會發生。

-或-

嘗試將屬性設定為非有效、絕對 URI 的值。

備註

這是 WS-Federation 登入申請的必備屬性。 如果啟用被動重定向，必須設定它。 URI 將 RP 與 STS 識別。 （關於識別 RP 的 STS，請參見性質。 Issuer ）

此特性的值在 WS-Federation 協定中序列化為 wtrealm 查詢字串參數。 它將RP識別給STS。 STS 用它來決定代幣發行時應適用何種政策，以及代幣發行後應將使用者導向到哪裡。 （關於識別 RP 的 STS，請參見 Issuer。）

你可以在每個 HTTP 請求上，透過新增事件處理程序 RedirectingToIdentityProvider 來覆蓋這個設定。 此事件會在模組以 WS-Federation 登入請求訊息重定向至安全憑證服務（STS）之前被觸發。 STS 由 Issuer 屬性指定。