Let your team sign in to CloudCruise with your identity provider over SAML 2.0
CloudCruise supports SAML 2.0 Single Sign-On (SSO), so your team signs in to the dashboard with your own identity provider (IdP) instead of a CloudCruise password. You can also require SSO for everyone on your email domain, centralizing access in your IdP and turning off password sign-in.
SAML SSO is part of the Enterprise plan and is configured per organization by an organization owner. If you don’t see the Authentication settings, contact CloudCruise to enable it.
Verify your domain — prove you own the email domain your team uses (e.g. acme.com) by adding a DNS TXT record.
Attach a SAML configuration — paste your IdP’s metadata (Entity ID, SSO URL, signing certificate) onto the verified domain.
Once configured, anyone with an email on that domain can authenticate with SSO. Access to an organization or workspace is still controlled by CloudCruise membership and invites. Optionally, turn on Require SSO to block password sign-in and sign-up for the domain entirely.Any SAML 2.0–compliant identity provider works, including:
Okta
Microsoft Entra ID (Azure AD)
Google Workspace
OneLogin
Ping Identity
JumpCloud
…and any other SAML 2.0 IdP
Before you start
You’ll be moving values back and forth between your IdP and CloudCruise. From CloudCruise, your IdP needs these Service Provider (SP) details:
These Service Provider URLs are the same for every CloudCruise customer — they’re CloudCruise’s hosted SAML endpoint. Point your IdP’s ACS and Audience at them, and send the user’s email address as the SAML Name ID.
From your IdP, CloudCruise needs three values (covered in Step 2):
IdP Entity ID — your IdP’s SAML issuer / metadata identifier.
IdP SSO URL — the IdP login endpoint (must be HTTPS).
IdP signing certificate — the IdP’s x509 public certificate, in PEM format.
Step 1: Verify your domain
1
Open Authentication settings
Go to your organization’s Settings → Authentication page. (This link resolves to your active organization automatically.)
2
Add your email domain
Under Verified domains, enter the domain your team signs in with (for example acme.com) and click Add domain. A verification dialog opens automatically.
3
Publish the DNS TXT record
Add the following record at your DNS provider (the dialog shows the exact values with copy buttons):
Field
Value
Type
TXT
Name / Host
_cloudcruise-sso-verification.acme.com
Value
cc-sso-verify=<your-unique-token>
The token is generated per domain — copy it from the dialog rather than from this page.
4
Verify
Click Start verification. CloudCruise checks DNS every 15 seconds for up to 15 minutes (you can also click Check now). Once the record is found, the domain flips to Verified.
DNS changes can take anywhere from a minute to a few hours to propagate. If verification keeps failing, the dialog tells you exactly what it found at the hostname — e.g. a stale cc-sso-verify= record or no record at all.
A domain can only be verified by one organization. Multiple organizations can have a pending claim on the same domain, but only the first to verify it via DNS takes ownership.
Step 2: Add your SAML configuration
First create a SAML application in your IdP using the Service Provider details above, then bring the IdP’s values back into CloudCruise.
1
Create the SAML app in your IdP
In your identity provider, create a new SAML 2.0 application and set:
Audience / SP Entity ID → https://hrcczpkvvknatvtuwksw.supabase.co/auth/v1/sso/saml/metadata
Name ID → the user’s email address, format emailAddress
Assign the app to the users or groups who should be allowed to authenticate with CloudCruise. They still need CloudCruise organization and workspace membership to access your team’s workspaces.
2
Copy your IdP's metadata values
From the IdP’s SAML metadata (or app settings), collect:
IdP Entity ID (e.g. https://idp.acme.com/metadata)
IdP SSO URL — the HTTPS sign-on endpoint (e.g. https://idp.acme.com/sso)
Signing certificate in PEM form, including the -----BEGIN CERTIFICATE----- / -----END CERTIFICATE----- lines
3
Create the configuration in CloudCruise
Back on the Authentication page, under SAML configuration:
Choose the verified domain from Step 1.
Paste the IdP Entity ID, IdP SSO URL, and IdP Certificate (PEM).
Click Create configuration.
CloudCruise validates the values and registers the provider with its hosted SAML endpoint.
4
Test the login
Open the login page, choose Sign in with SSO, and enter a work email on the configured domain. You should be redirected to your IdP and, after authenticating, returned to CloudCruise signed in.
The IdP SSO URL must use HTTPS, and the certificate must be a valid PEM-encoded x509 certificate (starting with -----BEGIN CERTIFICATE-----). The dashboard rejects values that don’t meet these requirements.
Signing in directly from your IdP (optional)
Most identity providers offer a dashboard where users can click an app tile to launch straight into a connected app — Okta calls this an app tile, Entra ID and OneLogin call it a bookmark application. If you try pointing that tile directly at CloudCruise’s SAML app, users are redirected to the CloudCruise login page instead of being signed in.
This is a limitation of the IdP-initiated SAML flow itself, not a CloudCruise-specific bug: an app tile POSTs an unsolicited SAML assertion straight to CloudCruise’s SAML endpoint, with none of the request state CloudCruise normally sets up first. To keep sign-in secure, that state is required, so an unsolicited assertion can’t complete a login.
To get the same one-click experience safely, point the tile at CloudCruise’s SSO initiation URL instead of directly at the SAML app. CloudCruise starts the login itself from there, so the request state exists and the sign-in completes normally:
Replace <your-verified-domain> with the domain you verified in Step 1 (for example acme.com).
1
Create a bookmark app in your IdP
In your IdP, create a bookmark or link application (not a SAML application) with the URL above as its target. In Okta: Applications → Create App Integration → Bookmark App.
2
Assign it to your users
Assign the bookmark app to the same users or groups as your SAML app. Clicking it now runs the normal SSO login and lands them in CloudCruise signed in.
Not every IdP has a bookmark-app concept (for example, Auth0 doesn’t). In that case, just share the SSO initiation URL above directly — as a link on your intranet, in a password manager, or as a browser bookmark. It works the same way either way.
Requiring SSO (enforcement)
Each SAML configuration has a Require SSO toggle:
State
Behavior
Off (default)
Users on the domain can sign in either with SSO or with an email/password.
On
Password sign-in and new password sign-ups are blocked for the domain. Anyone attempting password login is redirected to SSO.
Enforcement is applied both in the CloudCruise sign-in flow and deep in the auth layer, so it can’t be bypassed by going straight to the password form.
Turn enforcement on only after you’ve confirmed SSO login works end-to-end. CloudCruise also enforces this at the database level: Require SSO cannot be turned on until at least one organization Owner has actually signed in via SSO and linked their account, which prevents the classic case of enforcement being flipped on before anyone can use SSO yet. This doesn’t protect against every failure mode — if your IdP breaks later (e.g. a certificate rotates) while enforcement is already on, you can still end up temporarily locked out. Leave it off while testing, then flip it on.
User provisioning
CloudCruise uses just-in-time provisioning. When a user signs in through SSO for the first time, an account is created automatically from the email address in the SAML assertion — there’s no separate import step. The email comes from the SAML Name ID (emailAddress format), which is why your IdP must send it there.Just-in-time provisioning creates the CloudCruise user account and profile only. It does not automatically add the user to your organization or to every workspace.To give a user access, invite them to your organization from CloudCruise. When they accept the invite, they’re added as an organization Member and as a Member of the organization’s existing workspaces. New workspaces can also be created with existing organization members added automatically, or workspace access can be managed separately.
If someone already has a CloudCruise account under the same email — for example, they signed up with a password before your organization set up SSO — signing in via SSO does not automatically merge into that existing account. SAML identities are deliberately never auto-linked to other accounts, for security reasons. Instead, CloudCruise detects the match and prompts the user to link the two accounts: if the existing account already has organization access, linking is required before they can continue; otherwise it’s an optional prompt they can act on whenever they choose. Until they link, the two accounts stay fully separate.
For most providers the default mapping (Name ID → email) is all you need. If your IdP can only send email as a custom attribute claim, contact support — a custom attribute mapping can be applied to your configuration.
Identity provider quick reference
The exact labels differ per provider, but the mapping is always the same.
Okta
Microsoft Entra ID
Google Workspace
Applications → Create App Integration → SAML 2.0.
Single sign-on URL → https://hrcczpkvvknatvtuwksw.supabase.co/auth/v1/sso/saml/acs
Audience URI (SP Entity ID) → https://hrcczpkvvknatvtuwksw.supabase.co/auth/v1/sso/saml/metadata
Name ID format → EmailAddress; Application username → Email.
Finish, then open Sign On → View SAML setup instructions to grab:
Identity Provider Issuer → IdP Entity ID
Identity Provider Single Sign-On URL → IdP SSO URL
X.509 Certificate → paste as the PEM certificate
Enterprise applications → New application → Create your own (non-gallery), then Single sign-on → SAML.
Delete a SAML configuration — users on that domain can no longer sign in via SSO (delete this before removing the domain).
Delete a verified domain — only allowed once its SAML configuration has been removed.
Troubleshooting
Domain verification never succeeds
Confirm the TXT record is on the exact host _cloudcruise-sso-verification.<your-domain> and the value matches cc-sso-verify=<token> from the dialog. The verification dialog reports what it actually found — a stale token, a non-CloudCruise record, or nothing yet. Allow time for DNS propagation and use Check now to retry.
“SSO is not configured for this domain”
The email’s domain has no SAML configuration, or you entered a domain that isn’t verified. Make sure the domain is Verified and has a SAML configuration attached, and that the user’s email domain exactly matches.
Login redirects to the IdP but fails to come back
Double-check the ACS URL and SP Entity ID in your IdP exactly match the values above, and that the IdP sends the user’s email as the Name ID in emailAddress format. A mismatched audience or missing email is the most common cause.
Clicking the app tile in the IdP dashboard just lands on the CloudCruise login page
This happens when the IdP tile points directly at the SAML app (an IdP-initiated login), which CloudCruise’s SAML endpoint can’t complete. See Signing in directly from your IdP — point the tile at the SSO initiation URL instead.
Certificate or SSO URL rejected on save
The IdP SSO URL must be HTTPS, and the certificate must be a PEM block beginning with -----BEGIN CERTIFICATE-----. Copy the full certificate including the header and footer lines.
Locked out after enabling Require SSO
CloudCruise prevents the most common cause of this: enforcement can’t be turned on until an organization Owner has already linked their account via SSO, so there’s always at least one Owner able to sign in. If you’re still locked out — for example, your IdP configuration broke after enforcement was already on — contact support to temporarily disable enforcement so you can fix the IdP settings.
Security notes
CloudCruise validates each SAML assertion against the signing certificate you provide — rotate it in your IdP and update the configuration if it changes.
Enforcement blocks the password path server-side, not just in the UI, so it cannot be bypassed.
SSO is scoped to your organization for configuration and enforcement. Workspace access is still determined by CloudCruise workspace membership.
All configuration changes (created, updated, enforcement toggled, deleted) are recorded in an audit log.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"CloudCruise","colors":{"primary":"#3b82f6","light":"#06b6d4","dark":"#3b82f6"},"logo":{"light":"https://mintcdn.com/cloudcruise/8_UPZbQUthCzbuCo/logo/logo-light-mode.png?fit=max\u0026auto=format\u0026n=8_UPZbQUthCzbuCo\u0026q=85\u0026s=ef2ba0e76d3257b48973b64d9e3a6da0","dark":"https://mintcdn.com/cloudcruise/8_UPZbQUthCzbuCo/logo/logo-dark-mode.png?fit=max\u0026auto=format\u0026n=8_UPZbQUthCzbuCo\u0026q=85\u0026s=1fc723ef8c6d2f2901d0d383193b63d1"},"favicon":"https://mintcdn.com/cloudcruise/uOQYUGXxCIiaQU-f/favicon.svg?fit=max\u0026auto=format\u0026n=uOQYUGXxCIiaQU-f\u0026q=85\u0026s=58063611db7799cda985cc9a963b6e7e","navbar":{"links":[{"href":"mailto:founders@cloudcruise.com","label":"Support"},{"href":"https://docs.cloudcruise.com/llms.txt","label":"For AI"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.cloudcruise.com"}},"footer":{"socials":{"x":"https://x.com/cloudcruise_app","github":"https://github.com/CloudCruise","linkedin":"https://www.linkedin.com/company/cloudcruise"}},"contextual":{"options":["copy","view"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Community","icon":"discord","href":"https://discord.com/invite/MHjbUqedZF"},{"anchor":"Blog","icon":"newspaper","href":"https://cloudcruise.com/blog"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cloudcruise","hasAudioNarration":false,"actualSubdomain":"cloudcruise","customDomains":["docs.cloudcruise.com"],"gitSource":{"type":"github","owner":"cloudcruise","repo":"monorepo","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afe328299dd50e5a0d60d31","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"default","tag":"API Reference","count":52},{"language":"default","tag":"Concepts","count":44},{"language":"default","tag":"Workflow DSL","count":23},{"language":"default","tag":"Workflow API","count":23},{"language":"default","tag":"Node Types","count":21},{"language":"default","tag":"Run API","count":15},{"language":"default","tag":"Vault API","count":8},{"language":"default","tag":"Maintenance Agent","count":7},{"language":"default","tag":"SDK","count":7},{"language":"default","tag":"Custom Secret Provider API","count":4}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"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":[],"page":{"pagePath":"concepts/saml-sso","slug":"/concepts/saml-sso","pageMetadata":{"title":"SAML Single Sign-On","description":"Let your team sign in to CloudCruise with your identity provider over SAML 2.0","href":"/concepts/saml-sso"},"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 to CloudCruise with your identity provider over SAML 2.0\"\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`,em:`em`,hr:`hr`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,CodeBlock,Heading,Note,Step,Steps,Tab,Table,Tabs,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`CloudCruise supports `,_jsx(_components.strong,{children:`SAML 2.0 Single Sign-On (SSO)`}),`, so your team signs in to the dashboard with your own identity provider (IdP) instead of a CloudCruise password. You can also `,_jsx(_components.strong,{children:`require`}),` SSO for everyone on your email domain, centralizing access in your IdP and turning off password sign-in.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`SAML SSO is part of the `,_jsx(_components.strong,{children:`Enterprise plan`}),` and is configured per `,_jsx(_components.strong,{children:`organization`}),` by an organization `,_jsx(_components.strong,{children:`owner`}),`. If you don’t see the Authentication settings, `,_jsx(_components.a,{href:`mailto:founders@cloudcruise.com`,children:`contact CloudCruise`}),` to enable it.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`how-it-works`,children:`How it works`}),`\n`,_jsxs(_components.p,{children:[`SSO is set up in two steps, both from `,_jsx(_components.a,{href:`https://app.cloudcruise.com/organizations/authentication`,children:`Organization Settings → Authentication`}),`:`]}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Verify your domain`}),` — prove you own the email domain your team uses (e.g. `,_jsx(_components.code,{children:`acme.com`}),`) by adding a DNS TXT record.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Attach a SAML configuration`}),` — paste your IdP’s metadata (Entity ID, SSO URL, signing certificate) onto the verified domain.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Once configured, anyone with an email on that domain can authenticate with SSO. Access to an organization or workspace is still controlled by CloudCruise membership and invites. Optionally, turn on `,_jsx(_components.strong,{children:`Require SSO`}),` to block password sign-in and sign-up for the domain entirely.`]}),`\n`,_jsx(_components.p,{children:`Any SAML 2.0–compliant identity provider works, including:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.strong,{children:`Okta`})}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Microsoft Entra ID`}),` (Azure AD)`]}),`\n`,_jsx(_components.li,{children:_jsx(_components.strong,{children:`Google Workspace`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.strong,{children:`OneLogin`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.strong,{children:`Ping Identity`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.strong,{children:`JumpCloud`})}),`\n`,_jsx(_components.li,{children:`…and any other SAML 2.0 IdP`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`before-you-start`,children:`Before you start`}),`\n`,_jsxs(_components.p,{children:[`You’ll be moving values back and forth between your IdP and CloudCruise. From CloudCruise, your IdP needs these `,_jsx(_components.strong,{children:`Service Provider (SP)`}),` details:`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting in your IdP`}),_jsx(_components.th,{children:`Value`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`ACS URL`}),` (a.k.a. Reply URL, Single sign-on URL, Assertion Consumer Service)`]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`https://hrcczpkvvknatvtuwksw.supabase.co/auth/v1/sso/saml/acs`})})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`SP Entity ID`}),` (a.k.a. Audience URI, Identifier)`]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`https://hrcczpkvvknatvtuwksw.supabase.co/auth/v1/sso/saml/metadata`})})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`SP Metadata URL`}),` (if your IdP supports importing it)`]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`https://hrcczpkvvknatvtuwksw.supabase.co/auth/v1/sso/saml/metadata`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Name ID format`})}),_jsxs(_components.td,{children:[`Email address (`,_jsx(_components.code,{children:`urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress`}),`)`]})]})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`These Service Provider URLs are the same for every CloudCruise customer — they’re CloudCruise’s hosted SAML endpoint. Point your IdP’s ACS and Audience at them, and send the user’s `,_jsx(_components.strong,{children:`email address as the SAML Name ID`}),`.`]})}),`\n`,_jsxs(_components.p,{children:[`From your IdP, CloudCruise needs three values (covered in `,_jsx(_components.a,{href:`#step-2-add-your-saml-configuration`,children:`Step 2`}),`):`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`IdP Entity ID`}),` — your IdP’s SAML issuer / metadata identifier.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`IdP SSO URL`}),` — the IdP login endpoint (must be `,_jsx(_components.strong,{children:`HTTPS`}),`).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`IdP signing certificate`}),` — the IdP’s x509 public certificate, in PEM format.`]}),`\n`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`step-1-verify-your-domain`,children:`Step 1: Verify your domain`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open Authentication settings`,children:_jsxs(_components.p,{children:[`Go to your organization’s `,_jsx(_components.a,{href:`https://app.cloudcruise.com/organizations/authentication`,children:_jsx(_components.strong,{children:`Settings → Authentication`})}),` page. (This link resolves to your active organization automatically.)`]})}),_jsx(Step,{title:`Add your email domain`,children:_jsxs(_components.p,{children:[`Under `,_jsx(_components.strong,{children:`Verified domains`}),`, enter the domain your team signs in with (for example `,_jsx(_components.code,{children:`acme.com`}),`) and click `,_jsx(_components.strong,{children:`Add domain`}),`. A verification dialog opens automatically.`]})}),_jsxs(Step,{title:`Publish the DNS TXT record`,children:[_jsx(_components.p,{children:`Add the following record at your DNS provider (the dialog shows the exact values with copy buttons):`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Value`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Type`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`TXT`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Name / Host`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`_cloudcruise-sso-verification.acme.com`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Value`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`cc-sso-verify=\u003cyour-unique-token>`})})]})]})]}),_jsx(_components.p,{children:`The token is generated per domain — copy it from the dialog rather than from this page.`})]}),_jsx(Step,{title:`Verify`,children:_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Start verification`}),`. CloudCruise checks DNS every 15 seconds for up to 15 minutes (you can also click `,_jsx(_components.strong,{children:`Check now`}),`). Once the record is found, the domain flips to `,_jsx(_components.strong,{children:`Verified`}),`.`]})})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`DNS changes can take anywhere from a minute to a few hours to propagate. If verification keeps failing, the dialog tells you exactly what it found at the hostname — e.g. a stale `,_jsx(_components.code,{children:`cc-sso-verify=`}),` record or no record at all.`]})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`A domain can only be `,_jsx(_components.strong,{children:`verified by one organization`}),`. Multiple organizations can have a `,_jsx(_components.em,{children:`pending`}),` claim on the same domain, but only the first to verify it via DNS takes ownership.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`step-2-add-your-saml-configuration`,children:`Step 2: Add your SAML configuration`}),`\n`,_jsxs(_components.p,{children:[`First create a SAML application in your IdP using the `,_jsx(_components.a,{href:`#before-you-start`,children:`Service Provider details above`}),`, then bring the IdP’s values back into CloudCruise.`]}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Create the SAML app in your IdP`,children:[_jsx(_components.p,{children:`In your identity provider, create a new SAML 2.0 application and set:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`ACS URL`}),` → `,_jsx(_components.code,{children:`https://hrcczpkvvknatvtuwksw.supabase.co/auth/v1/sso/saml/acs`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Audience / SP Entity ID`}),` → `,_jsx(_components.code,{children:`https://hrcczpkvvknatvtuwksw.supabase.co/auth/v1/sso/saml/metadata`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Name ID`}),` → the user’s `,_jsx(_components.strong,{children:`email address`}),`, format `,_jsx(_components.code,{children:`emailAddress`})]}),`\n`]}),_jsx(_components.p,{children:`Assign the app to the users or groups who should be allowed to authenticate with CloudCruise. They still need CloudCruise organization and workspace membership to access your team’s workspaces.`})]}),_jsxs(Step,{title:`Copy your IdP's metadata values`,children:[_jsx(_components.p,{children:`From the IdP’s SAML metadata (or app settings), collect:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`IdP Entity ID`}),` (e.g. `,_jsx(_components.code,{children:`https://idp.acme.com/metadata`}),`)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`IdP SSO URL`}),` — the HTTPS sign-on endpoint (e.g. `,_jsx(_components.code,{children:`https://idp.acme.com/sso`}),`)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Signing certificate`}),` in PEM form, including the `,_jsx(_components.code,{children:`-----BEGIN CERTIFICATE-----`}),` / `,_jsx(_components.code,{children:`-----END CERTIFICATE-----`}),` lines`]}),`\n`]})]}),_jsxs(Step,{title:`Create the configuration in CloudCruise`,children:[_jsxs(_components.p,{children:[`Back on the `,_jsx(_components.strong,{children:`Authentication`}),` page, under `,_jsx(_components.strong,{children:`SAML configuration`}),`:`]}),_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Choose the `,_jsx(_components.strong,{children:`verified domain`}),` from Step 1.`]}),`\n`,_jsxs(_components.li,{children:[`Paste the `,_jsx(_components.strong,{children:`IdP Entity ID`}),`, `,_jsx(_components.strong,{children:`IdP SSO URL`}),`, and `,_jsx(_components.strong,{children:`IdP Certificate (PEM)`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Create configuration`}),`.`]}),`\n`]}),_jsx(_components.p,{children:`CloudCruise validates the values and registers the provider with its hosted SAML endpoint.`})]}),_jsx(Step,{title:`Test the login`,children:_jsxs(_components.p,{children:[`Open the `,_jsx(_components.a,{href:`https://app.cloudcruise.com/login`,children:`login page`}),`, choose `,_jsx(_components.strong,{children:`Sign in with SSO`}),`, and enter a work email on the configured domain. You should be redirected to your IdP and, after authenticating, returned to CloudCruise signed in.`]})})]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`The `,_jsx(_components.strong,{children:`IdP SSO URL must use HTTPS`}),`, and the certificate must be a valid PEM-encoded x509 certificate (starting with `,_jsx(_components.code,{children:`-----BEGIN CERTIFICATE-----`}),`). The dashboard rejects values that don’t meet these requirements.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`signing-in-directly-from-your-idp-optional`,children:`Signing in directly from your IdP (optional)`}),`\n`,_jsxs(_components.p,{children:[`Most identity providers offer a dashboard where users can click an app tile to launch straight into a connected app — Okta calls this an `,_jsx(_components.strong,{children:`app tile`}),`, Entra ID and OneLogin call it a `,_jsx(_components.strong,{children:`bookmark application`}),`. If you try pointing that tile directly at CloudCruise’s SAML app, users are redirected to the CloudCruise login page instead of being signed in.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`This is a limitation of the `,_jsx(_components.strong,{children:`IdP-initiated SAML`}),` flow itself, not a CloudCruise-specific bug: an app tile POSTs an unsolicited SAML assertion straight to CloudCruise’s SAML endpoint, with none of the request state CloudCruise normally sets up first. To keep sign-in secure, that state is required, so an unsolicited assertion can’t complete a login.`]})}),`\n`,_jsxs(_components.p,{children:[`To get the same one-click experience safely, point the tile at CloudCruise’s `,_jsx(_components.strong,{children:`SSO initiation URL`}),` instead of directly at the SAML app. CloudCruise starts the login itself from there, so the request state exists and the sign-in completes normally:`]}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`https://app.cloudcruise.com/auth/saml-init?domain=\u003cyour-verified-domain>`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.p,{children:[`Replace `,_jsx(_components.code,{children:`\u003cyour-verified-domain>`}),` with the domain you verified in `,_jsx(_components.a,{href:`#step-1-verify-your-domain`,children:`Step 1`}),` (for example `,_jsx(_components.code,{children:`acme.com`}),`).`]}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Create a bookmark app in your IdP`,children:_jsxs(_components.p,{children:[`In your IdP, create a `,_jsx(_components.strong,{children:`bookmark`}),` or `,_jsx(_components.strong,{children:`link`}),` application (not a SAML application) with the URL above as its target. In Okta: `,_jsx(_components.strong,{children:`Applications → Create App Integration → Bookmark App`}),`.`]})}),_jsx(Step,{title:`Assign it to your users`,children:_jsx(_components.p,{children:`Assign the bookmark app to the same users or groups as your SAML app. Clicking it now runs the normal SSO login and lands them in CloudCruise signed in.`})})]}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`Not every IdP has a bookmark-app concept (for example, Auth0 doesn’t). In that case, just share the SSO initiation URL above directly — as a link on your intranet, in a password manager, or as a browser bookmark. It works the same way either way.`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`requiring-sso-enforcement`,children:`Requiring SSO (enforcement)`}),`\n`,_jsxs(_components.p,{children:[`Each SAML configuration has a `,_jsx(_components.strong,{children:`Require SSO`}),` toggle:`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`State`}),_jsx(_components.th,{children:`Behavior`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Off`}),` (default)`]}),_jsxs(_components.td,{children:[`Users on the domain can sign in `,_jsx(_components.strong,{children:`either`}),` with SSO `,_jsx(_components.strong,{children:`or`}),` with an email/password.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`On`})}),_jsxs(_components.td,{children:[`Password sign-in and new password sign-ups are `,_jsx(_components.strong,{children:`blocked`}),` for the domain. Anyone attempting password login is redirected to SSO.`]})]})]})]}),`\n`,_jsx(_components.p,{children:`Enforcement is applied both in the CloudCruise sign-in flow and deep in the auth layer, so it can’t be bypassed by going straight to the password form.`}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Turn enforcement `,_jsx(_components.strong,{children:`on only after`}),` you’ve confirmed SSO login works end-to-end. CloudCruise also enforces this at the database level: `,_jsx(_components.strong,{children:`Require SSO`}),` cannot be turned on until at least one organization `,_jsx(_components.strong,{children:`Owner`}),` has actually signed in via SSO and linked their account, which prevents the classic case of enforcement being flipped on before anyone can use SSO yet. This doesn’t protect against every failure mode — if your IdP breaks later (e.g. a certificate rotates) while enforcement is already on, you can still end up temporarily locked out. Leave it off while testing, then flip it on.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`user-provisioning`,children:`User provisioning`}),`\n`,_jsxs(_components.p,{children:[`CloudCruise uses `,_jsx(_components.strong,{children:`just-in-time provisioning`}),`. When a user signs in through SSO for the first time, an account is created automatically from the email address in the SAML assertion — there’s no separate import step. The email comes from the SAML `,_jsx(_components.strong,{children:`Name ID`}),` (`,_jsx(_components.code,{children:`emailAddress`}),` format), which is why your IdP must send it there.`]}),`\n`,_jsxs(_components.p,{children:[`Just-in-time provisioning creates the CloudCruise user account and profile only. It does `,_jsx(_components.strong,{children:`not`}),` automatically add the user to your organization or to every workspace.`]}),`\n`,_jsxs(_components.p,{children:[`To give a user access, invite them to your organization from CloudCruise. When they accept the invite, they’re added as an organization `,_jsx(_components.strong,{children:`Member`}),` and as a `,_jsx(_components.strong,{children:`Member`}),` of the organization’s existing workspaces. New workspaces can also be created with existing organization members added automatically, or workspace access can be managed separately.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`If someone already has a CloudCruise account under the same email — for example, they signed up with a password before your organization set up SSO — signing in via SSO does `,_jsx(_components.strong,{children:`not`}),` automatically merge into that existing account. SAML identities are deliberately never auto-linked to other accounts, for security reasons. Instead, CloudCruise detects the match and prompts the user to link the two accounts: if the existing account already has organization access, linking is `,_jsx(_components.strong,{children:`required`}),` before they can continue; otherwise it’s an optional prompt they can act on whenever they choose. Until they link, the two accounts stay fully separate.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`For most providers the default mapping (Name ID → email) is all you need. If your IdP can only send email as a custom attribute claim, `,_jsx(_components.a,{href:`mailto:founders@cloudcruise.com`,children:`contact support`}),` — a custom attribute mapping can be applied to your configuration.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`identity-provider-quick-reference`,children:`Identity provider quick reference`}),`\n`,_jsx(_components.p,{children:`The exact labels differ per provider, but the mapping is always the same.`}),`\n`,_jsxs(Tabs,{children:[_jsx(Tab,{title:`Okta`,id:`okta`,children:_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Applications → Create App Integration → SAML 2.0`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Single sign-on URL`}),` → `,_jsx(_components.code,{children:`https://hrcczpkvvknatvtuwksw.supabase.co/auth/v1/sso/saml/acs`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Audience URI (SP Entity ID)`}),` → `,_jsx(_components.code,{children:`https://hrcczpkvvknatvtuwksw.supabase.co/auth/v1/sso/saml/metadata`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Name ID format`}),` → `,_jsx(_components.code,{children:`EmailAddress`}),`; `,_jsx(_components.strong,{children:`Application username`}),` → Email.`]}),`\n`,_jsxs(_components.li,{children:[`Finish, then open `,_jsx(_components.strong,{children:`Sign On → View SAML setup instructions`}),` to grab:`,`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Identity Provider Issuer`}),` → IdP Entity ID`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Identity Provider Single Sign-On URL`}),` → IdP SSO URL`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`X.509 Certificate`}),` → paste as the PEM certificate`]}),`\n`]}),`\n`]}),`\n`]})}),_jsx(Tab,{title:`Microsoft Entra ID`,id:`microsoft-entra-id`,children:_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Enterprise applications → New application → Create your own`}),` (non-gallery), then `,_jsx(_components.strong,{children:`Single sign-on → SAML`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Identifier (Entity ID)`}),` → `,_jsx(_components.code,{children:`https://hrcczpkvvknatvtuwksw.supabase.co/auth/v1/sso/saml/metadata`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Reply URL (ACS URL)`}),` → `,_jsx(_components.code,{children:`https://hrcczpkvvknatvtuwksw.supabase.co/auth/v1/sso/saml/acs`})]}),`\n`,_jsxs(_components.li,{children:[`Ensure the `,_jsx(_components.strong,{children:`Unique User Identifier (Name ID)`}),` claim is the user’s `,_jsx(_components.code,{children:`user.mail`}),` in email format.`]}),`\n`,_jsxs(_components.li,{children:[`From the SAML configuration panel, copy:`,`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Microsoft Entra Identifier`}),` → IdP Entity ID`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Login URL`}),` → IdP SSO URL`]}),`\n`,_jsxs(_components.li,{children:[`Download the `,_jsx(_components.strong,{children:`Certificate (Base64)`}),` → paste as the PEM certificate`]}),`\n`]}),`\n`]}),`\n`]})}),_jsx(Tab,{title:`Google Workspace`,id:`google-workspace`,children:_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Admin console → Apps → Web and mobile apps → Add custom SAML app`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Copy Google’s `,_jsx(_components.strong,{children:`SSO URL`}),`, `,_jsx(_components.strong,{children:`Entity ID`}),`, and `,_jsx(_components.strong,{children:`Certificate`}),` (these are your IdP values).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`ACS URL`}),` → `,_jsx(_components.code,{children:`https://hrcczpkvvknatvtuwksw.supabase.co/auth/v1/sso/saml/acs`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Entity ID`}),` → `,_jsx(_components.code,{children:`https://hrcczpkvvknatvtuwksw.supabase.co/auth/v1/sso/saml/metadata`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Name ID format`}),` → `,_jsx(_components.code,{children:`EMAIL`}),`; `,_jsx(_components.strong,{children:`Name ID`}),` → Basic Information > Primary email.`]}),`\n`]})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`managing-and-removing-configurations`,children:`Managing and removing configurations`}),`\n`,_jsxs(_components.p,{children:[`From the `,_jsx(_components.a,{href:`https://app.cloudcruise.com/organizations/authentication`,children:_jsx(_components.strong,{children:`Authentication`})}),` page you can:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Toggle Require SSO`}),` on or off at any time.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Delete a SAML configuration`}),` — users on that domain can no longer sign in via SSO (delete this before removing the domain).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Delete a verified domain`}),` — only allowed once its SAML configuration has been removed.`]}),`\n`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`troubleshooting`,children:`Troubleshooting`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`Domain verification never succeeds`,id:`domain-verification-never-succeeds`,children:_jsxs(_components.p,{children:[`Confirm the TXT record is on the exact host `,_jsx(_components.code,{children:`_cloudcruise-sso-verification.\u003cyour-domain>`}),` and the value matches `,_jsx(_components.code,{children:`cc-sso-verify=\u003ctoken>`}),` from the dialog. The verification dialog reports what it actually found — a stale token, a non-CloudCruise record, or nothing yet. Allow time for DNS propagation and use `,_jsx(_components.strong,{children:`Check now`}),` to retry.`]})}),_jsx(Accordion,{title:`“SSO is not configured for this domain”`,id:`sso-is-not-configured-for-this-domain`,children:_jsxs(_components.p,{children:[`The email’s domain has no SAML configuration, or you entered a domain that isn’t verified. Make sure the domain is `,_jsx(_components.strong,{children:`Verified`}),` and has a SAML configuration attached, and that the user’s email domain exactly matches.`]})}),_jsx(Accordion,{title:`Login redirects to the IdP but fails to come back`,id:`login-redirects-to-the-idp-but-fails-to-come-back`,children:_jsxs(_components.p,{children:[`Double-check the `,_jsx(_components.strong,{children:`ACS URL`}),` and `,_jsx(_components.strong,{children:`SP Entity ID`}),` in your IdP exactly match the values above, and that the IdP sends the user’s `,_jsx(_components.strong,{children:`email as the Name ID`}),` in `,_jsx(_components.code,{children:`emailAddress`}),` format. A mismatched audience or missing email is the most common cause.`]})}),_jsx(Accordion,{title:`Clicking the app tile in the IdP dashboard just lands on the CloudCruise login page`,id:`clicking-the-app-tile-in-the-idp-dashboard-just-lands-on-the-cloudcruise-login-page`,children:_jsxs(_components.p,{children:[`This happens when the IdP tile points directly at the SAML app (an IdP-initiated login), which CloudCruise’s SAML endpoint can’t complete. See `,_jsx(_components.a,{href:`#signing-in-directly-from-your-idp-optional`,children:`Signing in directly from your IdP`}),` — point the tile at the SSO initiation URL instead.`]})}),_jsx(Accordion,{title:`Certificate or SSO URL rejected on save`,id:`certificate-or-sso-url-rejected-on-save`,children:_jsxs(_components.p,{children:[`The `,_jsx(_components.strong,{children:`IdP SSO URL`}),` must be HTTPS, and the `,_jsx(_components.strong,{children:`certificate`}),` must be a PEM block beginning with `,_jsx(_components.code,{children:`-----BEGIN CERTIFICATE-----`}),`. Copy the full certificate including the header and footer lines.`]})}),_jsx(Accordion,{title:`Locked out after enabling Require SSO`,id:`locked-out-after-enabling-require-sso`,children:_jsxs(_components.p,{children:[`CloudCruise prevents the most common cause of this: enforcement can’t be turned on until an organization Owner has already linked their account via SSO, so there’s always at least one Owner able to sign in. If you’re still locked out — for example, your IdP configuration broke after enforcement was already on — `,_jsx(_components.a,{href:`mailto:founders@cloudcruise.com`,children:`contact support`}),` to temporarily disable enforcement so you can fix the IdP settings.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`security-notes`,children:`Security notes`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`CloudCruise validates each SAML assertion against the `,_jsx(_components.strong,{children:`signing certificate`}),` you provide — rotate it in your IdP and update the configuration if it changes.`]}),`\n`,_jsxs(_components.li,{children:[`Enforcement blocks the password path `,_jsx(_components.strong,{children:`server-side`}),`, not just in the UI, so it cannot be bypassed.`]}),`\n`,_jsxs(_components.li,{children:[`SSO is scoped to your `,_jsx(_components.strong,{children:`organization`}),` for configuration and enforcement. Workspace access is still determined by CloudCruise workspace membership.`]}),`\n`,_jsx(_components.li,{children:`All configuration changes (created, updated, enforcement toggled, deleted) are recorded in an audit log.`}),`\n`]})]})}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":"SAML Single Sign-On","description":"Let your team sign in to CloudCruise with your identity provider over SAML 2.0","href":"/concepts/saml-sso"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"How it works","slug":"how-it-works","depth":2,"children":[]},{"title":"Before you start","slug":"before-you-start","depth":2,"children":[]},{"title":"Step 1: Verify your domain","slug":"step-1-verify-your-domain","depth":2,"children":[]},{"title":"Step 2: Add your SAML configuration","slug":"step-2-add-your-saml-configuration","depth":2,"children":[]},{"title":"Signing in directly from your IdP (optional)","slug":"signing-in-directly-from-your-idp-optional","depth":2,"children":[]},{"title":"Requiring SSO (enforcement)","slug":"requiring-sso-enforcement","depth":2,"children":[]},{"title":"User provisioning","slug":"user-provisioning","depth":2,"children":[]},{"title":"Identity provider quick reference","slug":"identity-provider-quick-reference","depth":2,"children":[]},{"title":"Managing and removing configurations","slug":"managing-and-removing-configurations","depth":2,"children":[]},{"title":"Troubleshooting","slug":"troubleshooting","depth":2,"children":[]},{"title":"Security notes","slug":"security-notes","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"cloudcruise","siteName":"CloudCruise","title":"SAML Single Sign-On - CloudCruise","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-12T01:00:11.813Z","originalFileLocation":"concepts/saml-sso.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 to CloudCruise with your identity provider over SAML 2.0\">\u003cmeta data-mint-head name=\"application-name\" content=\"CloudCruise\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cloudcruise/qna2ORyQtRYDEfUK/_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/cloudcruise/qna2ORyQtRYDEfUK/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cloudcruise/qna2ORyQtRYDEfUK/_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/cloudcruise/qna2ORyQtRYDEfUK/_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/cloudcruise/qna2ORyQtRYDEfUK/_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/cloudcruise/qna2ORyQtRYDEfUK/_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/cloudcruise/qna2ORyQtRYDEfUK/_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/cloudcruise/qna2ORyQtRYDEfUK/_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/cloudcruise/qna2ORyQtRYDEfUK/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"SAML Single Sign-On - CloudCruise\">\u003cmeta data-mint-head property=\"og:description\" content=\"Let your team sign in to CloudCruise with your identity provider over SAML 2.0\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"CloudCruise\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.cloudcruise.com/concepts/saml-sso\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cloudcruise.mintlify.site/_mintlify/api/og/v2?division=Concepts\u0026amp;title=SAML+Single+Sign-On\u0026amp;description=Let+your+team+sign+in+to+CloudCruise+with+your+identity+provider+over+SAML+2.0\u0026amp;theme=ffc9db1ae4e249ee41b68180\u0026amp;signature=bc283459230c2dcea908ec0c92dbdc797e9b26db521e452c43049f06877e3da5\">\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=\"SAML Single Sign-On - CloudCruise\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Let your team sign in to CloudCruise with your identity provider over SAML 2.0\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cloudcruise.mintlify.site/_mintlify/api/og/v2?division=Concepts\u0026amp;title=SAML+Single+Sign-On\u0026amp;description=Let+your+team+sign+in+to+CloudCruise+with+your+identity+provider+over+SAML+2.0\u0026amp;theme=ffc9db1ae4e249ee41b68180\u0026amp;signature=bc283459230c2dcea908ec0c92dbdc797e9b26db521e452c43049f06877e3da5\">\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/cloudcruise/qna2ORyQtRYDEfUK/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"CloudCruise\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3b82f6\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.cloudcruise.com/concepts/saml-sso\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/concepts/saml-sso.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.cloudcruise.com/#organization\",\"name\":\"CloudCruise\",\"url\":\"https://docs.cloudcruise.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cloudcruise/8_UPZbQUthCzbuCo/logo/logo-light-mode.png?fit=max\u0026auto=format\u0026n=8_UPZbQUthCzbuCo\u0026q=85\u0026s=ef2ba0e76d3257b48973b64d9e3a6da0\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.cloudcruise.com#website\",\"name\":\"CloudCruise\",\"url\":\"https://docs.cloudcruise.com\",\"publisher\":{\"@id\":\"https://docs.cloudcruise.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.cloudcruise.com/concepts/saml-sso#webpage\",\"url\":\"https://docs.cloudcruise.com/concepts/saml-sso\",\"name\":\"SAML Single Sign-On\",\"description\":\"Let your team sign in to CloudCruise with your identity provider over SAML 2.0\",\"dateModified\":\"2026-11-12T01:00:11.813Z\",\"isPartOf\":{\"@id\":\"https://docs.cloudcruise.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.cloudcruise.com/concepts/saml-sso#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.cloudcruise.com/concepts/saml-sso#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Concepts\",\"item\":\"https://docs.cloudcruise.com/concepts/workflows\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"SAML Single Sign-On\",\"item\":\"https://docs.cloudcruise.com/concepts/saml-sso\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.cloudcruise.com/concepts/saml-sso#article\",\"headline\":\"SAML Single Sign-On\",\"name\":\"SAML Single Sign-On\",\"description\":\"Let your team sign in to CloudCruise with your identity provider over SAML 2.0\",\"url\":\"https://docs.cloudcruise.com/concepts/saml-sso\",\"mainEntityOfPage\":{\"@id\":\"https://docs.cloudcruise.com/concepts/saml-sso#webpage\"},\"dateModified\":\"2026-11-12T01:00:11.813Z\",\"publisher\":{\"@id\":\"https://docs.cloudcruise.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.cloudcruise.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"CloudCruise\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"CloudCruise\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/concepts/saml-sso.md","siteName":"CloudCruise","nav":{"global":{"anchors":[{"anchor":"Community","icon":"discord","href":"https://discord.com/invite/MHjbUqedZF"},{"anchor":"Blog","icon":"newspaper","href":"https://cloudcruise.com/blog"}]},"groups":[{"group":"Getting Started","public":true,"pages":[{"title":"Quickstart","href":"/introduction"}]},{"group":"Concepts","public":true,"pages":[{"title":"Workflows","href":"/concepts/workflows"},{"title":"Run Window","href":"/concepts/run-window"},{"title":"Workflow Versioning","href":"/concepts/workflow-versioning"},{"title":"Workflow Components","href":"/concepts/workflow-components"},{"title":"Builder Agent","href":"/concepts/builder-agent"},{"group":"Maintenance Agent","root":{"title":"Maintenance Agent","href":"/concepts/maintenance-agent"},"pages":[{"title":"Understanding failures","href":"/concepts/maintenance-agent/understanding-failures"},{"title":"Automatic recovery","href":"/concepts/maintenance-agent/automatic-recovery"},{"title":"Decision Required","href":"/concepts/decision-required"},{"title":"Recovery settings","href":"/concepts/maintenance-agent/recovery-settings"},{"title":"Error codes","href":"/concepts/maintenance-agent/error-codes"},{"title":"Pausing","href":"/concepts/maintenance-agent/pausing"},{"title":"Results","href":"/concepts/maintenance-agent/results"}]},{"group":"Workflow DSL","pages":[{"title":"Overview","href":"/concepts/workflow-dsl/overview"},{"title":"Workflow Settings","href":"/concepts/workflow-dsl/workflow-settings"},{"group":"Node Types","pages":[{"title":"Start","href":"/concepts/workflow-dsl/start"},{"title":"Navigate","href":"/concepts/workflow-dsl/navigate"},{"title":"Click","href":"/concepts/workflow-dsl/click"},{"title":"Input Text","href":"/concepts/workflow-dsl/input-text"},{"title":"Input Select","href":"/concepts/workflow-dsl/input-select"},{"title":"Extract Datamodel","href":"/concepts/workflow-dsl/extract-datamodel"},{"title":"Extract Network","href":"/concepts/workflow-dsl/extract-network"},{"title":"API Flow","href":"/concepts/workflow-dsl/api-flow"},{"title":"Bool Condition","href":"/concepts/workflow-dsl/bool-condition"},{"title":"Loop","href":"/concepts/workflow-dsl/loop"},{"title":"Transform","href":"/concepts/workflow-dsl/transform"},{"title":"Delay","href":"/concepts/workflow-dsl/delay"},{"title":"Captcha","href":"/concepts/workflow-dsl/captcha"},{"title":"Scroll","href":"/concepts/workflow-dsl/scroll"},{"title":"Screenshot","href":"/concepts/workflow-dsl/screenshot"},{"title":"File Upload","href":"/concepts/workflow-dsl/file-upload"},{"title":"File Download","href":"/concepts/workflow-dsl/file-download"},{"title":"Tab Management","href":"/concepts/workflow-dsl/tab-management"},{"title":"Two-Factor Authentication","href":"/concepts/workflow-dsl/tfa"},{"title":"User Interaction","href":"/concepts/workflow-dsl/user-interaction"},{"title":"End","href":"/concepts/workflow-dsl/end"}]}]},{"title":"Webhooks","href":"/concepts/webhooks"},{"title":"Run Statuses","href":"/concepts/run-statuses"},{"title":"Downloading Run Files","href":"/concepts/file-urls"},{"title":"Vault","href":"/concepts/vault"},{"title":"Two-Factor Authentication","description":"Seamless 2FA handling for autonomous browser agents","href":"/concepts/twofactor"},{"title":"SAML Single Sign-On","href":"/concepts/saml-sso"},{"title":"Citrix Virtual Desktops","description":"Automate workflows inside Citrix VDI environments via HTML5 browser access","href":"/concepts/citrix"},{"title":"Rate Limits","href":"/concepts/rate-limits"},{"title":"Payload Limits","href":"/concepts/limits"}]},{"group":"API Reference","public":true,"pages":[{"group":"Workflow API","pages":[{"openapi":"workflow-api/workflow-api.yaml get /workflows","title":"Get all workflows","href":"/workflow-api/get-workflows"},{"openapi":"workflow-api/workflow-api.yaml get /workflows/{workflow_id}","title":"Get workflow","href":"/workflow-api/get-workflow"},{"openapi":"workflow-api/workflow-api.yaml get /workflows/{workflow_id}/metadata","title":"Get workflow metadata","href":"/workflow-api/get-metadata"},{"openapi":"workflow-api/workflow-api.yaml get /workflows/{workflow_id}/versions","title":"List workflow versions","href":"/workflow-api/list-versions"},{"openapi":"workflow-api/workflow-api.yaml get /workflows/{workflow_id}/versions/{version}","title":"Get workflow version","href":"/workflow-api/get-version"},{"openapi":"workflow-api/workflow-api.yaml get /workflows/{workflow_id}/branches","title":"List workflow branches","href":"/workflow-api/list-branches"},{"openapi":"workflow-api/workflow-api.yaml post /workflows","title":"Create workflow","href":"/workflow-api/create-workflow"},{"openapi":"workflow-api/workflow-api.yaml put /workflows/{workflow_id}","title":"Update workflow","href":"/workflow-api/update-workflow"},{"openapi":"workflow-api/workflow-api.yaml get /workflows/{workflow_id}/run-window","title":"Get run window","href":"/workflow-api/get-run-window"},{"openapi":"workflow-api/workflow-api.yaml put /workflows/{workflow_id}/run-window","title":"Set run window","href":"/workflow-api/set-run-window"},{"openapi":"workflow-api/workflow-api.yaml delete /workflows/{workflow_id}/run-window","title":"Delete run window","href":"/workflow-api/delete-run-window"},{"openapi":"workflow-api/workflow-api.yaml get /workflow-components","title":"List workflow components","href":"/workflow-api/list-components"},{"openapi":"workflow-api/workflow-api.yaml get /workflow-components/{component_id}","title":"Get workflow component","href":"/workflow-api/get-component"},{"openapi":"workflow-api/workflow-api.yaml get /workflow-components/{component_id}/usage","title":"Get component usage","href":"/workflow-api/get-component-usage"},{"openapi":"workflow-api/workflow-api.yaml get /workflow-components/{component_id}/versions","title":"List component versions","href":"/workflow-api/list-component-versions"},{"openapi":"workflow-api/workflow-api.yaml get /workflow-components/{component_id}/versions/{version_number}","title":"Get component version","href":"/workflow-api/get-component-version"},{"openapi":"workflow-api/workflow-api.yaml post /workflow-components","title":"Create workflow component","href":"/workflow-api/create-component"},{"openapi":"workflow-api/workflow-api.yaml patch /workflow-components/{component_id}","title":"Rename workflow component","href":"/workflow-api/rename-component"},{"openapi":"workflow-api/workflow-api.yaml put /workflow-components/{component_id}","title":"Update workflow component","href":"/workflow-api/update-component"},{"openapi":"workflow-api/workflow-api.yaml delete /workflow-components/{component_id}","title":"Delete workflow component","href":"/workflow-api/delete-component"},{"openapi":"workflow-api/workflow-api.yaml get /error-codes","title":"List error codes","href":"/workflow-api/list-error-codes"},{"openapi":"workflow-api/workflow-api.yaml post /error-codes","title":"Create error code","href":"/workflow-api/create-error-code"},{"openapi":"workflow-api/workflow-api.yaml patch /error-codes/{error_code_id}","title":"Update error code","href":"/workflow-api/update-error-code"}]},{"group":"Run API","pages":[{"openapi":"run-api/run-api.yaml post /run","title":"Start a run","href":"/run-api/start-a-run"},{"openapi":"run-api/run-api.yaml get /runs","title":"List runs","href":"/run-api/list-runs"},{"openapi":"run-api/run-api.yaml get /run/{session_id}","title":"Retrieve run results","href":"/run-api/retrieve-run-results"},{"openapi":"run-api/run-api.yaml get /run/{session_id}/debug-snapshots/{node_id}","title":"Get debug snapshots","href":"/run-api/get-debug-snapshots"},{"openapi":"run-api/run-api.yaml get /run/{session_id}/network","title":"Get run network traffic","href":"/run-api/get-run-network"},{"openapi":"run-api/run-api.yaml get /runs/workflow/{workflow_id}/errors","title":"Get workflow error analytics","href":"/run-api/get-workflow-error-report"},{"openapi":"run-api/run-api.yaml get /run/{session_id}/decision/pending","title":"Get the pending decision","href":"/run-api/get-pending-decision"},{"openapi":"run-api/run-api.yaml post /run/{session_id}/decision/respond","title":"Answer a decision","href":"/run-api/answer-a-decision"},{"openapi":"run-api/run-api.yaml post /run/{session_id}/user_interaction","title":"Submit user interaction data","href":"/run-api/submit-user-interaction-data"},{"openapi":"run-api/run-api.yaml post /run/{session_id}/interrupt","title":"Interrupt run","href":"/run-api/interrupt-run"},{"openapi":"run-api/run-api.yaml get /runs/paused","title":"List paused resources","href":"/run-api/get-paused-resources"},{"openapi":"run-api/run-api.yaml post /runs/pause","title":"Pause runs","href":"/run-api/pause-runs"},{"openapi":"run-api/run-api.yaml post /runs/unpause","title":"Unpause runs","href":"/run-api/unpause-runs"},{"openapi":"run-api/run-api.yaml post /runs/unpause-all","title":"Unpause all runs","href":"/run-api/unpause-all-runs"},{"openapi":"run-api/run-api.yaml get /live/sessions/{session_id}/connection","title":"Get live-view connection","href":"/run-api/get-live-view-connection"}]},{"group":"Vault API","pages":[{"openapi":"vault-api/vault-api.yaml get /vault","title":"Get vault entries","href":"/vault-api/get-vault-entries"},{"openapi":"vault-api/vault-api.yaml get /vault/tfa-code","title":"Get 2FA code","href":"/vault-api/get-vault-tfa-code"},{"openapi":"vault-api/vault-api.yaml post /vault","title":"Create vault entry","href":"/vault-api/create-vault-entry"},{"openapi":"vault-api/vault-api.yaml put /vault","title":"Update vault entry","href":"/vault-api/update-vault-entry"},{"openapi":"vault-api/vault-api.yaml delete /vault","title":"Delete vault entry","href":"/vault-api/delete-vault-entry"},{"openapi":"vault-api/vault-api.yaml patch /vault/clear-browser-state","title":"Clear browser state","href":"/vault-api/clear-browser-state"},{"openapi":"vault-api/vault-api.yaml get /secret-providers","title":"List secret provider connections","href":"/vault-api/list-secret-providers"},{"openapi":"vault-api/vault-api.yaml get /secret-providers/{id}/items","title":"List secret provider items","href":"/vault-api/list-secret-provider-items"}]},{"group":"Custom Secret Provider API","pages":[{"openapi":"custom-secret-provider-api/custom-secret-provider-api.yaml post /v1/capabilities","title":"Report supported optional endpoints","href":"/custom-secret-provider-api/get-capabilities"},{"openapi":"custom-secret-provider-api/custom-secret-provider-api.yaml post /v1/items/resolve","title":"Return the secret values of one item","href":"/custom-secret-provider-api/resolve-item"},{"openapi":"custom-secret-provider-api/custom-secret-provider-api.yaml post /v1/items/describe","title":"Return an item's display metadata","href":"/custom-secret-provider-api/describe-item"},{"openapi":"custom-secret-provider-api/custom-secret-provider-api.yaml post /v1/items/list","title":"List items the connection may access","href":"/custom-secret-provider-api/list-items"}]},{"group":"Webhooks API","pages":[{"openapi":"webhooks-api/webhooks-api.yaml get /webhooks/sessions/{session_id}","title":"Get webhook events for a run","href":"/webhooks-api/get-webhook-events"},{"openapi":"webhooks-api/webhooks-api.yaml post /webhooks/{session_id}/replay","title":"Replay webhooks","href":"/webhooks-api/replay-webhooks"}]}]},{"group":"SDK","public":true,"pages":[{"group":"JS/TS","pages":[{"title":"Overview","href":"/sdk/js/overview"},{"title":"Workflows","href":"/sdk/js/workflows"},{"title":"Vault","href":"/sdk/js/vault"}]},{"group":"Python","pages":[{"title":"Python Overview","href":"/sdk/python/overview"},{"title":"Workflows","href":"/sdk/python/workflows"},{"title":"Vault","href":"/sdk/python/vault"}]},{"group":"CLI","pages":[{"title":"Overview","href":"/sdk/cli/overview"}]}]},{"group":"Integrations","public":true,"pages":[{"title":"Slack","href":"/integrations/slack"},{"title":"Sentry","href":"/integrations/sentry"},{"title":"1Password","href":"/integrations/1password"},{"title":"Custom Secret Provider","href":"/integrations/custom-provider"}]}]},"basePath":"","title":"SAML Single Sign-On - CloudCruise","deploymentId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","buildId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","dynamics":[],"chunks":[]}