CORS(クロスオリジンリソースシェアリング) こーす(くろすおりじんりそーすしぇありんぐ)
簡単に言うとこんな感じ!
「別のサイトから勝手にデータを取りに来ていいの?」というブラウザの門番ルールだよ。たとえばあなたのサイト(example.com)が別のサーバー(api.other.com)にデータを取りに行こうとしたとき、ブラウザが「ちょっと待って、許可もらってる?」って確認するのがCORSなんだ。許可がなければブロック、あれば通過ってこと!
CORSとは
CORS(Cross-Origin Resource Sharing/クロスオリジンリソースシェアリング) とは、Webブラウザが「異なるオリジン(出所)からのリソース取得を制御する」仕組みのことです。ブラウザには Same-Origin Policy(同一オリジンポリシー) というセキュリティルールがあり、デフォルトでは「自分と同じオリジン(プロトコル+ドメイン+ポート番号の組み合わせ)以外へのリクエスト」をブロックします。CORSはその制限を「条件付きで緩和する」ための公式な方法です。
たとえば、フロントエンドが https://shop.example.com で動いていて、バックエンドAPIが https://api.example.com にある場合、サブドメインが違うだけで「別オリジン」扱いになります。この場合、APIサーバー側がCORSの 許可ヘッダー を返さないと、ブラウザはデータを受け取ってくれません。
CORSのポイントは「制限しているのはブラウザ」という点です。curlやサーバー間通信ではCORSは関係なく、あくまでWebブラウザ上のJavaScriptからのリクエストに対して働くルールです。
オリジンとは何か
「オリジン」は3つの要素の組み合わせで決まります。1つでも違えば「別オリジン(クロスオリジン)」です。
| 要素 | 例 | 備考 |
|---|---|---|
| プロトコル | https:// / http:// | httpとhttpsは別オリジン |
| ドメイン | example.com / api.example.com | サブドメインが違えば別オリジン |
| ポート番号 | :443 / :3000 | ポートが違えば別オリジン |
同一オリジン vs クロスオリジンの例
| URLの組み合わせ | 同一 or 別? | 理由 |
|---|---|---|
https://example.com → https://example.com/api | ✅ 同一 | すべて一致 |
https://example.com → http://example.com | ❌ 別 | プロトコルが違う |
https://example.com → https://api.example.com | ❌ 別 | サブドメインが違う |
https://example.com → https://example.com:3000 | ❌ 別 | ポートが違う |
覚え方
「プロドポ(プロトコル・ドメイン・ポート)が3つ揃って同一オリジン!」 — プロドポが1つでも違えばクロスオリジンと覚えましょう。
CORSの仕組み:プリフライトリクエスト
CORSには シンプルリクエスト と プリフライトリクエスト の2種類の流れがあります。
| 種別 | 発生条件 | 流れ |
|---|---|---|
| シンプルリクエスト | GET/POST(特定の条件下)・ヘッダーが標準的な場合 | リクエスト → レスポンスにCORSヘッダーがあればOK |
| プリフライトリクエスト | PUT/DELETE・カスタムヘッダー・JSON送信など | 事前確認(OPTIONS)→ 本リクエスト、の2段階 |
プリフライトとは「本命リクエストの前にOPTIONSメソッドで事前確認する」仕組みです。空港のセキュリティチェックのようなもので、まず「こういうリクエストを送っていいですか?」と聞き、サーバーが「いいよ」と返して初めて本リクエストを送ります。
主要なCORSヘッダー一覧
CORSはHTTPヘッダーのやり取りで制御されます。サーバーが返すべき主なヘッダーは以下の通りです。
| ヘッダー名 | 役割 | 設定例 |
|---|---|---|
Access-Control-Allow-Origin | どのオリジンを許可するか | https://shop.example.com または *(全許可) |
Access-Control-Allow-Methods | 許可するHTTPメソッド | GET, POST, PUT, DELETE |
Access-Control-Allow-Headers | 許可するリクエストヘッダー | Content-Type, Authorization |
Access-Control-Allow-Credentials | Cookie・認証情報の送信を許可するか | true |
Access-Control-Max-Age | プリフライト結果のキャッシュ時間(秒) | 86400(24時間) |
⚠️
*(ワイルドカード)は危険な場合がある:Access-Control-Allow-Origin: *はすべてのオリジンを許可するため、社内システムや認証が必要なAPIには使わないこと。特にAccess-Control-Allow-Credentials: trueと組み合わせることはできません。
歴史と背景
- 1990年代後半〜2000年代初頭:XMLHttpRequest(Ajax)が登場。ブラウザから非同期でデータを取得できるようになり、別サーバーへのリクエスト問題が顕在化
- 2004年頃:Same-Origin Policyによるセキュリティ問題が議論され始め、
<script>タグを使った「JSONP」という回避策が広まる(セキュリティ上の問題あり) - 2006年:W3CがCORSの仕様策定を開始
- 2009年〜2010年:主要ブラウザ(Firefox 3.5、Safari 4、Chrome)がCORSを実装し始める
- 2014年:W3Cが CORS仕様を正式勧告(Recommendation)として公開
- 2018年〜現在:Fetch Standardに統合。現代のSPA(シングルページアプリケーション)やモバイルアプリのバックエンドAPIにとって必須の知識となる
CORSエラーの対処法と設定例
CORSエラーはほぼ100%「サーバー側の設定不足」が原因です。フロントエンド側でできることはほとんどありません。
サーバー側の設定例(Node.js / Express)
// corsパッケージを使う場合
const cors = require('cors');
app.use(cors({
origin: 'https://shop.example.com', // 許可するオリジンを明示
methods: ['GET', 'POST', 'PUT'],
allowedHeaders: ['Content-Type', 'Authorization'],
credentials: true,
}));
よくあるCORSエラーと原因
| エラーメッセージ | 原因 | 対処法 |
|---|---|---|
No 'Access-Control-Allow-Origin' header | サーバーがCORSヘッダーを返していない | サーバー設定を追加 |
The value of 'Access-Control-Allow-Origin' header is * with credentials | *とcredentials:trueの同時使用 | オリジンを明示指定する |
プリフライトで 405 Method Not Allowed | OPTIONSメソッドを処理していない | OPTIONSを許可するルーティングを追加 |
開発時の一時回避策(本番環境では使わないこと)
# ローカル開発時にプロキシ経由でCORSを回避する(create-react-appの例)
# package.json に以下を追加
"proxy": "http://localhost:3001"
関連する規格・RFC
| 規格・RFC番号 | 内容 |
|---|---|
| RFC 6454 | Web オリジンの概念(The Web Origin Concept)の定義 |
| Fetch Living Standard | CORSを含むFetchの現行仕様(WHATWGが管理) |
関連用語
- Same-Origin Policy — ブラウザが別オリジンへのアクセスをデフォルトでブロックするセキュリティルール
- HTTP ヘッダー — HTTPリクエスト・レスポンスに付加されるメタ情報
- REST API — URLとHTTPメソッドを使ってリソースを操作するAPI設計スタイル
- プリフライトリクエスト — CORS で本リクエストの前にOPTIONSメソッドで事前確認する仕組み
- JSONP — CORSが普及する前に使われていたクロスオリジン通信の回避策
- CSP(コンテンツセキュリティポリシー) — Webページが読み込めるリソースの出所を制限するセキュリティ機能
- 認証トークン(Bearer Token) — APIへのアクセス権を証明するトークン。CORSのcredentials設定と関係する
- SPA(シングルページアプリケーション) — フロントエンドとAPIサーバーが分離する構成でCORSが必須になるアーキテクチャ