Skip to content

Clarify auth capabilities on Enterprise page#888

Merged
danbarr merged 2 commits into
mainfrom
clarify-enterprise-auth-table
May 20, 2026
Merged

Clarify auth capabilities on Enterprise page#888
danbarr merged 2 commits into
mainfrom
clarify-enterprise-auth-table

Conversation

@danbarr
Copy link
Copy Markdown
Collaborator

@danbarr danbarr commented May 20, 2026

Description

The auth & identity comparison table on the Enterprise page had two rows that prospects were reading the wrong way:

  • "Basic authentication" was being read as HTTP Basic auth. Renamed to "OIDC/OAuth authentication" since that's what ToolHive actually provides in both Community and Enterprise.
  • "Built-in IdP integration (Okta, Entra ID)" implied that OAuth/OIDC isn't available in open source at all. The actual differentiation is that Enterprise ships preset configurations for specific identity providers, so renamed to "Turnkey IdP integration (Okta, Entra ID)".

While in the area:

  • Split "Token exchange & credential brokering" into "Token exchange (RFC 8693)" (Community + Enterprise) and "Entra ID on-behalf-of flow" (Enterprise-only, since it's a non-RFC variant).
  • Fixed "CEDAR" capitalization (Cedar is a proper noun, not an acronym).
  • Aligned the :::enterprise admonition on the docs landing page and the FAQ entry on the Enterprise page to use the same "turnkey IdP integration" framing.
  • Sentence-cased the "Enterprise platform components" heading to match the rest of the page.
  • Fixed "open-source" → "open source" per the style guide.

Type of change

  • Documentation update

Submitter checklist

  • I have reviewed the content for technical accuracy
  • I have reviewed the content for spelling, grammar, and style

The "Basic authentication" row was read as HTTP Basic, and "Built-in
IdP integration" implied OAuth/OIDC weren't available in community.
Rename for accuracy, split token exchange into RFC 8693 (both) and
Entra ID on-behalf-of (Enterprise-only), and align admonition copy
to use "turnkey IdP integration" across the page and the landing
page callout. Also fix Cedar casing, sentence-case the Enterprise
platform components heading, and de-hyphenate "open source".

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings May 20, 2026 22:05
@vercel
Copy link
Copy Markdown

vercel Bot commented May 20, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs-website Ready Ready Preview, Comment May 20, 2026 10:11pm

Request Review

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Updates ToolHive Enterprise documentation to reduce confusion in the auth & identity comparison content by clarifying terminology and tightening consistency with the style guide.

Changes:

  • Reworded Enterprise landing-page :::enterprise callout to highlight “turnkey” identity provider support.
  • Updated the Enterprise auth/identity comparison table to clarify OAuth/OIDC auth, distinguish RFC 8693 token exchange vs. Entra OBO, and correct “Cedar” capitalization.
  • Normalized heading capitalization and “open source” wording per the style guide.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File Description
docs/toolhive/index.mdx Refines the Enterprise callout messaging on the ToolHive docs landing page.
docs/toolhive/enterprise.mdx Clarifies auth/identity capability table rows and applies small style/wording fixes.

Comment thread docs/toolhive/index.mdx Outdated
Acronym was only used once on this page, so drop it entirely rather
than introducing it just to abbreviate.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Copy link
Copy Markdown
Contributor

@Derek2Tu Derek2Tu left a comment

Choose a reason for hiding this comment

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

LGTM

@danbarr danbarr merged commit 23676f3 into main May 20, 2026
3 checks passed
@danbarr danbarr deleted the clarify-enterprise-auth-table branch May 20, 2026 22:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants