WSFederationAuthenticationModule.Realm 屬性

定義

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

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

嘗試將屬性設為 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 指定。