OAuthHandler<TOptions> 類別

定義

命名空間:

Microsoft.AspNetCore.Authentication.OAuth

組件:

Microsoft.AspNetCore.Authentication.OAuth.dll

套件:

Microsoft.AspNetCore.App.Ref v9.0.0

支援 OAuth 的驗證處理程式。

public class OAuthHandler<TOptions> : Microsoft.AspNetCore.Authentication.RemoteAuthenticationHandler<TOptions> where TOptions : OAuthOptions, new()

type OAuthHandler<'Options (requires 'Options :> OAuthOptions and 'Options : (new : unit -> 'Options))> = class
    inherit RemoteAuthenticationHandler<'Options (requires 'Options :> OAuthOptions and 'Options : (new : unit -> 'Options))>

Public Class OAuthHandler(Of TOptions)
Inherits RemoteAuthenticationHandler(Of TOptions)

類型參數

TOptions

選項的類型。

繼承

Object

AuthenticationHandler<TOptions>

RemoteAuthenticationHandler<TOptions>

OAuthHandler<TOptions>

衍生

Microsoft.AspNetCore.Authentication.Facebook.FacebookHandler

Microsoft.AspNetCore.Authentication.Google.GoogleHandler

Microsoft.AspNetCore.Authentication.MicrosoftAccount.MicrosoftAccountHandler

建構函式

OAuthHandler<TOptions>(IOptionsMonitor<TOptions>, ILoggerFactory, UrlEncoder, ISystemClock)	已淘汰. 初始化 OAuthHandler<TOptions>的新實例。
OAuthHandler<TOptions>(IOptionsMonitor<TOptions>, ILoggerFactory, UrlEncoder)	初始化 OAuthHandler<TOptions>的新實例。

屬性

Backchannel	取得用來與遠端驗證提供者通訊的 HttpClient 實例。
ChallengeCalled	支援 OAuth 的驗證處理程式。 (繼承來源 AuthenticationHandler<TOptions>)
ClaimsIssuer	取得發行任何宣告時應該使用的簽發者。 (繼承來源 AuthenticationHandler<TOptions>)
Clock	已淘汰. 取得 ISystemClock。 (繼承來源 AuthenticationHandler<TOptions>)
Context	取得或設定 HttpContext。 (繼承來源 AuthenticationHandler<TOptions>)
CurrentUri	取得絕對目前的URL。 (繼承來源 AuthenticationHandler<TOptions>)
Events	處理程式會在事件上呼叫方法，以在處理發生時的特定時間點提供應用程控。 如果未提供預設實例，則會在呼叫 方法時執行任何動作。
InitializeResult	支援 OAuth 的驗證處理程式。 (繼承來源 AuthenticationHandler<TOptions>)
Logger	取得 ILogger。 (繼承來源 AuthenticationHandler<TOptions>)
Options	取得或設定與這個驗證處理程式相關聯的選項。 (繼承來源 AuthenticationHandler<TOptions>)
OptionsMonitor	取得 IOptionsMonitor<TOptions>，以偵測選項的變更。 (繼承來源 AuthenticationHandler<TOptions>)
OriginalPath	取得驗證中間件所見的路徑。 (繼承來源 AuthenticationHandler<TOptions>)
OriginalPathBase	取得驗證中間件所見的路徑基底。 (繼承來源 AuthenticationHandler<TOptions>)
PriorHandler	支援 OAuth 的驗證處理程式。 (繼承來源 AuthenticationHandler<TOptions>)
Request	取得與目前要求相關聯的 HttpRequest。 (繼承來源 AuthenticationHandler<TOptions>)
Response	取得與目前要求相關聯的 HttpResponse。 (繼承來源 AuthenticationHandler<TOptions>)
Scheme	取得或設定與此驗證處理程式相關聯的 AuthenticationScheme。 (繼承來源 AuthenticationHandler<TOptions>)
SignInAccepted	支援 OAuth 的驗證處理程式。 (繼承來源 AuthenticationHandler<TOptions>)
SignInScheme	預設用於登入的驗證配置。 (繼承來源 RemoteAuthenticationHandler<TOptions>)
SignOutAccepted	支援 OAuth 的驗證處理程式。 (繼承來源 AuthenticationHandler<TOptions>)
TimeProvider	取得目前時間，主要是用於單元測試。 (繼承來源 AuthenticationHandler<TOptions>)
UrlEncoder	取得 UrlEncoder。 (繼承來源 AuthenticationHandler<TOptions>)

方法

AuthenticateAsync()	驗證目前的要求。 (繼承來源 AuthenticationHandler<TOptions>)
AuthenticateAsync(AuthenticateContext)	支援 OAuth 的驗證處理程式。 (繼承來源 AuthenticationHandler<TOptions>)
BuildChallengeUrl(AuthenticationProperties, String)	建構 OAuth 挑戰URL。
BuildRedirectUri(String)	建構指定之 targetPath的絕對 URL。 (繼承來源 AuthenticationHandler<TOptions>)
ChallengeAsync(AuthenticationProperties)	挑戰目前的要求。 (繼承來源 AuthenticationHandler<TOptions>)
ChallengeAsync(ChallengeContext)	支援 OAuth 的驗證處理程式。 (繼承來源 AuthenticationHandler<TOptions>)
CreateEventsAsync()	建立事件實例的新實例。
CreateTicketAsync(ClaimsIdentity, AuthenticationProperties, OAuthTokenResponse)	從指定的 tokens建立 AuthenticationTicket。
ExchangeCodeAsync(OAuthCodeExchangeContext)	從遠端提供者交換授權令牌的授權碼。
FinishResponseAsync()	即將傳送回應時所呼叫的勾點 (繼承來源 AuthenticationHandler<TOptions>)
ForbidAsync(AuthenticationProperties)	禁止目前的要求。 (繼承來源 AuthenticationHandler<TOptions>)
FormatScope()	格式化 Scope 屬性。
FormatScope(IEnumerable<String>)	格式化 OAuth 範圍清單。
GenerateCorrelationId(AuthenticationProperties)	產生包含 Nonce 的 Cookie，用來將目前的遠端驗證要求相互關聯。 (繼承來源 RemoteAuthenticationHandler<TOptions>)
GenerateCorrelationId(AuthenticationProperties)	支援 OAuth 的驗證處理程式。 (繼承來源 RemoteAuthenticationHandler<TOptions>)
GetDescriptions(DescribeSchemesContext)	支援 OAuth 的驗證處理程式。 (繼承來源 AuthenticationHandler<TOptions>)
HandleAccessDeniedErrorAsync(AuthenticationProperties)	衍生類型可能會覆寫此方法來處理拒絕存取錯誤。 (繼承來源 RemoteAuthenticationHandler<TOptions>)
HandleAuthenticateAsync()	允許衍生類型處理驗證。 (繼承來源 RemoteAuthenticationHandler<TOptions>)
HandleAuthenticateOnceAsync()	用來確保 HandleAuthenticateAsync 只會叫用一次。 後續呼叫會傳回相同的驗證結果。 (繼承來源 AuthenticationHandler<TOptions>)
HandleAuthenticateOnceSafeAsync()	用來確保 HandleAuthenticateAsync 只會安全地叫用一次。 後續呼叫會傳回相同的驗證結果。 任何例外狀況都會轉換成包含例外狀況的失敗驗證結果。 (繼承來源 AuthenticationHandler<TOptions>)
HandleChallengeAsync(AuthenticationProperties)	覆寫此方法來處理 401 挑戰考慮，如果有問題的驗證配置會處理驗證互動，做為要求流程的一部分。 （例如新增響應標頭，或將 401 結果變更為登入頁面或外部登入位置的 302。
HandleForbiddenAsync(AuthenticationProperties)	覆寫此方法以處理 Forbid。 (繼承來源 RemoteAuthenticationHandler<TOptions>)
HandleForbiddenAsync(ChallengeContext)	支援 OAuth 的驗證處理程式。 (繼承來源 RemoteAuthenticationHandler<TOptions>)
HandleRemoteAuthenticateAsync()	使用識別提供者驗證使用者身分識別。 方法會處理 CallbackPath 所定義端點上的要求。
HandleRemoteCallbackAsync()	支援 OAuth 的驗證處理程式。 (繼承來源 RemoteAuthenticationHandler<TOptions>)
HandleRequestAsync()	處理目前的驗證要求。 (繼承來源 RemoteAuthenticationHandler<TOptions>)
HandleSignInAsync(SignInContext)	支援 OAuth 的驗證處理程式。 (繼承來源 RemoteAuthenticationHandler<TOptions>)
HandleSignOutAsync(SignOutContext)	支援 OAuth 的驗證處理程式。 (繼承來源 RemoteAuthenticationHandler<TOptions>)
HandleUnauthorizedAsync(ChallengeContext)	覆寫此方法來處理 401 挑戰考慮，如果有問題的驗證配置會處理驗證互動，做為要求流程的一部分。 （例如新增響應標頭，或將 401 結果變更為登入頁面或外部登入位置的 302。 (繼承來源 AuthenticationHandler<TOptions>)
InitializeAsync(AuthenticationScheme, HttpContext)	初始化處理程式，解析選項並加以驗證。 (繼承來源 AuthenticationHandler<TOptions>)
InitializeAsync(TOptions, HttpContext, ILogger, UrlEncoder)	每個要求會呼叫初始化一次，以適當狀態將此實例內容化。 (繼承來源 AuthenticationHandler<TOptions>)
InitializeEventsAsync()	初始化事件物件，InitializeAsync(AuthenticationScheme, HttpContext)的每個要求呼叫一次。 (繼承來源 AuthenticationHandler<TOptions>)
InitializeHandlerAsync()	在已初始化選項/事件之後呼叫，處理程式完成初始化本身。 (繼承來源 AuthenticationHandler<TOptions>)
ResolveTarget(String)	解析此驗證作業轉送至的配置。 (繼承來源 AuthenticationHandler<TOptions>)
ShouldHandleRequestAsync()	取得值，這個值會判斷目前的驗證要求是否應該由 HandleRequestAsync()處理。 (繼承來源 RemoteAuthenticationHandler<TOptions>)
ShouldHandleScheme(String, Boolean)	支援 OAuth 的驗證處理程式。 (繼承來源 AuthenticationHandler<TOptions>)
SignInAsync(SignInContext)	支援 OAuth 的驗證處理程式。 (繼承來源 AuthenticationHandler<TOptions>)
SignOutAsync(SignOutContext)	支援 OAuth 的驗證處理程式。 (繼承來源 AuthenticationHandler<TOptions>)
ValidateCorrelationId(AuthenticationProperties)	驗證目前的要求是否與目前的遠端驗證要求相互關聯。 (繼承來源 RemoteAuthenticationHandler<TOptions>)
ValidateCorrelationId(AuthenticationProperties)	支援 OAuth 的驗證處理程式。 (繼承來源 RemoteAuthenticationHandler<TOptions>)