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とは別に認証・認可の仕組みで守る必要があります。 |