CORS
別名: Cross-Origin Resource Sharing / クロスオリジン
ブラウザがあるオリジン(http(s) + ホスト + ポート)から別オリジンの API を呼び出すときに、サーバ側が許可ヘッダを返さないと弾く仕組み。
Same-Origin Policy の緩和ルール。
公開: 更新:
定義
CORS(Cross-Origin Resource Sharing) は、ブラウザがオリジンをまたぐリクエストを送る際に、サーバが Access-Control-Allow-Origin などのレスポンスヘッダで「許可」を明示することで通信を成立させる仕組みである。
標準は Fetch Spec の HTTP CORS protocol に定められている。
詳細
ブラウザは原則として Same-Origin Policy(同一オリジン制約)により、JS から別オリジンのレスポンスを読ませない。fetch("https://api.example.com/...") を別ドメインのページから叩くと、ブラウザはリクエストの種類によって扱いを分ける。
- 単純リクエスト(GET / HEAD / 一部の POST)では、リクエストを送りつつレスポンスを精査する。
- プリフライトが要るリクエスト(その他のメソッド・カスタムヘッダあり)では、先に
OPTIONSリクエストで事前許諾を確認する。
どちらの場合も、サーバが Access-Control-Allow-Origin: <呼び出し元> を返さなければ、ブラウザは JS にレスポンス本体を渡さない。
よくある誤解
- サーバにリクエストが届けば通信が成立する、というわけではない。
ブラウザがレスポンスを JS に渡さないだけで、サーバ自体は処理を実行する場合がある(POST が走ってしまうケースに注意)。 - CORS だけでセキュリティは守れない。
CORS は防御の最後の砦ではない。
本質的な認可は CSRF 対策・トークン検証など別レイヤで行う。 Access-Control-Allow-Origin: *を返しても、全部が解決するわけではない。
Cookie 認証(credentials: 'include')と*は同時に使えない。
明示的なオリジンを返す必要がある。
関連
サーバ側(Express / Nginx / API Gateway 等)で適切なヘッダを返す必要がある。
クライアント側で JS だけでは突破できない。