AuthenticationHandler Class

Article
10/27/2015

Base class for the per-request work performed by most authentication middleware.

Namespace: Microsoft.Owin.Security.Infrastructure
Assembly: Microsoft.Owin.Security (in Microsoft.Owin.Security.dll)

Inheritance Hierarchy

System.Object
Microsoft.Owin.Security.Infrastructure.AuthenticationHandler
Microsoft.Owin.Security.Infrastructure.AuthenticationHandler<TOptions>

Syntax

public abstract class AuthenticationHandler

public ref class AuthenticationHandler abstract

[<AbstractClass>]
type AuthenticationHandler = class end

Public MustInherit Class AuthenticationHandler

Constructors

	Name	Description
	AuthenticationHandler()	Initializes a new instance of the AuthenticationHandler class.

Properties

	Name	Description
	Context
	Faulted
	Helper
	Request
	RequestPathBase
	Response

Methods

	Name	Description
	ApplyResponseChallengeAsync()	Override this method to dela with 401 challenge concerns, if an authentication scheme in question deals an authentication interaction as part of it's request flow. (like adding a response header, or changing the 401 result to 302 of a login page or external sign-in location.)
	ApplyResponseCoreAsync()	Core method that may be overridden by handler. The default behavior is to call two common response activities, one that deals with sign-in/sign-out concerns, and a second to deal with 401 challenges.
	ApplyResponseGrantAsync()	Override this method to dela with sign-in/sign-out concerns, if an authentication scheme in question deals with grant/revoke as part of it's request flow. (like setting/deleting cookies)
	AuthenticateAsync()	Causes the authentication logic in AuthenticateCore to be performed for the current request at most once and returns the results. Calling Authenticate more than once will always return the original value. This method should always be called instead of calling AuthenticateCore directly.
	AuthenticateCoreAsync()	The core authentication logic which must be provided by the handler. Will be invoked at most once per request. Do not call directly, call the wrapping Authenticate method instead.
	BaseInitializeAsync(AuthenticationOptions, IOwinContext)
	Equals(Object)	(Inherited from Object.)
	Finalize()	(Inherited from Object.)
	GenerateCorrelationId(AuthenticationProperties)
	GetHashCode()	(Inherited from Object.)
	GetType()	(Inherited from Object.)
	InitializeCoreAsync()
	InvokeAsync()	Called once by common code after initialization. If an authentication middleware responds directly to specifically known paths it must override this virtual, compare the request path to it's known paths, provide any response information as appropriate, and true to stop further processing.
	MemberwiseClone()	(Inherited from Object.)
	TeardownCoreAsync()
	ToString()	(Inherited from Object.)
	ValidateCorrelationId(AuthenticationProperties, ILogger)

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.