CORS Deployment Configuration

Architecture

CORS is configured via a two-layer model applied identically to every stack:

CDK_DOMAIN_NAME → auto-applied as https://{value} (always)
CDK_CORS_ORIGINS → additional global origins (optional, comma-separated)
Per-section CDK_*_CORS_ORIGINS → stack-specific extras (optional)

localhost is NEVER auto-included. Use CDK_CORS_ORIGINS=http://localhost:4200 for local dev.

The Helper

Every stack uses buildCorsOrigins(config, additionalOrigins?) from infrastructure/lib/config.ts. This returns a deduplicated string[].

// Container env var (Fargate / AgentCore Runtime)
CORS_ORIGINS: buildCorsOrigins(config, config.appApi.additionalCorsOrigins).join(','),

// S3 bucket CORS rule
cors: [{ allowedOrigins: buildCorsOrigins(config, config.fileUpload?.additionalCorsOrigins) }]

Config Derivation (config.ts)

CDK_DOMAIN_NAME → domainName → "https://{domainName}"  (always first)
CDK_CORS_ORIGINS → extraCorsOrigins                     (appended)
Result: config.corsOrigins = "https://{domainName},{extras}"

Both are joined into config.corsOrigins. The helper then splits, deduplicates, and optionally appends section extras.

Python Backend

Both app_api/main.py and inference_api/main.py read CORS_ORIGINS env var:

_cors_origins = os.environ.get("CORS_ORIGINS", "").split(",")

No hardcoded fallback. If CORS_ORIGINS is empty, no origins are allowed.

Workflow Requirements

CDK_DOMAIN_NAME and CDK_CORS_ORIGINS MUST be in the job-level env: block (not workflow-level) because they use vars.* which requires environment: on the job.

Every workflow that runs synth or deploy must include:

env:
  CDK_DOMAIN_NAME: ${{ vars.CDK_DOMAIN_NAME }}
  CDK_CORS_ORIGINS: ${{ vars.CDK_CORS_ORIGINS }}

Per-Section Config Interfaces

Every config section that consumes CORS has additionalCorsOrigins?: string:

AppApiConfig.additionalCorsOrigins
InferenceApiConfig.additionalCorsOrigins
FrontendConfig.additionalCorsOrigins
FileUploadConfig.additionalCorsOrigins
RagIngestionConfig.additionalCorsOrigins
AssistantsConfig.additionalCorsOrigins
FineTuningConfig.additionalCorsOrigins

Adding CORS to a New Stack

Import buildCorsOrigins from ./config
Call buildCorsOrigins(config, config.mySection.additionalCorsOrigins)
Add additionalCorsOrigins?: string to the section's config interface
Load it in loadConfig(): additionalCorsOrigins: process.env.CDK_MY_SECTION_CORS_ORIGINS || ...
Add CDK_DOMAIN_NAME and CDK_CORS_ORIGINS to the workflow job env
Add a test in infrastructure/test/cors.test.ts

Common Mistakes

Putting vars.* in workflow-level env: → resolves to empty string
Hardcoding http://localhost:4200 in buildCorsOrigins or Python fallback
Forgetting to add CDK_DOMAIN_NAME to a new workflow's synth/deploy jobs
Using config.domainName directly instead of buildCorsOrigins()
Setting corsOrigins in cdk.context.json (overrides domain derivation)

cors-deployment