API設計

CORS(クロスオリジンリソースシェアリング) こーす(くろすおりじんりそーすしぇありんぐ)

オリジンSame-Origin PolicyプリフライトリクエストHTTPヘッダーセキュリティAPI
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メソッドで事前確認する」仕組みです。空港のセキュリティチェックのようなもので、まず「こういうリクエストを送っていいですか?」と聞き、サーバーが「いいよ」と返して初めて本リクエストを送ります。

ブラウザ (フロントエンド) APIサーバー (別オリジン) ① プリフライトリクエスト(事前確認) OPTIONS /api/data Origin: https://shop.example.com Access-Control-Request-Method: POST ② プリフライトレスポンス(許可) 204 No Content Access-Control-Allow-Origin: https://shop.example.com Access-Control-Allow-Methods: POST ③ 本リクエスト → レスポンス(実際のデータ取得) POST /api/data → 200 OK + Access-Control-Allow-Origin: https://shop.example.com

主要な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-CredentialsCookie・認証情報の送信を許可するか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 AllowedOPTIONSメソッドを処理していないOPTIONSを許可するルーティングを追加

開発時の一時回避策(本番環境では使わないこと)

# ローカル開発時にプロキシ経由でCORSを回避する(create-react-appの例)
# package.json に以下を追加
"proxy": "http://localhost:3001"

関連する規格・RFC

規格・RFC番号内容
RFC 6454Web オリジンの概念(The Web Origin Concept)の定義
Fetch Living StandardCORSを含む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が必須になるアーキテクチャ

シス担のミカタ メールマガジン

セキュリティの速報とシステムの最新情報をメールで受け取る

登録すると、次の配信からお届けします。配信はメールの下のリンクから、いつでも解除できます。個人情報の取り扱い