Skip to content

Revamp Developer Portal: add: Configure CORS how-to guide and CORS troubleshooting page#1950

Open
sharadregoti wants to merge 14 commits intoportal-ia-structural-changes-a3-a7from
portal-b20-configure-cors
Open

Revamp Developer Portal: add: Configure CORS how-to guide and CORS troubleshooting page#1950
sharadregoti wants to merge 14 commits intoportal-ia-structural-changes-a3-a7from
portal-b20-configure-cors

Conversation

@sharadregoti
Copy link
Copy Markdown
Contributor

@sharadregoti sharadregoti commented Apr 29, 2026

Summary

  • B20 (portal/how-to-guides/configure-cors.mdx): New how-to guide covering both CORS layers — Portal application CORS (7 env vars, env var + Helm tabs) and Gateway CORS per API definition (Classic and Tyk OAS). Includes TT-15960 regression callout and a TODO comment on the AllowedOrigins default discrepancy (pending confirmation from Portal team).
  • B10 (portal/troubleshooting/cors-issues.mdx): New troubleshooting page with four validated CORS error scenarios in AccordionGroup format, covering Portal CORS disabled, Gateway CORS misconfigured, TT-15960 403 regression, and credentials+wildcard origin conflict. Scenarios validated via OEL code analysis and confirmed against customer-insights Zendesk cases (Centerpoint Connect, International SOS).

🤖 Generated with Claude Code

…ing page

- configure-cors.mdx: covers Portal application CORS (env vars + Helm)
  and Gateway CORS for Classic and OAS API definitions; includes
  TT-15960 regression callout and AllowedOrigins default TODO
- cors-issues.mdx: troubleshooting page with four validated scenarios
  (Portal CORS disabled, Gateway CORS misconfigured, TT-15960 403
  regression, credentials+wildcard conflict) based on OEL code
  analysis and customer-insights Zendesk cases
@github-actions
Copy link
Copy Markdown

Failed to generate code suggestions for PR

@sharadregoti sharadregoti changed the title Portal B20/B10: Configure CORS how-to guide and CORS troubleshooting page Revamp Developer Portal: add: Configure CORS how-to guide and CORS troubleshooting page May 1, 2026
- Remove Tyk Classic API definition section; replace with a Note
  callout linking to the Classic CORS reference
- Promote Tyk OAS as the sole primary path for Gateway CORS config
- Convert bold-prefixed pseudo-steps to proper numbered list items
  with continuation content indented under each step
- Replace env var column in optional settings table with config keys
  (CORS.MaxAge, CORS.AllowCredentials) linked to their exact anchors
  in the configuration reference; remove PORTAL_CORS_DEBUG (not in
  config reference); correct default allowed methods to GET and POST
- Replace Kubernetes (Helm) tabs with Config file (JSON) tabs on all
  three Portal CORS steps
- Link PORTAL_CORS_ENABLE and PORTAL_CORS_ALLOWED_ORIGINS to their
  exact anchors in the configuration reference wherever they appear
  in prose and warning callouts
- Remove Type column from optional settings table
OEL confirmed: rs/cors v1.11.1 treats an empty AllowedOrigins slice as
allow-all (sets allowedOriginsAll=true). When PORTAL_CORS_ALLOWED_ORIGINS
is unset the Portal allows all origins — not "no origins" as previously
stated. Update both B20 and configuration.mdx to reflect actual behavior.
- Add sidebarTitle and keywords to frontmatter
- Link PORTAL_CORS_ENABLE, PORTAL_CORS_ALLOW_CREDENTIALS, and
  PORTAL_CORS_ALLOWED_ORIGINS in prose to their config reference anchors
- Replace em-dashes in all four accordion titles with restructured phrasing
Comment thread portal/how-to-guides/configure-cors.mdx Outdated
Comment thread portal/troubleshooting/cors-issues.mdx Outdated
Co-authored-by: Master <sharadregoti15@gmail.com>
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.

1 participant