CORSの仕組み

エラーの解消に入る前に、なぜブラウザがこのような挙動をするのかを整理します。CORSの前提となるSame-Origin Policy、CORSが解決する範囲、そしてプリフライトリクエストの役割を順に確認します。

1. オリジンとは

CORSの話に入る前に、そもそもオリジン(Origin)が何を指すのかを押さえておきます。オリジンは、Webにおいてリソースの「出どころ」を識別する単位で、プロトコル・ホスト・ポートの3つの組み合わせで決まります。1つでも違うオリジンは別のオリジンとして扱われます。

URL オリジン
http://localhost:5173/index.html http://localhost:5173
http://localhost:8000/notes http://localhost:8000
https://example.com/api/users https://example.com
http://api.example.com/users http://api.example.com

先ほど体験したケースでは、フロントエンドはhttp://localhost:5173、APIはhttp://localhost:8000で、ポート番号が違うため別オリジンとして扱われます。Webブラウザは、この「オリジンが異なるかどうか」を基準にセキュリティ制約を適用します。

2. Same-Origin PolicyとCORS

Same-Origin Policy(同一オリジンポリシー)は、Webブラウザが「あるオリジンで読み込まれたページから、別のオリジンのリソースへ自由にアクセスできないようにする」ためのセキュリティ制約です。ここでのオリジンは、プロトコル・ホスト・ポートの3つの組み合わせで決まります。1つでも異なれば別オリジンとして扱われます。

ページのオリジン APIのオリジン 同一オリジンか
http://localhost:5173 http://localhost:5173/api 同一オリジンである
http://localhost:5173 http://localhost:8000 別オリジンである(ポートが違う)
http://example.com https://example.com 別オリジンである(プロトコルが違う)
http://example.com http://api.example.com 別オリジンである(ホストが違う)

Same-Origin Policyだけだと、別オリジンのAPIサーバをフロントエンドから呼び出す構成が成立しません。そこで、サーバ側から「このオリジンからのアクセスは許可します」と明示的に宣言できる仕組みが必要になります。それがCORS(Cross-Origin Resource Sharing)です。

CORSでは、サーバがレスポンスにAccess-Control-Allow-Originなどの専用ヘッダを付けることで、ブラウザに対して「このオリジンからのクロスオリジンリクエストは許可する」と伝えます。ブラウザはこのヘッダを見て、リクエスト結果のスクリプトへの受け渡しを許可するかどうかを判定します。

📝 CORSの詳細仕様
CORSの詳細な仕様は、Cross-Origin Resource Sharing (CORS)(MDN Web Docs)に記載があります。

3. 単純リクエストとプリフライトリクエスト

CORSは、リクエストの内容によって挙動が変わります。ブラウザから送られるクロスオリジンリクエストは、大きく単純リクエストとプリフライトが必要なリクエストの2種類に分かれます。

単純リクエストは、以下のような条件を満たすリクエストです。

  • メソッドがGET・HEAD・POSTのいずれか
  • Content-Typeがtext/plain・application/x-www-form-urlencoded・multipart/form-dataのいずれか
  • カスタムヘッダ(Authorizationなど)を付けていない

これらの条件に該当する場合、ブラウザはリクエストをそのまま送信し、レスポンスのAccess-Control-Allow-Originヘッダを見て許可判定を行います。先ほど体験したGET /notesは単純リクエストに該当し、レスポンスにAccess-Control-Allow-Originが無かったためブラウザがブロックしました。

プリフライトが必要なリクエストは、PUT・DELETE・Authorizationヘッダ付き・Content-Type: application/jsonなど、単純リクエストの条件から外れるリクエストです。これらは従来のHTMLフォームでは送信できない形式で、リソースの更新・削除といったサーバ側の状態を変える操作や、任意のヘッダを付けたリクエストが該当します。もしチェックなしでブラウザが送信を許してしまうと、悪意のあるサイトから許可なく送られたリクエストによってサーバ側のデータが書き換えられたり、認証情報付きのリクエストが偽装されたりする恐れがあります。

そこでブラウザは、本来のリクエストを送る前に、OPTIONSメソッドでプリフライトリクエストを送り、「これから送るメソッド・ヘッダは許可されているか」をサーバに問い合わせる形にしています。単純リクエストがCORS登場以前から送れていた(HTMLフォームで送れる範囲の)操作でそのまま送信を許すのに対し、これらのリクエストは「先に許可を取ってから送る」という一段強い制約を敷くことで、意図しないクロスオリジンの書き込み・認証利用を防いでいます。

サーバがプリフライトに対して許可を返せば、ブラウザは本来のリクエストを送信します。許可されないヘッダやメソッドが含まれていれば、本来のリクエスト自体が送信されずにブロックされます。

📝 CORSはブラウザの仕組み
CORSはあくまでブラウザが実装している安全装置であり、APIサーバ自体を保護するものではありません。curlやサーバ間の通信ではCORSヘッダの有無にかかわらずリクエストは通ります。APIサーバのアクセス制御は、CORSとは別に認証・認可の仕組みで守る必要があります。