WSFederationAuthenticationModule.CanReadSignInResponse 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
傳回值,指出指定的 HTTP 要求是否為 WS-Federation 登入回應消息。 如果訊息是 WS-Federation 註銷清除訊息 (“wsignoutcleanup1.0”),這個方法會處理要求。
多載
| 名稱 | Description |
|---|---|
| CanReadSignInResponse(HttpRequestBase) |
傳回值,指出指定的 HTTP 要求是否為 WS-Federation 登入回應消息。 如果訊息是 WS-Federation 註銷清除訊息 (“wsignoutcleanup1.0”),這個方法會處理要求。 |
| CanReadSignInResponse(HttpRequestBase, Boolean) |
傳回值,指出指定的 HTTP 要求是否為 WS-Federation 登入回應消息。 如果訊息是 WS-Federation 註銷清除訊息 (“wsignoutcleanup1.0”),這個方法會處理要求。 |
備註
登入回應訊息由安全憑證服務(STS)在回應登入請求訊息時發送給依賴方(RP)。
CanReadSignInResponse(HttpRequestBase)
傳回值,指出指定的 HTTP 要求是否為 WS-Federation 登入回應消息。 如果訊息是 WS-Federation 註銷清除訊息 (“wsignoutcleanup1.0”),這個方法會處理要求。
public:
bool CanReadSignInResponse(System::Web::HttpRequestBase ^ request);
public bool CanReadSignInResponse(System.Web.HttpRequestBase request);
member this.CanReadSignInResponse : System.Web.HttpRequestBase -> bool
Public Function CanReadSignInResponse (request As HttpRequestBase) As Boolean
參數
- request
- HttpRequestBase
收到的 HTTP 請求。
傳回
true若指定的 HTTP 請求包含一個 POST 格式,其中 wa 參數設為「wsignout1.0」且 wresult 參數非空;否則,。 false
例外狀況
request 是 null。
備註
此方法從請求處理管線中調用,以判斷收到的 HTTP 請求是否為包含 WS-Federation 登出回應訊息的 FORM 貼文。
它會WSFederationAuthenticationModule.CanReadSignInResponse(HttpRequestBase, Boolean)呼叫過載,並設定onPagefalse參數表示呼叫並非在處理頁面時發出。
另請參閱
適用於
CanReadSignInResponse(HttpRequestBase, Boolean)
傳回值,指出指定的 HTTP 要求是否為 WS-Federation 登入回應消息。 如果訊息是 WS-Federation 註銷清除訊息 (“wsignoutcleanup1.0”),這個方法會處理要求。
public:
virtual bool CanReadSignInResponse(System::Web::HttpRequestBase ^ request, bool onPage);
public virtual bool CanReadSignInResponse(System.Web.HttpRequestBase request, bool onPage);
abstract member CanReadSignInResponse : System.Web.HttpRequestBase * bool -> bool
override this.CanReadSignInResponse : System.Web.HttpRequestBase * bool -> bool
Public Overridable Function CanReadSignInResponse (request As HttpRequestBase, onPage As Boolean) As Boolean
參數
- request
- HttpRequestBase
收到的 HTTP 請求。
- onPage
- Boolean
true 如果通話是在處理分頁請求時發出的。
false 如果呼叫者是 HTTP 模組。 此參數決定若收到訊息為 WS-Federation 登出清理訊息(「wsignoutcleanup1.0」),該如何終止處理或傳送重定向。
傳回
true若指定的 HTTP 請求包含一個 FORM 貼文,且 wa 參數設為「wsignout1.0」且 wresult 參數非空;否則,。 false
例外狀況
request 是 null。
備註
此方法會從請求處理管線中 WSFederationAuthenticationModule.CanReadSignInResponse(HttpRequestBase) 透過過載階段調用,以判斷收到的 HTTP 請求是否為包含 WS-Federation 登入回應訊息的表單 POST。
預設實作可執行以下功能:
若收到的請求為表單 POST,則會呼叫該 IsSignInResponse 方法來判斷表單 POST 是否包含登入回應。
若收到的請求不是表單 POST,且請求包含 WS-Federation 登出清理請求(wa 參數為「wsignoutcleanup1.0」),則會執行登出清理。 此時, WSFederationAuthenticationModule.SignOut(Boolean) 方法會被呼叫(參數設為
true表示登出清理)以登出會話。 這也會導致登出事件被觸發。接著,若登出清理請求包含 wreply 參數,客戶端會被導向該方法回傳 GetSignOutRedirectUrl 的 URL;否則,會回傳一個綠色勾勾的影像給 STS。 STS 可藉此影像確認 RP 已收到並成功處理登出清理請求。