SignInRequestMessage 類別

定義

命名空間:

System.IdentityModel.Services

組件:

System.IdentityModel.Services.dll

代表「WS-同盟登入要求」訊息。

public ref class SignInRequestMessage : System::IdentityModel::Services::WSFederationMessage

public class SignInRequestMessage : System.IdentityModel.Services.WSFederationMessage

type SignInRequestMessage = class
    inherit WSFederationMessage

Public Class SignInRequestMessage
Inherits WSFederationMessage

繼承

Object

FederationMessage

WSFederationMessage

SignInRequestMessage

範例

string identityProviderUri = Request.QueryString["whr"];
string action = Request.QueryString["wa"];

SignInRequestMessage signInRequest = FederatedAuthentication.WSFederationAuthenticationModule.CreateSignInRequest(Guid.NewGuid().ToString(), 
                                                                                                                  "http://MyAppreturnUrl", 
                                                                                                                  false);
signInRequest.Realm = "htp://MyApp.com";
signInRequest.HomeRealm = identityProviderUri;

Response.Redirect(signInRequest.RequestUrl);

備註

WS-Federation 登入訊息是由信賴憑證者 (RP) 傳送至安全性令牌服務， (STS) 要求安全性令牌。 wa 參數必須設定為 “wsignout1.0”，而 wtrealm 參數應該設定為所要求資源的安全性領域， (這通常是所要求資源的 URL) 。 您也可以在要求中指定其他選擇性參數。

SignOutRequestMessage訊息是由 類別的SignOutRequestMessage靜態方法所建立，例如CreateFromUri，當 wa 參數設定為 “wsignin1.0” 時，沒有 wresult 或 wresultptr 參數存在，而且 wtrealm 參數或 wreply 參數存在。

重要

為了與 Active Directory 同盟服務 (AD FS) 1.0 版的回溯相容性，Windows Identity Foundation (WIF) 允許 wtrealm 參數或 wreply 參數設定為 (或兩者) ，讓登入訊息有效;不過，WS-Federation 通訊協定會要求 wtrealm 參數出現在登入要求中。 在大部分情況下，您應該確定已指定 wtrealm 參數。

類別 SignInRequestMessage 會公開數個可用來設定或存取個別訊息參數的屬性。 您也可以透過 Parameters 字典來設定或存取這些參數。 例如，您可以透過 Realm 屬性或在訊息中將 「wtrealm」 指定為字典的索引鍵 Parameters ，來讀取訊息中的 wtrealm 參數。

如需此類別所代表之訊息的詳細資訊，請參閱下列規格的第13節： Web服務同盟語言 (WS-Federation) 1.2 版。

建構函式

SignInRequestMessage(Uri, String)	使用指定的基底 URL 和 wtrealm 參數，初始化 SignInRequestMessage 類別的新執行個體。
SignInRequestMessage(Uri, String, String)	使用指定的基底 URI、wtrealm 參數和 wreply 參數，初始化 SignInRequestMessage 類別的新執行個體。 支援建立非標準訊息以提供回溯相容性。

屬性

Action	取得或設定訊息的 wa 參數。 (繼承來源 WSFederationMessage)
AuthenticationType	取得或設定訊息的 wauth 參數。
BaseUri	取得或設定訊息套用至其中的基底 URL。 (繼承來源 FederationMessage)
Context	取得或設定訊息的 wctx 參數。 (繼承來源 WSFederationMessage)
CurrentTime	取得或設定訊息的 wct 參數。
Encoding	取得或設定訊息的 wencoding 參數。 (繼承來源 WSFederationMessage)
Federation	取得或設定訊息的 wfed 參數。
Freshness	取得或設定訊息的 wfresh 參數。
HomeRealm	取得或設定訊息的 whr 參數。
Parameters	取得訊息參數，做為字典。 (繼承來源 FederationMessage)
Policy	取得或設定訊息的 wp 參數。
Realm	取得或設定訊息的 wtrealm 參數。
Reply	取得或設定訊息的 wreply 參數。
Request	取得或設定訊息的 wreq 參數。
RequestPtr	取得或設定訊息的 wreqptr 參數。
RequestUrl	取得對應至此訊息的 URL 字串表示。
Resource	取得或設定訊息的 wres 參數。

方法

Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetParameter(String)	從參數字典傳回指定的參數值。 (繼承來源 FederationMessage)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
RemoveParameter(String)	從參數字典中移除參數。 (繼承來源 FederationMessage)
SetParameter(String, String)	設定參數字典中的參數值。 (繼承來源 FederationMessage)
SetUriParameter(String, String)	設定參數字典中的參數值。 此值必須是絕對 URI。 (繼承來源 FederationMessage)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)
Validate()	驗證目前的執行個體。
Write(TextWriter)	將這個查詢字串格式的訊息寫入至指定的文字寫入器。
WriteFormPost()	將訊息序列化為表單張貼並傳回結果表單與其字串 Javascript。 (繼承來源 FederationMessage)
WriteQueryString()	傳回代表查詢字串格式訊息的字串。 (繼承來源 FederationMessage)

另請參閱

• SignInResponseMessage