Compliance reference for actions protected by authentication freshness.
Zylon can require a recent authentication challenge before a principal performs a sensitive workspace or backoffice action. This control adds a time-bound reauthentication requirement on top of the user’s existing permissions and authorization checks.
Authentication freshness is not applied to API requests authenticated with tokens. Token-based integrations do not need additional reauthentication steps or changes to their existing flows.
The feature can be enabled and configured by risk level. When enabled, the action-specific challenge is valid only for the configured freshness window. The low, medium, and high windows are independent.
The following table reflects the current backend call sites of assertPrincipalAuthChallengeIsValid. The list is a code-level reference and should be reviewed after changes to sensitive authorization paths.
Area
Protected action
Backend method
Risk level
Organization
Create an organization
createOrganization
Medium
Organization
Delete an organization, including its content
deleteOrganization
High
Organization
Update organization settings
updateOrganization
Low
Gateway
Create a gateway
createGateway
High
Gateway
Delete a gateway
deleteGateway
High
Gateway users
Add a user to a gateway
addUserToGateway
Medium
Gateway users
Change a gateway user’s role
updateUserRole
Medium
Gateway users
Activate a gateway user
setGatewayUserState
Low
Gateway users
Deactivate a gateway user
setGatewayUserState
High
Gateway users
Remove a user from a gateway
removeGatewayUser
Medium
Project
Transfer project ownership
transferProjectOwnership
Medium
Project
Update project settings
updateProject
Low
Project
Add project members
addMembersToProject
Medium
Project
Update project member roles
updateMemberRoles
Medium
Project
Remove a project member
removeMemberFromProject
Medium
Project
Soft-delete a project
deleteProject
High
Project
Hard-delete a project
hardDeleteProject
High
API tokens
Create an API token
createApiToken
High
API tokens
Delete an API token
deleteTokenByHash
High
Artifacts
Create connector artifacts
createArtifact
Low
Artifacts
Delete artifacts
deleteArtifactsById
High
Artifacts
Delete an ingested document and its entity
scheduleDeleteVectorsAndEntity
High
Users
Change a user’s role
updateUser
Medium when retaining or reducing privilege; High when granting a higher role
Users
Add a user to an organization
addUserToOrganization
High
Users
Activate a user
setUserState
High
Users
Deactivate a user
setUserState
Medium
Accounts
Activate an account
updateAccount
High
Accounts
Deactivate an account
updateAccount
Low
API-token principals are exempt from this freshness check by design. This does not bypass the endpoint’s normal permission, scope, or ownership checks.
For interactive users, the frontend can answer an authentication challenge with the configured password or SSO flow. A missing or expired challenge prevents the protected action from proceeding until the user authenticates again. Google and Microsoft SSO may redirect the browser away from the original request; operators should account for the possibility that the user needs to repeat the action after returning.For configuration details and the exact freshness windows, see Authentication Freshness.
{"docsConfig":{"theme":"palm","$schema":"https://mintlify.com/docs.json","name":"Zylon","description":"Zylon is an enterprise AI platform delivering private generative AI and on-premise AI software for regulated industries, enabling secure deployment inside enterprise infrastructure without external cloud dependencies.","colors":{"primary":"#796ABF","light":"#796ABF","dark":"#E7E5E4"},"logo":{"light":"https://mintcdn.com/zylon/gak9PYoO0ozUIC1W/logo/light.svg?fit=max\u0026auto=format\u0026n=gak9PYoO0ozUIC1W\u0026q=85\u0026s=138e7b0b2d91e5562def19bf93ef93ef","dark":"https://mintcdn.com/zylon/gak9PYoO0ozUIC1W/logo/dark.svg?fit=max\u0026auto=format\u0026n=gak9PYoO0ozUIC1W\u0026q=85\u0026s=54b0904a089ec64c29a0f16d16da0cc3"},"favicon":"https://mintcdn.com/zylon/_j0w7hJa3Cg0VgjU/favicon.png?fit=max\u0026auto=format\u0026n=_j0w7hJa3Cg0VgjU\u0026q=85\u0026s=8d03180cb6eda69a1f2e0f44bcf63bae","api":{"playground":{"display":"simple"},"examples":{"defaults":"required","languages":["curl","python","javascript"]}},"appearance":{"default":"light"},"background":{"decoration":"gradient","color":{"light":"#FFFFFF","dark":"#1C1917"}},"navbar":{"links":[{"href":"mailto:dev@zylon.ai","label":"Support"}],"primary":{"type":"button","label":"Request a Demo","href":"https://cal.com/zylon/demo?source=docs"}},"footer":{"socials":{"x":"https://x.com/zylonprivategpt","github":"https://github.com/zylon-ai","linkedin":"https://www.linkedin.com/company/zylon-privategpt"}},"styling":{"eyebrows":"breadcrumbs","latex":true},"errors":{"404":{"redirect":false}},"contextual":{"options":["copy"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"zylon","hasAudioNarration":false,"actualSubdomain":"zylon","customDomains":["docs.zylon.ai"],"gitSource":{"type":"github","owner":"zylon-ai","repo":"zylon-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6aec6b8452e1c9f3bbf528eb","clientVersion":"0.0.4087","searchFilterCounts":[{"language":"en","tag":"Zylon","count":316},{"language":"es","tag":"Zylon","count":312},{"language":"en","tag":"Operator Manual","count":137},{"language":"es","tag":"Manual del Operador","count":137},{"language":"en","tag":"User Manual","count":95},{"language":"es","tag":"Manual de Usuario","count":93},{"language":"en","tag":"Configuration","count":81},{"language":"es","tag":"Configuración","count":81},{"language":"en","tag":"Developer Manual","count":78},{"language":"es","tag":"Manual de Desarrollador","count":76},{"language":"en","tag":"Build with Zylon","count":66},{"language":"es","tag":"Construye con Zylon","count":64},{"language":"en","tag":"Workspace API","count":37},{"language":"es","tag":"Workspace API","count":37},{"language":"en","tag":"ZylonGPT API","count":25},{"language":"es","tag":"ZylonGPT API","count":25},{"language":"en","tag":"Features \u0026 Capabilities","count":24},{"language":"es","tag":"Funciones y Capacidades","count":24},{"language":"en","tag":"Chat Assistant","count":21},{"language":"es","tag":"Asistente de Chat","count":21}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","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":"llms-txt-v2","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":"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":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".dark{--zylon-surface: oklch(0.268 0.007 56.043);--zylon-paper: oklch(0.2 0.004 56.043);--zylon-code: oklch(0.18 0.006 56.043);--zylon-text: oklch(0.985 0.001 106.423);--zylon-body: oklch(0.985 0.001 106.423 / 72%);--zylon-muted: oklch(0.709 0.01 56.259);--zylon-border: oklch(1 0 0 / 10%);--primary: var(--primary-dark);--primary-light: var(--primary-dark)}.dark #navbar{background-color:rgb(var(--background-dark))}.dark #sidebar-content,.dark #navbar>div:first-child,.dark #footer{border-color:var(--zylon-border)}.dark span.pointer-events-none[style*=\"radial-gradient\"]{display:none}.dark #page-title,.dark #content :is(h1,h2,h3,h4,strong),.dark .card :is(h2,h3){color:var(--zylon-text)}.dark #content{color:var(--zylon-body);--tw-prose-body: var(--zylon-body);--tw-prose-headings: var(--zylon-text);--tw-prose-bold: var(--zylon-text);--tw-prose-links: var(--zylon-text)}.dark #table-of-contents{color:var(--zylon-muted)}.dark #search-bar-entry{background:var(--zylon-surface);color:var(--zylon-muted);--tw-ring-color: var(--zylon-border)}.dark .card{background:var(--zylon-paper);border-color:var(--zylon-border)}.dark .card p{color:var(--zylon-body)}.dark .card:hover{background:var(--zylon-surface);border-color:oklch(1 0 0 / 20%)}.dark .code-block{background:var(--zylon-code);border-color:var(--zylon-border)}.dark .code-block-background{--shiki-dark-bg: var(--zylon-code) !important}"}],"page":{"pagePath":"en/v1.58/operator-manual/security/authentication-for-sensitive-actions","slug":"/en/v1.58/operator-manual/security/authentication-for-sensitive-actions","pageMetadata":{"title":"Authentication for Sensitive Actions","description":"Compliance reference for actions protected by authentication freshness.","href":"/en/v1.58/operator-manual/security/authentication-for-sensitive-actions"},"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: \"Compliance reference for actions protected by authentication freshness.\"\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`,p:`p`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Heading,Table,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Zylon can require a recent authentication challenge before a principal performs a sensitive workspace or backoffice action. This control adds a time-bound reauthentication requirement on top of the user’s existing permissions and authorization checks.`}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Authentication freshness is not applied to API requests authenticated with tokens. Token-based integrations do not need additional reauthentication steps or changes to their existing flows.`})}),`\n`,_jsxs(_components.p,{children:[`The feature can be `,_jsx(_components.a,{href:`/en/v1.58/operator-manual/configuration/features/authentication-freshness`,children:`enabled and configured by risk level`}),`. When enabled, the action-specific challenge is valid only for the configured freshness window. The low, medium, and high windows are independent.`]}),`\n`,_jsx(Heading,{level:`2`,id:`protected-actions`,children:`Protected actions`}),`\n`,_jsxs(_components.p,{children:[`The following table reflects the current backend call sites of `,_jsx(_components.code,{children:`assertPrincipalAuthChallengeIsValid`}),`. The list is a code-level reference and should be reviewed after changes to sensitive authorization paths.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Area`}),_jsx(_components.th,{children:`Protected action`}),_jsx(_components.th,{children:`Backend method`}),_jsx(_components.th,{children:`Risk level`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Organization`}),_jsx(_components.td,{children:`Create an organization`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`createOrganization`})}),_jsx(_components.td,{children:`Medium`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Organization`}),_jsx(_components.td,{children:`Delete an organization, including its content`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`deleteOrganization`})}),_jsx(_components.td,{children:`High`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Organization`}),_jsx(_components.td,{children:`Update organization settings`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`updateOrganization`})}),_jsx(_components.td,{children:`Low`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Gateway`}),_jsx(_components.td,{children:`Create a gateway`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`createGateway`})}),_jsx(_components.td,{children:`High`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Gateway`}),_jsx(_components.td,{children:`Delete a gateway`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`deleteGateway`})}),_jsx(_components.td,{children:`High`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Gateway users`}),_jsx(_components.td,{children:`Add a user to a gateway`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`addUserToGateway`})}),_jsx(_components.td,{children:`Medium`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Gateway users`}),_jsx(_components.td,{children:`Change a gateway user’s role`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`updateUserRole`})}),_jsx(_components.td,{children:`Medium`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Gateway users`}),_jsx(_components.td,{children:`Activate a gateway user`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`setGatewayUserState`})}),_jsx(_components.td,{children:`Low`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Gateway users`}),_jsx(_components.td,{children:`Deactivate a gateway user`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`setGatewayUserState`})}),_jsx(_components.td,{children:`High`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Gateway users`}),_jsx(_components.td,{children:`Remove a user from a gateway`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`removeGatewayUser`})}),_jsx(_components.td,{children:`Medium`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Project`}),_jsx(_components.td,{children:`Transfer project ownership`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`transferProjectOwnership`})}),_jsx(_components.td,{children:`Medium`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Project`}),_jsx(_components.td,{children:`Update project settings`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`updateProject`})}),_jsx(_components.td,{children:`Low`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Project`}),_jsx(_components.td,{children:`Add project members`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`addMembersToProject`})}),_jsx(_components.td,{children:`Medium`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Project`}),_jsx(_components.td,{children:`Update project member roles`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`updateMemberRoles`})}),_jsx(_components.td,{children:`Medium`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Project`}),_jsx(_components.td,{children:`Remove a project member`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`removeMemberFromProject`})}),_jsx(_components.td,{children:`Medium`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Project`}),_jsx(_components.td,{children:`Soft-delete a project`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`deleteProject`})}),_jsx(_components.td,{children:`High`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Project`}),_jsx(_components.td,{children:`Hard-delete a project`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`hardDeleteProject`})}),_jsx(_components.td,{children:`High`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`API tokens`}),_jsx(_components.td,{children:`Create an API token`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`createApiToken`})}),_jsx(_components.td,{children:`High`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`API tokens`}),_jsx(_components.td,{children:`Delete an API token`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`deleteTokenByHash`})}),_jsx(_components.td,{children:`High`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Artifacts`}),_jsx(_components.td,{children:`Create connector artifacts`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`createArtifact`})}),_jsx(_components.td,{children:`Low`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Artifacts`}),_jsx(_components.td,{children:`Delete artifacts`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`deleteArtifactsById`})}),_jsx(_components.td,{children:`High`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Artifacts`}),_jsx(_components.td,{children:`Delete an ingested document and its entity`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`scheduleDeleteVectorsAndEntity`})}),_jsx(_components.td,{children:`High`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Users`}),_jsx(_components.td,{children:`Change a user’s role`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`updateUser`})}),_jsx(_components.td,{children:`Medium when retaining or reducing privilege; High when granting a higher role`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Users`}),_jsx(_components.td,{children:`Add a user to an organization`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`addUserToOrganization`})}),_jsx(_components.td,{children:`High`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Users`}),_jsx(_components.td,{children:`Activate a user`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`setUserState`})}),_jsx(_components.td,{children:`High`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Users`}),_jsx(_components.td,{children:`Deactivate a user`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`setUserState`})}),_jsx(_components.td,{children:`Medium`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Accounts`}),_jsx(_components.td,{children:`Activate an account`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`updateAccount`})}),_jsx(_components.td,{children:`High`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Accounts`}),_jsx(_components.td,{children:`Deactivate an account`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`updateAccount`})}),_jsx(_components.td,{children:`Low`})]})]})]}),`\n`,_jsx(_components.p,{children:`API-token principals are exempt from this freshness check by design. This does not bypass the endpoint’s normal permission, scope, or ownership checks.`}),`\n`,_jsx(Heading,{level:`2`,id:`authentication-methods-and-failure-handling`,children:`Authentication methods and failure handling`}),`\n`,_jsx(_components.p,{children:`For interactive users, the frontend can answer an authentication challenge with the configured password or SSO flow. A missing or expired challenge prevents the protected action from proceeding until the user authenticates again. Google and Microsoft SSO may redirect the browser away from the original request; operators should account for the possibility that the user needs to repeat the action after returning.`}),`\n`,_jsxs(_components.p,{children:[`For configuration details and the exact freshness windows, see `,_jsx(_components.a,{href:`/en/v1.58/operator-manual/configuration/features/authentication-freshness`,children:`Authentication Freshness`}),`.`]})]})}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 for Sensitive Actions","description":"Compliance reference for actions protected by authentication freshness.","href":"/en/v1.58/operator-manual/security/authentication-for-sensitive-actions"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Protected actions","slug":"protected-actions","depth":2,"children":[]},{"title":"Authentication methods and failure handling","slug":"authentication-methods-and-failure-handling","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"zylon","siteName":"Zylon","title":"Authentication for Sensitive Actions - Zylon","navMaps":{"firstHrefInVersion":{"1.58":{"href":"/en/v1.58/operator-manual/security/authentication-for-sensitive-actions","matchLevel":0},"1.57":{"href":"/en/v1.57/operator-manual/security/authentication-for-sensitive-actions","matchLevel":1}},"firstHrefInLanguage":{"es":{"href":"/es/v1.58/operator-manual/security/authentication-for-sensitive-actions","matchLevel":1},"en":{"href":"/en/v1.58/operator-manual/security/authentication-for-sensitive-actions","matchLevel":0}}},"lastModified":"2026-10-23T04:01:01.443Z","originalFileLocation":"en/v1.58/operator-manual/security/authentication-for-sensitive-actions.mdx","locale":"en"},"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=\"light\"}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=\"Compliance reference for actions protected by authentication freshness.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Zylon\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/zylon/3kb7900r6lLAc1G9/_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/zylon/3kb7900r6lLAc1G9/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/zylon/3kb7900r6lLAc1G9/_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/zylon/3kb7900r6lLAc1G9/_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/zylon/3kb7900r6lLAc1G9/_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/zylon/3kb7900r6lLAc1G9/_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/zylon/3kb7900r6lLAc1G9/_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/zylon/3kb7900r6lLAc1G9/_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/zylon/3kb7900r6lLAc1G9/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Authentication for Sensitive Actions - Zylon\">\u003cmeta data-mint-head property=\"og:description\" content=\"Compliance reference for actions protected by authentication freshness.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Zylon\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.zylon.ai/en/v1.58/operator-manual/security/authentication-for-sensitive-actions\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://zylon.mintlify.site/_mintlify/api/og/v2?division=Security\u0026amp;title=Authentication+for+Sensitive+Actions\u0026amp;description=Compliance+reference+for+actions+protected+by+authentication+freshness.\u0026amp;theme=1d8a24a593f8f29b69df7e0a\u0026amp;signature=78ec836bdf4a13c0a5540049de4f1ac9a2f0e4f9ac6ba2c902a84e0569374ba2\">\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 for Sensitive Actions - Zylon\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Compliance reference for actions protected by authentication freshness.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://zylon.mintlify.site/_mintlify/api/og/v2?division=Security\u0026amp;title=Authentication+for+Sensitive+Actions\u0026amp;description=Compliance+reference+for+actions+protected+by+authentication+freshness.\u0026amp;theme=1d8a24a593f8f29b69df7e0a\u0026amp;signature=78ec836bdf4a13c0a5540049de4f1ac9a2f0e4f9ac6ba2c902a84e0569374ba2\">\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/zylon/3kb7900r6lLAc1G9/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Zylon\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#796ABF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.zylon.ai/en/v1.58/operator-manual/security/authentication-for-sensitive-actions\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/en/v1.58/operator-manual/security/authentication-for-sensitive-actions.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.zylon.ai/en/v1.58/operator-manual/security/authentication-for-sensitive-actions\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.zylon.ai/es/v1.58/operator-manual/security/authentication-for-sensitive-actions\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.zylon.ai/es/v1.58/operator-manual/security/authentication-for-sensitive-actions\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.zylon.ai/#organization\",\"name\":\"Zylon\",\"url\":\"https://docs.zylon.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/zylon/gak9PYoO0ozUIC1W/logo/light.svg?fit=max\u0026auto=format\u0026n=gak9PYoO0ozUIC1W\u0026q=85\u0026s=138e7b0b2d91e5562def19bf93ef93ef\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.zylon.ai#website\",\"name\":\"Zylon\",\"url\":\"https://docs.zylon.ai\",\"publisher\":{\"@id\":\"https://docs.zylon.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.zylon.ai/en/v1.58/operator-manual/security/authentication-for-sensitive-actions#webpage\",\"url\":\"https://docs.zylon.ai/en/v1.58/operator-manual/security/authentication-for-sensitive-actions\",\"name\":\"Authentication for Sensitive Actions\",\"description\":\"Compliance reference for actions protected by authentication freshness.\",\"dateModified\":\"2026-10-23T04:01:01.443Z\",\"isPartOf\":{\"@id\":\"https://docs.zylon.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.zylon.ai/en/v1.58/operator-manual/security/authentication-for-sensitive-actions#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.zylon.ai/en/v1.58/operator-manual/security/authentication-for-sensitive-actions#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Security\",\"item\":\"https://docs.zylon.ai/en/v1.58/operator-manual/instance-hardening/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Authentication for Sensitive Actions\",\"item\":\"https://docs.zylon.ai/en/v1.58/operator-manual/security/authentication-for-sensitive-actions\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.zylon.ai/en/v1.58/operator-manual/security/authentication-for-sensitive-actions#article\",\"headline\":\"Authentication for Sensitive Actions\",\"name\":\"Authentication for Sensitive Actions\",\"description\":\"Compliance reference for actions protected by authentication freshness.\",\"url\":\"https://docs.zylon.ai/en/v1.58/operator-manual/security/authentication-for-sensitive-actions\",\"mainEntityOfPage\":{\"@id\":\"https://docs.zylon.ai/en/v1.58/operator-manual/security/authentication-for-sensitive-actions#webpage\"},\"dateModified\":\"2026-10-23T04:01:01.443Z\",\"publisher\":{\"@id\":\"https://docs.zylon.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.zylon.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Zylon\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Zylon","nav":{"global":null,"products":[{"product":"Zylon","versions":[{"version":"1.58","default":true,"languages":[{"language":"es","pages":[{"title":"es","href":"/es/v1.58/operator-manual/security/authentication-for-sensitive-actions"}]},{"language":"en","tabs":[{"tab":"Home","icon":"house","pages":[{"title":"Home","href":"/en/v1.58/overview"}]},{"tab":"User Manual","icon":"user","pages":[{"title":"User Manual","href":"/en/v1.58/user-manual/what-is-zylon-workspace"}]},{"tab":"Developer Manual","icon":"code","pages":[{"title":"Developer Manual","href":"/en/v1.58/developer-manual/get-started/intro-to-zylon"}]},{"tab":"Operator Manual","icon":"wrench","groups":[{"group":"Getting Started","pages":[{"title":"How to use this manual","href":"/en/v1.58/operator-manual/overview"}]},{"group":"Installation","pages":[{"title":"Getting Started","href":"/en/v1.58/operator-manual/installation/overview"},{"title":"Hardware requirements","href":"/en/v1.58/operator-manual/installation/hardware-requirements"},{"title":"Online Installation","href":"/en/v1.58/operator-manual/installation/online"},{"title":"Semi-Airgap Installation","href":"/en/v1.58/operator-manual/installation/semi-airgap"},{"title":"Full-Airgap Installation","href":"/en/v1.58/operator-manual/installation/airgap"},{"title":"Install Zylon (Legacy)","href":"/en/v1.58/operator-manual/installation/legacy"},{"title":"Uninstall","href":"/en/v1.58/operator-manual/installation/uninstall"}]},{"group":"Maintenance \u0026 Operations","pages":[{"title":"Backups and Disaster Recovery","href":"/en/v1.58/operator-manual/operations/backup"},{"title":"Store Zylon Data on a Separate Disk","href":"/en/v1.58/operator-manual/operations/data-disk"},{"title":"Sys Admin Dashboard","href":"/en/v1.58/operator-manual/operations/sys-admin-dashboard"}]},{"group":"Backoffice","pages":[{"title":"Introduction","icon":"building","href":"/en/v1.58/operator-manual/backoffice/introduction"},{"title":"Roles and Permissions","icon":"unlock-keyhole","href":"/en/v1.58/operator-manual/backoffice/roles-and-permissions"},{"title":"Accessing the Backoffice","icon":"user","href":"/en/v1.58/operator-manual/backoffice/accessing-the-backoffice"},{"title":"Platform Backoffice","icon":"wrench","href":"/en/v1.58/operator-manual/backoffice/platform-backoffice"},{"title":"Quotas","icon":"gauge-high","href":"/en/v1.58/operator-manual/backoffice/quotas"},{"title":"Guardrails","icon":"shield","href":"/en/v1.58/operator-manual/backoffice/guardrails"},{"title":"Usage Dashboard","icon":"chart-column","href":"/en/v1.58/operator-manual/backoffice/usage-dashboard"},{"title":"System Monitor","icon":"gauge-high","href":"/en/v1.58/operator-manual/backoffice/system-monitor"}]},{"group":"Configuration","pages":[{"title":"Configuration Overview","href":"/en/v1.58/operator-manual/configuration/overview"},{"group":"AI Presets","pages":[{"title":"Getting Started","href":"/en/v1.58/operator-manual/ai-presets/getting-started"},{"title":"AI Presets Reference","href":"/en/v1.58/operator-manual/ai-presets/presets"},{"title":"Configuration Options","href":"/en/v1.58/operator-manual/ai-presets/configuration"},{"title":"Advanced Customization","href":"/en/v1.58/operator-manual/ai-presets/advanced-customization"},{"title":"Troubleshooting","href":"/en/v1.58/operator-manual/ai-presets/troubleshooting"}]},{"group":"Network \u0026 Connectivity","pages":[{"title":"Ports and DNS","href":"/en/v1.58/operator-manual/configuration/network/ports-and-dns"},{"title":"Proxy","href":"/en/v1.58/operator-manual/configuration/network/proxy"}]},{"group":"Authentication","pages":[{"title":"Google Integration (SSO)","href":"/en/v1.58/operator-manual/openid/google"},{"title":"Microsoft Entra Integration (SSO)","href":"/en/v1.58/operator-manual/openid/microsoft"},{"title":"LDAP Directory Authentication","href":"/en/v1.58/operator-manual/authentication/ldap"}]},{"group":"Knowledge Base Connectors","pages":[{"title":"Knowledge Connectors","href":"/en/v1.58/operator-manual/knowledge-base/overview"},{"title":"Google Drive","href":"/en/v1.58/operator-manual/knowledge-base/google-drive"},{"title":"SharePoint","href":"/en/v1.58/operator-manual/knowledge-base/sharepoint"},{"title":"Confluence","href":"/en/v1.58/operator-manual/knowledge-base/confluence"},{"title":"Confluence Server","href":"/en/v1.58/operator-manual/knowledge-base/confluence-server"},{"title":"Samba File System","href":"/en/v1.58/operator-manual/knowledge-base/file-system"},{"title":"Claromentis","href":"/en/v1.58/operator-manual/knowledge-base/claromentis"}]},{"group":"Features \u0026 Capabilities","pages":[{"title":"MCP Tool Connector","href":"/en/v1.58/operator-manual/configuration/features/feat-mcp"},{"title":"Vision File Processing","href":"/en/v1.58/operator-manual/configuration/features/feat-file-vision"},{"title":"Database Tool Connector","href":"/en/v1.58/operator-manual/configuration/features/feat-database"},{"title":"Code Execution","href":"/en/v1.58/operator-manual/configuration/features/feat-code-execution"},{"title":"Audit Log","href":"/en/v1.58/operator-manual/configuration/features/feat-audit"},{"title":"Quotas and rate limits","href":"/en/v1.58/operator-manual/configuration/features/feat-quotas"},{"title":"System Monitor","href":"/en/v1.58/operator-manual/configuration/features/feat-system-monitor"},{"title":"Log Delivery and Storage","href":"/en/v1.58/operator-manual/configuration/features/log-delivery-storage"},{"title":"Project Custom Instructions","href":"/en/v1.58/operator-manual/configuration/features/feat-project-custom-instructions"},{"title":"Omnisearch","href":"/en/v1.58/operator-manual/configuration/search"},{"title":"Web Extract","href":"/en/v1.58/operator-manual/configuration/features/feat-webextract"},{"title":"Web Search","href":"/en/v1.58/operator-manual/configuration/features/feat-websearch"},{"title":"Multimodalility capabilities","href":"/en/v1.58/operator-manual/configuration/features/feat-multimodal"},{"title":"Authentication Freshness","href":"/en/v1.58/operator-manual/configuration/features/authentication-freshness"}]},{"group":"Cron Tasks","pages":[{"title":"Sync","href":"/en/v1.58/operator-manual/configuration/cron-tasks/sync"},{"title":"Hard delete","href":"/en/v1.58/operator-manual/configuration/cron-tasks/hard-delete"}]},{"group":"Advanced Settings","pages":[{"group":"Observability","pages":[{"title":"How to configure observability","href":"/en/v1.58/operator-manual/configuration/observability/overview"},{"title":"Platform Metrics","href":"/en/v1.58/operator-manual/configuration/observability/platform-metrics"},{"title":"Metrics Destinations","href":"/en/v1.58/operator-manual/configuration/observability/destinations"},{"title":"External Grafana Dashboard","href":"/en/v1.58/operator-manual/configuration/observability/external-grafana-dashboard"}]},{"title":"Performance tweaks","href":"/en/v1.58/operator-manual/configuration/performance"},{"title":"Whitelabel","href":"/en/v1.58/operator-manual/configuration/whitelabel"},{"title":"n8n","href":"/en/v1.58/operator-manual/configuration/n8n"}]},{"title":"Zylon CLI","href":"/en/v1.58/operator-manual/configuration/cli"}]},{"group":"Troubleshooting","pages":[{"title":"General issues","href":"/en/v1.58/operator-manual/troubleshooting/troubleshoot"},{"title":"Exporting Logs","href":"/en/v1.58/operator-manual/troubleshooting/exporting-logs"},{"title":"Nvidia Drivers","href":"/en/v1.58/operator-manual/troubleshooting/nvidia-drivers"},{"title":"AI Inference Performance","href":"/en/v1.58/operator-manual/troubleshooting/ai"}]},{"group":"Security","pages":[{"title":"Security overview","href":"/en/v1.58/operator-manual/instance-hardening/overview"},{"title":"Airgap Your Server","href":"/en/v1.58/operator-manual/instance-hardening/airgap-your-server"},{"title":"Disk Encryption","description":"Encrypt your Zylon server's disk to protect data at rest on Ubuntu 24.04","href":"/en/v1.58/operator-manual/instance-hardening/disk-encryption"},{"title":"Authentication for Sensitive Actions","href":"/en/v1.58/operator-manual/security/authentication-for-sensitive-actions"}]},{"group":"Auditability \u0026 AI Governance","pages":[{"title":"Auditability \u0026 AI Governance","description":"Auditability, traceability, evidence preservation, governance, and AI accountability capabilities in Zylon.","icon":"shield-check","href":"/en/v1.58/operator-manual/auditability-ai-safety/overview"},{"title":"Logging, Evidence, and SIEM Delivery","icon":"list","href":"/en/v1.58/operator-manual/backoffice/log-delivery-storage"}]},{"group":"Additional pages","hidden":true,"pages":[{"title":"All Features","href":"/en/v1.58/operator-manual/configuration/features/overview"},{"title":"Low-level API","href":"/en/v1.58/operator-manual/low-level"}]}]},{"tab":"Customer Support Manual","icon":"headphones","pages":[{"title":"Customer Support Manual","href":"/en/v1.58/customer-support-manual/zendesk-client-manual"}]},{"tab":"Changelog","icon":"list","pages":[{"title":"Changelog","href":"/en/v1.58/changelog/overview"}]}]}]},{"version":"1.57","pages":[{"title":"1.57","href":"/en/v1.57/operator-manual/security/authentication-for-sensitive-actions"}]}]},{"product":"Zylon Code","hidden":true,"pages":[{"title":"Zylon Code","href":"/zylon-code/es"}]}]},"basePath":"","title":"Authentication for Sensitive Actions - Zylon","buildId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","deploymentId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","dynamics":[],"chunks":[]}