Token Transport

Last updated


This page explains where the package reads tokens from a request, where it writes new tokens, and which cookie attributes it sets.

Read Order


ValueFirstFallback
Access Tokenauthorization: Bearer <token> headercookie AccessTokenCookieKey (default access_token)
Refresh IDX-Refresh-ID headercookie RefreshTokenCookieKey (default refresh_id)
Device IDX-Device-ID headerreq.body.deviceId

Cookies are read from req.cookies, so mount cookie-parser first.

Write Locations


WhenWrites
CreateJWT()Access cookie, refresh cookie; return value { token, refresh_id }
VerifyJWT() on refreshAccess cookie, refresh cookie, X-New-Access-Token, X-New-Refresh-ID
RevokeJWT()Clears both cookies


AttributeisProd: trueisProd: false
httpOnlytruetrue
securetruefalse
sameSitenonelax
domainconfig.domainlocalhost
path//
LifetimeAccess: accessTokenExpires; refresh: refreshTokenExpiresSame

Related: Client Integration, Configuration
中文