Choose between local no-auth mode and an external auth provider.
Second supports two authentication modes, controlled by the SECOND_AUTH_MODE environment variable.
none mode (local development)
Designed for local development and trusted internal networks. Identity is managed entirely within Second.How it works:
User fills out /onboarding/identity (display name + email).
A local signed session cookie is issued.
Users without workspace memberships are redirected to /onboarding/workspace.
Cookie signatures use an auto-generated process secret — no external config needed.
Do not expose none mode to the public internet. There is no real authentication — anyone who can reach the server can create an identity.
Local mode does not send real workspace invitations. The members UI still shows
roles and governance state, but invitation actions explain that external
authentication is required. For local multi-user testing, seed a second user into
an existing workspace with scripts/local-workspace-member.mjs; the seeded user
is added to the workspace’s default General team.
external mode (production)
For internet-facing deployments. Second delegates authentication to your own provider.Your provider must:
Resolve the authenticated actor on each request
Return a stable user identifier
Map the identity into Second’s users and membership model
Sync workspace memberships and roles into Second’s workspace_memberships
Send and reconcile workspace invitations when collaboration is enabled
If external mode is set but no provider extension is present, the app fails fast on startup — you’ll see a clear error rather than silent misbehavior.External providers should map each workspace to the provider’s organization or
tenant concept. Accepted invitations must upsert the Second user, upsert the
workspace membership with a validated role (owner, admin, or member), and
ensure the user belongs to the workspace’s default General team.
How auth mode affects authorization
Authentication mode only changes where identity comes from. The authorization flow is the same regardless:
Resolve actor (from session cookie or external provider)
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Second","colors":{"primary":"#0D9373"},"logo":{"light":"https://mintcdn.com/second-232e8a64/y8YPAohSgaZLlL4S/assets/second-logo-light.svg?fit=max\u0026auto=format\u0026n=y8YPAohSgaZLlL4S\u0026q=85\u0026s=bafa7977425a9354a690ccee23c1b2bf","dark":"https://mintcdn.com/second-232e8a64/y8YPAohSgaZLlL4S/assets/second-logo-dark.svg?fit=max\u0026auto=format\u0026n=y8YPAohSgaZLlL4S\u0026q=85\u0026s=89b751f307b24554c7ece434b8f306d0"},"favicon":{"light":"https://mintcdn.com/second-232e8a64/y8YPAohSgaZLlL4S/assets/favicon-black.svg?fit=max\u0026auto=format\u0026n=y8YPAohSgaZLlL4S\u0026q=85\u0026s=82636516125f017788857acf390f28d5","dark":"https://mintcdn.com/second-232e8a64/y8YPAohSgaZLlL4S/assets/favicon-white.svg?fit=max\u0026auto=format\u0026n=y8YPAohSgaZLlL4S\u0026q=85\u0026s=fd85a2965df6172ff32cd04ff958b420"},"icons":{"library":"lucide"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"second-232e8a64","hasAudioNarration":false,"actualSubdomain":"second-232e8a64","customDomains":["docs.second.so"],"gitSource":{"type":"github","owner":"second-inc","repo":"second","deployBranch":"main","contentDirectory":"docs","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6ae94a44e5b11aa510b63c8d:success","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Architecture","count":14},{"language":"default","tag":"Getting Started","count":4},{"language":"default","tag":"Deployment","count":2},{"language":"default","tag":"Community","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"authentication","slug":"/authentication","pageMetadata":{"title":"Authentication","description":"Choose between local no-auth mode and an external auth provider.","icon":"key-round","href":"/authentication"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Choose between local no-auth mode and an external auth provider.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Second supports two authentication modes, controlled by the `,_jsx(_components.code,{children:`SECOND_AUTH_MODE`}),` environment variable.`]}),`\n`,_jsxs(Heading,{level:`2`,id:`none-mode-local-development`,children:[_jsx(_components.code,{children:`none`}),` mode (local development)`]}),`\n`,_jsx(_components.p,{children:`Designed for local development and trusted internal networks. Identity is managed entirely within Second.`}),`\n`,_jsx(_components.p,{children:`How it works:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`User fills out `,_jsx(_components.code,{children:`/onboarding/identity`}),` (display name + email).`]}),`\n`,_jsx(_components.li,{children:`A local signed session cookie is issued.`}),`\n`,_jsxs(_components.li,{children:[`Users without workspace memberships are redirected to `,_jsx(_components.code,{children:`/onboarding/workspace`}),`.`]}),`\n`,_jsx(_components.li,{children:`Cookie signatures use an auto-generated process secret — no external config needed.`}),`\n`]}),`\n`,_jsxs(Warning,{children:[`Do not expose `,_jsx(_components.code,{children:`none`}),` mode to the public internet. There is no real authentication — anyone who can reach the server can create an identity.`]}),`\n`,_jsxs(_components.p,{children:[`Local mode does not send real workspace invitations. The members UI still shows\nroles and governance state, but invitation actions explain that external\nauthentication is required. For local multi-user testing, seed a second user into\nan existing workspace with `,_jsx(_components.code,{children:`scripts/local-workspace-member.mjs`}),`; the seeded user\nis added to the workspace’s default `,_jsx(_components.code,{children:`General`}),` team.`]}),`\n`,_jsxs(Heading,{level:`2`,id:`external-mode-production`,children:[_jsx(_components.code,{children:`external`}),` mode (production)`]}),`\n`,_jsx(_components.p,{children:`For internet-facing deployments. Second delegates authentication to your own provider.`}),`\n`,_jsx(_components.p,{children:`Your provider must:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Resolve the authenticated actor on each request`}),`\n`,_jsx(_components.li,{children:`Return a stable user identifier`}),`\n`,_jsxs(_components.li,{children:[`Map the identity into Second’s `,_jsx(_components.code,{children:`users`}),` and membership model`]}),`\n`,_jsxs(_components.li,{children:[`Sync workspace memberships and roles into Second’s `,_jsx(_components.code,{children:`workspace_memberships`})]}),`\n`,_jsx(_components.li,{children:`Send and reconcile workspace invitations when collaboration is enabled`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`If `,_jsx(_components.code,{children:`external`}),` mode is set but no provider extension is present, the app fails fast on startup — you’ll see a clear error rather than silent misbehavior.`]}),`\n`,_jsxs(_components.p,{children:[`External providers should map each workspace to the provider’s organization or\ntenant concept. Accepted invitations must upsert the Second user, upsert the\nworkspace membership with a validated role (`,_jsx(_components.code,{children:`owner`}),`, `,_jsx(_components.code,{children:`admin`}),`, or `,_jsx(_components.code,{children:`member`}),`), and\nensure the user belongs to the workspace’s default `,_jsx(_components.code,{children:`General`}),` team.`]}),`\n`,_jsx(Heading,{level:`2`,id:`how-auth-mode-affects-authorization`,children:`How auth mode affects authorization`}),`\n`,_jsxs(_components.p,{children:[`Authentication mode only changes `,_jsx(_components.strong,{children:`where identity comes from`}),`. The authorization flow is the same regardless:`]}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`Resolve actor (from session cookie or external provider)`}),`\n`,_jsx(_components.li,{children:`Verify workspace membership`}),`\n`,_jsx(_components.li,{children:`Check any route-level workspace permission`}),`\n`,_jsxs(_components.li,{children:[`Query scoped by `,_jsx(_components.code,{children:`workspaceId`})]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/guard-and-tenancy`,children:`Guard and Tenancy`}),` for the full enforcement model.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Authentication","description":"Choose between local no-auth mode and an external auth provider.","icon":"key-round","href":"/authentication"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"none mode (local development)","slug":"none-mode-local-development","depth":2,"children":[]},{"title":"external mode (production)","slug":"external-mode-production","depth":2,"children":[]},{"title":"How auth mode affects authorization","slug":"how-auth-mode-affects-authorization","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"second-232e8a64","siteName":"Second","title":"Authentication - Second","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-05-17T15:26:31.081Z","originalFileLocation":"authentication.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Choose between local no-auth mode and an external auth provider.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Second\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/second-232e8a64/2g4sX9umberuUO_W/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/second-232e8a64/2g4sX9umberuUO_W/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/second-232e8a64/2g4sX9umberuUO_W/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/second-232e8a64/2g4sX9umberuUO_W/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/second-232e8a64/2g4sX9umberuUO_W/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/second-232e8a64/2g4sX9umberuUO_W/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/second-232e8a64/2g4sX9umberuUO_W/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/second-232e8a64/2g4sX9umberuUO_W/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/second-232e8a64/2g4sX9umberuUO_W/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Authentication - Second\">\u003cmeta data-mint-head property=\"og:description\" content=\"Choose between local no-auth mode and an external auth provider.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Second\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.second.so/authentication\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://second-232e8a64.mintlify.site/_mintlify/api/og/v2?division=Architecture\u0026amp;title=Authentication\u0026amp;description=Choose+between+local+no-auth+mode+and+an+external+auth+provider.\u0026amp;theme=8362ae10edea568685c84275\u0026amp;signature=3611d4db6a5e11e0438612f518ebf972cdca18acdb7a6195d3ba6c4b84bb9f28\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Authentication - Second\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Choose between local no-auth mode and an external auth provider.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://second-232e8a64.mintlify.site/_mintlify/api/og/v2?division=Architecture\u0026amp;title=Authentication\u0026amp;description=Choose+between+local+no-auth+mode+and+an+external+auth+provider.\u0026amp;theme=8362ae10edea568685c84275\u0026amp;signature=3611d4db6a5e11e0438612f518ebf972cdca18acdb7a6195d3ba6c4b84bb9f28\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/second-232e8a64/2g4sX9umberuUO_W/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Second\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0D9373\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.second.so/authentication\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/authentication.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.second.so/#organization\",\"name\":\"Second\",\"url\":\"https://docs.second.so\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/second-232e8a64/y8YPAohSgaZLlL4S/assets/second-logo-light.svg?fit=max\u0026auto=format\u0026n=y8YPAohSgaZLlL4S\u0026q=85\u0026s=bafa7977425a9354a690ccee23c1b2bf\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.second.so#website\",\"name\":\"Second\",\"url\":\"https://docs.second.so\",\"publisher\":{\"@id\":\"https://docs.second.so/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.second.so/authentication#webpage\",\"url\":\"https://docs.second.so/authentication\",\"name\":\"Authentication\",\"description\":\"Choose between local no-auth mode and an external auth provider.\",\"dateModified\":\"2026-05-17T15:26:31.081Z\",\"isPartOf\":{\"@id\":\"https://docs.second.so#website\"},\"breadcrumb\":{\"@id\":\"https://docs.second.so/authentication#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.second.so/authentication#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Architecture\",\"item\":\"https://docs.second.so/architecture\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Authentication\",\"item\":\"https://docs.second.so/authentication\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.second.so/authentication#article\",\"headline\":\"Authentication\",\"name\":\"Authentication\",\"description\":\"Choose between local no-auth mode and an external auth provider.\",\"url\":\"https://docs.second.so/authentication\",\"mainEntityOfPage\":{\"@id\":\"https://docs.second.so/authentication#webpage\"},\"dateModified\":\"2026-05-17T15:26:31.081Z\",\"publisher\":{\"@id\":\"https://docs.second.so/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.second.so#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Second\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Second\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/authentication.md","siteName":"Second","nav":{"global":null,"groups":[{"group":"Getting Started","pages":[{"title":"Get started with Second","href":"/index"},{"title":"Quickstart","href":"/quickstart"},{"title":"Enterprise Deployment and Security","href":"/enterprise"},{"title":"Development","href":"/development"}]},{"group":"Architecture","pages":[{"title":"Architecture","icon":"network","href":"/architecture"},{"title":"App Governance","icon":"shield-check","href":"/app-governance"},{"title":"Source Control","icon":"git-branch","href":"/source-control"},{"title":"Agent System","icon":"bot","href":"/agent-system"},{"title":"App Agents","icon":"users-round","href":"/app-agents"},{"title":"App Data","icon":"database","href":"/app-data"},{"title":"Integrations","icon":"plug","href":"/integrations"},{"title":"Worker","icon":"server-cog","href":"/worker"},{"title":"App Preview","icon":"monitor","href":"/app-preview"},{"title":"Streaming","icon":"radio","href":"/streaming"},{"title":"Runtimes, Models \u0026 Usage Tracking","icon":"gauge","href":"/models-and-usage"},{"title":"Guard and Tenancy","description":"How Second enforces workspace isolation, access control, and scoped database queries.","icon":"shield","href":"/guard-and-tenancy"},{"title":"Authentication","icon":"key-round","href":"/authentication"},{"title":"Product analytics","description":"How Second captures PostHog events while preserving the anonymized usage-data setting.","icon":"chart-line","href":"/product-analytics"}]},{"group":"Deployment","pages":[{"title":"Self-hosting","icon":"cloud-cog","href":"/self-hosting"},{"title":"Deployed Slowness Playbook","icon":"activity","href":"/deployed-slowness-playbook"}]},{"group":"Community","pages":[{"title":"Contributing","icon":"heart-handshake","href":"/contributing"}]}]},"basePath":"","title":"Authentication - Second","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}