Login Page Cookies

On this page

FusionAuth sets cookies in the browser when you use the hosted login pagesThe login, registration, password recovery, and multi-factor authentication pages that FusionAuth serves. A Theme controls the look of the pages. or the hosted backend. Some APIs, such as the Login APIThe FusionAuth API that logs a user in without the hosted login pages., also set cookies. The API documentation lists those cookies.

Domains#

FusionAuth sets every cookie on the host that serves FusionAuth. When FusionAuth serves auth.example.com, FusionAuth sets cookies for auth.example.com and never for .example.com. To change the host, put FusionAuth behind a proxy. For more information, see Proxy FusionAuth.

Most FusionAuth cookies use a SameSite value of Strict or Lax, to protect against cross-site request forgery. The browser leaves those cookies off cross-site requests, except for top-level navigation. A FusionAuth page in an iframe on another site therefore can't read the cookies. FusionAuth marks cookies Secure only when FusionAuth serves the page over HTTPS.

Caution

The following list is for information only. Cookie names, types, and descriptions can change in any release.

NameTypeDescription
access_tokenSessionThe access token. Set by the login API.
app.atPersistentThe access token. Set by the hosted backend.
app.at_expPersistentThe access token expiration. Set by the hosted backend.
app.idtPersistentThe Id token. Set by the hosted backend.
app.pkce_vPersistentThe PKCE verifier. Set by the hosted backend.
app.rtPersistentThe refresh token. Set by the hosted backend.
fa.bypass-cSessionImplements security functionality.
fa.bypass-c.csrfSessionImplements security functionality.
federated.csrfSessionImplements security functionality.
fusionauth.app.pkce-verifierRequestUsed to support Proof Key for Code Exchange during login.
fusionauth.csrfSessionImplements security functionality.
fusionauth.flash-messageRequestUsed to display a message across requests.
fusionauth.known-device.*PersistentIdentifies a device known to FusionAuth. More than one cookie may be set.
fusionauth.liSessionUsed to support post-authentication steps during login.
fusionauth.localePersistentThe locale used to localize the themed pages.
fusionauth.pkce-verifierRequestImplements security functionality.
fusionauth.remember-devicePersistentRecords whether the user wants to remain logged in on this device.
fusionauth.ssoPersistentRepresents a single sign-on session.
fusionauth.timezonePersistentThe configured or approximated timezone used to adjust displayed dates and times.
fusionauth.trustPersistentAllows a MFA challenge to be bypassed during login.
fusionauth.trust_cRequestImplements security functionality.
fusionauth.trust_tRequestImplements security functionality.
fusionauth.trusted-device.*PersistentIdentifies a trusted device. More than one cookie may be set.
fusionauth.webauthn-reauth.*PersistentRecords user choices about WebAuthn and passkeys. More than one cookie may be set.
refresh_tokenPersistentThe refresh token when the login API is used.
saml.csrfSessionImplements security functionality.