cors-tester

Test, debug, and generate CORS configurations from the command line.

Quick Start

# Test CORS headers on a URL
python3 scripts/cors_tester.py test https://api.example.com/data --origin https://myapp.com

# Test preflight (OPTIONS) request
python3 scripts/cors_tester.py preflight https://api.example.com/data --origin https://myapp.com --method POST --header "Content-Type"

# Generate CORS config for a framework
python3 scripts/cors_tester.py config --framework nginx --origins "https://myapp.com,https://staging.myapp.com" --methods "GET,POST,PUT,DELETE"

# Audit CORS security
python3 scripts/cors_tester.py audit https://api.example.com/data

Commands

test

Send a request with an Origin header and inspect the CORS response headers.

python3 scripts/cors_tester.py test \x3Curl> --origin \x3Corigin> [--method GET]

Options:

• --origin \x3Curl> — Origin to test (required)
• --method \x3Cmethod> — HTTP method (default: GET)
• --verbose — Show all response headers

Output shows:

• Access-Control-Allow-Origin — Whether the origin is allowed
• Access-Control-Allow-Credentials — Whether credentials are supported
• Access-Control-Expose-Headers — Which headers are exposed

preflight

Send an OPTIONS preflight request to test if a cross-origin request would be allowed.

python3 scripts/cors_tester.py preflight \x3Curl> --origin \x3Corigin> [--method POST] [--header Content-Type]

Options:

• --origin \x3Curl> — Origin to test (required)
• --method \x3Cmethod> — Method to request (default: POST)
• --header \x3Cname> — Custom header to request (repeatable)

Output shows:

• Access-Control-Allow-Methods — Allowed methods
• Access-Control-Allow-Headers — Allowed headers
• Access-Control-Max-Age — Preflight cache duration

audit

Check a URL for common CORS misconfigurations and security issues.

python3 scripts/cors_tester.py audit \x3Curl>

Checks for:

• Wildcard origin (*) with credentials
• Origin reflection (server echoes any origin back)
• Missing Vary: Origin header
• Overly permissive allowed methods
• Missing preflight cache (Access-Control-Max-Age)

config

Generate CORS configuration snippets for common frameworks.

python3 scripts/cors_tester.py config --framework \x3Cname> --origins \x3Corigins> [--methods \x3Cmethods>] [--headers \x3Cheaders>] [--credentials]

Options:

• --framework \x3Cname> — Target: nginx, apache, express, flask, fastapi, rails
• --origins \x3Ccsv> — Comma-separated allowed origins
• --methods \x3Ccsv> — Comma-separated methods (default: GET,POST,OPTIONS)
• --headers \x3Ccsv> — Comma-separated allowed headers (default: Content-Type,Authorization)
• --credentials — Allow credentials
• --max-age \x3Cseconds> — Preflight cache (default: 86400)