MyJackfruit

Help
Browse topics · Sign-in and tokens

Sign-in and tokens

← Sign-in and tokens

How long do tokens last?

Short answer

Sign-in tokens last 7 days, renewed sign-ins 5 minutes to 14 days, machine and service tokens 300 seconds, browser-session tokens 1800 seconds.

Before you start

Words used here (1)
session
A session is one stretch of work with an agent, from its start until you close it; with Kai-Zen it ends in a handoff.
Deeper

A sign-in token, from the e-mail-code sign-in, lasts 7 days. That is a platform setting and can change, so read its exp claim, the expiry time inside the token, rather than the number. A review login, a fixed code the platform owner issues for an app-store review, gives one for 24 hours, or less if the code ends sooner.

A web page on an origin the platform owner approved for its app can renew a sign-in; an app published at its pages.dev address with the connector is approved on its own. The first token, and the new token each renewal gives, lasts 7 days or the renewal window, whichever is shorter, and each renewal moves the end of the sign-in to the window from now. Before 12 November 2026, 09:04 UTC, the first token lasted 7 days whatever the window. The window is what the app's owner chose, from 5 minutes up to 14 days, and 14 days if none was chosen; each renewal starts the time again. The answer on refreshing a token shows how.

A machine token, which your app's server gets as itself, lasts 300 seconds, with no refresh: ask again. A service token, which one outside service accepts for a signed-in person, lasts 300 seconds, or less if the sign-in token ends sooner.

GilbPlatform's own web apps get tokens from the person's browser sign-in at id.gilb.com: a plain Bearer token or a DPoP-bound one, each for 1800 seconds, asked for again while the browser sign-in lasts, up to 30 days after it was last used. The file gilb-session.token from Download key in GilbApp holds such a plain token and ends by itself after about 30 minutes.

A DPoP proof, a short signed note your app makes for one request, naming its method and address (RFC 9449), works once, and only within 60 seconds of the time written in it.

A token can end sooner. When your app signs the person out with POST https://id.gilb.com/base/auth/sign-out, every sign-in token on that key made until then is refused, by vaults within about 5 seconds, and so are the DPoP-bound browser tokens when the person signs out of GilbPlatform's own apps. A plain Bearer token is not ended by signing out: it runs to its end. When the person signs out, a service token already given keeps working at the service until it runs out, at most 300 seconds. If the person's account is suspended, its tokens stop working at the next request.

Time is not the only limit: a token bound to a key works only with the private key it is bound to, so a copy without the key is useless.

The full reference, with every field and every answer, is the Developer Guide, GilbPlatform's guide for people who build apps on it, in its chapter Dev.Guide.SignIn, https://appbuilder.gilb.com/base/e/06gkzpwhanxrh55sca1pdkxj88. Its exhibits TokenLife and Revocation hold the lifetime and the sign-out, and its exhibit StaySignedIn holds the renewal; that exhibit's examples are marked Not yet verified on production. It can be read with no sign-in, as data for programs and AIs rather than as a web page.

Source: GilbPlatform 498d29a0 (live at https://id.gilb.com/version, read 2026-11-11; code read at 498d29a0): src/config/index.ts:379-392, :648-649 (EMAIL_OTC_TOKEN_TTL_SEC_DEFAULT = 7 days), :683-687 (AUTH_EMAIL_OTC_TOKEN_TTL_SEC overrides); src/auth/email-otc.ts:457-462 (sign-in token TTL), :394 (review login: min(86400, remaining)); src/auth/renewable-sign-in.ts:75-85, :498-531, :641-672; src/routes/renew-sign-in.ts:140-148 (new token = min(TTL, remaining window)); src/routes/email-auth.ts:428-447; src/auth/machine-token.ts:94, :390-395 (expires_in 300); src/auth/outside-service-exchange.ts:367-382 (min(300, remaining)); src/routes/session-token.ts:129-130 (SESSION_TOKEN_TTL_SEC 1800), :412-416, :468-472; src/auth/browser-session.ts:119-124 (SESSION_TTL_MS 30 days), :583-584 (sliding); src/auth/verify.ts:76-79, :167-178 (proof 60 s, once); src/routes/sign-out.ts:1-104; src/auth/ended-sign-in.ts:1-22 (keyed by cnf.jkt: an unbound token is never ended); src/auth/ended-sign-in-set.ts:185 (5 s); src/routes/onboarding.ts:1315-1377 (browser sign-out ends the bridged DPoP keys); src/auth/bearer-principal.ts:28-31 (a suspended account resolves to no one on every surface); src/auth/verify.ts:415-423 (proof key must be the bound key). GilbApp ebd9415e: src/lib/base/localAgentToken.ts:1-20, src/components/LocalAgentTokenButton.tsx:19, :42 (Download key, about 30 minutes). Dev.Guide.SignIn (A 06gkzpwhanxrh55sca1pdkxj88, pack GilbPlatformDeveloperGuide, 2026-11-11; https://appbuilder.gilb.com/base/e/06gkzpwhanxrh55sca1pdkxj88; read for agreement, not copied) TokenLife (7 days; no refresh for an app outside the platform's own sites is out of date), Revocation (sign-out; suspension Not yet verified on production), ReviewLogin (24 hours), Programs (about 5 minutes). Rows: Security.SessionBridgeTokenShortLived, EmailTokenSevenDays (needs the renewal), MachineTokenFiveMinutes, TokenBoundToYourKey. GilbPlatform 0fc5a548 (https://id.gilb.com/version, read 13 November 2026): src/routes/email-auth.ts:440-446 (With a family started, the first token lasts no longer than this window.), src/auth/email-otc.ts:314-321, :441, :482 (first token = min(7 days, window)); revision 140ab2f0 (in 0fc5a548; live since 2026-11-12); src/routes/publish.ts:460-485. Dev.Guide.SignIn (https://appbuilder.gilb.com/base/e/06gkzpwhanxrh55sca1pdkxj88, read 13 November 2026) exhibit StaySignedIn ("From revision 140ab2f0: the first token lasts no longer than the window you asked for."; examples Not yet verified on production).

Checked against GilbApp d529620.