100% ブラウザ内完結計算 • サーバーログ完全ゼロ • 即時実行
Curious Techie開発者ツールボックス
CORS9分で読める•日本語 Edition100% クライアントサイド実行

CORSと同一生成元ポリシー(SOP)の完全解説

Cross-Origin Resource Sharingの仕組み、プリフライトOPTIONSリクエスト、CORSエラーの原因と安全なAPI設定手法。

CT
Curious-Techie Engineering Team認証著者

Web Protocols & Security Architecture Research

公開日:
•
更新日:
•9分で読める
査読者: Curious-Techie Architecture Peer Review Group
主要な疑問 • 即時アーキテクチャ回答

CORSと同一生成元ポリシー(SOP)の完全解説

TL;DR — 設計・エンジニアリングの要点

  • 同一生成元ポリシー(SOP)は、スキーム・ホスト・ポートが異なるオリジンからのデータ読み取りを制限します。
  • CORSは、サーバー側がHTTPヘッダーを用いて特定の外部オリジンにアクセスを許可するための規格です。
  • 非単純リクエストでは、ブラウザが事前に OPTIONS プリフライトリクエストを送信して安全性を確認します。
  • 認証クッキーやヘッダーを含む通信では、ワイルドカード Access-Control-Allow-Origin: * はブラウザによって拒否されます。
  • CORSはブラウザが強制するセキュリティ機能であり、サーバー間通信(cURL等)には適用されません。
// 基本概念

中核概念とアーキテクチャ構造

Same-Origin Policy (SOP)

Boundary

The baseline security boundary isolating origins from reading each other’s DOM and network response payloads.

Preflight Request

Handshake

An automatic HTTP `OPTIONS` probe dispatched by the browser before the actual request to verify permissions.

Simple Request

Optimization

Requests utilizing standard methods (GET, HEAD, POST) with standard headers (Accept, Content-Type: text/plain, form-urlencoded, multipart) that bypass preflight.

Credentialed Requests

Auth

Requests sending HTTP cookies, TLS client certificates, or Authorization headers across origins.

Exposed Headers

Headers

Custom server headers (`Access-Control-Expose-Headers`) that the browser allows frontend JavaScript to read.

処理プロセス • 実行シーケンス

CORSと同一生成元ポリシー(SOP)の完全解説の動作原理と仕組み

直接の回答:

When JavaScript triggers a fetch request to a different origin, the browser evaluates whether the request is "simple" or "complex". If complex (e.g., custom headers or JSON content-type), the browser automatically dispatches an `OPTIONS` preflight request with `Origin`, `Access-Control-Request-Method`, and `Access-Control-Request-Headers`. If the server responds with matching `Access-Control-Allow-*` headers, the browser fires the actual request. If not, the browser blocks the response from frontend JS.

1

Origin Check

Browser identifies target URL origin differs from window.location origin.

Fetch from https://app.com -> https://api.com:443
2

Preflight OPTIONS Dispatch

Browser sends HTTP OPTIONS probe with requested method and headers.

OPTIONS /api/data HTTP/1.1
Origin: https://app.com
Access-Control-Request-Method: POST
Access-Control-Request-Headers: content-type, authorization
3

Server Header Validation

Server inspects Origin, checks authorized list, and returns approval headers.

HTTP/1.1 204 No Content
Access-Control-Allow-Origin: https://app.com
Access-Control-Allow-Methods: POST, GET, OPTIONS
Access-Control-Allow-Headers: Content-Type, Authorization
Access-Control-Max-Age: 86400
4

Actual Request Execution

Browser verifies preflight response matches, then transmits actual POST request.

POST /api/data HTTP/1.1
Origin: https://app.com
Content-Type: application/json

{"data": "payload"}
5

Payload Delivery

Server returns response; browser checks `Access-Control-Allow-Origin` and delivers data to JS Promise.

const response = await fetch(...); // Promise resolves!
実装コード例 • ベストプラクティス

CORSと同一生成元ポリシー(SOP)の完全解説の実務における実装方法

Complete Production Express.js CORS Middleware Implementation

javascript
import cors from "cors";
import express from "express";

const app = express();

const allowedOrigins = [
  "https://curious-techie.com",
  "https://staging.curious-techie.com",
];

const corsOptions = {
  origin: (origin, callback) => {
    // Allow requests with no origin (e.g. mobile apps or server-to-server)
    if (!origin || allowedOrigins.includes(origin)) {
      callback(null, true);
    } else {
      callback(new Error("Blocked by CORS policy"));
    }
  },
  methods: ["GET", "POST", "PUT", "DELETE", "PATCH", "OPTIONS"],
  allowedHeaders: ["Content-Type", "Authorization", "X-Requested-With"],
  exposedHeaders: ["X-Total-Count", "Content-Disposition"],
  credentials: true,
  maxAge: 86400, // Cache preflight for 24 hours
};

app.use(cors(corsOptions));

エンジニアリング詳細: Dynamic origin validation allowing credentialed requests without unsafe wildcards, with preflight caching for 24 hours.

Configuring Native Nginx CORS Response Headers

nginx
location /api/ {
    if ($request_method = 'OPTIONS') {
        add_header 'Access-Control-Allow-Origin' '$http_origin' always;
        add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS, PUT, DELETE' always;
        add_header 'Access-Control-Allow-Headers' 'Authorization, Content-Type, Accept' always;
        add_header 'Access-Control-Allow-Credentials' 'true' always;
        add_header 'Access-Control-Max-Age' 86400 always;
        add_header 'Content-Length' 0;
        add_header 'Content-Type' 'text/plain charset=UTF-8';
        return 204;
    }

    add_header 'Access-Control-Allow-Origin' '$http_origin' always;
    add_header 'Access-Control-Allow-Credentials' 'true' always;
    proxy_pass http://backend_upstream;
}

エンジニアリング詳細: Handles OPTIONS preflight calls directly at Nginx edge layer with HTTP 204 No Content, reducing backend load.

本番環境アーキテクチャ • 実用ケース

本番環境でのCORSと同一生成元ポリシー(SOP)の完全解説の適用理由と構成

Decoupled JAMstack Frontend with Independent API Gateway

Next.js frontend hosted on Vercel (`app.curious-techie.com`) calling a Go backend on AWS (`api.curious-techie.com`).

Subdomain crossing constitutes a cross-origin call; the Go backend returns explicit CORS headers allowing the frontend origin.

Third-Party SaaS Embeddable Widgets

Chat widget or analytics SDK installed on thousands of customer websites.

API server must return `Access-Control-Allow-Origin: *` since requests originate from arbitrary customer hostnames.

アンチパターンと回避策

CORSと同一生成元ポリシー(SOP)の完全解説でよくある設計上の過ちと誤解

アンチパターン: Returning `Access-Control-Allow-Origin: *` alongside `Access-Control-Allow-Credentials: true`

影響: Browsers strictly reject this combination for security; cross-origin call fails with fatal console error.

推奨される修正策: Dynamically reflect the verified client `Origin` header value instead of the `*` wildcard when credentials are required.

アンチパターン: Thinking CORS is a backend security firewall preventing scraping or hacking

影響: Attackers bypass CORS completely using cURL, Python scripts, or mobile apps since non-browser clients ignore CORS.

推奨される修正策: Enforce real backend authentication (JWTs, session tokens, rate limiting) rather than relying on CORS for security.

アンチパターン: Failing to handle the HTTP `OPTIONS` method on the server routing table

影響: Server returns 404 or 405 to the preflight probe; actual POST/PUT request is never allowed to fire.

推奨される修正策: Ensure your server framework or API gateway explicitly responds to `OPTIONS` with status 200 or 204.

脅威モデル分析 • 攻撃ベクトル

CORSと同一生成元ポリシー(SOP)の完全解説のセキュリティ上のリスクと脆弱性

Overly Permissive Cross-Origin Data Exfiltration

CWE-942 Permissive Cross-Domain Policy with Untrusted Domains

脆弱性: Server blindly reflects any incoming `Origin` header back into `Access-Control-Allow-Origin` with `credentials: true`.

防御・緩和策: Validate incoming Origin headers against an explicit, strict allowlist of authorized company domains.

Internal Network Pivot via CORS

CWE-346 Origin Validation Error

脆弱性: Intranet server (e.g. `http://192.168.1.1`) responds with permissive CORS; malicious internet site uses visitor browser to read internal data.

防御・緩和策: Implement Private Network Access (PNA) checks; restrict intranet APIs to local authentication tokens.
診断ワークフロー • 根本原因解決

CORSと同一生成元ポリシー(SOP)の完全解説のエラー診断とトラブルシューティング

発生症状とエラーの兆候: Console Error: "No 'Access-Control-Allow-Origin' header is present on the requested resource"

根本原因の技術的分析:
  • Server threw an unhandled 500 exception before CORS middleware ran
  • CORS middleware placed after route handlers
本番環境検証済み修正手順: Mount CORS middleware at the very top of server middleware stack before routes; check server exception logs for 500 errors.

発生症状とエラーの兆候: Custom response headers cannot be read via `response.headers.get()` in JavaScript

根本原因の技術的分析:
  • Server omitted `Access-Control-Expose-Headers` for custom headers
本番環境検証済み修正手順: Include `Access-Control-Expose-Headers: X-Custom-Header, X-Total-Count` in the server response headers.
技術ナレッジベース • 即時回答

CORSと同一生成元ポリシー(SOP)の完全解説に関するよくある質問

Q:Why does CORS only happen in browsers and not in Postman or cURL?

直接の回答:CORS is a browser-enforced security mechanism designed to protect users from malicious websites using their browser session credentials. CLI tools like cURL do not execute untrusted foreign code, so they ignore CORS.

In a browser, you might visit `evil.com` while logged into `yourbank.com`. Without SOP and CORS, JavaScript on `evil.com` could fetch data from `yourbank.com` using your browser session cookies. Postman doesn’t have this security hazard.

Q:What is a Preflight request and when is it triggered?

直接の回答:A preflight request is an automated HTTP OPTIONS request sent by the browser before the real request. It is triggered whenever a request uses methods other than GET/HEAD/POST, sets custom headers (like Authorization), or uses non-standard Content-Types (like application/json).

The preflight allows the server to verify that it understands the method and headers before any payload data is processed on the backend.

セクション 12 • 対話型ユーティリティ

おすすめの関連開発者ツール

100% クライアントサイド実行

Companion Interactive Tool100% Client-Side Execution

Test & Verify with CORS Checker & Builder

Validate and generate secure Cross-Origin Resource Sharing (CORS) headers.

Companion Interactive Tool100% Client-Side Execution

Test & Verify with HTTP Header Analyzer

Analyze raw or live HTTP response headers for caching and architecture.

Companion Interactive Tool100% Client-Side Execution

Test & Verify with Security Headers Checker

Audit HSTS, CSP, X-Frame-Options, and OWASP recommended web headers.

用語集

Origin
The unique combination of protocol, hostname, and port number.
Preflight
An HTTP OPTIONS request sent before the actual request to verify that the server permits it.
SOP
Same-Origin Policy: Browser security rule preventing scripts on one origin from accessing data on another.
Authoritative Sourcing & Verification

References & Primary Sources

Every source below directly substantiates technical statements and protocol behaviors explained in CORSと同一生成元ポリシー(SOP)の完全解説. Curious-Techie prioritizes official Internet standards (IETF RFCs, W3C Recommendations, WHATWG specifications) and established security bodies (OWASP, NIST). Zero sponsored or secondary links.

  1. [1]WHATWGPrimary SpecificationWHATWG Fetch • § 3.2 HTTP-network-fetch
    Verified Primary Source
    Technical Claim Supported:

    Defines the normative browser CORS protocol, preflight cache validation (Access-Control-Max-Age), and the prohibition of wildcard Access-Control-Allow-Origin: * when Access-Control-Allow-Credentials is true.

    “For a CORS request with credentials, the server cannot specify a wildcard for Access-Control-Allow-Origin. It must specify an explicit origin.”
  2. [2]IETFPrimary SpecificationRFC 9110 • § 9.2.1
    Verified Primary Source
    Technical Claim Supported:

    Specifies that the Origin request header indicates the scheme, host, and port of the originating context and must not be altered by user-agent JavaScript.

  3. [3]OWASPAuthoritative Security StandardOWASP Cheat Sheet Series • Origin Validation & Credentials
    Verified Primary Source
    Technical Claim Supported:

    Documents the security risks of dynamic origin reflection without strict server-side allowlist verification (CORS misconfiguration vulnerabilities).

  4. [4]MDNDeveloper Authority (MDN)MDN Web Docs • CORS Preflight & Simple Requests
    Verified Primary Source
    Technical Claim Supported:

    Provides developer reference for simple requests vs. preflighted requests and safelisted headers (Accept, Accept-Language, Content-Language, Content-Type).