Repository navigation
docs(id-jag): describe the current xaa setup, plans, and token rules - #21929
Merged
Merged
Conversation
ID-JAG (XAA) is on the Scale and Enterprise platform add-ons, not Enterprise only. The page also described the old per-domain modal, showed a token request without client authentication, and left out the claim rules, user matching, and most error cases. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Contributor
Deploy preview
Changed pages
|
rafaeelaudibert
marked this pull request as ready for review
November 4, 2026 00:40
Contributor
|
Vale prose linter → found 5 errors, 33 warnings, 7 suggestions in your markdown Full report → Copy the linter results into an LLM to batch-fix issues. Linter being weird? Update the rules!
|
| Line | Severity | Message | Rule |
|---|---|---|---|
| 10:71 | warning | 'untrusted' is a possible misspelling. | PostHogBase.Spelling |
| 16:150 | warning | Capitalize 'Feature Flags' for PostHog's product. Use 'feature flags' for the general industry concept. | PostHogBase.ProductNames |
| 16:165 | warning | Capitalize 'Product Analytics' for PostHog's product. Use 'product analytics' for the general industry concept. | PostHogBase.ProductNames |
| 16:184 | warning | Capitalize 'Error Tracking' for PostHog's product. Use 'error tracking' for the general industry concept. | PostHogBase.ProductNames |
| 16:200 | warning | Capitalize 'Experiments' for PostHog's product. Use 'experiments' for the general industry concept. | PostHogBase.ProductNames |
| 16:231 | warning | Capitalize 'Surveys' for PostHog's product. Use 'surveys' for the general industry concept. | PostHogBase.ProductNames |
| 30:363 | warning | Capitalize 'Endpoints' for PostHog's product. Use 'endpoints' for the general industry concept. | PostHogBase.ProductNames |
| 34:122 | warning | Capitalize 'Endpoints' for PostHog's product. Use 'endpoints' for the general industry concept. | PostHogBase.ProductNames |
| 50:273 | warning | 'Entra' is a possible misspelling. | PostHogBase.Spelling |
| 58:69 | warning | 'untrusted' is a possible misspelling. | PostHogBase.Spelling |
| 62:5 | warning | 'Using an API key instead of OAuth' heading should be in sentence case, and product names should be capitalized. | PostHogBase.SentenceCase |
| 95:30 | error | Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. | PostHogBase.EnDash |
| 96:25 | error | Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. | PostHogBase.EnDash |
| 100:20 | error | Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. | PostHogBase.EnDash |
| 101:15 | error | Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. | PostHogBase.EnDash |
| 155:124 | warning | Avoid trivializing words. 'easy to' can sound dismissive to the reader. | PostHogDocs.Trivializers |
| 170:122 | warning | 'Cowork' is a possible misspelling. | PostHogBase.Spelling |
| 214:61 | warning | Use the Oxford comma before 'and' or 'or' in a list of three or more items. | PostHogBase.OxfordComma |
| 237:31 | warning | Capitalize 'Data Warehouse' for PostHog's product. Use 'Data warehouse' for the general industry concept. | PostHogBase.ProductNames |
| 243:43 | warning | Capitalize 'Experiments' for PostHog's product. Use 'experiments' for the general industry concept. | PostHogBase.ProductNames |
| 260:31 | warning | Capitalize 'Session Replay' for PostHog's product. Use 'Session replay' for the general industry concept. | PostHogBase.ProductNames |
| 263:31 | warning | Capitalize 'Customer Analytics' for PostHog's product. Use 'Customer analytics' for the general industry concept. | PostHogBase.ProductNames |
| 269:81 | warning | Don't put a comma after 'e.g.,'. Write 'i.e.' or 'e.g.' with no comma after it. | PostHogBase.LatinAbbreviationComma |
| 281:68 | error | Hi, Andy here... use an en dash ( – ) with spaces. On Mac, holding down the Option and hyphen key will give you an en dash. | PostHogBase.EnDash |
| 312:24 | warning | Use 'PostHog' instead of 'posthog'. | Vale.Terms |
| 313:26 | warning | Use 'PostHog' instead of 'posthog'. | Vale.Terms |
| 314:17 | warning | Use 'PostHog' instead of 'posthog'. | Vale.Terms |
contents/docs/settings/agent-discovery.mdx — 0 errors, 5 warnings, 0 suggestions
| Line | Severity | Message | Rule |
|---|---|---|---|
| 6:158 | warning | Capitalize 'Endpoints' for PostHog's product. Use 'endpoints' for the general industry concept. | PostHogBase.ProductNames |
| 17:51 | warning | Capitalize 'Endpoints' for PostHog's product. Use 'endpoints' for the general industry concept. | PostHogBase.ProductNames |
| 69:118 | warning | Capitalize 'Endpoints' for PostHog's product. Use 'endpoints' for the general industry concept. | PostHogBase.ProductNames |
| 94:74 | warning | Capitalize 'Endpoints' for PostHog's product. Use 'endpoints' for the general industry concept. | PostHogBase.ProductNames |
| 94:234 | warning | 'hardcoding' is a possible misspelling. | PostHogBase.Spelling |
contents/docs/settings/authentication/id-jag.mdx — 0 errors, 6 warnings, 7 suggestions
| Line | Severity | Message | Rule |
|---|---|---|---|
| 10:163 | warning | 'Entra' is a possible misspelling. | PostHogBase.Spelling |
| 81:49 | warning | 'IdP's' is a possible misspelling. | PostHogBase.Spelling |
| 82:61 | warning | 'IdP's' is a possible misspelling. | PostHogBase.Spelling |
| 105:28 | suggestion | Address the reader directly. Use 'you' instead of 'the user'. | PostHogDocs.DirectAddress |
| 116:122 | suggestion | Address the reader directly. Use 'you' instead of 'the user'. | PostHogDocs.DirectAddress |
| 117:61 | suggestion | Address the reader directly. Use 'you' instead of 'The user'. | PostHogDocs.DirectAddress |
| 122:4 | warning | 'FAQ' heading should be in sentence case, and product names should be capitalized. | PostHogBase.SentenceCase |
| 130:102 | warning | 'IdP's' is a possible misspelling. | PostHogBase.Spelling |
| 135:35 | suggestion | Address the reader directly. Use 'you' instead of 'the user'. | PostHogDocs.DirectAddress |
| 136:13 | suggestion | Address the reader directly. Use 'you' instead of 'The user'. | PostHogDocs.DirectAddress |
| 142:22 | warning | 'IdP's' is a possible misspelling. | PostHogBase.Spelling |
| 149:118 | suggestion | Address the reader directly. Use 'you' instead of 'the user'. | PostHogDocs.DirectAddress |
| 201:43 | suggestion | Address the reader directly. Use 'you' instead of 'The user'. | PostHogDocs.DirectAddress |
ID-JAG (XAA) leaves beta when the XAA settings roll out to all organizations. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Admins configuring XAA need the setup steps, revocation, and the common errors. The claim rules, user matching, manual token exchange, token details, and full error table now sit in collapsed FAQ entries at the end of the page. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Contributor
Bundle reportTotal JS (gzip)11.71 MiB (+0.1 KiB / +0.0%) Eager graph (modules shipped in each entrypoint's initial chunks)
Largest modules in the
|
| Module | Size |
|---|---|
css ./node_modules/.pnpm/css-loader@5.2.7_webpack@5.101.3/node_modules/css-loader/dist/cjs.js??ruleSet[1].rules[8].oneOf[1].use[1]!./node_modules/.pnpm/postcss-loader@4.3.0_postcss@8.5.6_webpack@5.101.3/node_modules/postcss-loader/dist/cjs.js??ruleSet[1].rules[8].oneOf[1].use[2]!./src/styles/global.css |
839.5 KiB |
./src/components/Stickers/Stickers.tsx |
696.4 KiB |
./node_modules/.pnpm/@posthog+icons@0.36.6_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/@posthog/icons/dist/posthog-icons.es.js |
354.8 KiB |
./node_modules/.pnpm/react-markdown@8.0.7_@types+react@16.14.66_react@18.3.1/node_modules/react-markdown/lib/react-markdown.js + 88 modules |
351.4 KiB |
./node_modules/.pnpm/framer-motion@14.0.0_react-dom@18.3.1_react@18.3.1__react@18.3.1/node_modules/framer-motion/dist/es/render/components/motion/proxy.mjs + 126 modules |
287.2 KiB |
./node_modules/.pnpm/cloudinary-core@2.14.0_lodash@4.17.21/node_modules/cloudinary-core/cloudinary-core.js |
281.9 KiB |
./src/components/SearchUI/index.tsx + 87 modules |
273.1 KiB |
./gatsby-browser.tsx + 59 modules |
259.1 KiB |
./node_modules/.pnpm/@posthog+brand@0.13.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/construction-1.mjs |
248.5 KiB |
./src/components/Pricing/PricingSlider/Slider.tsx + 87 modules |
240.2 KiB |
./node_modules/.pnpm/@posthog+brand@0.13.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/construction-2.mjs |
228.2 KiB |
./node_modules/.pnpm/@posthog+brand@0.13.0_react@18.3.1/node_modules/@posthog/brand/dist/generated/hoggies/svg/magnifying-glass.mjs |
221.7 KiB |
./src/hooks/skills.tsx + 2 modules |
150.7 KiB |
./src/hooks/useProduct.ts + 9 modules |
149.9 KiB |
./src/components/Icons/Icons.tsx |
147.4 KiB |
Eager-graph budgets are report-only until a baseline is established. Sizes are gzip of public/**/*.js; eager size is webpack module source bytes for the modules actually shipped in the entrypoint's initial chunks (post-tree-shake).
This was referenced Nov 4, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Executive summary
This PR updates the ID-JAG (XAA) docs to match the product as it is now. PostHog plans to enable XAA settings for all organizations when this PR and PostHog/posthog#128775 merge.
The old page had these errors:
curlexample sent no client credentials. The token endpoint refuses that request withinvalid_client.jti,client_id, andresource, or the 10-minute lifetime limit.Changes
id-jag.mdx: rewrite the plan callout, requirements, and setup steps for an admin reader. The main page keeps setup, revocation, and the five most common errors.id-jag.mdx: move the technical reference into collapsed FAQ entries at the end: the claims that PostHog checks, user matching, the manual token exchange, token details, and the full error table.agent-discovery.mdxandmodel-context-protocol/faq.mdx: change "Enterprise plan" to "Scale and Enterprise add-ons".id-jag.mdxandagent-discovery.mdx: remove the beta label. XAA leaves beta when this PR merges and the XAA settings roll out to all organizations.Not in this PR
model-context-protocol/enterprise-managed-authorization.mdxstays unchanged. It still says "Enterprise plan only". The Claude and Okta setup needs a manual test before that page changes.Dependency
resourcevaluehttps://mcp.posthog.com/mcpworks only after https://github.com/PostHog/charts/pull/19389 deploys.Checks
prettier --checkpasses on the three files. The commit hook ranmarkdownlint-cli2 --fix.pnpm start, Node 22) compiled the page data for all three pages, with the new text.src/components/Learn/PocketGuides/AioPocketGuide/figures.tsx:63(changed in Rebuild the AI Observability pocket guide #21849), not this PR.check-internal-links (base)failed because its self-hosted runner lost contact while it builtmaster. Other open PRs show the same failure today.check-internal-links (head)passed, and neither link check is required.🤖 Agent context
posthog/api/id_jag.py,posthog/api/oauth/views.py,posthog/auth.py, and the settings components. Plan data comes from the live billing catalog.🤖 Generated with Claude Code