SignInRequestMessage 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
代表「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
- 繼承
範例
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) |