SSO lets users sign in to Launchpad through their organization’s identity provider instead of separate KODE Labs credentials. Launchpad supports OIDC and SAML, with pre-built integrations for several identity providers. You configure sign-in methods from Sign In Methods in the sidebar.
The Sign In Methods page shows all configured methods, including Email & Password and any SSO integrations
Benefits of Single Sign-On
SSO simplifies the sign-in experience by eliminating the need to manage separate credentials for each platform. Users authenticate once through their organization’s identity provider and gain access to Launchpad and other connected applications without repeated logins. This reduces password-related support requests and frees IT teams to focus on higher-priority work.
Centralized authentication through your existing identity provider
Reduced credential fatigue, as users rely on one set of credentials across platforms
Stronger security posture by enforcing your organization’s authentication policies
Simplified user management, with user provisioning and de-provisioning handled through your IdP
Fewer password-related support tickets for IT teams
Supported Sign-in Methods
Launchpad supports SSO through the following authentication protocols.
OpenID Connect (OIDC) — a modern authentication protocol commonly used for web and mobile applications.
Security Assertion Markup Language (SAML) — an XML-based protocol widely adopted for enterprise SSO across web applications.
KODE Labs has integrated with the following identity providers:
CyberArk
Azure Active Directory (Azure AD)
Okta
Auth0
JumpCloud
You can also configure a custom OIDC or SAML integration with any IdP that supports these protocols.
Configuration
Setting up SSO requires configuring a sign-in method in Launchpad and connecting the corresponding application in your identity provider. You complete both from a single form in Launchpad. Click + Add Sign in Method to choose a protocol or pre-built template.
Choose between OIDC or SAML protocols, or select a pre-built template for Auth0, Azure AD, Okta, CyberArk, or JumpCloud
Before you begin, verify that you have an admin role in your Launchpad workspace and access to your identity provider’s configuration settings.
OIDC
SAML
1
Open sign-in methods
In the Launchpad sidebar, click Sign In Methods, then click + Add Sign in Method. Select one of the pre-configured identity providers that uses OIDC, or choose a custom OIDC configuration if your provider is not listed.
2
Copy callback URL
Launchpad generates an Authentication Callback URL at the top of the form. Copy this value — you need to enter it in your IdP as the Redirect URL or Callback URL.
Field
The callback endpoint your IdP redirects users to after authentication. This value is auto-generated and read-only.
3
Name sign-in method
In the Sign In Method Name field, enter a unique name for this method. You can optionally upload an IdP picture.
The sign-in method name cannot be changed after you save it.
4
Set up app in IdP
Log in to your identity provider and create a new application for KODE Labs. Provide the Authentication Callback URL you copied from Launchpad. After configuring the application, your IdP provides the values needed for the next step.
5
Enter IdP details
Back in the Launchpad form, enter the following values from your IdP:
Field
The OpenID Connect discovery endpoint provided by your IdP (typically ending in /.well-known/openid-configuration).
Field
The unique identifier your IdP assigned to the KODE Labs application.
Field
The secret key your IdP generated for this application.
6
Configure email claim
Under Claim configuration for email, verify that the Email field is set to the claim your IdP uses for email addresses (defaults to email).
7
Save
Optionally check Set as default Sign In Method if you want this to be the primary sign-in option for your organization. Click Save.
The SAML configuration form shows generated values, sign-in method name, and pre-configured protocol fields
1
Open sign-in methods
In the Launchpad sidebar, click Sign In Methods, then click + Add Sign in Method. Select one of the pre-configured identity providers that uses SAML, or choose a custom SAML configuration if your provider is not listed.
2
Copy generated values
Launchpad generates several values at the top of the form. Copy or download these — you need them when configuring the application in your IdP.
Field
The endpoint where your IdP sends SAML responses after authentication. Copy this into your IdP’s ACS URL field.
Field
The service provider certificate (x509Certificate.pem). Click Download to save it.
3
Name sign-in method
In the Sign In Method Name field, enter a unique name for this method. You can optionally upload an IdP picture.
The sign-in method name cannot be changed after you save it.
4
Review pre-configured fields
The following fields are pre-configured in Launchpad and must match the corresponding values in your IdP:
Field
The unique identifier for Launchpad as a service provider.
Field
The format used to identify users. Pre-set to EmailAddress.
Field
The algorithm used to sign SAML assertions. Pre-set to RSA-SHA256.
Field
The transport method for SAML messages. Pre-set to HTTP-POST.
Toggle
When enabled, Launchpad signs outgoing SAML requests. Disabled by default.
5
Set up app in IdP
Log in to your identity provider and create a new application for KODE Labs. Provide the Assertion Consumer Service URL, SP Entity ID, NameID Format, Signature Algorithm, and Protocol Binding values from the Launchpad form. Configure attribute mapping in your IdP for firstName, lastName, and optionally roles to synchronize role assignments.
6
Enter IdP details
Back in the Launchpad form, you can either upload a metadata XML file to autofill the fields below, or enter them manually:
Field
Upload your IdP’s metadata XML file to autofill the IdP URL, IdP Entity ID, and Certificate fields.
Field
The SSO endpoint provided by your IdP for SAML authentication.
Field
The unique identifier for your identity provider.
Field
The public certificate your IdP uses to sign SAML assertions. Upload a .pem or .der file.
7
Configure email claim
Under Claim configuration for email, enter the attribute your IdP uses for email addresses in the Email field.
8
Save
Optionally check Set as default Sign In Method if you want this to be the primary sign-in option for your organization. Click Save.
Role mapping
With SSO enabled, you can pass user roles from your identity provider to KODE OS automatically. This means user permissions are managed in your IdP rather than individually in Launchpad. Role mapping is optional — you can always set user permissions directly in KODE OS regardless of how users authenticate.
Role mapping requires attribute configuration in both your IdP and Launchpad. Before you configure role mappings, add the roles attribute in the Attribute Mappings section of your IdP and return the information in KODE Labs.
To configure role mapping, open the sign-in method in Launchpad and configure the following options:
Toggle
Allows automatic user creation on first login. When enabled, configure the First Name attribute, Last Name attribute, and Roles attribute that your IdP returns.
Toggle
Sets a fallback role for users who do not have a role mapped in this sign-in method. You can add additional roles after you save the sign-in method.
Toggle
When enabled, existing roles assigned to users in Launchpad are overridden by the roles assigned to their IdP groups on each login.
Toggle
When enabled, allows access to the site map. You can add additional site mappings after you save the sign-in method.
After you enable IdP role mapping, role management for users of that IdP is handled from your IdP instead of from Launchpad. You can manage your role mappings by adding the ability to create, update, and assign users to buildings on sign-in.
Attribute mapping
Under Attribute Mapping in your IdP, add the following attributes. If you want to map IdP groups or roles to KODE OS roles, add a roles attribute and return your IdP users’ roles or groups to Launchpad.
In the Launchpad sidebar, click Sign In Methods. Select the method you want to modify.
2
Edit the configuration
Click Edit at the top-right of the SSO Details section. Update the configuration or attribute fields as needed, such as SP Entity ID, IdP URL, or IdP Entity ID.
3
Update metadata or certificate
You can upload a new metadata file to autofill the required fields, or update the signing certificate manually.
4
Save
Click Save to apply the changes. Click Cancel to discard them.
Sign in with SSO
Once SSO is configured, users can sign in through their organization’s identity provider. There are two ways to access your workspace.
With a workspace URL
If you know your workspace URL, enter it directly in your browser (for example, companyname.kodelabs.com). The sign-in page displays your configured SSO options alongside the standard email and password login.
The sign-in page shows SSO options alongside email and password login
You can sign in using one of the following options:
Click a Sign in with… button to authenticate through your IdP. If you are already signed in to your IdP, you are redirected to your workspace without additional prompts. Otherwise, you are redirected to your IdP’s sign-in page first.
Enter your email and password and click Login with Email to use your KODE OS credentials.
Azure AD errors such as AADSTS50020 usually mean the account is not in your organization directory. Personal Microsoft accounts (for example, @gmail.com via live.com) cannot use Azure AD alone. Ask your organization’s IT team to add the user as a guest in Azure AD, or sign in with the method your Launchpad administrator assigned.
Without a workspace URL
If you do not know your workspace URL, navigate to accounts.kodelabs.com. Enter your workspace domain and click Continue to reach your sign-in page.
The workspace domain page lets you enter your organization's subdomain to access the sign-in page
Find your workspace
If you do not know your workspace domain, click Find your workspaces on the workspace domain page. Enter your KODE OS account email and click Continue. You receive an email with instructions to locate your workspace.
The Find your workspace page sends workspace details to your email address
Last modified on August 19, 2026
Was this page helpful?
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"KODE Labs - Product Documentation","colors":{"primary":"#015BFA","light":"#3A9AFF","dark":"#015BFA"},"logo":{"light":"https://mintcdn.com/kodelabs/YfYud6Al4TM68wc2/logo/logo-light.png?fit=max\u0026auto=format\u0026n=YfYud6Al4TM68wc2\u0026q=85\u0026s=00d4ffd6ad7a592e52856804d1a53d12","dark":"https://mintcdn.com/kodelabs/YfYud6Al4TM68wc2/logo/logo-dark.png?fit=max\u0026auto=format\u0026n=YfYud6Al4TM68wc2\u0026q=85\u0026s=a6769f53904d96f5a53ea0c4b3c972d6","href":"/"},"favicon":{"light":"https://mintcdn.com/kodelabs/H3HEEQdnaG21O57-/logo/favicon-light.png?fit=max\u0026auto=format\u0026n=H3HEEQdnaG21O57-\u0026q=85\u0026s=3ae881e353dfb5c2f667e175ec82c799","dark":"https://mintcdn.com/kodelabs/H3HEEQdnaG21O57-/logo/favicon-dark.png?fit=max\u0026auto=format\u0026n=H3HEEQdnaG21O57-\u0026q=85\u0026s=845431bc7d53ce5bf50f56ef53d9137f"},"api":{"params":{"expanded":"closed"},"playground":{"display":"interactive","proxy":true},"examples":{"defaults":"required","languages":["bash","javascript","python","powershell"],"prefill":true,"autogenerate":true},"url":"full"},"appearance":{"default":"light","strict":true},"background":{"color":{"light":"#ffffff","dark":"#121212"}},"navbar":{"links":[{"href":"https://kodelabs.com/contact/","label":"Contact Us"}]},"footer":{"socials":{"x":"https://twitter.com/kodelabs","instagram":"https://www.instagram.com/kode_labs","linkedin":"https://www.linkedin.com/company/kodelabs","youtube":"https://www.youtube.com/channel/UCKCnsgnYtugWxMPzu3UEHkw"},"links":[{"header":"Platform","items":[{"label":"KODE OS","href":"https://kodelabs.com"},{"label":"Integrations","href":"https://kodelabs.com/partners/integrations-library"},{"label":"Security","href":"https://kodelabs.com/security"}]},{"header":"Resources","items":[{"label":"Blog","href":"https://kodelabs.com/blog"},{"label":"Reports \u0026 Guides","href":"https://kodelabs.com/resources"},{"label":"Podcasts \u0026 Webinars","href":"https://kodelabs.com/resources"},{"label":"Case Studies","href":"https://kodelabs.com/case-studies"},{"label":"News","href":"https://kodelabs.com/news"}]},{"header":"Solutions","items":[{"label":"Commercial","href":"https://kodelabs.com/solutions/commercial-real-estate"},{"label":"Corporate","href":"https://kodelabs.com/solutions/corporate"},{"label":"Retail","href":"https://kodelabs.com/solutions/retail"},{"label":"Healthcare","href":"https://kodelabs.com/solutions/healthcare"},{"label":"Education","href":"https://kodelabs.com/solutions/education"}]},{"header":"Company","items":[{"label":"About","href":"https://kodelabs.com/about"},{"label":"Careers","href":"https://kodelabs.com/careers"},{"label":"Internships","href":"https://kodelabs.com/internships"},{"label":"Contact Us","href":"https://kodelabs.com/contact"}]}]},"search":{"prompt":"Search our docs..."},"fonts":{"heading":{"family":"Manrope","weight":600},"body":{"family":"Inter"}},"icons":{"library":"lucide"},"styling":{"eyebrows":"section","codeblocks":{"theme":{"light":"github-light","dark":"github-dark"}},"latex":false},"integrations":{"ga4":{"measurementId":"G-WKYQEE1T4B"}},"banner":{"content":"KODE 3.20 is live. See [what's new in November 2026](/whats-new/2026/v3.20-november-2026).","dismissible":true,"color":{"light":"#015BFA","dark":"#015BFA"}},"errors":{"404":{"redirect":false,"title":"We're working on it!","description":"If you're not seeing this page, we're definitely updating it."}},"contextual":{"options":["copy","view",{"title":"Email KODE support","description":"Contact KODE Labs support for help","icon":"mail","href":"mailto:support@kodelabs.com"}],"display":"toc"},"interaction":{"drilldown":false},"metadata":{"timestamp":true},"navigation":{"global":{"anchors":[{"anchor":"Home","icon":"house","href":"/"},{"anchor":"What's New","icon":"megaphone","href":"/whats-new/2026/v3.20-november-2026"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"kodelabs","hasAudioNarration":false,"actualSubdomain":"kodelabs","customDomains":["docs.kodelabs.com"],"gitSource":{"type":"github","owner":"kode-labs","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af8e4f300819710da52c87a","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"Integrations","count":214},{"language":"default","tag":"All Integrations","count":205},{"language":"default","tag":"KODE API","count":143},{"language":"default","tag":"API reference","count":132},{"language":"default","tag":"EnerG","count":61},{"language":"default","tag":"Meters","count":37},{"language":"default","tag":"Building BI","count":35},{"language":"default","tag":"AssetOps","count":32},{"language":"default","tag":"Cloud BMS","count":31},{"language":"default","tag":"Reference","count":29}],"searchSettings":{"showContentSnippets":true,"isFiltersEnabled":true,"maxResults":10}},"assistantConfig":{"enableStarterQuestions":true,"enableContextualStarterQuestions":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[],"googleFontsInlined":true},"customCss":[{"filePath":"custom.css","href":"/_mintlify/custom/kodelabs/fd6257d3326e3afa/custom.css"}]}
{"page":{"pagePath":"products/launchpad/get-started/configure-single-sign-on-sso","slug":"/products/launchpad/get-started/configure-single-sign-on-sso","pageMetadata":{"title":"Configure Single Sign-On (SSO)","sidebarTitle":"Configure SSO","description":"Set up SSO with OIDC or SAML","icon":"key","keywords":["SSO","single sign-on","OIDC","SAML","identity provider","IdP","authentication","Launchpad"],"href":"/products/launchpad/get-started/configure-single-sign-on-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: \"Set up SSO with OIDC or SAML\"\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={code:`code`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Frame,Heading,Info,Note,OptimizedImage,ParamField,Step,Steps,Tab,Tabs,Tip,Warning}=_components;if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`SSO lets users sign in to Launchpad through their organization’s identity provider instead of separate KODE Labs credentials. Launchpad supports OIDC and SAML, with pre-built integrations for several identity providers. You configure sign-in methods from `,_jsx(_components.strong,{children:`Sign In Methods`}),` in the sidebar.`]}),`\n`,_jsx(Frame,{caption:`The Sign In Methods page shows all configured methods, including Email \u0026 Password and any SSO integrations`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-client-org-sign-in-methods.png?fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=3718f70c7031be1eb6625aa452e814df`,alt:`Sign In Methods page showing Email and Password and Azure AD set as the default method, with an Add Sign in Method button`,\"data-og-width\":`1024`,width:`1024`,\"data-og-height\":`391`,height:`391`,\"data-path\":`images/launchpad/launchpad-client-org-sign-in-methods.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-client-org-sign-in-methods.png?w=280\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=167e09acafc14ff89b6da32c9f7ae120 280w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-client-org-sign-in-methods.png?w=560\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=5b6ef3970a48e6e0356827ae198919a6 560w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-client-org-sign-in-methods.png?w=840\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=b02f4b041562d59beaec0f1e6282d77b 840w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-client-org-sign-in-methods.png?w=1100\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=61e1c0d8683b9c2c2cc99b5db350e0b9 1100w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-client-org-sign-in-methods.png?w=1650\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=e15ae9c5989a937b92c0d3b2ecb22f37 1650w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-client-org-sign-in-methods.png?w=2500\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=7af6009b397cb507a6f4dd47c99a6aac 2500w`})}),`\n`,_jsx(Heading,{level:`2`,id:`benefits-of-single-sign-on`,children:`Benefits of Single Sign-On`}),`\n`,_jsx(_components.p,{children:`SSO simplifies the sign-in experience by eliminating the need to manage separate credentials for each platform. Users authenticate once through their organization’s identity provider and gain access to Launchpad and other connected applications without repeated logins. This reduces password-related support requests and frees IT teams to focus on higher-priority work.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Centralized authentication through your existing identity provider`}),`\n`,_jsx(_components.li,{children:`Reduced credential fatigue, as users rely on one set of credentials across platforms`}),`\n`,_jsx(_components.li,{children:`Stronger security posture by enforcing your organization’s authentication policies`}),`\n`,_jsx(_components.li,{children:`Simplified user management, with user provisioning and de-provisioning handled through your IdP`}),`\n`,_jsx(_components.li,{children:`Fewer password-related support tickets for IT teams`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`supported-sign-in-methods`,children:`Supported Sign-in Methods`}),`\n`,_jsx(_components.p,{children:`Launchpad supports SSO through the following authentication protocols.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`OpenID Connect (OIDC)`}),` — a modern authentication protocol commonly used for web and mobile applications.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Security Assertion Markup Language (SAML)`}),` — an XML-based protocol widely adopted for enterprise SSO across web applications.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`KODE Labs has integrated with the following identity providers:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`CyberArk`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`Azure Active Directory (Azure AD)`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`Okta`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`Auth0`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`JumpCloud`})}),`\n`]}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`You can also configure a custom OIDC or SAML integration with any IdP that supports these protocols.`})}),`\n`,_jsx(Heading,{level:`2`,id:`configuration`,children:`Configuration`}),`\n`,_jsxs(_components.p,{children:[`Setting up SSO requires configuring a sign-in method in Launchpad and connecting the corresponding application in your identity provider. You complete both from a single form in Launchpad. Click `,_jsx(_components.code,{children:`+ Add Sign in Method`}),` to choose a protocol or pre-built template.`]}),`\n`,_jsx(Frame,{caption:`Choose between OIDC or SAML protocols, or select a pre-built template for Auth0, Azure AD, Okta, CyberArk, or JumpCloud`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-sign-in-add-method.png?fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=ab9d47128d1e117fac2b4a6277caafd1`,alt:`Choose Sign in Method dialog showing OIDC and SAML protocol options and pre-built templates for Auth0, Azure AD, Okta, CyberArk, and JumpCloud`,\"data-og-width\":`376`,width:`376`,\"data-og-height\":`498`,height:`498`,\"data-path\":`images/launchpad/launchpad-sign-in-add-method.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-sign-in-add-method.png?w=280\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=989d4f65855b4d870ab5119250d57848 280w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-sign-in-add-method.png?w=560\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=7ea3a1accead4de21211b509bde334ea 560w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-sign-in-add-method.png?w=840\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=81663445d53ba6c4aa9f0a57107b013e 840w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-sign-in-add-method.png?w=1100\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=f0f301bec11dc7d3e10c4ce5ed68ecb1 1100w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-sign-in-add-method.png?w=1650\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=c6b6301a8bf7a4607e78889f9be85c2e 1650w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-sign-in-add-method.png?w=2500\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=0c0e274685de691dd93f573d3b06bb67 2500w`})}),`\n`,_jsx(Info,{children:_jsx(_components.p,{children:`Before you begin, verify that you have an admin role in your Launchpad workspace and access to your identity provider’s configuration settings.`})}),`\n`,_jsxs(Tabs,{children:[_jsx(Tab,{title:`OIDC`,id:`oidc`,children:_jsxs(Steps,{children:[_jsx(Step,{title:`Open sign-in methods`,children:_jsxs(_components.p,{children:[`In the Launchpad sidebar, click `,_jsx(_components.strong,{children:`Sign In Methods`}),`, then click `,_jsx(_components.strong,{children:`+ Add Sign in Method`}),`. Select one of the pre-configured identity providers that uses OIDC, or choose a custom OIDC configuration if your provider is not listed.`]})}),_jsxs(Step,{title:`Copy callback URL`,children:[_jsxs(_components.p,{children:[`Launchpad generates an `,_jsx(_components.strong,{children:`Authentication Callback URL`}),` at the top of the form. Copy this value — you need to enter it in your IdP as the Redirect URL or Callback URL.`]}),_jsx(ParamField,{path:`Authentication Callback URL`,type:`Field`,id:`param-authentication-callback-url`,children:_jsx(_components.p,{children:`The callback endpoint your IdP redirects users to after authentication. This value is auto-generated and read-only.`})})]}),_jsxs(Step,{title:`Name sign-in method`,children:[_jsxs(_components.p,{children:[`In the `,_jsx(_components.strong,{children:`Sign In Method Name`}),` field, enter a unique name for this method. You can optionally upload an IdP picture.`]}),_jsx(Warning,{children:_jsx(_components.p,{children:`The sign-in method name cannot be changed after you save it.`})})]}),_jsx(Step,{title:`Set up app in IdP`,children:_jsx(_components.p,{children:`Log in to your identity provider and create a new application for KODE Labs. Provide the Authentication Callback URL you copied from Launchpad. After configuring the application, your IdP provides the values needed for the next step.`})}),_jsxs(Step,{title:`Enter IdP details`,children:[_jsx(_components.p,{children:`Back in the Launchpad form, enter the following values from your IdP:`}),_jsx(ParamField,{path:`OpenID Well-known URL`,type:`Field`,id:`param-open-id-well-known-url`,children:_jsxs(_components.p,{children:[`The OpenID Connect discovery endpoint provided by your IdP (typically ending in `,_jsx(_components.code,{children:`/.well-known/openid-configuration`}),`).`]})}),_jsx(ParamField,{path:`Client ID`,type:`Field`,id:`param-client-id`,children:_jsx(_components.p,{children:`The unique identifier your IdP assigned to the KODE Labs application.`})}),_jsx(ParamField,{path:`Client Secret`,type:`Field`,id:`param-client-secret`,children:_jsx(_components.p,{children:`The secret key your IdP generated for this application.`})})]}),_jsx(Step,{title:`Configure email claim`,children:_jsxs(_components.p,{children:[`Under `,_jsx(_components.strong,{children:`Claim configuration for email`}),`, verify that the `,_jsx(_components.strong,{children:`Email`}),` field is set to the claim your IdP uses for email addresses (defaults to `,_jsx(_components.code,{children:`email`}),`).`]})}),_jsx(Step,{title:`Save`,children:_jsxs(_components.p,{children:[`Optionally check `,_jsx(_components.strong,{children:`Set as default Sign In Method`}),` if you want this to be the primary sign-in option for your organization. Click `,_jsx(_components.strong,{children:`Save`}),`.`]})})]})}),_jsxs(Tab,{title:`SAML`,id:`saml`,children:[_jsx(Frame,{caption:`The SAML configuration form shows generated values, sign-in method name, and pre-configured protocol fields`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-sso-saml-form.png?fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=35ed39fcd0203660b5ab359b017b85a4`,alt:`Add Sign-In Method form for SAML showing Assertion Consumer Service URL, SP Certificate download, sign-in method name field, SP Entity ID, SAML Subject NameID Format, Signature Algorithm, Protocol Binding, and Sign Request toggle`,\"data-og-width\":`1024`,width:`1024`,\"data-og-height\":`663`,height:`663`,\"data-path\":`images/launchpad/launchpad-sso-saml-form.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-sso-saml-form.png?w=280\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=0f81e93ece6d800963ca88b98323243a 280w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-sso-saml-form.png?w=560\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=0f8184744e61a229dbf0422fb1c91415 560w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-sso-saml-form.png?w=840\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=9f598a98296f416a262f157f2d3be487 840w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-sso-saml-form.png?w=1100\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=a9b569336ce83ca32869bf231375082c 1100w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-sso-saml-form.png?w=1650\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=90f9b3c1f85caaaf3877f59b47578105 1650w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-sso-saml-form.png?w=2500\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=d76ce3f9ac7efd646cdb203374b7d1c4 2500w`})}),_jsxs(Steps,{children:[_jsx(Step,{title:`Open sign-in methods`,children:_jsxs(_components.p,{children:[`In the Launchpad sidebar, click `,_jsx(_components.strong,{children:`Sign In Methods`}),`, then click `,_jsx(_components.strong,{children:`+ Add Sign in Method`}),`. Select one of the pre-configured identity providers that uses SAML, or choose a custom SAML configuration if your provider is not listed.`]})}),_jsxs(Step,{title:`Copy generated values`,children:[_jsx(_components.p,{children:`Launchpad generates several values at the top of the form. Copy or download these — you need them when configuring the application in your IdP.`}),_jsx(ParamField,{path:`Assertion Consumer Service URL`,type:`Field`,id:`param-assertion-consumer-service-url`,children:_jsx(_components.p,{children:`The endpoint where your IdP sends SAML responses after authentication. Copy this into your IdP’s ACS URL field.`})}),_jsx(ParamField,{path:`SP Certificate`,type:`Field`,id:`param-sp-certificate`,children:_jsxs(_components.p,{children:[`The service provider certificate (`,_jsx(_components.code,{children:`x509Certificate.pem`}),`). Click `,_jsx(_components.strong,{children:`Download`}),` to save it.`]})})]}),_jsxs(Step,{title:`Name sign-in method`,children:[_jsxs(_components.p,{children:[`In the `,_jsx(_components.strong,{children:`Sign In Method Name`}),` field, enter a unique name for this method. You can optionally upload an IdP picture.`]}),_jsx(Warning,{children:_jsx(_components.p,{children:`The sign-in method name cannot be changed after you save it.`})})]}),_jsxs(Step,{title:`Review pre-configured fields`,children:[_jsx(_components.p,{children:`The following fields are pre-configured in Launchpad and must match the corresponding values in your IdP:`}),_jsx(ParamField,{path:`SP Entity ID`,type:`Field`,id:`param-sp-entity-id`,children:_jsx(_components.p,{children:`The unique identifier for Launchpad as a service provider.`})}),_jsx(ParamField,{path:`SAML Subject NameID Format`,type:`Field`,id:`param-saml-subject-name-id-format`,children:_jsx(_components.p,{children:`The format used to identify users. Pre-set to EmailAddress.`})}),_jsx(ParamField,{path:`Signature Algorithm`,type:`Field`,id:`param-signature-algorithm`,children:_jsx(_components.p,{children:`The algorithm used to sign SAML assertions. Pre-set to RSA-SHA256.`})}),_jsx(ParamField,{path:`Protocol Binding`,type:`Field`,id:`param-protocol-binding`,children:_jsx(_components.p,{children:`The transport method for SAML messages. Pre-set to HTTP-POST.`})}),_jsx(ParamField,{path:`Sign Request`,type:`Toggle`,id:`param-sign-request`,children:_jsx(_components.p,{children:`When enabled, Launchpad signs outgoing SAML requests. Disabled by default.`})})]}),_jsx(Step,{title:`Set up app in IdP`,children:_jsxs(_components.p,{children:[`Log in to your identity provider and create a new application for KODE Labs. Provide the Assertion Consumer Service URL, SP Entity ID, NameID Format, Signature Algorithm, and Protocol Binding values from the Launchpad form. Configure attribute mapping in your IdP for `,_jsx(_components.code,{children:`firstName`}),`, `,_jsx(_components.code,{children:`lastName`}),`, and optionally `,_jsx(_components.code,{children:`roles`}),` to synchronize role assignments.`]})}),_jsxs(Step,{title:`Enter IdP details`,children:[_jsx(_components.p,{children:`Back in the Launchpad form, you can either upload a metadata XML file to autofill the fields below, or enter them manually:`}),_jsx(ParamField,{path:`Upload MetaData`,type:`Field`,id:`param-upload-meta-data`,children:_jsx(_components.p,{children:`Upload your IdP’s metadata XML file to autofill the IdP URL, IdP Entity ID, and Certificate fields.`})}),_jsx(ParamField,{path:`IdP URL`,type:`Field`,id:`param-id-p-url`,children:_jsx(_components.p,{children:`The SSO endpoint provided by your IdP for SAML authentication.`})}),_jsx(ParamField,{path:`IdP Entity ID`,type:`Field`,id:`param-id-p-entity-id`,children:_jsx(_components.p,{children:`The unique identifier for your identity provider.`})}),_jsx(ParamField,{path:`Certificate`,type:`Field`,id:`param-certificate`,children:_jsxs(_components.p,{children:[`The public certificate your IdP uses to sign SAML assertions. Upload a `,_jsx(_components.code,{children:`.pem`}),` or `,_jsx(_components.code,{children:`.der`}),` file.`]})})]}),_jsx(Step,{title:`Configure email claim`,children:_jsxs(_components.p,{children:[`Under `,_jsx(_components.strong,{children:`Claim configuration for email`}),`, enter the attribute your IdP uses for email addresses in the `,_jsx(_components.strong,{children:`Email`}),` field.`]})}),_jsx(Step,{title:`Save`,children:_jsxs(_components.p,{children:[`Optionally check `,_jsx(_components.strong,{children:`Set as default Sign In Method`}),` if you want this to be the primary sign-in option for your organization. Click `,_jsx(_components.strong,{children:`Save`}),`.`]})})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`role-mapping`,children:`Role mapping`}),`\n`,_jsx(_components.p,{children:`With SSO enabled, you can pass user roles from your identity provider to KODE OS automatically. This means user permissions are managed in your IdP rather than individually in Launchpad. Role mapping is optional — you can always set user permissions directly in KODE OS regardless of how users authenticate.`}),`\n`,_jsx(Info,{children:_jsx(_components.p,{children:`Role mapping requires attribute configuration in both your IdP and Launchpad. Before you configure role mappings, add the roles attribute in the Attribute Mappings section of your IdP and return the information in KODE Labs.`})}),`\n`,_jsx(_components.p,{children:`To configure role mapping, open the sign-in method in Launchpad and configure the following options:`}),`\n`,_jsx(ParamField,{path:`Create user on first login`,type:`Toggle`,id:`param-create-user-on-first-login`,children:_jsxs(_components.p,{children:[`Allows automatic user creation on first login. When enabled, configure the `,_jsx(_components.code,{children:`First Name`}),` attribute, `,_jsx(_components.code,{children:`Last Name`}),` attribute, and `,_jsx(_components.code,{children:`Roles`}),` attribute that your IdP returns.`]})}),`\n`,_jsx(ParamField,{path:`Default Role`,type:`Toggle`,id:`param-default-role`,children:_jsx(_components.p,{children:`Sets a fallback role for users who do not have a role mapped in this sign-in method. You can add additional roles after you save the sign-in method.`})}),`\n`,_jsx(ParamField,{path:`Update user role on login`,type:`Toggle`,id:`param-update-user-role-on-login`,children:_jsx(_components.p,{children:`When enabled, existing roles assigned to users in Launchpad are overridden by the roles assigned to their IdP groups on each login.`})}),`\n`,_jsx(ParamField,{path:`Site Mapping`,type:`Toggle`,id:`param-site-mapping`,children:_jsx(_components.p,{children:`When enabled, allows access to the site map. You can add additional site mappings after you save the sign-in method.`})}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`After you enable IdP role mapping, role management for users of that IdP is handled from your IdP instead of from Launchpad. You can manage your role mappings by adding the ability to create, update, and assign users to buildings on sign-in.`})}),`\n`,_jsx(Heading,{level:`3`,id:`attribute-mapping`,children:`Attribute mapping`}),`\n`,_jsxs(_components.p,{children:[`Under Attribute Mapping in your IdP, add the following attributes. If you want to map IdP groups or roles to KODE OS roles, add a `,_jsx(_components.code,{children:`roles`}),` attribute and return your IdP users’ roles or groups to Launchpad.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`SAML IdP`}),`: `,_jsx(_components.code,{children:`firstName`}),` attribute, `,_jsx(_components.code,{children:`lastName`}),` attribute, `,_jsx(_components.code,{children:`roles`}),` attribute`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`OIDC IdP`}),`: `,_jsx(_components.code,{children:`firstName`}),` claim, `,_jsx(_components.code,{children:`lastName`}),` claim, `,_jsx(_components.code,{children:`roles`}),` claim`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`edit-sso-configuration`,children:`Edit SSO configuration`}),`\n`,_jsx(_components.p,{children:`To update an existing SSO configuration:`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open the sign-in method`,children:_jsxs(_components.p,{children:[`In the Launchpad sidebar, click `,_jsx(_components.strong,{children:`Sign In Methods`}),`. Select the method you want to modify.`]})}),_jsx(Step,{title:`Edit the configuration`,children:_jsxs(_components.p,{children:[`Click `,_jsx(_components.code,{children:`Edit`}),` at the top-right of the SSO Details section. Update the configuration or attribute fields as needed, such as `,_jsx(_components.code,{children:`SP Entity ID`}),`, `,_jsx(_components.code,{children:`IdP URL`}),`, or `,_jsx(_components.code,{children:`IdP Entity ID`}),`.`]})}),_jsx(Step,{title:`Update metadata or certificate`,children:_jsx(_components.p,{children:`You can upload a new metadata file to autofill the required fields, or update the signing certificate manually.`})}),_jsx(Step,{title:`Save`,children:_jsxs(_components.p,{children:[`Click `,_jsx(_components.code,{children:`Save`}),` to apply the changes. Click `,_jsx(_components.code,{children:`Cancel`}),` to discard them.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`sign-in-with-sso`,children:`Sign in with SSO`}),`\n`,_jsx(_components.p,{children:`Once SSO is configured, users can sign in through their organization’s identity provider. There are two ways to access your workspace.`}),`\n`,_jsx(Heading,{level:`3`,id:`with-a-workspace-url`,children:`With a workspace URL`}),`\n`,_jsxs(_components.p,{children:[`If you know your workspace URL, enter it directly in your browser (for example, `,_jsx(_components.code,{children:`companyname.kodelabs.com`}),`). The sign-in page displays your configured SSO options alongside the standard email and password login.`]}),`\n`,_jsx(Frame,{caption:`The sign-in page shows SSO options alongside email and password login`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-sso-sign-in-page.png?fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=fd3b55398829c0384a3fae9e9de3c2c6`,alt:`Sign In to KODE Labs page showing Sign in with Azure AD button, email and password fields, and an Other sign in methods option`,\"data-og-width\":`462`,width:`462`,\"data-og-height\":`544`,height:`544`,\"data-path\":`images/launchpad/launchpad-sso-sign-in-page.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-sso-sign-in-page.png?w=280\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=9957839a7af81a871092df65b547c32e 280w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-sso-sign-in-page.png?w=560\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=c72d4069f3c8d77f6a49d7181bf16db8 560w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-sso-sign-in-page.png?w=840\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=cf1d8f4d2a1a39e588d11cadb182feb3 840w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-sso-sign-in-page.png?w=1100\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=064a738c12c9e06bb884fc4c95f1de2d 1100w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-sso-sign-in-page.png?w=1650\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=d93e6cf6f85cdc7e387df8c185e81435 1650w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-sso-sign-in-page.png?w=2500\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=7302b5b2c564b5db389288b3b652ad8e 2500w`})}),`\n`,_jsx(_components.p,{children:`You can sign in using one of the following options:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Click a `,_jsx(_components.strong,{children:`Sign in with…`}),` button to authenticate through your IdP. If you are already signed in to your IdP, you are redirected to your workspace without additional prompts. Otherwise, you are redirected to your IdP’s sign-in page first.`]}),`\n`,_jsxs(_components.li,{children:[`Enter your email and password and click `,_jsx(_components.code,{children:`Login with Email`}),` to use your KODE OS credentials.`]}),`\n`]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Azure AD errors such as `,_jsx(_components.code,{children:`AADSTS50020`}),` usually mean the account is not in your organization directory. Personal Microsoft accounts (for example, `,_jsx(_components.code,{children:`@gmail.com`}),` via `,_jsx(_components.code,{children:`live.com`}),`) cannot use Azure AD alone. Ask your organization’s IT team to add the user as a guest in Azure AD, or sign in with the method your Launchpad administrator assigned.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`without-a-workspace-url`,children:`Without a workspace URL`}),`\n`,_jsxs(_components.p,{children:[`If you do not know your workspace URL, navigate to `,_jsx(_components.code,{children:`accounts.kodelabs.com`}),`. Enter your workspace domain and click `,_jsx(_components.code,{children:`Continue`}),` to reach your sign-in page.`]}),`\n`,_jsx(Frame,{caption:`The workspace domain page lets you enter your organization's subdomain to access the sign-in page`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-sso-workspace-domain.png?fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=431d92997e523b75ea8a9944c6f82f7c`,alt:`Sign in to your workspace page with a workspace domain field showing the .kodelabs.com suffix and a Continue button`,\"data-og-width\":`1006`,width:`1006`,\"data-og-height\":`796`,height:`796`,\"data-path\":`images/launchpad/launchpad-sso-workspace-domain.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-sso-workspace-domain.png?w=280\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=1f91c62e1a0845a1baf244c5d30d49a2 280w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-sso-workspace-domain.png?w=560\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=04dda8af71ef52aa1fcf8ddf5ab83a17 560w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-sso-workspace-domain.png?w=840\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=fbde10b9aec186c4fb37ccc9465d47b0 840w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-sso-workspace-domain.png?w=1100\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=f8f59bcfdef43e9f7725a712aaa816ef 1100w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-sso-workspace-domain.png?w=1650\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=a20a013ebf64fb4f03b97150b400a41d 1650w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-sso-workspace-domain.png?w=2500\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=3149dd45bbd747f6afeecf92c2f157af 2500w`})}),`\n`,_jsx(Heading,{level:`3`,id:`find-your-workspace`,children:`Find your workspace`}),`\n`,_jsxs(_components.p,{children:[`If you do not know your workspace domain, click `,_jsx(_components.strong,{children:`Find your workspaces`}),` on the workspace domain page. Enter your KODE OS account email and click `,_jsx(_components.code,{children:`Continue`}),`. You receive an email with instructions to locate your workspace.`]}),`\n`,_jsx(Frame,{caption:`The Find your workspace page sends workspace details to your email address`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-sso-find-workspace.png?fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=602123e5fda2f9f8e5b58d4346c94a11`,alt:`Find your workspace page with an email field and Continue button, plus a link to return to the workspace sign-in page`,\"data-og-width\":`745`,width:`745`,\"data-og-height\":`526`,height:`526`,\"data-path\":`images/launchpad/launchpad-sso-find-workspace.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-sso-find-workspace.png?w=280\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=0a6c9f2dc140ab68923045653965fcdb 280w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-sso-find-workspace.png?w=560\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=e0a477031d0ae79d573f7b61aa1842c8 560w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-sso-find-workspace.png?w=840\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=7ce0bc49f49a25b0f028dfeef51fe768 840w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-sso-find-workspace.png?w=1100\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=2f40f5428dfabe5f3fb7d5cad145e2f7 1100w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-sso-find-workspace.png?w=1650\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=b71619495fd3d864f53c8abdbbbb812c 1650w, https://mintcdn.com/kodelabs/QV43LEddE2aJcRYU/images/launchpad/launchpad-sso-find-workspace.png?w=2500\u0026fit=max\u0026auto=format\u0026n=QV43LEddE2aJcRYU\u0026q=85\u0026s=46dd07667786139212f375ecef527394 2500w`})})]})}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":{"codeStyling":{"theme":{"light":"github-light","dark":"github-dark"}},"config":{},"pageMetadata":{"title":"Configure Single Sign-On (SSO)","sidebarTitle":"Configure SSO","description":"Set up SSO with OIDC or SAML","icon":"key","keywords":["SSO","single sign-on","OIDC","SAML","identity provider","IdP","authentication","Launchpad"],"href":"/products/launchpad/get-started/configure-single-sign-on-sso"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Benefits of Single Sign-On","slug":"benefits-of-single-sign-on","depth":2,"children":[]},{"title":"Supported Sign-in Methods","slug":"supported-sign-in-methods","depth":2,"children":[]},{"title":"Configuration","slug":"configuration","depth":2,"children":[]},{"title":"Role mapping","slug":"role-mapping","depth":2,"children":[{"title":"Attribute mapping","slug":"attribute-mapping","depth":3,"children":[]}]},{"title":"Edit SSO configuration","slug":"edit-sso-configuration","depth":2,"children":[]},{"title":"Sign in with SSO","slug":"sign-in-with-sso","depth":2,"children":[{"title":"With a workspace URL","slug":"with-a-workspace-url","depth":3,"children":[]},{"title":"Without a workspace URL","slug":"without-a-workspace-url","depth":3,"children":[]},{"title":"Find your workspace","slug":"find-your-workspace","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/kodelabs/ce5d3bd08e955b7b/navbar-assistant.js"],"subdomain":"kodelabs","siteName":"KODE Labs - Product Documentation","title":"Configure Single Sign-On (SSO) - KODE Labs - Product Documentation","contextualStarterQuestions":[{"_id":"6a88bbb01af966f81de14614","deploymentId":"67fd4d9635f314f3a994be65","questionText":"How do I set up SSO?","status":"active","generatedBy":"contextual","path":"products/launchpad/get-started/configure-single-sign-on-sso","createdAt":"2026-08-21T20:57:20.192Z","updatedAt":"2026-08-21T20:57:20.192Z","__v":0},{"_id":"6a88bbb01af966f81de14615","deploymentId":"67fd4d9635f314f3a994be65","questionText":"What SSO protocols are supported?","status":"active","generatedBy":"contextual","path":"products/launchpad/get-started/configure-single-sign-on-sso","createdAt":"2026-08-21T20:57:20.192Z","updatedAt":"2026-08-21T20:57:20.192Z","__v":0}],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-19T11:09:23.908Z","gitLastModified":"2026-08-19T11:07:50.000Z","originalFileLocation":"products/launchpad/get-started/configure-single-sign-on-sso.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Set up SSO with OIDC or SAML\">\u003cmeta data-mint-head name=\"application-name\" content=\"KODE Labs - Product Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/kodelabs/vtcGE1gj2AkAE1l2/_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/kodelabs/vtcGE1gj2AkAE1l2/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/kodelabs/vtcGE1gj2AkAE1l2/_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/kodelabs/vtcGE1gj2AkAE1l2/_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/kodelabs/vtcGE1gj2AkAE1l2/_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/kodelabs/vtcGE1gj2AkAE1l2/_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/kodelabs/vtcGE1gj2AkAE1l2/_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/kodelabs/vtcGE1gj2AkAE1l2/_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/kodelabs/vtcGE1gj2AkAE1l2/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Configure Single Sign-On (SSO) - KODE Labs - Product Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Set up SSO with OIDC or SAML\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"KODE Labs - Product Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.kodelabs.com/products/launchpad/get-started/configure-single-sign-on-sso\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://kodelabs.mintlify.site/_mintlify/api/og/v2?division=Get+Started\u0026amp;title=Configure+Single+Sign-On+%28SSO%29\u0026amp;description=Set+up+SSO+with+OIDC+or+SAML\u0026amp;theme=ac252318c016362b89abdbd3\u0026amp;signature=b9d332840ea7aac62af09c2156c7054e51d5ddc8e63072165c65843447c89f18\">\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=\"Configure Single Sign-On (SSO) - KODE Labs - Product Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Set up SSO with OIDC or SAML\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://kodelabs.mintlify.site/_mintlify/api/og/v2?division=Get+Started\u0026amp;title=Configure+Single+Sign-On+%28SSO%29\u0026amp;description=Set+up+SSO+with+OIDC+or+SAML\u0026amp;theme=ac252318c016362b89abdbd3\u0026amp;signature=b9d332840ea7aac62af09c2156c7054e51d5ddc8e63072165c65843447c89f18\">\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/kodelabs/vtcGE1gj2AkAE1l2/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"KODE Labs - Product Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#015BFA\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.kodelabs.com/products/launchpad/get-started/configure-single-sign-on-sso\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/products/launchpad/get-started/configure-single-sign-on-sso.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.kodelabs.com/#organization\",\"name\":\"KODE Labs - Product Documentation\",\"url\":\"https://docs.kodelabs.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/kodelabs/YfYud6Al4TM68wc2/logo/logo-light.png?fit=max\u0026auto=format\u0026n=YfYud6Al4TM68wc2\u0026q=85\u0026s=00d4ffd6ad7a592e52856804d1a53d12\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.kodelabs.com#website\",\"name\":\"KODE Labs - Product Documentation\",\"url\":\"https://docs.kodelabs.com\",\"publisher\":{\"@id\":\"https://docs.kodelabs.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.kodelabs.com/products/launchpad/get-started/configure-single-sign-on-sso#webpage\",\"url\":\"https://docs.kodelabs.com/products/launchpad/get-started/configure-single-sign-on-sso\",\"name\":\"Configure Single Sign-On (SSO)\",\"description\":\"Set up SSO with OIDC or SAML\",\"dateModified\":\"2026-08-19T11:07:50.000Z\",\"isPartOf\":{\"@id\":\"https://docs.kodelabs.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.kodelabs.com/products/launchpad/get-started/configure-single-sign-on-sso#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.kodelabs.com/products/launchpad/get-started/configure-single-sign-on-sso#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Get Started\",\"item\":\"https://docs.kodelabs.com/products/launchpad/get-started/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Configure Single Sign-On (SSO)\",\"item\":\"https://docs.kodelabs.com/products/launchpad/get-started/configure-single-sign-on-sso\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.kodelabs.com/products/launchpad/get-started/configure-single-sign-on-sso#article\",\"headline\":\"Configure Single Sign-On (SSO)\",\"name\":\"Configure Single Sign-On (SSO)\",\"description\":\"Set up SSO with OIDC or SAML\",\"url\":\"https://docs.kodelabs.com/products/launchpad/get-started/configure-single-sign-on-sso\",\"mainEntityOfPage\":{\"@id\":\"https://docs.kodelabs.com/products/launchpad/get-started/configure-single-sign-on-sso#webpage\"},\"dateModified\":\"2026-08-19T11:07:50.000Z\",\"keywords\":\"SSO, single sign-on, OIDC, SAML, identity provider, IdP, authentication, Launchpad\",\"publisher\":{\"@id\":\"https://docs.kodelabs.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.kodelabs.com#website\"}}]}\u003c/script>","agentPointerHref":"/products/launchpad/get-started/configure-single-sign-on-sso.md","siteName":"KODE Labs - Product Documentation","nav":{"global":{"anchors":[{"anchor":"Home","icon":"house","href":"/"},{"anchor":"What's New","icon":"megaphone","href":"/whats-new/2026/v3.20-november-2026"}]},"products":[{"product":"Cloud BMS","icon":"https://mintlify.s3.us-west-1.amazonaws.com/kodelabs/images/cloud-bms.svg","description":"Cloud building management, graphics, and control","pages":[{"title":"Cloud BMS","href":"/products/kode-os/get-started/introduction"}]},{"product":"Building BI","icon":"https://mintlify.s3.us-west-1.amazonaws.com/kodelabs/images/bbi.svg","description":"Dashboards and analytics for building performance","pages":[{"title":"Building BI","href":"/products/building-bi/overview"}]},{"product":"FDD","icon":"https://mintlify.s3.us-west-1.amazonaws.com/kodelabs/images/fdd.svg","description":"Fault detection and diagnostics for equipment","pages":[{"title":"FDD","href":"/products/fdd/overview"}]},{"product":"FTT","icon":"https://mintlify.s3.us-west-1.amazonaws.com/kodelabs/images/ftt.svg","description":"Automated functional testing and commissioning","pages":[{"title":"FTT","href":"/products/ftt/overview"}]},{"product":"AssetOps","icon":"https://mintlify.s3.us-west-1.amazonaws.com/kodelabs/images/assetops.svg","description":"Asset and maintenance operations","pages":[{"title":"AssetOps","href":"/products/assetops/quickstart/overview"}]},{"product":"EnerG","icon":"https://mintlify.s3.us-west-1.amazonaws.com/kodelabs/images/enerG.svg","description":"Energy management and sustainability reporting","pages":[{"title":"EnerG","href":"/products/energ/get-started/introduction"}]},{"product":"Launchpad","icon":"https://mintlify.s3.us-west-1.amazonaws.com/kodelabs/images/launchpad.svg","description":"Dynamic management for apps, users, and buildings","groups":[{"group":"Get Started","pages":[{"title":"What's Launchpad?","sidebarTitle":"Introduction","icon":"rocket","href":"/products/launchpad/get-started/introduction"},{"title":"Provisioning Architecture","sidebarTitle":"Provisioning Architecture","icon":"git-branch","href":"/products/launchpad/get-started/provisioning-architecture"},{"title":"Accounts and Users","sidebarTitle":"Accounts and Users","icon":"users","href":"/products/launchpad/get-started/accounts-and-users"},{"title":"Workspaces \u0026 Sign-In","sidebarTitle":"Workspaces \u0026 Sign-In","description":"Sign in to Launchpad, manage your account and organizations, open applications from the landing page, and configure authentication","icon":"log-in","href":"/products/launchpad/get-started/workspaces-and-sign-in"},{"title":"Configure Single Sign-On (SSO)","sidebarTitle":"Configure SSO","icon":"key","href":"/products/launchpad/get-started/configure-single-sign-on-sso"},{"title":"Security Settings","sidebarTitle":"Security Settings","description":"Configure MFA, password policies, and session timeouts","icon":"shield","href":"/products/launchpad/get-started/security-settings"}]},{"group":"Channel Partners","pages":[{"title":"Channel Partners","sidebarTitle":"Overview","icon":"book-open","href":"/products/launchpad/channel-partners/channel-partner-overview"},{"title":"Clients","sidebarTitle":"Manage Clients","icon":"cog","href":"/products/launchpad/channel-partners/clients"},{"title":"Users","sidebarTitle":"Manage Users","icon":"cog","href":"/products/launchpad/channel-partners/users"},{"title":"Product Enablement","sidebarTitle":"Product Enablement","icon":"box","href":"/products/launchpad/channel-partners/product-enablement"}]},{"group":"Client Organizations","pages":[{"title":"Client Organizations","sidebarTitle":"Overview","icon":"book-open","href":"/products/launchpad/client-organizations/client-organization-overview"},{"title":"Users","sidebarTitle":"Manage Users","icon":"cog","href":"/products/launchpad/client-organizations/users"},{"title":"Buildings","sidebarTitle":"Manage Buildings","icon":"cog","href":"/products/launchpad/client-organizations/buildings"},{"group":"Apps","icon":"app-store","pages":[{"title":"Apps (KODE OS)","sidebarTitle":"Overview","icon":"dot","tag":"KODE OS","href":"/products/launchpad/client-organizations/apps"},{"title":"Permissions Reference","sidebarTitle":"Permissions Reference","icon":"dot","href":"/products/launchpad/client-organizations/apps/permissions-reference"}]},{"group":"Service Accounts","icon":"webhook","pages":[{"title":"Service Accounts","sidebarTitle":"Overview","icon":"dot","href":"/products/launchpad/client-organizations/service-accounts"},{"title":"Permissions Reference","sidebarTitle":"Permissions Reference","icon":"dot","href":"/products/launchpad/client-organizations/service-accounts/permissions-reference"}]}]},{"group":"Reference","icon":"book-a","pages":[{"title":"KODE glossary","sidebarTitle":"Glossary","icon":"book-a","href":"/products/launchpad/glossary"}]}]},{"product":"Mobile app","icon":"https://mintlify.s3.us-west-1.amazonaws.com/kodelabs/images/mobile-app.svg","description":"Monitor and operate buildings from iOS and Android","pages":[{"title":"Mobile app","href":"/products/mobile-app/overview"}]},{"product":"KODE API","icon":"braces","description":"Build services and integrations with KODE OS","pages":[{"title":"KODE API","href":"/products/kode-api"}]},{"product":"Integrations","icon":"cable","description":"Connect 200+ building systems to KODE OS","pages":[{"title":"Integrations","href":"/products/integrations/get-started/introduction"}]},{"product":"What's New","icon":"megaphone","description":"KODE platform release notes and updates","pages":[{"title":"What's New","href":"/whats-new/2026/v3.20-november-2026"}]}]},"basePath":"","title":"Configure Single Sign-On (SSO) - KODE Labs - Product Documentation","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":["10e4515597","07c022d89b","a74be98ba7","a9bb46feb3"],"chunks":["BannerMarkdown-DnSAhvaM.js","dist-DIfYWxfm.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","Frame-BRsfsIIG.js","DynamicMarkdown-NFqqduU7.js","zoom-image-lightbox-BguUeq2N.js","lightbox-handle-r17bVUz3.js","Markdown-CwtoSfEf.js","AssistantPageLink-CTqa3eoi.js"]}