Connect your organisation’s own OpenID Connect identity provider - Microsoft Entra ID, Okta or any other - so it decides who is a member, which role they hold, and when their access ends.
Single sign-on lets your organisation’s own identity provider decide who is a member of it in Ankra. People the provider admits become members when they sign in. People it stops admitting lose access on their own, without anyone removing them in Ankra.The same organisation identity can protect proxied ankra.cc hostnames and custom domains through the Ankra Cloud access gateway.You set it up yourself under Organisation → Settings → Single sign-on. Ankra does not need to enable anything for you first.The whole setup in two minutes, from connecting the provider to what happens when someone leaves:
Who may sign in
Whoever is assigned to the Ankra application in your provider.
Which role they hold
The provider’s groups, mapped to Ankra roles. Optional.
When access ends
At the end of the re-verification window: 24 hours by default.
Microsoft Entra ID (Microsoft 365), Okta and Keycloak all speak it. SAML is not supported.
Access to the DNS of your email domain
You publish one TXT record to prove the domain is yours.
The Enterprise plan
Single sign-on is part of Enterprise. To use it on another plan, contact support. It is not available on the single-user Homebuilder plan, because single sign-on adds members.
Set it up
The Single sign-on settings page with a provider connected and enabled (example data)
1
Register Ankra with your identity provider
Open Organisation → Settings → Single sign-on and copy the value under Redirect URI to register with your provider. Then create an application for Ankra in your provider.
Microsoft Entra ID
Okta
Another provider
In the Microsoft Entra admin centre, open App registrations → New registration.
Under Supported account types, choose Accounts in this organizational directory only.
Under Redirect URI, choose the Web platform and paste the redirect URI from Ankra.
On the registration’s Overview, copy the Application (client) ID and the Directory (tenant) ID.
Open Certificates & secrets → New client secret and copy the secret’s Value.
Open Enterprise applications, select the application, and under Properties set Assignment required? to Yes. Then assign the people or groups who should have access under Users and groups.
Your issuer is https://login.microsoftonline.com/<tenant-id>/v2.0.
Without Assignment required, everyone in your tenant with an address on a verified domain can sign in, and joins your Ankra organisation while just-in-time membership is on. Removing someone from the assignment is also how their access ends, so it is the control this whole feature rests on.
Ankra reads the email claim, which Entra ID fills from the user’s email address. A user with no email address set in Entra ID cannot sign in.
In the Okta Admin Console, open Applications → Create App Integration.
Choose OIDC - OpenID Connect and Web Application.
Under Sign-in redirect URIs, paste the redirect URI from Ankra. Keep the Authorization Code grant.
Under Assignments, limit access to the people or groups who should have access.
Copy the Client ID and Client secret.
Your issuer is your Okta organisation URL, https://<your-okta-domain>. If you sign people in through a custom authorization server, use its issuer instead, for example https://<your-okta-domain>/oauth2/default.
Any OpenID Connect provider works if it meets these requirements:
It publishes a discovery document at <issuer>/.well-known/openid-configuration, reachable from the internet over HTTPS.
The application is a confidential client: authorization code flow with a client secret.
It releases the email claim when Ankra requests the openid, profile and email scopes.
The redirect URI from Ankra is registered on the application.
Restrict who may use the application in the provider itself. Ankra admits whoever the provider signs in with an address on one of your verified domains.
2
Connect the provider in Ankra
Back on Single sign-on, under Identity provider, fill in the three fields and click Connect provider.
Field
What to enter
Issuer
The issuer URL itself, not the discovery document URL. For Entra ID it must be your own tenant’s issuer: the shared common, organizations and consumers authorities admit accounts from any tenant and are refused.
Client ID
The application’s client ID.
Client secret
Passed to the identity broker that performs the sign-in. It is not stored in Ankra or shown again.
The provider now shows as Connected, not enabled. Nobody can sign in through it yet.
To rotate the secret later, enter the new one and click Save provider. Changing the issuer or the client ID needs the secret again.
3
Verify your email domain
Under Email domains, enter the domain your members’ addresses use and click Add domain. Ankra shows a record to publish at your DNS provider:
Type
Record name
Record value
TXT
_ankra-challenge.<your-domain>
ankra-domain-verification=<token>
Publish it, then click Verify. DNS changes can take a few minutes to appear, and you can click Verify again until the domain shows Verified. A Sign-in link then appears under Email domains.Ankra accepts a sign-in through your provider only when the address is on a domain you have verified. That is what stops a provider from signing people in under addresses its owner does not control.
A verified domain covers exactly that domain. example.com does not cover eu.example.com; add and verify each one.
Public email providers such as gmail.com and outlook.com cannot be claimed.
A domain can be verified by one organisation only.
4
Enable single sign-on
Under Access policy, turn on Enable single sign-on. It can only be turned on once at least one domain is verified.
5
Sign in through the provider once
Open the sign-in link in a private browser window and sign in as someone assigned to the application. You should land in your organisation, and the Identity provider card should show the time under Last sign-in through the provider.Do this before you tell anyone else. It proves the provider works, and Ankra will not let you require single sign-on until one sign-in has succeeded.
Single sign-on is now on and optional: members can use it, and everyone can still sign in the way they did before. To make the provider the only way in, see Require single sign-on.
Shown under Email domains. It goes straight to your provider. Share it, or set it as the application’s home page URL in your provider so that the Ankra tile in your members’ application portal opens it.
The single sign-on page
A member enters their work email address and Ankra sends them to the provider that serves its domain.
Every sign-in through the provider has to be a fresh one: Ankra accepts it only when the provider authenticated the person within the last ten minutes.Ankra’s second factor is separate from your provider’s. A member who has one enrolled is still asked for it after the provider signs them in, and an organisation that requires MFA still requires each member to enrol.
Who becomes a member
Just-in-time membership is on by default: anyone the provider admits, with an address on a verified domain, becomes a member the first time they sign in. Turn it off under Access policy and only people you have invited can join through the provider.
Who signs in through the provider
Just-in-time on (default)
Just-in-time off
Someone new, with no invitation
Becomes a member with the Default role, which is Member unless you change it
Refused, and told to ask an administrator for an invite
Someone you invited
The invitation is accepted, with the role it carries
The invitation is accepted, with the role it carries
An existing member
Stays a member, and is governed by single sign-on from now on
Stays a member, and is governed by single sign-on from now on
Someone who already has an Ankra account under the same address keeps it. The provider is connected to their existing account, so their API tokens, second factors and memberships of other organisations are unchanged. This needs the existing account’s address to have been verified; an account that never verified its address is refused, and the message says so.
While just-in-time membership is on, removing a governed member on the members page lasts only until their next sign-in: the provider still admits them, so they join again. To remove someone, remove them from the application in your provider.
Set roles from groups
By default the provider decides who is a member and you decide roles in Ankra. Add mappings under Group to role and the provider decides roles too.
1
Send the member's groups to Ankra
Your provider has to put the member’s groups in a groups claim on the ID token. Ankra requests the openid, profile and email scopes only, so the claim has to be released without an extra scope.
Microsoft Entra ID
Okta
On the app registration, open Token configuration → Add groups claim and include it in the ID token. Choose Groups assigned to the application so the claim stays small.The claim carries group object IDs unless you configure the application to emit names.
On the application’s Sign On tab, set a groups claim filter in the OpenID Connect ID Token section.
2
Map groups to roles
Click Add mapping, enter a group exactly as the provider sends it - a name or an object ID - and pick Member, Admin or Read-only. Then click Save mappings.
3
Check it
Sign in as a member of a mapped group and look for the sso_member_role_synced entry in the audit log.
While at least one mapping exists, every sign-in through the provider sets the member’s role from the groups it sent:
Situation
Role the member gets
In one mapped group
That group’s role
In several mapped groups
The highest: Admin, then Member, then Read-only
In no mapped group
The Default role
You changed the role by hand in Ankra
Your change lasts until that member’s next sign-in
An owner or a break-glass member
Never moved by groups. Ownership is granted by hand, and break-glass members are your way back in if the provider is wrong.
Mappings set the organisation-wide built-in role. Custom roles and roles assigned on a single cluster or cluster group are left as they are. Remove every mapping and roles are yours to set in Ankra again.
How access ends
Your provider does not tell Ankra when you remove someone, so access through single sign-on is a lease that each sign-in renews.
The life of a membership that single sign-on governs
A member is governed by single sign-on once they have signed in through the provider. Each of those sign-ins records that the provider vouched for them. When the latest one is older than the Re-verification window, Ankra suspends the membership.A suspended member loses everything at once: portal sessions, personal API tokens, and Kubernetes access granted through Ankra. They show as Suspended on the members page. Ankra checks every five minutes, and a suspension takes effect everywhere within about six minutes of the window ending.Signing in through the provider again restores the membership, with the role it had. Someone you removed from the application in your provider cannot complete that sign-in, so their access ends at the window.The window therefore sets two things:
What it sets
How
How long a removed person keeps access
At most one window after their last sign-in through the provider
How often everyone else signs in through the provider
At least once per window, or they are suspended until they do
The default is 24 hours, and you can set anything from 1 to 720 hours under Access policy. A shorter window revokes faster and asks members to sign in more often.Two kinds of member are never suspended: break-glass members, and everyone while single sign-on is switched off for the organisation.
A suspended member’s personal API tokens stop working with them. Run pipelines and integrations on service tokens, which belong to the organisation and are not governed by single sign-on.
Require single sign-on
Under Access policy, set Require single sign-on to Required. Ankra allows this once single sign-on is enabled and someone has signed in through the provider.
Who
What changes when it is required
A member with an address on a verified domain
Signing in any other way sends them to your provider
A new sign-up with an address on a verified domain
Sent to your provider
Every active member on a verified domain, except break-glass members
Governed immediately, with one full window to sign in through the provider
A member whose address is on another domain
Nothing. They keep signing in the way they do today
An account that shares your domain but belongs only to other organisations
Nothing
Break-glass members
Break-glass members keep their other sign-in methods when single sign-on is required, and are never suspended. They are how you get back in when the provider is misconfigured or down.
The list can never be empty, and at least one break-glass member must be able to manage the organisation.
Whoever sets single sign-on to Required is added to the list.
Choose them under Break-glass members and click Save break-glass members.
Keep at least one break-glass member whose own sign-in you have tested. If the provider fails and no break-glass member can sign in, nobody in your organisation can reach the settings to turn single sign-on off, and you will need Ankra support to recover access.
Change or remove it
Action
What happens to members
Turn off Enable single sign-on
Nobody can sign in through the provider, nobody is suspended, and Required returns to Optional. Members with a password or social sign-in use that; members who only ever signed in through the provider cannot sign in until it is enabled again.
Remove a verified domain
Active members on that domain return to ordinary membership. Suspended members stay suspended. The last verified domain cannot be removed while single sign-on is enabled.
Remove single sign-on
Active members become ordinary members. Suspended members stay suspended.
Removing single sign-on cannot be undone for accounts that existed only through your provider. They lose their sign-in, and their personal API tokens and Kubernetes access are revoked. Members who also have a password or social sign-in keep it.
A member who is still suspended after single sign-on is turned off or removed can be removed and invited again from the members page.
Audit trail
Every change and every membership decision is written to the organisation’s audit log:
An invited person joins by signing in through the provider
sso_member_role_synced
A sign-in changes a member’s role from their groups
sso_member_suspended
The window ends without a sign-in through the provider
sso_member_restored
A suspended member signs in through the provider again
For an access review, filter the audit export to these actions: together they are the joiner, mover and leaver record for members the provider governs.
Limits
Limit
Value
Protocol
OpenID Connect. SAML is not supported.
Providers
One per organisation
Email domains
Up to 20
Group mappings
Up to 50, to Member, Admin and Read-only. Owner cannot be mapped.
Break-glass members
1 to 20
Re-verification window
1 to 720 hours, 24 by default
Deprovisioning
Removal in the provider is not pushed to Ankra (there is no SCIM provisioning). Access ends at the re-verification window.
Management
In the portal. There is no CLI command or API token endpoint for these settings.
Troubleshooting
Entries are titled with the message Ankra shows, to an administrator on the settings page or to a member at sign-in.
Connecting a provider
Single sign-on could not be prepared on this installation right now
Ankra could not get its sign-in service ready for single sign-on. Try again in a few minutes, and contact support if it keeps failing.
The identity provider configuration was not accepted
The issuer or the client was refused. Check that the issuer is the issuer URL itself and that its discovery document is reachable from the internet.
Single sign-on adds members to the organisation, and the Homebuilder plan is limited to a single user
The organisation’s plan allows one member. Upgrade the plan under Billing, then connect the provider.
Verifying a domain
No TXT record with the expected value was found
The record is not visible in DNS yet, or its name or value differs from what the page shows. Check it and click Verify again.
The domain is already verified by another organisation
Another Ankra organisation has verified this domain, and a domain belongs to one organisation only. One of your own organisations may hold it.
Signing in
Not a domain your organisation has verified with Ankra
The provider signed the person in with an address outside your verified domains. Verify that domain, or correct the email address the provider sends.
Your identity provider did not share an email address with Ankra
The application does not release the email claim, or the user has no email address in the provider.
You have not been invited to it yet
Just-in-time membership is off and the person has no invitation. Invite them, or turn just-in-time membership on.
An Ankra account already exists for this email address, but the address was never verified
Sign in to that account the way it was created and verify the address, then sign in through the provider again.
This organisation is on the Homebuilder plan, which is limited to a single user
The provider admitted the person, but the organisation’s plan allows one member. The organisation needs to upgrade before anyone else can join.
Single sign-on is not enabled for this organisation
The provider is connected but Enable single sign-on is off.
Single sign-on is not set up for the domain
Shown on the single sign-on page when no enabled provider serves the address’s domain. Check the address, or that the domain is verified and single sign-on is enabled.
Ankra could not confirm a fresh sign-in with your identity provider
The provider did not authenticate the person just now. Close the window and start again from the sign-in link.
Your organisation requires single sign-on, but the sign-in did not complete through your identity provider
Start again from the sign-in link. If it repeats, contact support.
A member shows as Suspended
The provider has not vouched for them within the window. They are restored by signing in through the provider.
Requiring single sign-on
Sign in through single sign-on successfully once before requiring it
Nobody has signed in through the provider yet. Use the sign-in link once, then set Required.
Related
Identity & Access Controls
The compliance view of sign-in, MFA, roles and tokens.
Roles & Access
What each role grants, and scoped and custom roles.
Service Tokens
Credentials for automation that do not depend on a person.
Audit Log
Review who was admitted, suspended and restored.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Ankra","colors":{"primary":"#5d64ff","light":"#5d64ff","dark":"#3f48b2"},"logo":{"light":"https://mintcdn.com/ankra/uW749bPYey14eJsU/logo/light.svg?fit=max\u0026auto=format\u0026n=uW749bPYey14eJsU\u0026q=85\u0026s=7f48236f76559638a5a154da424c91d6","dark":"https://mintcdn.com/ankra/uW749bPYey14eJsU/logo/dark.svg?fit=max\u0026auto=format\u0026n=uW749bPYey14eJsU\u0026q=85\u0026s=4e4b278d2d7c90f2c8ff4ac9cc95c78a","href":"https://ankra.ai"},"favicon":"https://mintcdn.com/ankra/uW749bPYey14eJsU/favicon.ico?fit=max\u0026auto=format\u0026n=uW749bPYey14eJsU\u0026q=85\u0026s=68fd8c280641a74d9a2171dfa7b39219","api":{"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["python","javascript","curl"]},"mdx":{"auth":{"method":"bearer"}}},"navbar":{"links":[{"href":"mailto:[email protected]","label":"Support"}],"primary":{"type":"button","label":"Platform","href":"https://platform.ankra.app/next"}},"footer":{"socials":{"linkedin":"https://linkedin.com/company/ankra","github":"https://github.com/ankraio","slack":"https://join.slack.com/t/ankra-community/shared_invite/zt-3a5rem8f8-cUho4epX2MoLT83bFf~VSA"}},"seo":{"metatags":{"og:site_name":"Ankra"}},"integrations":{"posthog":{"apiKey":"phc_c1cRSlsPgqJH5IGiQYzk40R91jQxf2e3ZaZVwO5e6OM","apiHost":"https://eu.i.posthog.com"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Community","icon":"slack","href":"https://join.slack.com/t/ankra-community/shared_invite/zt-3a5rem8f8-cUho4epX2MoLT83bFf~VSA"},{"anchor":"Youtube","icon":"youtube","href":"https://www.youtube.com/@ankraio"},{"anchor":"Blog","icon":"newspaper","href":"https://www.ankra.ai/blog"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ankra","hasAudioNarration":false,"actualSubdomain":"ankra","customDomains":["docs.ankra.ai"],"gitSource":{"type":"github","owner":"ankraio","repo":"ankra-docs","deployBranch":"master","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6afa4b45541a7d21b8769fa6","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"API Reference","count":2230},{"language":"default","tag":"Endpoints","count":2229},{"language":"default","tag":"Documentation","count":273},{"language":"default","tag":"Applications","count":184},{"language":"default","tag":"Security","count":125},{"language":"default","tag":"Ankra Cloud Clusters","count":109},{"language":"default","tag":"AWS Clusters","count":107},{"language":"default","tag":"Pipelines","count":107},{"language":"default","tag":"Scaleway Clusters","count":107},{"language":"default","tag":"Stack Profiles","count":104}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"guides/single-sign-on","slug":"/guides/single-sign-on","pageMetadata":{"title":"Single Sign-On","description":"Connect your organisation's own OpenID Connect identity provider - Microsoft Entra ID, Okta or any other - so it decides who is a member, which role they hold, and when their access ends.","href":"/guides/single-sign-on"},"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: \"Connect your organisation’s own OpenID Connect identity provider - Microsoft Entra ID, Okta or any other - so it decides who is a member, which role they hold, and when their access ends.\"\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];const YouTube=({id,title,start})=>{const wrapperStyle={position:`relative`,width:`100%`,paddingBottom:`56.25%`,margin:`1rem 0 1.5rem`,borderRadius:`0.75rem`,overflow:`hidden`,border:`1px solid rgba(128, 128, 128, 0.35)`,background:`rgba(128, 128, 128, 0.08)`};const frameStyle={position:`absolute`,top:0,left:0,width:`100%`,height:`100%`,border:0};const source=`https://www.youtube-nocookie.com/embed/`+id+`?rel=0`+(start?`\u0026start=`+start:``);return _jsx(`div`,{style:wrapperStyle,\"data-youtube\":id,children:_jsx(`iframe`,{style:frameStyle,src:source,title:title||`Ankra video`,loading:`lazy`,allow:`accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share`,allowFullScreen:true,referrerPolicy:`strict-origin-when-cross-origin`})})};function _createMdxContent(props){const _components={a:`a`,code:`code`,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,Card,CardGroup,Check,CodeBlock,CodeGroup,Frame,Heading,Mermaid,Note,OptimizedImage,Step,Steps,Tab,Table,Tabs,Tip,Warning,_MdxComponentBoundary}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!Check)_missingMdxReference(`Check`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Mermaid)_missingMdxReference(`Mermaid`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,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(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);if(!_MdxComponentBoundary)_missingMdxReference(`_MdxComponentBoundary`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Single sign-on lets your organisation’s own identity provider decide who is a member of it in Ankra. People the provider admits become members when they sign in. People it stops admitting lose access on their own, without anyone removing them in Ankra.`}),`\n`,_jsxs(_components.p,{children:[`The same organisation identity can protect `,_jsxs(_components.a,{href:`/guides/private-proxied-domains`,children:[`proxied `,_jsx(_components.code,{children:`ankra.cc`}),` hostnames and custom domains`]}),` through the Ankra Cloud access gateway.`]}),`\n`,_jsxs(_components.p,{children:[`You set it up yourself under `,_jsx(_components.strong,{children:`Organisation`}),` → `,_jsx(_components.strong,{children:`Settings`}),` → `,_jsx(_components.strong,{children:`Single sign-on`}),`. Ankra does not need to enable anything for you first.`]}),`\n`,_jsx(_components.p,{children:`The whole setup in two minutes, from connecting the provider to what happens when someone leaves:`}),`\n`,_jsx(_MdxComponentBoundary,{name:`YouTube`,children:_jsx(YouTube,{id:`XQUPrsFSaQg`,title:`Ankra single sign-on: your identity provider decides who is in`})}),`\n`,_jsxs(CardGroup,{cols:3,children:[_jsx(Card,{title:`Who may sign in`,icon:`user-check`,href:`#who-becomes-a-member`,children:_jsx(_components.p,{children:`Whoever is assigned to the Ankra application in your provider.`})}),_jsx(Card,{title:`Which role they hold`,icon:`users-gear`,href:`#set-roles-from-groups`,children:_jsx(_components.p,{children:`The provider’s groups, mapped to Ankra roles. Optional.`})}),_jsx(Card,{title:`When access ends`,icon:`hourglass-half`,href:`#how-access-ends`,children:_jsx(_components.p,{children:`At the end of the re-verification window: 24 hours by default.`})})]}),`\n`,_jsx(Frame,{caption:`A sign-in through your provider`,children:_jsx(Mermaid,{chart:`flowchart LR\n Member([Member]) -->|\"sign-in link\"| Provider[Your identity\u003cbr/>provider]\n Provider -->|\"signs them in\"| Ankra[Ankra checks the\u003cbr/>verified domain]\n Ankra --> Active([Active member])`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`before-you-start`,children:`Before you start`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`You need`}),_jsx(_components.th,{children:`Why`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsxs(_components.strong,{children:[`The `,_jsx(_components.code,{children:`organisation.manage`}),` permission`]})}),_jsxs(_components.td,{children:[`Held by owners and admins. See `,_jsx(_components.a,{href:`/guides/roles-and-access`,children:`Roles \u0026 Access`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`An OpenID Connect identity provider`})}),_jsx(_components.td,{children:`Microsoft Entra ID (Microsoft 365), Okta and Keycloak all speak it. SAML is not supported.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Access to the DNS of your email domain`})}),_jsx(_components.td,{children:`You publish one TXT record to prove the domain is yours.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`The Enterprise plan`})}),_jsxs(_components.td,{children:[`Single sign-on is part of `,_jsx(_components.a,{href:`/platform/billing#plans`,children:`Enterprise`}),`. To use it on another plan, `,_jsx(_components.a,{href:`/platform/support`,children:`contact support`}),`. It is not available on the single-user Homebuilder plan, because single sign-on adds members.`]})]})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`set-it-up`,children:`Set it up`}),`\n`,_jsx(Frame,{caption:`The Single sign-on settings page with a provider connected and enabled (example data)`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/ankra/O_3kIfS4u-iVfb0E/images/single-sign-on-settings.png?fit=max\u0026auto=format\u0026n=O_3kIfS4u-iVfb0E\u0026q=85\u0026s=64cf33aa71aae162b13df8470b37f044`,alt:`The Single sign-on page under Organisation settings: an Identity provider card showing Enabled, the issuer, client ID and client secret fields, the redirect URI to register with the provider, and Microsoft Entra ID hints`,className:`mint-w-full mint-rounded-xl`,\"data-og-width\":`1440`,width:`1440`,\"data-og-height\":`900`,height:`900`,\"data-path\":`images/single-sign-on-settings.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/ankra/O_3kIfS4u-iVfb0E/images/single-sign-on-settings.png?w=280\u0026fit=max\u0026auto=format\u0026n=O_3kIfS4u-iVfb0E\u0026q=85\u0026s=66d55397e0ef84b3e7967cde5fb0a54c 280w, https://mintcdn.com/ankra/O_3kIfS4u-iVfb0E/images/single-sign-on-settings.png?w=560\u0026fit=max\u0026auto=format\u0026n=O_3kIfS4u-iVfb0E\u0026q=85\u0026s=97f3195c08296bf60470684ef237fe8b 560w, https://mintcdn.com/ankra/O_3kIfS4u-iVfb0E/images/single-sign-on-settings.png?w=840\u0026fit=max\u0026auto=format\u0026n=O_3kIfS4u-iVfb0E\u0026q=85\u0026s=9af26d9adf0c84dd2207afae5bed5b51 840w, https://mintcdn.com/ankra/O_3kIfS4u-iVfb0E/images/single-sign-on-settings.png?w=1100\u0026fit=max\u0026auto=format\u0026n=O_3kIfS4u-iVfb0E\u0026q=85\u0026s=0ae1399deffae8a164766a5de5c368db 1100w, https://mintcdn.com/ankra/O_3kIfS4u-iVfb0E/images/single-sign-on-settings.png?w=1650\u0026fit=max\u0026auto=format\u0026n=O_3kIfS4u-iVfb0E\u0026q=85\u0026s=6fe3ff623da51d693d53257de50dae60 1650w, https://mintcdn.com/ankra/O_3kIfS4u-iVfb0E/images/single-sign-on-settings.png?w=2500\u0026fit=max\u0026auto=format\u0026n=O_3kIfS4u-iVfb0E\u0026q=85\u0026s=346fe5182409f4f663e0a963e3e16616 2500w`})}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Register Ankra with your identity provider`,children:[_jsxs(_components.p,{children:[`Open `,_jsx(_components.strong,{children:`Organisation`}),` → `,_jsx(_components.strong,{children:`Settings`}),` → `,_jsx(_components.strong,{children:`Single sign-on`}),` and copy the value under `,_jsx(_components.strong,{children:`Redirect URI to register with your provider`}),`. Then create an application for Ankra in your provider.`]}),_jsxs(Tabs,{children:[_jsxs(Tab,{title:`Microsoft Entra ID`,id:`microsoft-entra-id`,children:[_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`In the Microsoft Entra admin centre, open `,_jsx(_components.strong,{children:`App registrations`}),` → `,_jsx(_components.strong,{children:`New registration`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Under `,_jsx(_components.strong,{children:`Supported account types`}),`, choose `,_jsx(_components.strong,{children:`Accounts in this organizational directory only`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Under `,_jsx(_components.strong,{children:`Redirect URI`}),`, choose the `,_jsx(_components.strong,{children:`Web`}),` platform and paste the redirect URI from Ankra.`]}),`\n`,_jsxs(_components.li,{children:[`On the registration’s `,_jsx(_components.strong,{children:`Overview`}),`, copy the `,_jsx(_components.strong,{children:`Application (client) ID`}),` and the `,_jsx(_components.strong,{children:`Directory (tenant) ID`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Open `,_jsx(_components.strong,{children:`Certificates \u0026 secrets`}),` → `,_jsx(_components.strong,{children:`New client secret`}),` and copy the secret’s `,_jsx(_components.strong,{children:`Value`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Open `,_jsx(_components.strong,{children:`Enterprise applications`}),`, select the application, and under `,_jsx(_components.strong,{children:`Properties`}),` set `,_jsx(_components.strong,{children:`Assignment required?`}),` to `,_jsx(_components.strong,{children:`Yes`}),`. Then assign the people or groups who should have access under `,_jsx(_components.strong,{children:`Users and groups`}),`.`]}),`\n`]}),_jsxs(_components.p,{children:[`Your issuer is `,_jsx(_components.code,{children:`https://login.microsoftonline.com/\u003ctenant-id>/v2.0`}),`.`]}),_jsx(Warning,{children:_jsxs(_components.p,{children:[`Without `,_jsx(_components.strong,{children:`Assignment required`}),`, everyone in your tenant with an address on a verified domain can sign in, and joins your Ankra organisation while just-in-time membership is on. Removing someone from the assignment is also how their access ends, so it is the control this whole feature rests on.`]})}),_jsxs(_components.p,{children:[`Ankra reads the `,_jsx(_components.code,{children:`email`}),` claim, which Entra ID fills from the user’s email address. A user with no email address set in Entra ID cannot sign in.`]})]}),_jsxs(Tab,{title:`Okta`,id:`okta`,children:[_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`In the Okta Admin Console, open `,_jsx(_components.strong,{children:`Applications`}),` → `,_jsx(_components.strong,{children:`Create App Integration`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Choose `,_jsx(_components.strong,{children:`OIDC - OpenID Connect`}),` and `,_jsx(_components.strong,{children:`Web Application`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Under `,_jsx(_components.strong,{children:`Sign-in redirect URIs`}),`, paste the redirect URI from Ankra. Keep the `,_jsx(_components.strong,{children:`Authorization Code`}),` grant.`]}),`\n`,_jsxs(_components.li,{children:[`Under `,_jsx(_components.strong,{children:`Assignments`}),`, limit access to the people or groups who should have access.`]}),`\n`,_jsxs(_components.li,{children:[`Copy the `,_jsx(_components.strong,{children:`Client ID`}),` and `,_jsx(_components.strong,{children:`Client secret`}),`.`]}),`\n`]}),_jsxs(_components.p,{children:[`Your issuer is your Okta organisation URL, `,_jsx(_components.code,{children:`https://\u003cyour-okta-domain>`}),`. If you sign people in through a custom authorization server, use its issuer instead, for example `,_jsx(_components.code,{children:`https://\u003cyour-okta-domain>/oauth2/default`}),`.`]})]}),_jsxs(Tab,{title:`Another provider`,id:`another-provider`,children:[_jsx(_components.p,{children:`Any OpenID Connect provider works if it meets these requirements:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`It publishes a discovery document at `,_jsx(_components.code,{children:`\u003cissuer>/.well-known/openid-configuration`}),`, reachable from the internet over HTTPS.`]}),`\n`,_jsx(_components.li,{children:`The application is a confidential client: authorization code flow with a client secret.`}),`\n`,_jsxs(_components.li,{children:[`It releases the `,_jsx(_components.code,{children:`email`}),` claim when Ankra requests the `,_jsx(_components.code,{children:`openid`}),`, `,_jsx(_components.code,{children:`profile`}),` and `,_jsx(_components.code,{children:`email`}),` scopes.`]}),`\n`,_jsx(_components.li,{children:`The redirect URI from Ankra is registered on the application.`}),`\n`]}),_jsx(_components.p,{children:`Restrict who may use the application in the provider itself. Ankra admits whoever the provider signs in with an address on one of your verified domains.`})]})]})]}),_jsxs(Step,{title:`Connect the provider in Ankra`,children:[_jsxs(_components.p,{children:[`Back on `,_jsx(_components.strong,{children:`Single sign-on`}),`, under `,_jsx(_components.strong,{children:`Identity provider`}),`, fill in the three fields and click `,_jsx(_components.strong,{children:`Connect provider`}),`.`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`What to enter`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Issuer`})}),_jsxs(_components.td,{children:[`The issuer URL itself, not the discovery document URL. For Entra ID it must be your own tenant’s issuer: the shared `,_jsx(_components.code,{children:`common`}),`, `,_jsx(_components.code,{children:`organizations`}),` and `,_jsx(_components.code,{children:`consumers`}),` authorities admit accounts from any tenant and are refused.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Client ID`})}),_jsx(_components.td,{children:`The application’s client ID.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Client secret`})}),_jsx(_components.td,{children:`Passed to the identity broker that performs the sign-in. It is not stored in Ankra or shown again.`})]})]})]}),_jsxs(_components.p,{children:[`The provider now shows as `,_jsx(_components.strong,{children:`Connected, not enabled`}),`. Nobody can sign in through it yet.`]}),_jsx(Tip,{children:_jsxs(_components.p,{children:[`To rotate the secret later, enter the new one and click `,_jsx(_components.strong,{children:`Save provider`}),`. Changing the issuer or the client ID needs the secret again.`]})})]}),_jsxs(Step,{title:`Verify your email domain`,children:[_jsxs(_components.p,{children:[`Under `,_jsx(_components.strong,{children:`Email domains`}),`, enter the domain your members’ addresses use and click `,_jsx(_components.strong,{children:`Add domain`}),`. Ankra shows a record to publish at your DNS provider:`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Record name`}),_jsx(_components.th,{children:`Record value`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`TXT`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`_ankra-challenge.\u003cyour-domain>`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`ankra-domain-verification=\u003ctoken>`})})]})})]}),_jsxs(_components.p,{children:[`Publish it, then click `,_jsx(_components.strong,{children:`Verify`}),`. DNS changes can take a few minutes to appear, and you can click `,_jsx(_components.strong,{children:`Verify`}),` again until the domain shows `,_jsx(_components.strong,{children:`Verified`}),`. A `,_jsx(_components.strong,{children:`Sign-in link`}),` then appears under `,_jsx(_components.strong,{children:`Email domains`}),`.`]}),_jsx(_components.p,{children:`Ankra accepts a sign-in through your provider only when the address is on a domain you have verified. That is what stops a provider from signing people in under addresses its owner does not control.`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`A verified domain covers exactly that domain. `,_jsx(_components.code,{children:`example.com`}),` does not cover `,_jsx(_components.code,{children:`eu.example.com`}),`; add and verify each one.`]}),`\n`,_jsxs(_components.li,{children:[`Public email providers such as `,_jsx(_components.code,{children:`gmail.com`}),` and `,_jsx(_components.code,{children:`outlook.com`}),` cannot be claimed.`]}),`\n`,_jsx(_components.li,{children:`A domain can be verified by one organisation only.`}),`\n`]})]}),_jsx(Step,{title:`Enable single sign-on`,children:_jsxs(_components.p,{children:[`Under `,_jsx(_components.strong,{children:`Access policy`}),`, turn on `,_jsx(_components.strong,{children:`Enable single sign-on`}),`. It can only be turned on once at least one domain is verified.`]})}),_jsxs(Step,{title:`Sign in through the provider once`,children:[_jsxs(_components.p,{children:[`Open the sign-in link in a private browser window and sign in as someone assigned to the application. You should land in your organisation, and the `,_jsx(_components.strong,{children:`Identity provider`}),` card should show the time under `,_jsx(_components.strong,{children:`Last sign-in through the provider`}),`.`]}),_jsx(_components.p,{children:`Do this before you tell anyone else. It proves the provider works, and Ankra will not let you require single sign-on until one sign-in has succeeded.`})]})]}),`\n`,_jsx(Check,{children:_jsxs(_components.p,{children:[`Single sign-on is now on and optional: members can use it, and everyone can still sign in the way they did before. To make the provider the only way in, see `,_jsx(_components.a,{href:`#require-single-sign-on`,children:`Require single sign-on`}),`.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`how-members-sign-in`,children:`How members sign in`}),`\n`,_jsx(_components.p,{children:`There are two ways to reach your provider:`}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`Sign-in link`,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://platform.ankra.app/auth/sso/login?domain=\u003cyour-domain>`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(CodeBlock,{filename:`Single sign-on page`,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://platform.ankra.app/auth/sso`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`The sign-in link`,icon:`link`,children:_jsxs(_components.p,{children:[`Shown under `,_jsx(_components.strong,{children:`Email domains`}),`. It goes straight to your provider. Share it, or set it as the application’s home page URL in your provider so that the Ankra tile in your members’ application portal opens it.`]})}),_jsx(Card,{title:`The single sign-on page`,icon:`at`,children:_jsx(_components.p,{children:`A member enters their work email address and Ankra sends them to the provider that serves its domain.`})})]}),`\n`,_jsx(_components.p,{children:`Every sign-in through the provider has to be a fresh one: Ankra accepts it only when the provider authenticated the person within the last ten minutes.`}),`\n`,_jsxs(_components.p,{children:[`Ankra’s second factor is separate from your provider’s. A member who has one enrolled is still asked for it after the provider signs them in, and an organisation that `,_jsx(_components.a,{href:`/platform/account-security`,children:`requires MFA`}),` still requires each member to enrol.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`who-becomes-a-member`,children:`Who becomes a member`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Just-in-time membership`}),` is on by default: anyone the provider admits, with an address on a verified domain, becomes a member the first time they sign in. Turn it off under `,_jsx(_components.strong,{children:`Access policy`}),` and only people you have invited can join through the provider.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Who signs in through the provider`}),_jsx(_components.th,{children:`Just-in-time on (default)`}),_jsx(_components.th,{children:`Just-in-time off`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Someone new, with no invitation`}),_jsxs(_components.td,{children:[`Becomes a member with the `,_jsx(_components.strong,{children:`Default role`}),`, which is `,_jsx(_components.strong,{children:`Member`}),` unless you change it`]}),_jsx(_components.td,{children:`Refused, and told to ask an administrator for an invite`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Someone you invited`}),_jsx(_components.td,{children:`The invitation is accepted, with the role it carries`}),_jsx(_components.td,{children:`The invitation is accepted, with the role it carries`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`An existing member`}),_jsx(_components.td,{children:`Stays a member, and is governed by single sign-on from now on`}),_jsx(_components.td,{children:`Stays a member, and is governed by single sign-on from now on`})]})]})]}),`\n`,_jsx(_components.p,{children:`Someone who already has an Ankra account under the same address keeps it. The provider is connected to their existing account, so their API tokens, second factors and memberships of other organisations are unchanged. This needs the existing account’s address to have been verified; an account that never verified its address is refused, and the message says so.`}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`While just-in-time membership is on, removing a governed member on the members page lasts only until their next sign-in: the provider still admits them, so they join again. To remove someone, remove them from the application in your provider.`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`set-roles-from-groups`,children:`Set roles from groups`}),`\n`,_jsxs(_components.p,{children:[`By default the provider decides who is a member and you decide roles in Ankra. Add mappings under `,_jsx(_components.strong,{children:`Group to role`}),` and the provider decides roles too.`]}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Send the member's groups to Ankra`,children:[_jsxs(_components.p,{children:[`Your provider has to put the member’s groups in a `,_jsx(_components.code,{children:`groups`}),` claim on the ID token. Ankra requests the `,_jsx(_components.code,{children:`openid`}),`, `,_jsx(_components.code,{children:`profile`}),` and `,_jsx(_components.code,{children:`email`}),` scopes only, so the claim has to be released without an extra scope.`]}),_jsxs(Tabs,{children:[_jsxs(Tab,{title:`Microsoft Entra ID`,id:`microsoft-entra-id-2`,children:[_jsxs(_components.p,{children:[`On the app registration, open `,_jsx(_components.strong,{children:`Token configuration`}),` → `,_jsx(_components.strong,{children:`Add groups claim`}),` and include it in the ID token. Choose `,_jsx(_components.strong,{children:`Groups assigned to the application`}),` so the claim stays small.`]}),_jsx(_components.p,{children:`The claim carries group object IDs unless you configure the application to emit names.`})]}),_jsx(Tab,{title:`Okta`,id:`okta-2`,children:_jsxs(_components.p,{children:[`On the application’s `,_jsx(_components.strong,{children:`Sign On`}),` tab, set a groups claim filter in the `,_jsx(_components.strong,{children:`OpenID Connect ID Token`}),` section.`]})})]})]}),_jsx(Step,{title:`Map groups to roles`,children:_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Add mapping`}),`, enter a group exactly as the provider sends it - a name or an object ID - and pick `,_jsx(_components.strong,{children:`Member`}),`, `,_jsx(_components.strong,{children:`Admin`}),` or `,_jsx(_components.strong,{children:`Read-only`}),`. Then click `,_jsx(_components.strong,{children:`Save mappings`}),`.`]})}),_jsx(Step,{title:`Check it`,children:_jsxs(_components.p,{children:[`Sign in as a member of a mapped group and look for the `,_jsx(_components.code,{children:`sso_member_role_synced`}),` entry in the `,_jsx(_components.a,{href:`/guides/audit-log`,children:`audit log`}),`.`]})})]}),`\n`,_jsx(_components.p,{children:`While at least one mapping exists, every sign-in through the provider sets the member’s role from the groups it sent:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Situation`}),_jsx(_components.th,{children:`Role the member gets`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`In one mapped group`}),_jsx(_components.td,{children:`That group’s role`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`In several mapped groups`}),_jsxs(_components.td,{children:[`The highest: `,_jsx(_components.strong,{children:`Admin`}),`, then `,_jsx(_components.strong,{children:`Member`}),`, then `,_jsx(_components.strong,{children:`Read-only`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`In no mapped group`}),_jsxs(_components.td,{children:[`The `,_jsx(_components.strong,{children:`Default role`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`You changed the role by hand in Ankra`}),_jsx(_components.td,{children:`Your change lasts until that member’s next sign-in`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`An `,_jsx(_components.strong,{children:`owner`}),` or a `,_jsx(_components.strong,{children:`break-glass member`})]}),_jsx(_components.td,{children:`Never moved by groups. Ownership is granted by hand, and break-glass members are your way back in if the provider is wrong.`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Mappings set the organisation-wide built-in role. `,_jsx(_components.a,{href:`/guides/roles-and-access`,children:`Custom roles`}),` and roles assigned on a single cluster or cluster group are left as they are. Remove every mapping and roles are yours to set in Ankra again.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`how-access-ends`,children:`How access ends`}),`\n`,_jsx(_components.p,{children:`Your provider does not tell Ankra when you remove someone, so access through single sign-on is a lease that each sign-in renews.`}),`\n`,_jsx(Frame,{caption:`The life of a membership that single sign-on governs`,children:_jsx(Mermaid,{chart:`flowchart TD\n SignIn([Signs in through your provider]) --> Active[Active, and the window starts again]\n Active -->|\"the window ends with no new sign-in\"| Suspended[Suspended]\n Suspended -->|\"signs in through the provider again\"| Active\n Suspended -->|\"removed in the provider, so the sign-in fails\"| Ended([Access stays ended])`})}),`\n`,_jsxs(_components.p,{children:[`A member is `,_jsx(_components.strong,{children:`governed`}),` by single sign-on once they have signed in through the provider. Each of those sign-ins records that the provider vouched for them. When the latest one is older than the `,_jsx(_components.strong,{children:`Re-verification window`}),`, Ankra suspends the membership.`]}),`\n`,_jsxs(_components.p,{children:[`A suspended member loses everything at once: portal sessions, personal API tokens, and Kubernetes access granted through Ankra. They show as `,_jsx(_components.strong,{children:`Suspended`}),` on the members page. Ankra checks every five minutes, and a suspension takes effect everywhere within about six minutes of the window ending.`]}),`\n`,_jsx(_components.p,{children:`Signing in through the provider again restores the membership, with the role it had. Someone you removed from the application in your provider cannot complete that sign-in, so their access ends at the window.`}),`\n`,_jsx(_components.p,{children:`The window therefore sets two things:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`What it sets`}),_jsx(_components.th,{children:`How`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`How long a removed person keeps access`})}),_jsx(_components.td,{children:`At most one window after their last sign-in through the provider`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`How often everyone else signs in through the provider`})}),_jsx(_components.td,{children:`At least once per window, or they are suspended until they do`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`The default is 24 hours, and you can set anything from 1 to 720 hours under `,_jsx(_components.strong,{children:`Access policy`}),`. A shorter window revokes faster and asks members to sign in more often.`]}),`\n`,_jsx(_components.p,{children:`Two kinds of member are never suspended: break-glass members, and everyone while single sign-on is switched off for the organisation.`}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`A suspended member’s personal API tokens stop working with them. Run pipelines and integrations on `,_jsx(_components.a,{href:`/guides/service-tokens`,children:`service tokens`}),`, which belong to the organisation and are not governed by single sign-on.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`require-single-sign-on`,children:`Require single sign-on`}),`\n`,_jsxs(_components.p,{children:[`Under `,_jsx(_components.strong,{children:`Access policy`}),`, set `,_jsx(_components.strong,{children:`Require single sign-on`}),` to `,_jsx(_components.strong,{children:`Required`}),`. Ankra allows this once single sign-on is enabled and someone has signed in through the provider.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Who`}),_jsx(_components.th,{children:`What changes when it is required`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`A member with an address on a verified domain`}),_jsx(_components.td,{children:`Signing in any other way sends them to your provider`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`A new sign-up with an address on a verified domain`}),_jsx(_components.td,{children:`Sent to your provider`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Every active member on a verified domain, except break-glass members`}),_jsx(_components.td,{children:`Governed immediately, with one full window to sign in through the provider`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`A member whose address is on another domain`}),_jsx(_components.td,{children:`Nothing. They keep signing in the way they do today`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`An account that shares your domain but belongs only to other organisations`}),_jsx(_components.td,{children:`Nothing`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`break-glass-members`,children:`Break-glass members`}),`\n`,_jsx(_components.p,{children:`Break-glass members keep their other sign-in methods when single sign-on is required, and are never suspended. They are how you get back in when the provider is misconfigured or down.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`The list can never be empty, and at least one break-glass member must be able to manage the organisation.`}),`\n`,_jsxs(_components.li,{children:[`Whoever sets single sign-on to `,_jsx(_components.strong,{children:`Required`}),` is added to the list.`]}),`\n`,_jsxs(_components.li,{children:[`Choose them under `,_jsx(_components.strong,{children:`Break-glass members`}),` and click `,_jsx(_components.strong,{children:`Save break-glass members`}),`.`]}),`\n`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Keep at least one break-glass member whose own sign-in you have tested. If the provider fails and no break-glass member can sign in, nobody in your organisation can reach the settings to turn single sign-on off, and you will need `,_jsx(_components.a,{href:`/platform/support`,children:`Ankra support`}),` to recover access.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`change-or-remove-it`,children:`Change or remove it`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Action`}),_jsx(_components.th,{children:`What happens to members`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`Turn off `,_jsx(_components.strong,{children:`Enable single sign-on`})]}),_jsxs(_components.td,{children:[`Nobody can sign in through the provider, nobody is suspended, and `,_jsx(_components.strong,{children:`Required`}),` returns to `,_jsx(_components.strong,{children:`Optional`}),`. Members with a password or social sign-in use that; members who only ever signed in through the provider cannot sign in until it is enabled again.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Remove a verified domain`}),_jsx(_components.td,{children:`Active members on that domain return to ordinary membership. Suspended members stay suspended. The last verified domain cannot be removed while single sign-on is enabled.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Remove single sign-on`})}),_jsx(_components.td,{children:`Active members become ordinary members. Suspended members stay suspended.`})]})]})]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Removing single sign-on cannot be undone for accounts that existed only through your provider. They lose their sign-in, and their personal API tokens and Kubernetes access are revoked. Members who also have a password or social sign-in keep it.`})}),`\n`,_jsx(_components.p,{children:`A member who is still suspended after single sign-on is turned off or removed can be removed and invited again from the members page.`}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`audit-trail`,children:`Audit trail`}),`\n`,_jsxs(_components.p,{children:[`Every change and every membership decision is written to the organisation’s `,_jsx(_components.a,{href:`/guides/audit-log`,children:`audit log`}),`:`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Action`}),_jsx(_components.th,{children:`Recorded when`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`sso_connection_created`}),`, `,_jsx(_components.code,{children:`sso_connection_updated`}),`, `,_jsx(_components.code,{children:`sso_connection_deleted`})]}),_jsx(_components.td,{children:`The provider is connected, re-keyed or removed`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`sso_policy_updated`})}),_jsx(_components.td,{children:`Enabling, requiring, the default role, the window or the break-glass list changes`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`sso_domain_added`}),`, `,_jsx(_components.code,{children:`sso_domain_verified`}),`, `,_jsx(_components.code,{children:`sso_domain_removed`})]}),_jsx(_components.td,{children:`An email domain is claimed, verified or removed`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`sso_group_mappings_updated`})}),_jsx(_components.td,{children:`The group mappings are saved`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`sso_member_provisioned`})}),_jsx(_components.td,{children:`The provider admits a new member`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`accept_invite`})}),_jsx(_components.td,{children:`An invited person joins by signing in through the provider`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`sso_member_role_synced`})}),_jsx(_components.td,{children:`A sign-in changes a member’s role from their groups`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`sso_member_suspended`})}),_jsx(_components.td,{children:`The window ends without a sign-in through the provider`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`sso_member_restored`})}),_jsx(_components.td,{children:`A suspended member signs in through the provider again`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`For an access review, filter the `,_jsx(_components.a,{href:`/security/audit-export`,children:`audit export`}),` to these actions: together they are the joiner, mover and leaver record for members the provider governs.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`limits`,children:`Limits`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Limit`}),_jsx(_components.th,{children:`Value`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Protocol`})}),_jsx(_components.td,{children:`OpenID Connect. SAML is not supported.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Providers`})}),_jsx(_components.td,{children:`One per organisation`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Email domains`})}),_jsx(_components.td,{children:`Up to 20`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Group mappings`})}),_jsxs(_components.td,{children:[`Up to 50, to `,_jsx(_components.strong,{children:`Member`}),`, `,_jsx(_components.strong,{children:`Admin`}),` and `,_jsx(_components.strong,{children:`Read-only`}),`. `,_jsx(_components.strong,{children:`Owner`}),` cannot be mapped.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Break-glass members`})}),_jsx(_components.td,{children:`1 to 20`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Re-verification window`})}),_jsx(_components.td,{children:`1 to 720 hours, 24 by default`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Deprovisioning`})}),_jsx(_components.td,{children:`Removal in the provider is not pushed to Ankra (there is no SCIM provisioning). Access ends at the re-verification window.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Management`})}),_jsx(_components.td,{children:`In the portal. There is no CLI command or API token endpoint for these settings.`})]})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`troubleshooting`,children:`Troubleshooting`}),`\n`,_jsx(_components.p,{children:`Entries are titled with the message Ankra shows, to an administrator on the settings page or to a member at sign-in.`}),`\n`,_jsx(Heading,{level:`3`,id:`connecting-a-provider`,children:`Connecting a provider`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`Single sign-on could not be prepared on this installation right now`,icon:`triangle-exclamation`,id:`single-sign-on-could-not-be-prepared-on-this-installation-right-now`,children:_jsxs(_components.p,{children:[`Ankra could not get its sign-in service ready for single sign-on. Try again in a few minutes, and `,_jsx(_components.a,{href:`/platform/support`,children:`contact support`}),` if it keeps failing.`]})}),_jsx(Accordion,{title:`The identity provider configuration was not accepted`,icon:`triangle-exclamation`,id:`the-identity-provider-configuration-was-not-accepted`,children:_jsx(_components.p,{children:`The issuer or the client was refused. Check that the issuer is the issuer URL itself and that its discovery document is reachable from the internet.`})}),_jsx(Accordion,{title:`Single sign-on adds members to the organisation, and the Homebuilder plan is limited to a single user`,icon:`triangle-exclamation`,id:`single-sign-on-adds-members-to-the-organisation-and-the-homebuilder-plan-is-limited-to-a-single-user`,children:_jsxs(_components.p,{children:[`The organisation’s plan allows one member. Upgrade the plan under `,_jsx(_components.a,{href:`/platform/billing`,children:`Billing`}),`, then connect the provider.`]})})]}),`\n`,_jsx(Heading,{level:`3`,id:`verifying-a-domain`,children:`Verifying a domain`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`No TXT record with the expected value was found`,icon:`globe`,id:`no-txt-record-with-the-expected-value-was-found`,children:_jsxs(_components.p,{children:[`The record is not visible in DNS yet, or its name or value differs from what the page shows. Check it and click `,_jsx(_components.strong,{children:`Verify`}),` again.`]})}),_jsx(Accordion,{title:`The domain is already verified by another organisation`,icon:`globe`,id:`the-domain-is-already-verified-by-another-organisation`,children:_jsx(_components.p,{children:`Another Ankra organisation has verified this domain, and a domain belongs to one organisation only. One of your own organisations may hold it.`})})]}),`\n`,_jsx(Heading,{level:`3`,id:`signing-in`,children:`Signing in`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`Not a domain your organisation has verified with Ankra`,icon:`right-to-bracket`,id:`not-a-domain-your-organisation-has-verified-with-ankra`,children:_jsx(_components.p,{children:`The provider signed the person in with an address outside your verified domains. Verify that domain, or correct the email address the provider sends.`})}),_jsx(Accordion,{title:`Your identity provider did not share an email address with Ankra`,icon:`right-to-bracket`,id:`your-identity-provider-did-not-share-an-email-address-with-ankra`,children:_jsxs(_components.p,{children:[`The application does not release the `,_jsx(_components.code,{children:`email`}),` claim, or the user has no email address in the provider.`]})}),_jsx(Accordion,{title:`You have not been invited to it yet`,icon:`right-to-bracket`,id:`you-have-not-been-invited-to-it-yet`,children:_jsx(_components.p,{children:`Just-in-time membership is off and the person has no invitation. Invite them, or turn just-in-time membership on.`})}),_jsx(Accordion,{title:`An Ankra account already exists for this email address, but the address was never verified`,icon:`right-to-bracket`,id:`an-ankra-account-already-exists-for-this-email-address-but-the-address-was-never-verified`,children:_jsx(_components.p,{children:`Sign in to that account the way it was created and verify the address, then sign in through the provider again.`})}),_jsx(Accordion,{title:`This organisation is on the Homebuilder plan, which is limited to a single user`,icon:`right-to-bracket`,id:`this-organisation-is-on-the-homebuilder-plan-which-is-limited-to-a-single-user`,children:_jsx(_components.p,{children:`The provider admitted the person, but the organisation’s plan allows one member. The organisation needs to upgrade before anyone else can join.`})}),_jsx(Accordion,{title:`Single sign-on is not enabled for this organisation`,icon:`right-to-bracket`,id:`single-sign-on-is-not-enabled-for-this-organisation`,children:_jsxs(_components.p,{children:[`The provider is connected but `,_jsx(_components.strong,{children:`Enable single sign-on`}),` is off.`]})}),_jsx(Accordion,{title:`Single sign-on is not set up for the domain`,icon:`right-to-bracket`,id:`single-sign-on-is-not-set-up-for-the-domain`,children:_jsx(_components.p,{children:`Shown on the single sign-on page when no enabled provider serves the address’s domain. Check the address, or that the domain is verified and single sign-on is enabled.`})}),_jsx(Accordion,{title:`Ankra could not confirm a fresh sign-in with your identity provider`,icon:`right-to-bracket`,id:`ankra-could-not-confirm-a-fresh-sign-in-with-your-identity-provider`,children:_jsx(_components.p,{children:`The provider did not authenticate the person just now. Close the window and start again from the sign-in link.`})}),_jsx(Accordion,{title:`Your organisation requires single sign-on, but the sign-in did not complete through your identity provider`,icon:`right-to-bracket`,id:`your-organisation-requires-single-sign-on-but-the-sign-in-did-not-complete-through-your-identity-provider`,children:_jsxs(_components.p,{children:[`Start again from the sign-in link. If it repeats, `,_jsx(_components.a,{href:`/platform/support`,children:`contact support`}),`.`]})}),_jsx(Accordion,{title:`A member shows as Suspended`,icon:`user-clock`,id:`a-member-shows-as-suspended`,children:_jsx(_components.p,{children:`The provider has not vouched for them within the window. They are restored by signing in through the provider.`})})]}),`\n`,_jsx(Heading,{level:`3`,id:`requiring-single-sign-on`,children:`Requiring single sign-on`}),`\n`,_jsx(AccordionGroup,{children:_jsx(Accordion,{title:`Sign in through single sign-on successfully once before requiring it`,icon:`shield-halved`,id:`sign-in-through-single-sign-on-successfully-once-before-requiring-it`,children:_jsxs(_components.p,{children:[`Nobody has signed in through the provider yet. Use the sign-in link once, then set `,_jsx(_components.strong,{children:`Required`}),`.`]})})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`related`,children:`Related`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Identity \u0026 Access Controls`,icon:`id-card`,href:`/security/identity-and-access`,children:_jsx(_components.p,{children:`The compliance view of sign-in, MFA, roles and tokens.`})}),_jsx(Card,{title:`Roles \u0026 Access`,icon:`user-shield`,href:`/guides/roles-and-access`,children:_jsx(_components.p,{children:`What each role grants, and scoped and custom roles.`})}),_jsx(Card,{title:`Service Tokens`,icon:`key`,href:`/guides/service-tokens`,children:_jsx(_components.p,{children:`Credentials for automation that do not depend on a person.`})}),_jsx(Card,{title:`Audit Log`,icon:`clipboard-list`,href:`/guides/audit-log`,children:_jsx(_components.p,{children:`Review who was admitted, suspended and restored.`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{YouTube,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":"Single Sign-On","description":"Connect your organisation's own OpenID Connect identity provider - Microsoft Entra ID, Okta or any other - so it decides who is a member, which role they hold, and when their access ends.","href":"/guides/single-sign-on"}}},"mdxSourceWithNoJs":null,"noJsSplices":[[143,915,")=>null;function _cr"]]},"mdxExtracts":{"tableOfContents":[{"title":"Before you start","slug":"before-you-start","depth":2,"children":[]},{"title":"Set it up","slug":"set-it-up","depth":2,"children":[]},{"title":"How members sign in","slug":"how-members-sign-in","depth":2,"children":[]},{"title":"Who becomes a member","slug":"who-becomes-a-member","depth":2,"children":[]},{"title":"Set roles from groups","slug":"set-roles-from-groups","depth":2,"children":[]},{"title":"How access ends","slug":"how-access-ends","depth":2,"children":[]},{"title":"Require single sign-on","slug":"require-single-sign-on","depth":2,"children":[{"title":"Break-glass members","slug":"break-glass-members","depth":3,"children":[]}]},{"title":"Change or remove it","slug":"change-or-remove-it","depth":2,"children":[]},{"title":"Audit trail","slug":"audit-trail","depth":2,"children":[]},{"title":"Limits","slug":"limits","depth":2,"children":[]},{"title":"Troubleshooting","slug":"troubleshooting","depth":2,"children":[{"title":"Connecting a provider","slug":"connecting-a-provider","depth":3,"children":[]},{"title":"Verifying a domain","slug":"verifying-a-domain","depth":3,"children":[]},{"title":"Signing in","slug":"signing-in","depth":3,"children":[]},{"title":"Requiring single sign-on","slug":"requiring-single-sign-on","depth":3,"children":[]}]},{"title":"Related","slug":"related","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"dynamicCss":".mint-w-full {\n width: 100%\n}\n.mint-rounded-xl {\n border-radius: 0.75rem\n}","subdomain":"ankra","siteName":"Ankra","title":"Single Sign-On - Ankra","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-11T22:54:12.571Z","originalFileLocation":"guides/single-sign-on.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=\"Connect your organisation\u0026#x27;s own OpenID Connect identity provider - Microsoft Entra ID, Okta or any other - so it decides who is a member, which role they hold, and when their access ends.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Ankra\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ankra/POmNwpWKiefNAN49/_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/ankra/POmNwpWKiefNAN49/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ankra/POmNwpWKiefNAN49/_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/ankra/POmNwpWKiefNAN49/_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/ankra/POmNwpWKiefNAN49/_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/ankra/POmNwpWKiefNAN49/_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/ankra/POmNwpWKiefNAN49/_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/ankra/POmNwpWKiefNAN49/_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/ankra/POmNwpWKiefNAN49/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Single Sign-On - Ankra\">\u003cmeta data-mint-head property=\"og:description\" content=\"Connect your organisation\u0026#x27;s own OpenID Connect identity provider - Microsoft Entra ID, Okta or any other - so it decides who is a member, which role they hold, and when their access ends.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Ankra\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.ankra.ai/guides/single-sign-on\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ankra.mintlify.site/_mintlify/api/og/v2?division=Access\u0026amp;title=Single+Sign-On\u0026amp;description=Connect+your+organisation%27s+own+OpenID+Connect+identity+provider+-+Microsoft+Entra+ID%2C+Okta+or+any+other+-+so+it+decides+who+is+a+member%2C+which+role+they+hold%2C+\u0026amp;theme=66127f62fb825da5e40c577a\u0026amp;signature=5cf854bec055811c1861cfeb1416c294f0a5b87b42454f35e424f83463f3ef4d\">\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=\"Single Sign-On - Ankra\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Connect your organisation\u0026#x27;s own OpenID Connect identity provider - Microsoft Entra ID, Okta or any other - so it decides who is a member, which role they hold, and when their access ends.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ankra.mintlify.site/_mintlify/api/og/v2?division=Access\u0026amp;title=Single+Sign-On\u0026amp;description=Connect+your+organisation%27s+own+OpenID+Connect+identity+provider+-+Microsoft+Entra+ID%2C+Okta+or+any+other+-+so+it+decides+who+is+a+member%2C+which+role+they+hold%2C+\u0026amp;theme=66127f62fb825da5e40c577a\u0026amp;signature=5cf854bec055811c1861cfeb1416c294f0a5b87b42454f35e424f83463f3ef4d\">\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/ankra/POmNwpWKiefNAN49/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Ankra\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5d64ff\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.ankra.ai/guides/single-sign-on\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/guides/single-sign-on.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.ankra.ai/#organization\",\"name\":\"Ankra\",\"url\":\"https://docs.ankra.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/ankra/uW749bPYey14eJsU/logo/light.svg?fit=max\u0026auto=format\u0026n=uW749bPYey14eJsU\u0026q=85\u0026s=7f48236f76559638a5a154da424c91d6\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.ankra.ai#website\",\"name\":\"Ankra\",\"url\":\"https://docs.ankra.ai\",\"publisher\":{\"@id\":\"https://docs.ankra.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.ankra.ai/guides/single-sign-on#webpage\",\"url\":\"https://docs.ankra.ai/guides/single-sign-on\",\"name\":\"Single Sign-On\",\"description\":\"Connect your organisation's own OpenID Connect identity provider - Microsoft Entra ID, Okta or any other - so it decides who is a member, which role they hold, and when their access ends.\",\"dateModified\":\"2026-11-11T22:54:12.571Z\",\"isPartOf\":{\"@id\":\"https://docs.ankra.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.ankra.ai/guides/single-sign-on#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.ankra.ai/guides/single-sign-on#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Security and Access\",\"item\":\"https://docs.ankra.ai/security/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Access\",\"item\":\"https://docs.ankra.ai/security/identity-and-access\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Single Sign-On\",\"item\":\"https://docs.ankra.ai/guides/single-sign-on\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.ankra.ai/guides/single-sign-on#article\",\"headline\":\"Single Sign-On\",\"name\":\"Single Sign-On\",\"description\":\"Connect your organisation's own OpenID Connect identity provider - Microsoft Entra ID, Okta or any other - so it decides who is a member, which role they hold, and when their access ends.\",\"url\":\"https://docs.ankra.ai/guides/single-sign-on\",\"mainEntityOfPage\":{\"@id\":\"https://docs.ankra.ai/guides/single-sign-on#webpage\"},\"dateModified\":\"2026-11-11T22:54:12.571Z\",\"publisher\":{\"@id\":\"https://docs.ankra.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.ankra.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Ankra\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Ankra\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/guides/single-sign-on.md","siteName":"Ankra","nav":{"global":{"anchors":[{"anchor":"Community","icon":"slack","href":"https://join.slack.com/t/ankra-community/shared_invite/zt-3a5rem8f8-cUho4epX2MoLT83bFf~VSA"},{"anchor":"Youtube","icon":"youtube","href":"https://www.youtube.com/@ankraio"},{"anchor":"Blog","icon":"newspaper","href":"https://www.ankra.ai/blog"}]},"tabs":[{"tab":"Documentation","icon":"book","groups":[{"group":"Get Started","pages":[{"title":"Introduction","href":""},{"title":"Quickstart","href":"/get-started/quickstart"},{"title":"Guided Setup","href":"/get-started/guided-setup"},{"title":"Get started with Ankra CI","sidebarTitle":"Get started with Ankra CI","href":"/get-started/ankra-ci"},{"title":"Add a Cluster","href":"/guides/import-cluster"},{"title":"Playground","href":"/guides/cluster-sandbox"}]},{"group":"Use Cases","pages":[{"title":"Production Multi-Cluster Platform","href":"/use-cases/production-multi-cluster-platform"},{"title":"From Prompt and Code to Production","href":"/use-cases/from-prompt-and-code-to-production"},{"title":"Prompt to Production","href":"/use-cases/prompt-to-production"},{"title":"Lovable to Ankra","href":"/use-cases/lovable-to-ankra"},{"title":"Vercel to Ankra","href":"/use-cases/vercel-to-ankra"},{"title":"Claude Code to Two Clusters","href":"/use-cases/claude-code-to-two-clusters"},{"title":"Speed Up CI","href":"/use-cases/speed-up-ci"},{"title":"Self-host an AI agent observability backend on-prem","href":"/use-cases/self-host-ai-agent-observability"}]},{"group":"Concepts","pages":[{"title":"How Ankra Works","href":"/concepts/how-ankra-works"},{"title":"Organisations \u0026 User Management","href":"/concepts/organisations"},{"title":"Projects","href":"/concepts/projects"},{"title":"Ankra Agent","href":"/concepts/cluster-agent"},{"title":"GitOps","href":"/concepts/gitops"},{"title":"Stacks","href":"/concepts/stacks"},{"title":"Add-ons","href":"/concepts/addons"},{"title":"Variables","href":"/concepts/variables"},{"title":"Deployment Engines","href":"/concepts/deployment-engines"},{"title":"Stack Profiles, Reusable Kubernetes Stack Templates","sidebarTitle":"Stack Profiles","href":"/concepts/stack-profiles"},{"title":"Applications","href":"/concepts/applications"},{"title":"Backup Vaults","href":"/concepts/backup-vaults"}]},{"group":"Create and Run Clusters","pages":[{"group":"Ankra Managed","pages":[{"title":"Hetzner Clusters","href":"/guides/hetzner-clusters"},{"title":"OVH Clusters","href":"/guides/ovh-clusters"},{"title":"UpCloud Clusters","href":"/guides/upcloud-clusters"},{"title":"DigitalOcean Clusters","href":"/guides/digitalocean-clusters"},{"title":"Scaleway Clusters","tag":"Closed Beta","href":"/guides/scaleway-clusters"},{"title":"AWS Clusters","icon":"aws","href":"/guides/aws-clusters"},{"title":"Ankra Cloud Clusters","icon":"cloud","tag":"Closed Beta","href":"/guides/ankra-cloud-clusters"},{"title":"Ankra Cloud Servers, Disks and Quota","tag":"Closed Beta","href":"/guides/ankra-cloud-servers-and-disks"},{"title":"Proxmox VE Clusters","href":"/guides/proxmox-clusters"},{"title":"Persistent Volumes on Proxmox VE Clusters","icon":"hard-drive","href":"/guides/proxmox-persistent-volumes"},{"title":"Morpheus Clusters","tag":"Closed Beta","href":"/guides/morpheus-clusters"},{"title":"Operate an Ankra Managed Cluster","href":"/guides/operate-ankra-managed-clusters"},{"title":"Gateway API","href":"/guides/gateway-api"},{"title":"Cluster Autoscaling","href":"/guides/cluster-autoscaling"},{"title":"Node Group Cloud-init User Data","href":"/guides/node-group-user-data"}]},{"group":"Cloud Managed","pages":[{"title":"Managed Kubernetes","href":"/guides/managed-kubernetes"},{"title":"DigitalOcean Kubernetes (DOKS)","icon":"digital-ocean","href":"/guides/doks-clusters"},{"title":"UpCloud Kubernetes (UKS)","icon":"cloud","href":"/guides/uks-clusters"},{"title":"Google Kubernetes Engine (GKE)","icon":"google","href":"/guides/gke-clusters"},{"title":"OVHcloud Managed Kubernetes (MKS)","icon":"cloud","href":"/guides/ovh-mks-clusters"},{"title":"Azure Kubernetes Service (AKS)","icon":"microsoft","href":"/guides/aks-clusters"},{"title":"Amazon EKS","icon":"aws","href":"/guides/eks-clusters"},{"title":"Ankra Cloud Kubernetes","icon":"cloud","tag":"Closed Beta","href":"/guides/ankra-cloud-kubernetes"}]},{"group":"Operate","pages":[{"title":"Cluster Settings","href":"/platform/cluster-settings"},{"title":"Nodes","href":"/platform/cluster-nodes"},{"title":"Stop, Start and Power Schedules","href":"/platform/cluster-power-schedules"},{"title":"Upgrade Kubernetes on a Cluster","href":"/guides/kubernetes-upgrades"},{"title":"OS Security Patching","href":"/guides/os-patching"},{"title":"Clone a Cluster","href":"/guides/clone-cluster"},{"title":"Rename a Cluster","href":"/guides/rename-cluster"},{"title":"Cluster Mesh","href":"/platform/cluster-mesh"},{"title":"Verify a Cluster Mesh","href":"/guides/cluster-mesh-verification"}]},{"title":"Run Kubernetes Locally","href":"/guides/minikube"},{"title":"Talos Linux Clusters","sidebarTitle":"Talos Linux","href":"/guides/talos-clusters"}]},{"group":"Ship Your App","pages":[{"title":"Ship Your App","sidebarTitle":"Pick a Route","href":"/guides/deliver-your-app"},{"group":"Applications","pages":[{"title":"Flow Parity Matrix","href":"/reference/flow-parity"},{"title":"Environments and Branch Rules","sidebarTitle":"Environments and Branch Rules","href":"/guides/application-environments"},{"title":"Application CI/CD","href":"/guides/cicd-pipeline"},{"title":"Harbor as your application registry","href":"/guides/harbor-registry"},{"title":"From Claude Design to a live application","href":"/guides/claude-design-to-ankra"}]},{"group":"Managed Services","pages":[{"title":"Managed Services","tag":"Closed Beta","href":"/concepts/managed-services"},{"title":"Set Up a Managed Service","tag":"Closed Beta","href":"/guides/set-up-a-managed-service"},{"title":"Connect to a Managed Service","tag":"Closed Beta","href":"/guides/connect-to-a-managed-service"},{"title":"Disconnect an Application from a Managed Service","tag":"Closed Beta","href":"/guides/disconnect-an-application-from-a-managed-service"},{"title":"Delete a Managed Service","tag":"Closed Beta","href":"/guides/delete-a-managed-service"},{"title":"Managed Service Settings","tag":"Closed Beta","href":"/reference/managed-services"}]},{"group":"Previews","pages":[{"title":"PR Preview Environments","href":"/guides/pr-preview-environments"},{"title":"Branch Demos","href":"/guides/branch-demos"},{"title":"Stack Profile Demos","href":"/guides/stack-profile-demos"}]},{"group":"Bring Your Own CI","pages":[{"title":"GitLab CI/CD Pipeline","href":"/guides/gitlab-cicd-pipeline"},{"title":"Use the ankra CLI in CI","href":"/guides/pipeline-agents"}]},{"group":"Move From Docker","pages":[{"title":"Move a Docker Deployment Into a Cluster","href":"/guides/migrate-from-docker"},{"title":"Write an ankra migrate Module","href":"/guides/migrate-modules"}]}]},{"group":"Ankra Pipelines","pages":[{"title":"Ankra Pipelines","sidebarTitle":"Overview","href":"/pipelines/overview"},{"title":"Why Ankra Pipelines","sidebarTitle":"Why Ankra Pipelines","href":"/pipelines/why-ankra-pipelines"},{"title":"How Ankra Pipelines works","sidebarTitle":"How it works","href":"/pipelines/how-it-works"},{"title":"Generated pipelines","sidebarTitle":"Generated pipelines","href":"/pipelines/generated-pipelines"},{"title":"Pipeline examples","sidebarTitle":"Examples","href":"/pipelines/examples"},{"group":"Speed","pages":[{"title":"Fast CI","sidebarTitle":"Fast CI","href":"/pipelines/fast-ci"},{"title":"Pipeline caching","sidebarTitle":"Caching","href":"/pipelines/caching"},{"title":"The merge train","sidebarTitle":"Merge train","href":"/pipelines/merge-train"}]},{"group":"AI","pages":[{"title":"AI in pull requests","sidebarTitle":"AI in pull requests","href":"/pipelines/ai-in-pull-requests"},{"title":"AI Gateway","sidebarTitle":"AI Gateway","href":"/pipelines/ai-gateway"},{"title":"Pipelines with Claude Code, Codex and the Claude app","sidebarTitle":"With coding agents","href":"/pipelines/coding-agents"}]},{"title":"Pipelines from the CLI and MCP","sidebarTitle":"CLI and MCP","href":"/pipelines/cli-and-mcp"},{"group":"Set Up and Operate","pages":[{"title":"Ankra Pipelines","href":"/guides/ankra-pipelines"},{"title":"Ankra CI starter pipelines","sidebarTitle":"Starter pipelines","href":"/guides/ankra-ci-starter-pipelines"},{"title":"Build a Bazel Repository with Ankra Pipelines","sidebarTitle":"Bazel","href":"/guides/bazel-pipelines"},{"title":"Move a team to Ankra CI","sidebarTitle":"Move a team to Ankra CI","href":"/guides/move-to-ankra-ci"},{"title":"Migrate from GitHub Actions","href":"/guides/migrate-from-github-actions"},{"title":"Run tests and lint in Ankra Workspaces","sidebarTitle":"Workspaces","href":"/guides/ankra-workspaces"},{"title":"Offload Claude Code build sessions to Ankra Workspaces","sidebarTitle":"Claude Code on Workspaces","href":"/guides/claude-code-workspaces"},{"title":"Ankra CI troubleshooting","sidebarTitle":"Troubleshooting","href":"/guides/ankra-ci-troubleshooting"}]},{"title":"pipeline.yaml reference","href":"/guides/pipeline-reference"}]},{"group":"Stacks and Add-ons","pages":[{"title":"Build a Monitoring Stack","href":"/guides/monitoring-stack"},{"title":"Build a Cloudflare Stack","href":"/guides/cloudflare-tunnel"},{"title":"Use Avura domains with Ankra","href":"/guides/avura-domains"},{"title":"Use Your Own Domain","href":"/guides/use-your-own-domain"},{"title":"Clone Stacks Between Clusters \u0026 Organisations","href":"/guides/clone-stack"},{"title":"Protect Persistent Data Before Changing a Stack","href":"/guides/protect-persistent-data"},{"title":"Stack Profile Suggestions","href":"/guides/stack-profile-suggestions"},{"group":"Add-on Catalog","pages":[{"title":"Add-on Catalog","href":"/platform/addon-catalog"},{"title":"Helm Registries","sidebarTitle":"Connect a Helm Registry","href":"/guides/registries"},{"title":"Helm Registries","sidebarTitle":"Helm Registry Providers","href":"/integrations/helm-registries"},{"title":"Create a Registry","href":"/guides/create-a-registry"},{"title":"Publishing Add-ons","href":"/platform/addon-publishing"},{"title":"Publishing Applications as Add-ons","href":"/platform/application-addons"}]}]},{"group":"Observe and Troubleshoot","pages":[{"title":"Dashboard","href":"/platform/dashboard"},{"title":"Activity \u0026 Inbox","href":"/platform/activity-inbox"},{"title":"Find out why a deploy failed and retry it","sidebarTitle":"Operations","href":"/platform/operations"},{"title":"Cluster Metrics","href":"/platform/cluster-metrics"},{"title":"Prometheus","href":"/integrations/prometheus"},{"title":"Logs","href":"/platform/logs"},{"title":"Ankra Hosted Logs","href":"/guides/hosted-logs"},{"title":"Log Sources","href":"/integrations/log-sources"},{"group":"Kubernetes Resources","pages":[{"title":"Kubernetes Resources","sidebarTitle":"Overview","href":"/platform/kubernetes-insights"},{"title":"Kubernetes Nodes","href":"/platform/kubernetes-nodes"},{"title":"Pod Terminal for Kubernetes in Your Browser","sidebarTitle":"Pod Terminal","href":"/platform/pod-terminal"},{"title":"Debug Pods","href":"/platform/debug-pods"}]},{"group":"Alerts and Notifications","pages":[{"title":"Alerts","href":"/guides/alerts"},{"title":"Notification routing","href":"/guides/notification-routing"},{"title":"Webhooks","href":"/guides/webhooks"},{"title":"Alert on Manifest Failures","href":"/guides/webhook-integrations"},{"title":"Mobile push notifications","href":"/guides/mobile-push"}]}]},{"group":"Ankra AI","pages":[{"title":"Ankra AI","sidebarTitle":"Overview","href":"/platform/ai-overview"},{"group":"Use It","pages":[{"title":"Guided Setup","href":"/platform/ai-guided-setup"},{"title":"AI Assistant","href":"/platform/ai-assistant"},{"title":"AI Insights","href":"/platform/ai-insights"}]},{"group":"Agents and Board","pages":[{"title":"AI Agents","href":"/platform/ai-agents"},{"title":"AI Board","href":"/platform/ai-board"},{"title":"Work the AI Board with Your Own Agent","href":"/guides/board-own-agent"},{"title":"AI Automations","href":"/platform/ai-automations"},{"title":"AI Autonomy","href":"/platform/ai-autonomy"},{"title":"Sync Board Tickets to Jira, Linear, or a Webhook","href":"/guides/ticket-sync"},{"title":"AI Workspaces","href":"/platform/ai-workspaces"}]},{"group":"Code Review","pages":[{"title":"AI Code Review","href":"/platform/ai-code-review"},{"title":"Cross-Repository Review","href":"/platform/ai-code-review-cross-repo"},{"title":"Application AI Settings","href":"/platform/application-ai"},{"title":"Teach Your Agents with AGENTS.md","href":"/platform/agents-md"}]},{"group":"Configure","pages":[{"title":"Models and Cost","href":"/platform/ai-provider"},{"title":"Your Own AI Keys","href":"/platform/personal-ai-keys"},{"title":"Bring Your Own OpenRouter API Key","href":"/guides/openrouter-api-key"},{"title":"AI Connections","href":"/platform/ai-connections"},{"title":"AI Skills and Custom Tools","href":"/platform/ai-skills"},{"title":"AI Memory and Feedback","href":"/platform/ai-memory"}]}]},{"group":"Connect Tools","pages":[{"title":"Ankra CLI","href":"/integrations/ankra-cli"},{"title":"MCP Server","href":"/platform/mcp-server"},{"title":"MCP Tool Reference","href":"/platform/mcp-tools"},{"title":"Agent Skills","href":"/integrations/agent-skills"},{"title":"Agent Skills Catalogue","href":"/integrations/agent-skills-catalogue"},{"title":"OpenClaw","href":"/integrations/openclaw"},{"title":"Ankra Terraform Provider","href":"/integrations/terraform"}]},{"group":"Source Control","pages":[{"title":"Git Providers","href":"/integrations/git-providers"},{"title":"GitHub Integration","href":"/integrations/github"},{"title":"GitLab Integration","href":"/integrations/gitlab"},{"title":"Bitbucket Cloud Integration","href":"/integrations/bitbucket-cloud"}]},{"group":"Security and Access","pages":[{"title":"What Ankra Can See and Do","sidebarTitle":"Security overview","href":"/security/overview"},{"title":"Cluster Security","href":"/guides/cluster-security"},{"title":"Security Reports","href":"/guides/security-reports"},{"group":"Access","pages":[{"title":"Identity \u0026 Access Controls","description":"The sign-in, MFA, role and token controls behind platform access - and the evidence each one produces for an audit.","href":"/security/identity-and-access"},{"title":"Single Sign-On","href":"/guides/single-sign-on"},{"title":"Roles \u0026 Access","description":"Govern who can do what in your organisation with roles, scoped assignments, cluster groups, and an audit log.","href":"/guides/roles-and-access"},{"title":"Set Up Projects","href":"/guides/set-up-projects"},{"title":"Private access for proxied domains","href":"/guides/private-proxied-domains"},{"title":"Protect a tunnel with Ankra sign-in","href":"/guides/protect-a-tunnel-with-ankra-sign-in"},{"title":"Account Security \u0026 2FA","href":"/platform/account-security"},{"title":"Service Tokens","href":"/guides/service-tokens"},{"title":"API Tokens","href":"/reference/tokens"},{"title":"Cluster Access","href":"/guides/cluster-access"},{"title":"Accessing Clusters with kubectl","href":"/guides/kubeconfig"},{"title":"Ankra Support Access","href":"/security/support-access"}]},{"group":"Hardening","pages":[{"title":"Cluster Hardening","href":"/security/hardening"},{"title":"Hardening the Agent","href":"/security/agent-hardening"},{"title":"Verified Provenance at Deploy","href":"/security/deploy-provenance"},{"title":"SOPS Encryption","href":"/guides/sops"},{"title":"Organisation Secrets","href":"/guides/organisation-secrets"}]},{"group":"Compliance and Audit","pages":[{"title":"Shared Responsibility","href":"/security/shared-responsibility"},{"title":"Compliance Management","href":"/security/compliance-management"},{"title":"Change Management","href":"/security/change-management"},{"title":"Audit Log","href":"/guides/audit-log"},{"title":"Audit Export","href":"/security/audit-export"},{"title":"Agent Compliance Posture","href":"/security/agent-compliance"}]}]},{"group":"Cost and Backups","pages":[{"title":"Cloud Cost","href":"/platform/cloud-cost"},{"title":"Cost Budgets and the Autopilot","href":"/guides/cost-budgets-and-autopilot"},{"title":"Backups and Restore Points","href":"/guides/backups"},{"title":"Object Storage Buckets","href":"/guides/object-storage-buckets"}]},{"group":"Organisation and Account","pages":[{"title":"Organisation Settings","href":"/platform/organisation-settings"},{"group":"Credentials","pages":[{"title":"Credentials","href":"/platform/credentials"},{"title":"Git Credentials","icon":"code-branch","href":"/platform/credentials/git"},{"title":"Registry Credentials","icon":"box","href":"/platform/credentials/registry"},{"title":"Hetzner API Credentials","icon":"cloud","href":"/platform/credentials/hetzner"},{"title":"OVH API Credentials","icon":"cloud","href":"/platform/credentials/ovh"},{"title":"UpCloud API Credentials","icon":"cloud","href":"/platform/credentials/upcloud"},{"title":"DigitalOcean API Credentials","icon":"digital-ocean","href":"/platform/credentials/digitalocean"},{"title":"Scaleway Credentials","icon":"cloud","tag":"Closed Beta","href":"/platform/credentials/scaleway"},{"title":"AWS Credentials","icon":"aws","href":"/platform/credentials/aws"},{"title":"Google Cloud (GCP) Credentials","icon":"google","href":"/platform/credentials/gcp"},{"title":"Azure Credentials","icon":"microsoft","href":"/platform/credentials/azure"},{"title":"Proxmox VE API Credentials","icon":"server","href":"/platform/credentials/proxmox"},{"title":"Morpheus API Credentials","icon":"server","tag":"Closed Beta","href":"/platform/credentials/morpheus"},{"title":"Ankra Cloud Credentials","icon":"cloud","tag":"Closed Beta","href":"/platform/credentials/ankra-cloud"},{"title":"SSH Key Credentials","icon":"lock","href":"/platform/credentials/ssh-key"}]},{"title":"Billing \u0026 Usage","href":"/platform/billing"},{"title":"Usage","href":"/platform/usage"},{"title":"User Profile","href":"/platform/user-profile"},{"title":"Command Palette","href":"/platform/command-palette"},{"title":"Keyboard Shortcuts","href":"/platform/keyboard-shortcuts"},{"title":"Support","href":"/platform/support"}]},{"group":"Reference","pages":[{"group":"CLI","pages":[{"title":"CLI Command Reference","href":"/reference/cli/index"},{"title":"ankra agents","href":"/reference/cli/agents"},{"title":"ankra ai","href":"/reference/cli/ai"},{"title":"ankra alerts","href":"/reference/cli/alerts"},{"title":"ankra application","href":"/reference/cli/application"},{"title":"ankra backup","href":"/reference/cli/backup"},{"title":"ankra bucket","href":"/reference/cli/bucket"},{"title":"ankra canvas","href":"/reference/cli/canvas"},{"title":"ankra charts","href":"/reference/cli/charts"},{"title":"ankra chat","href":"/reference/cli/chat"},{"title":"ankra cluster","href":"/reference/cli/cluster"},{"title":"ankra completion","href":"/reference/cli/completion"},{"title":"ankra config","href":"/reference/cli/config"},{"title":"ankra cost","href":"/reference/cli/cost"},{"title":"ankra credentials","href":"/reference/cli/credentials"},{"title":"ankra delete","href":"/reference/cli/delete"},{"title":"ankra deployments","href":"/reference/cli/deployments"},{"title":"ankra dev","href":"/reference/cli/dev"},{"title":"ankra exec","href":"/reference/cli/exec"},{"title":"ankra helm","href":"/reference/cli/helm"},{"title":"ankra login","href":"/reference/cli/login"},{"title":"ankra logout","href":"/reference/cli/logout"},{"title":"ankra mcp","href":"/reference/cli/mcp"},{"title":"ankra migrate","href":"/reference/cli/migrate"},{"title":"ankra onboard","href":"/reference/cli/onboard"},{"title":"ankra openclaw","href":"/reference/cli/openclaw"},{"title":"ankra org","href":"/reference/cli/org"},{"title":"ankra pipeline","href":"/reference/cli/pipeline"},{"title":"ankra plugins","href":"/reference/cli/plugins"},{"title":"ankra profile","href":"/reference/cli/profile"},{"title":"ankra project","href":"/reference/cli/project"},{"title":"ankra registry","href":"/reference/cli/registry"},{"title":"ankra runs","href":"/reference/cli/runs"},{"title":"ankra secrets","href":"/reference/cli/secrets"},{"title":"ankra security","href":"/reference/cli/security"},{"title":"ankra services","href":"/reference/cli/services"},{"title":"ankra skills","href":"/reference/cli/skills"},{"title":"ankra slack","href":"/reference/cli/slack"},{"title":"ankra stack-profiles","href":"/reference/cli/stack-profiles"},{"title":"ankra support","href":"/reference/cli/support"},{"title":"ankra targets","href":"/reference/cli/targets"},{"title":"ankra tickets","href":"/reference/cli/tickets"},{"title":"ankra tokens","href":"/reference/cli/tokens"},{"title":"ankra upgrade","href":"/reference/cli/upgrade"},{"title":"ankra workspace","href":"/reference/cli/workspace"}]},{"title":"ImportCluster YAML Schema","href":"/reference/importcluster"},{"title":"ankra.yaml reference","href":"/reference/application-descriptor"},{"title":"Agent Helm Values","href":"/reference/agent-helm-values"},{"title":"Add-on Settings","href":"/concepts/addon-settings"},{"title":"Cost API fields","href":"/reference/cost-api"},{"title":"Portal URLs","href":"/platform/portal-urls"},{"group":"Providers","pages":[{"title":"Hetzner Reference","href":"/reference/hetzner"},{"title":"OVH Reference","href":"/reference/ovh"},{"title":"UpCloud Reference","href":"/reference/upcloud"},{"title":"DigitalOcean Reference","href":"/reference/digitalocean"},{"title":"AWS Reference","href":"/reference/aws"},{"title":"Proxmox VE Reference","href":"/reference/proxmox"},{"title":"Morpheus Reference","tag":"Closed Beta","href":"/reference/morpheus"},{"title":"Managed Kubernetes Reference","href":"/reference/managed-kubernetes"}]}]}]},{"tab":"API Reference","icon":"terminal","pages":[{"title":"API Reference","href":"/api-reference/introduction"}]},{"tab":"Changelog","icon":"clock-rotate-left","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Single Sign-On - Ankra","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-D2acuaLg.js","DynamicMarkdown-Co5nikxh.js","zoom-image-lightbox-BbK2OBGL.js","lightbox-handle-r17bVUz3.js"]}