Let your team sign in with your identity provider and add or remove people automatically
Settings → Auth & Security is where an organization connects OpenWork to
its identity provider. It has two tabs:
Single sign-on (SSO): people sign in with your company account instead of
a separate OpenWork password.
User provisioning (SCIM): people and groups are added to and removed from
OpenWork when they change in your identity provider.
Older OpenWork versions, and organizations where Auth & Security is not turned
on yet, show these as two separate pages: Settings → SSO and
Settings → SCIM. Everything else on this page is the same. Links to the old
pages open the matching Auth & Security tab.
Who can use it
Plan
Who can change it
Single sign-on
Team and Enterprise
The organization owner, or anyone granted Manage single sign-on
User provisioning
Enterprise
The organization owner, or anyone granted Manage SCIM provisioning
On a plan without the feature, the tab says which plan includes it. People who
can manage billing see Upgrade to Team (single sign-on) or Talk to us
about Enterprise (user provisioning). See
Pricing and licensing.
Single sign-on
Single sign-on works with any SAML or OIDC identity provider. Follow the guide
for yours:
Every connection goes through the same steps before anyone can use it:
Open Settings → Auth & Security → Single sign-on (SSO) and save your
identity provider’s details.
Verify your email domain with a DNS TXT record.
Run a real test sign-in.
Turn SSO on.
Until all four are done, the connection stays off and people keep signing in
the way they do today. Someone from your verified domain who signs in with SSO
for the first time joins the organization as a Member.Once SSO is on, people at your verified domain see Continue with SSO first
when they sign in. To make SSO the only way into your organization, turn on
Require SSO (Enterprise plan). Depending on your organization’s settings,
this switch is at the top of the Single sign-on (SSO) tab or under
Authentication in Settings → General. Where available, Restrict this
domain to our SSO also stops people at your domain from using a password or
Google anywhere in OpenWork.
OIDC callback URLs
The OIDC callback is <callback-origin>/api/auth/sso/callback/<provider-id>.
For the first connection, the provider ID is openwork-sso-<organization-id>.
Find the organization ID in Settings → General. The callback origin is the
server’s configured public API URL, or its authentication origin when no public
API URL is configured. Ask your deployment administrator for the actual origin.Additional connections receive an ID when saved, so their callback cannot be
derived from the organization ID alone. Use the saved connection’s Redirect URL
as the authoritative value, including on deployments with separate web and API hosts.
Editing and recovery
An OIDC replacement save requires the client secret again, disables the connection,
and resets its test state. Test the saved configuration before re-enabling it.
The setup test uses a temporary session, not a normal SSO sign-in.Enforcement depends on deployment settings. Deployments without per-organization
SSO enforcement require SSO as soon as it is enabled. Plan recovery before enabling
or changing the only working connection. Disabling retains configuration but still
requires authenticated management access. Deleting also removes linked provider-account data.
User provisioning
User provisioning (SCIM) keeps OpenWork in step with your identity provider:
people you assign get access, and people you remove or deactivate lose it.
You can also create OpenWork teams from your identity provider’s groups.User provisioning needs single sign-on turned on first. Then follow the guide
for your identity provider:
Google Workspace can be used for single sign-on but not for user provisioning;
see Google Workspace SCIM provisioning.In Settings → Auth & Security → User provisioning (SCIM), create the
connector, then give your identity provider the SCIM base URL and the
bearer token shown once after you create or rotate it. Failed syncs are retried
and listed on the same tab until they are resolved.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"OpenWork Docs","colors":{"primary":"#011627","light":"#cbd5e1","dark":"#011627"},"logo":{"light":"https://mintcdn.com/differentai/bbTblqmGCwQ9TUdJ/logo/light.svg?fit=max\u0026auto=format\u0026n=bbTblqmGCwQ9TUdJ\u0026q=85\u0026s=4467903d12836ac81ccb6eef9dbe7bde","dark":"https://mintcdn.com/differentai/bbTblqmGCwQ9TUdJ/logo/dark.svg?fit=max\u0026auto=format\u0026n=bbTblqmGCwQ9TUdJ\u0026q=85\u0026s=104602207077f80bd2961c67c80dfcf4"},"favicon":"https://mintcdn.com/differentai/bbTblqmGCwQ9TUdJ/logo/light.svg?fit=max\u0026auto=format\u0026n=bbTblqmGCwQ9TUdJ\u0026q=85\u0026s=4467903d12836ac81ccb6eef9dbe7bde","api":{"openapi":"https://api.openworklabs.com/openapi.json?public=1"},"background":{"color":{"light":"#ffffff","dark":"#011627"}},"navbar":{"primary":{"type":"button","label":"Download OpenWork","href":"https://openworklabs.com/download"}},"seo":{"metatags":{"og:image":"https://openworklabs.com/docs/images/openwork-social.png","og:image:alt":"OpenWork — Your AI workspace. Without vendor lock-in.","twitter:image:alt":"OpenWork — Your AI workspace. Without vendor lock-in."}},"errors":{"404":{"redirect":false,"title":"Missing Documentation?","description":"If you're technical and want to use a specific part of the app that is not documented well yet, [send us a quick email](mailto:team@openworklabs.com?subject=missing%20documentation\u0026body=hey%20my%20github%20is%20%7Busername%7D%2C%20I%27m%20interested%20in%20%7Bfeature%7D%20from%20openwork%20but%20I%27m%20missing%20documentation%20on%20it%2C%20could%20you%20create%20it%3F%0A%0AThanks) and tell us what you're missing."}},"markdown":{"instructions":["For agents: install the OpenWork desktop app with `brew install --cask openwork` (macOS) or from https://openworklabs.com/download. Do not run `npx openwork`; the npm package named `openwork` is a different project.","Connect an agent to OpenWork with the MCP Gateway: `claude mcp add --transport http openwork https://api.openworklabs.com/mcp/agent`. Teams sign up at https://app.openworklabs.com?mode=sign-up.","Step-by-step agent guide: https://openworklabs.com/docs/start-here/use-openwork-from-an-ai-agent.md","Connect Slack (any organization admin): https://openworklabs.com/docs/slack/connect-slack.md. OpenWork in Slack (@openwork bot) is private alpha for approved organizations. Setup guide: https://openworklabs.com/docs/slack/overview.md. Agent skill: https://openworklabs.com/.well-known/agent-skills/set-up-openwork-slack/SKILL.md."]},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"differentai","hasAudioNarration":false,"actualSubdomain":"differentai","customDomains":["openworklabs.com"],"gitSource":{"type":"github","owner":"different-ai","repo":"openwork","deployBranch":"dev","contentDirectory":"packages/docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aff1cca8b67b28b9f29b77d","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"default","tag":"API","count":723},{"language":"default","tag":"Capability Sources","count":86},{"language":"default","tag":"Inference Providers","count":66},{"language":"default","tag":"Admin","count":65},{"language":"default","tag":"Organizations","count":50},{"language":"default","tag":"SSO","count":48},{"language":"default","tag":"AI Gateway","count":31},{"language":"default","tag":"Desktop App","count":30},{"language":"default","tag":"Authentication","count":30},{"language":"default","tag":"Connectors","count":30}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":true,"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":"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":[{"filePath":"style.css","content":"#topbar-cta-button>a[href=\"https://openworklabs.com/download\"]{padding-right:0.75rem}#topbar-cta-button>a[href=\"https://openworklabs.com/download\"]>div>svg[aria-hidden=\"true\"]{display:none}body:has(.docs-intro) #header{display:none}#content-area h1,#content-area h2,#content-area h3,#content-area h4{color:#011627;letter-spacing:-0.025em}.docs-intro{padding:8px 0 32px;margin-bottom:32px;border-bottom:1px solid #e5e7eb}#content-area .docs-eyebrow{margin:0 0 16px;color:#4b5563;font-family:ui-monospace, SFMono-Regular, Menlo, monospace;font-size:11px;line-height:1.6;letter-spacing:0.1em;text-transform:uppercase}#content-area .docs-intro h1,#content-area .docs-intro .docs-hero-title{margin:0;max-width:680px;font-size:clamp(2.25rem, 4vw, 3rem);font-weight:500;line-height:1.12;letter-spacing:-0.045em;text-wrap:balance}#content-area .docs-lead{margin:20px 0 24px;color:#4b5563;font-size:18px;line-height:1.65}#content-area .docs-section-title{margin:0 0 16px;font-size:clamp(1.75rem, 3vw, 2.25rem);font-weight:500;line-height:1.2;scroll-margin-top:150px}.docs-actions{display:flex;flex-wrap:wrap;gap:12px}#content-area .docs-actions a{display:inline-flex;align-items:center;justify-content:center;min-height:44px;padding:10px 20px;border:1px solid #e5e7eb;border-radius:999px;color:#011627;background:#f0f4f9;font-size:15px;font-weight:500;text-decoration:none}#content-area .docs-actions a:first-child{color:#ffffff;background:#011627;border-color:#011627}#content-area .docs-actions a:hover{opacity:0.85}#content-area .card{background:#f8fafc;border-color:#e5e7eb}a:focus-visible,button:focus-visible{outline:2px solid #011627;outline-offset:4px}@media (max-width: 1023px){#content-area a[aria-label=\"Navigate to header\"]{margin-left:-16px;width:16px}#content-area a[aria-label=\"Navigate to header\"]>div{width:16px;height:24px}}.dark #content-area :is(h1,h2,h3,h4),.dark #content-area :is(.docs-lead,.docs-eyebrow){color:#e2e8f0}.dark .docs-intro{border-color:#334155}.dark #content-area .docs-actions a{color:#e2e8f0;background:#172b3b;border-color:#475569}.dark #content-area .docs-actions a:first-child{color:#011627;background:#e2e8f0}.dark #content-area .card{background-color:#0b1e30;border-color:#334155}.dark :is(a,button):focus-visible{outline-color:#e2e8f0}a[href^=\"https://www.mintlify.com\"][href*=\"utm_campaign=poweredBy\"]{color:#4b5563}.dark a[href^=\"https://www.mintlify.com\"][href*=\"utm_campaign=poweredBy\"]{color:#cbd5e1}"}],"page":{"pagePath":"cloud/auth-and-security","slug":"/cloud/auth-and-security","pageMetadata":{"title":"Auth \u0026 Security","description":"Let your team sign in with your identity provider and add or remove people automatically","keywords":["SSO","single sign-on","SAML","OIDC","SCIM","user provisioning","Okta","Microsoft Entra ID","Google Workspace","identity provider"],"href":"/cloud/auth-and-security"},"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: \"Let your team sign in with your identity provider and add or remove people automatically\"\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`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Note,Table}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Settings → Auth \u0026 Security`}),` is where an organization connects OpenWork to\nits identity provider. It has two tabs:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Single sign-on (SSO)`}),`: people sign in with your company account instead of\na separate OpenWork password.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`User provisioning (SCIM)`}),`: people and groups are added to and removed from\nOpenWork when they change in your identity provider.`]}),`\n`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Older OpenWork versions, and organizations where Auth \u0026 Security is not turned\non yet, show these as two separate pages: `,_jsx(_components.strong,{children:`Settings → SSO`}),` and\n`,_jsx(_components.strong,{children:`Settings → SCIM`}),`. Everything else on this page is the same. Links to the old\npages open the matching Auth \u0026 Security tab.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`who-can-use-it`,children:`Who can use it`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{}),_jsx(_components.th,{children:`Plan`}),_jsx(_components.th,{children:`Who can change it`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Single sign-on`}),_jsx(_components.td,{children:`Team and Enterprise`}),_jsxs(_components.td,{children:[`The organization owner, or anyone granted `,_jsx(_components.strong,{children:`Manage single sign-on`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`User provisioning`}),_jsx(_components.td,{children:`Enterprise`}),_jsxs(_components.td,{children:[`The organization owner, or anyone granted `,_jsx(_components.strong,{children:`Manage SCIM provisioning`})]})]})]})]}),`\n`,_jsxs(_components.p,{children:[`On a plan without the feature, the tab says which plan includes it. People who\ncan manage billing see `,_jsx(_components.strong,{children:`Upgrade to Team`}),` (single sign-on) or `,_jsx(_components.strong,{children:`Talk to us\nabout Enterprise`}),` (user provisioning). See\n`,_jsx(_components.a,{href:`/start-here/pricing-and-licensing`,children:`Pricing and licensing`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`single-sign-on`,children:`Single sign-on`}),`\n`,_jsx(_components.p,{children:`Single sign-on works with any SAML or OIDC identity provider. Follow the guide\nfor yours:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/cloud/sso-oidc`,children:`Set up OIDC single sign-on`}),`, for an OIDC identity provider`]}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/cloud/sso-okta`,children:`Okta SAML SSO`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/cloud/sso-microsoft-entra`,children:`Microsoft Entra SAML SSO`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/cloud/sso-google-workspace`,children:`Google Workspace SAML SSO`})}),`\n`]}),`\n`,_jsx(_components.p,{children:`Every connection goes through the same steps before anyone can use it:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Open `,_jsx(_components.strong,{children:`Settings → Auth \u0026 Security → Single sign-on (SSO)`}),` and save your\nidentity provider’s details.`]}),`\n`,_jsx(_components.li,{children:`Verify your email domain with a DNS TXT record.`}),`\n`,_jsx(_components.li,{children:`Run a real test sign-in.`}),`\n`,_jsx(_components.li,{children:`Turn SSO on.`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Until all four are done, the connection stays off and people keep signing in\nthe way they do today. Someone from your verified domain who signs in with SSO\nfor the first time joins the organization as a `,_jsx(_components.strong,{children:`Member`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Once SSO is on, people at your verified domain see `,_jsx(_components.strong,{children:`Continue with SSO`}),` first\nwhen they sign in. To make SSO the only way into your organization, turn on\n`,_jsx(_components.strong,{children:`Require SSO`}),` (Enterprise plan). Depending on your organization’s settings,\nthis switch is at the top of the `,_jsx(_components.strong,{children:`Single sign-on (SSO)`}),` tab or under\n`,_jsx(_components.strong,{children:`Authentication`}),` in `,_jsx(_components.strong,{children:`Settings → General`}),`. Where available, `,_jsx(_components.strong,{children:`Restrict this\ndomain to our SSO`}),` also stops people at your domain from using a password or\nGoogle anywhere in OpenWork.`]}),`\n`,_jsx(Heading,{level:`3`,id:`oidc-callback-urls`,children:`OIDC callback URLs`}),`\n`,_jsxs(_components.p,{children:[`The OIDC callback is `,_jsx(_components.code,{children:`\u003ccallback-origin>/api/auth/sso/callback/\u003cprovider-id>`}),`.\nFor the first connection, the provider ID is `,_jsx(_components.code,{children:`openwork-sso-\u003corganization-id>`}),`.\nFind the organization ID in `,_jsx(_components.strong,{children:`Settings → General`}),`. The callback origin is the\nserver’s configured public API URL, or its authentication origin when no public\nAPI URL is configured. Ask your deployment administrator for the actual origin.`]}),`\n`,_jsxs(_components.p,{children:[`Additional connections receive an ID when saved, so their callback cannot be\nderived from the organization ID alone. Use the saved connection’s `,_jsx(_components.strong,{children:`Redirect URL`}),`\nas the authoritative value, including on deployments with separate web and API hosts.`]}),`\n`,_jsx(Heading,{level:`3`,id:`editing-and-recovery`,children:`Editing and recovery`}),`\n`,_jsx(_components.p,{children:`An OIDC replacement save requires the client secret again, disables the connection,\nand resets its test state. Test the saved configuration before re-enabling it.\nThe setup test uses a temporary session, not a normal SSO sign-in.`}),`\n`,_jsx(_components.p,{children:`Enforcement depends on deployment settings. Deployments without per-organization\nSSO enforcement require SSO as soon as it is enabled. Plan recovery before enabling\nor changing the only working connection. Disabling retains configuration but still\nrequires authenticated management access. Deleting also removes linked provider-account data.`}),`\n`,_jsx(Heading,{level:`2`,id:`user-provisioning`,children:`User provisioning`}),`\n`,_jsx(_components.p,{children:`User provisioning (SCIM) keeps OpenWork in step with your identity provider:\npeople you assign get access, and people you remove or deactivate lose it.\nYou can also create OpenWork teams from your identity provider’s groups.`}),`\n`,_jsx(_components.p,{children:`User provisioning needs single sign-on turned on first. Then follow the guide\nfor your identity provider:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/cloud/scim-okta`,children:`Okta SCIM provisioning`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/cloud/scim-microsoft-entra`,children:`Microsoft Entra SCIM provisioning`})}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Google Workspace can be used for single sign-on but not for user provisioning;\nsee `,_jsx(_components.a,{href:`/cloud/scim-google-workspace`,children:`Google Workspace SCIM provisioning`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`In `,_jsx(_components.strong,{children:`Settings → Auth \u0026 Security → User provisioning (SCIM)`}),`, create the\nconnector, then give your identity provider the `,_jsx(_components.strong,{children:`SCIM base URL`}),` and the\nbearer token shown once after you create or rotate it. Failed syncs are retried\nand listed on the same tab until they are resolved.`]})]})}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":"Auth \u0026 Security","description":"Let your team sign in with your identity provider and add or remove people automatically","keywords":["SSO","single sign-on","SAML","OIDC","SCIM","user provisioning","Okta","Microsoft Entra ID","Google Workspace","identity provider"],"href":"/cloud/auth-and-security"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Who can use it","slug":"who-can-use-it","depth":2,"children":[]},{"title":"Single sign-on","slug":"single-sign-on","depth":2,"children":[{"title":"OIDC callback URLs","slug":"oidc-callback-urls","depth":3,"children":[]},{"title":"Editing and recovery","slug":"editing-and-recovery","depth":3,"children":[]}]},{"title":"User provisioning","slug":"user-provisioning","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"differentai","siteName":"OpenWork Docs","title":"Auth \u0026 Security - OpenWork Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-11T18:23:26.127Z","originalFileLocation":"cloud/auth-and-security.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=\"Let your team sign in with your identity provider and add or remove people automatically\">\u003cmeta data-mint-head name=\"application-name\" content=\"OpenWork Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/differentai/wKsTNhaHes0Tin67/_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=\"/docs/mintlify-assets/_mintlify/favicons/differentai/wKsTNhaHes0Tin67/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/differentai/wKsTNhaHes0Tin67/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/differentai/wKsTNhaHes0Tin67/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/differentai/wKsTNhaHes0Tin67/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/differentai/wKsTNhaHes0Tin67/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/differentai/wKsTNhaHes0Tin67/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/differentai/wKsTNhaHes0Tin67/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/differentai/wKsTNhaHes0Tin67/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Auth \u0026amp; Security - OpenWork Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Let your team sign in with your identity provider and add or remove people automatically\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"OpenWork Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://openworklabs.com/docs/cloud/auth-and-security\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://openworklabs.com/docs/images/openwork-social.png\">\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=\"Auth \u0026amp; Security - OpenWork Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Let your team sign in with your identity provider and add or remove people automatically\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://openworklabs.com/docs/images/openwork-social.png\">\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=\"/docs/mintlify-assets/_mintlify/favicons/differentai/wKsTNhaHes0Tin67/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"OpenWork Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#011627\">\u003cmeta data-mint-head name=\"og:image:alt\" content=\"OpenWork — Your AI workspace. Without vendor lock-in.\">\u003cmeta data-mint-head name=\"twitter:image:alt\" content=\"OpenWork — Your AI workspace. Without vendor lock-in.\">\u003clink data-mint-head rel=\"canonical\" href=\"https://openworklabs.com/docs/cloud/auth-and-security\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/cloud/auth-and-security.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://openworklabs.com/#organization\",\"name\":\"OpenWork Docs\",\"url\":\"https://openworklabs.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/differentai/bbTblqmGCwQ9TUdJ/logo/light.svg?fit=max\u0026auto=format\u0026n=bbTblqmGCwQ9TUdJ\u0026q=85\u0026s=4467903d12836ac81ccb6eef9dbe7bde\"}},{\"@type\":\"WebSite\",\"@id\":\"https://openworklabs.com/docs#website\",\"name\":\"OpenWork Docs\",\"url\":\"https://openworklabs.com/docs\",\"publisher\":{\"@id\":\"https://openworklabs.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://openworklabs.com/docs/cloud/auth-and-security#webpage\",\"url\":\"https://openworklabs.com/docs/cloud/auth-and-security\",\"name\":\"Auth \u0026 Security\",\"description\":\"Let your team sign in with your identity provider and add or remove people automatically\",\"dateModified\":\"2026-11-11T18:23:26.127Z\",\"isPartOf\":{\"@id\":\"https://openworklabs.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://openworklabs.com/docs/cloud/auth-and-security#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://openworklabs.com/docs/cloud/auth-and-security#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"OpenWork Docs\",\"item\":\"https://openworklabs.com/docs\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Auth \u0026 Security\",\"item\":\"https://openworklabs.com/docs/cloud/auth-and-security\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://openworklabs.com/docs/cloud/auth-and-security#article\",\"headline\":\"Auth \u0026 Security\",\"name\":\"Auth \u0026 Security\",\"description\":\"Let your team sign in with your identity provider and add or remove people automatically\",\"url\":\"https://openworklabs.com/docs/cloud/auth-and-security\",\"mainEntityOfPage\":{\"@id\":\"https://openworklabs.com/docs/cloud/auth-and-security#webpage\"},\"image\":\"https://openworklabs.com/docs/images/openwork-social.png\",\"dateModified\":\"2026-11-11T18:23:26.127Z\",\"keywords\":\"SSO, single sign-on, SAML, OIDC, SCIM, user provisioning, Okta, Microsoft Entra ID, Google Workspace, identity provider\",\"publisher\":{\"@id\":\"https://openworklabs.com/#organization\"},\"isPartOf\":{\"@id\":\"https://openworklabs.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"OpenWork Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"OpenWork Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/cloud/auth-and-security.md","siteName":"OpenWork Docs","nav":{"global":null,"tabs":[{"tab":"Start here","pages":[{"title":"Start here","href":"/start-here/get-started"}]},{"tab":"Desktop App","pages":[{"title":"Desktop App","href":"/desktop-app/first-task"}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations/overview"}]},{"tab":"Slack","pages":[{"title":"Slack","href":"/slack/connect-slack"}]},{"tab":"AI Gateway","pages":[{"title":"AI Gateway","href":"/ai-gateway/overview"}]},{"tab":"MCP Gateway","pages":[{"title":"MCP Gateway","href":"/cloud/run-in-the-cloud/cloud-mcp"}]},{"tab":"Artifacts","pages":[{"title":"Artifacts","href":"/dashboards/overview"}]},{"tab":"SSO","pages":[{"group":"Set up your organization","pages":[{"title":"Get started with OpenWork Cloud","href":"/cloud/get-started"},{"title":"Team quickstart: from new org to a team skill","href":"/cloud/team-quickstart"},{"title":"Managing members and RBAC","description":"Manage owners, super admins, admins and members, group them into teams, and decide what they can do with built-in and custom roles","href":"/cloud/members-and-rbac"}]},{"group":"SSO and SCIM","pages":[{"title":"Auth \u0026 Security","href":"/cloud/auth-and-security"},{"title":"Set up OIDC single sign-on","description":"Connect your identity provider, verify your email domain, and test sign-in before enabling SSO.","href":"/cloud/sso-oidc"},{"title":"Google Workspace SAML SSO","href":"/cloud/sso-google-workspace"},{"title":"Google Workspace SCIM provisioning","href":"/cloud/scim-google-workspace"},{"title":"Okta SAML SSO","href":"/cloud/sso-okta"},{"title":"Okta SCIM provisioning","href":"/cloud/scim-okta"},{"title":"Microsoft Entra SAML SSO","href":"/cloud/sso-microsoft-entra"},{"title":"Microsoft Entra SCIM provisioning","href":"/cloud/scim-microsoft-entra"}]},{"group":"Policies and operations","pages":[{"title":"Desktop policies","href":"/cloud/share-with-your-team/desktop-policies"},{"title":"Agent permissions","href":"/cloud/share-with-your-team/agent-permissions"},{"title":"Team prompt cards","href":"/cloud/share-with-your-team/team-prompt-cards"},{"title":"Prompts for agents","href":"/cloud/share-with-your-team/prompts"},{"title":"Security and operations","href":"/cloud/security-and-operations"},{"title":"Enterprise","href":"/cloud/enterprise"}]},{"group":"Observability","pages":[{"title":"Analytics","href":"/cloud/analytics"},{"title":"Audit logs","href":"/cloud/audit-logs"}]},{"group":"Organization settings","pages":[{"title":"Billing","href":"/cloud/billing"},{"title":"API keys","href":"/cloud/api-keys"}]}]},{"tab":"Self-host","pages":[{"title":"Self-host","href":"/start-here/self-host"}]},{"tab":"API","pages":[{"title":"API","href":"/api-reference/system/check-den-api-health"}]},{"tab":"Roadmap","pages":[{"title":"Roadmap","href":"/roadmap"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Auth \u0026 Security - OpenWork Docs","deploymentId":"dpl_J2QdBVuN65x4CCtpqPb371YPt4xi","buildId":"dpl_J2QdBVuN65x4CCtpqPb371YPt4xi","dynamics":[],"chunks":[]}