Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 18 additions & 0 deletions concepts/enterprise-sso.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,8 @@
**Enterprise SSO** connects your [organization](/concepts/organizations) to
your company's identity provider, so members sign in to FloxHub and the Flox
CLI with their work accounts instead of GitHub, Google, or GitLab. Flox
supports any SAML or OIDC identity provider, including Okta Workforce

Check warning on line 15 in concepts/enterprise-sso.mdx

View check run for this annotation

Mintlify / Mintlify Validation (flox) - vale-spellcheck

concepts/enterprise-sso.mdx#L15

Did you really mean 'Okta'?
Identity, Entra ID, and Google Workspace.

Check warning on line 16 in concepts/enterprise-sso.mdx

View check run for this annotation

Mintlify / Mintlify Validation (flox) - vale-spellcheck

concepts/enterprise-sso.mdx#L16

Did you really mean 'Entra'?

Organization owners set the connection up themselves from the organization's
settings page, in a guided flow that includes verifying your company's email
Expand Down Expand Up @@ -70,3 +70,21 @@

To update or remove the connection, for example to change identity providers
or add a domain, contact [support@flox.dev](mailto:support@flox.dev).

## Direct sign-in link

Once the connection is active, the **Enterprise SSO** card also shows a
direct sign-in link. The link sends members straight to your identity
provider and skips the email prompt, which makes it the right target for
your identity provider's app tile:

- In Okta, set it as the **Initiate login URI** on your app integration

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

are there any others we need to call out here?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

maybe, but I don't know them well enough, so we'd be guessing. my vote is document what we know and we can always add more later.

and set **Login initiated by** to **Either Okta or App**. Members can
then start from the Flox tile in their Okta dashboard.

Check warning on line 83 in concepts/enterprise-sso.mdx

View check run for this annotation

Mintlify / Mintlify Validation (flox) - vale-spellcheck

concepts/enterprise-sso.mdx#L83

Did you really mean 'Okta'?
- In Microsoft Entra ID, set it as the **Home page URL** in your app

Check warning on line 84 in concepts/enterprise-sso.mdx

View check run for this annotation

Mintlify / Mintlify Validation (flox) - vale-spellcheck

concepts/enterprise-sso.mdx#L84

Did you really mean 'Entra'?
registration's **Branding** settings. Members can then start from the
Flox tile in My Apps.

The link also works as a plain bookmark. A member who follows it with an
active session at your identity provider signs in to FloxHub without
typing anything.