CookieAuthenticationOptions Class

Definition

Configuration options for CookieAuthenticationOptions.

public class CookieAuthenticationOptions : Microsoft.AspNetCore.Authentication.AuthenticationSchemeOptions
Inheritance
CookieAuthenticationOptions

Constructors

CookieAuthenticationOptions()

Create an instance of the options initialized with the default values

Properties

AccessDeniedPath

The AccessDeniedPath property informs the handler that it should change an outgoing 403 Forbidden status code into a 302 redirection onto the given path.

ClaimsIssuer

Gets or sets the issuer that should be used for any claims that are created

(Inherited from AuthenticationSchemeOptions)
Cookie

Determines the settings used to create the cookie.

defaults to Lax. defaults to true. defaults to SameAsRequest.

CookieDomain

This property is obsolete and will be removed in a future version. The recommended alternative is on Cookie.

Determines the domain used to create the cookie. Is not provided by default.

CookieHttpOnly

This property is obsolete and will be removed in a future version. The recommended alternative is on Cookie.

Determines if the browser should allow the cookie to be accessed by client-side javascript. The default is true, which means the cookie will only be passed to http requests and is not made available to script on the page.

CookieManager

The component used to get cookies from the request or set them on the response.

ChunkingCookieManager will be used by default.

CookieName

This property is obsolete and will be removed in a future version. The recommended alternative is on Cookie.

Determines the cookie name used to persist the identity. The default value is ".AspNetCore.Cookies". This value should be changed if you change the name of the AuthenticationScheme, especially if your system uses the cookie authentication handler multiple times.

CookiePath

This property is obsolete and will be removed in a future version. The recommended alternative is on Cookie.

Determines the path used to create the cookie. The default value is "/" for highest browser compatibility.

CookieSecure

This property is obsolete and will be removed in a future version. The recommended alternative is on Cookie.

Determines if the cookie should only be transmitted on HTTPS request. The default is to limit the cookie to HTTPS requests if the page which is doing the SignIn is also HTTPS. If you have an HTTPS sign in page and portions of your site are HTTP you may need to change this value.

DataProtectionProvider

If set this will be used by the CookieAuthenticationHandler for data protection.

Events

The Provider may be assigned to an instance of an object created by the application at startup time. The handler calls methods on the provider which give the application control at certain points where processing is occurring. If it is not provided a default instance is supplied which does nothing when the methods are called.

EventsType

If set, will be used as the service type to get the Events instance instead of the property.

(Inherited from AuthenticationSchemeOptions)
ExpireTimeSpan

Controls how much time the authentication ticket stored in the cookie will remain valid from the point it is created The expiration information is stored in the protected cookie ticket. Because of that an expired cookie will be ignored even if it is passed to the server after the browser should have purged it.

This is separate from the value of , which specifies how long the browser will keep the cookie.

LoginPath

The LoginPath property informs the handler that it should change an outgoing 401 Unauthorized status code into a 302 redirection onto the given login path. The current url which generated the 401 is added to the LoginPath as a query string parameter named by the ReturnUrlParameter. Once a request to the LoginPath grants a new SignIn identity, the ReturnUrlParameter value is used to redirect the browser back to the url which caused the original unauthorized status code.

LogoutPath

If the LogoutPath is provided the handler then a request to that path will redirect based on the ReturnUrlParameter.

ReturnUrlParameter

The ReturnUrlParameter determines the name of the query string parameter which is appended by the handler when a 401 Unauthorized status code is changed to a 302 redirect onto the login path. This is also the query string parameter looked for when a request arrives on the login path or logout path, in order to return to the original url after the action is performed.

SessionStore

An optional container in which to store the identity across requests. When used, only a session identifier is sent to the client. This can be used to mitigate potential problems with very large identities.

SlidingExpiration

The SlidingExpiration is set to true to instruct the handler to re-issue a new cookie with a new expiration time any time it processes a request which is more than halfway through the expiration window.

TicketDataFormat

The TicketDataFormat is used to protect and unprotect the identity and other properties which are stored in the cookie value. If not provided one will be created using DataProtectionProvider.

Methods

Validate()

Check that the options are valid. Should throw an exception if things are not ok.

(Inherited from AuthenticationSchemeOptions)

Applies to