CORSエラーの基本(別オリジン・ブラウザの制限・Access-Control-Allow-Origin・iframeとは別問題)
要点
ブラウザのJavaScriptから別オリジン(ドメイン・プロトコル・ポートが違う)のAPIを呼ぶと、相手のサーバーがAccess-Control-Allow-Originで許可していない限りブラウザが結果を読ませない。直すのは基本的にAPI側の設定か、自分のサーバー経由で呼ぶこと。ブラウザ側のコードだけで必ず解決できるものではない。iframeの表示可否は別問題。
何が起きているか
- オリジン = プロトコル+ドメイン+ポート(
https://example.com)。1つでも違えば別オリジン(https://api.example.com、http://example.comも別)。 - ブラウザは安全のため、あるサイトのJavaScriptが別オリジンの応答を読むことを制限している。
- 相手のサーバーが応答ヘッダーで
Access-Control-Allow-Origin: https://自サイトのように許可していれば読める。許可がないと Console に次のような赤いエラー:Access to fetch at '...' from origin '...' has been blocked by CORS policy - 送信方法やヘッダーによっては、本番の前に確認のリクエスト(OPTIONS、プリフライト)が送られ、その応答で許可されないと本体も送られない。
よくある誤解
- 「ブラウザ側のコードを直せば必ず解決する」わけではない。 許可するかどうかは相手(API側)のサーバーが決める。
mode: 'no-cors'にするとエラーは消えるが、応答の中身は読めない(解決ではない)。- サーバーから(PHP・curl)呼ぶと成功するのは、CORSがブラウザだけの制限だから。
解決の方向
| 状況 | 方向 |
|---|---|
| 自分が管理するAPI | API側で自サイトのオリジンを許可する設定を入れる(* で全部許可は、認証付きAPIでは避ける) |
| 外部サービスのAPI | そのサービスがブラウザからの利用を許可しているか確認。管理画面で許可ドメインを登録する方式もある |
| ブラウザからの利用が想定されていないAPI | 自分のサーバー(WordPressの処理など)経由で呼ぶ。秘密のキーもサーバー側に置ける(APIの実務の基本(GET/POST/PUT/PATCH/DELETE・JSON・ヘッダー・認証/トークン・レート制限・ページング・タイムアウト・リトライ)) |
iframe とは別問題
- iframe で別サイトを表示できるかどうかは、相手の
X-Frame-Options/ CSP の設定(外部サービスの組み込み方の違い(リンク・iframe・script埋め込み・ウィジェット・API)と自サイトCSSが効かない理由)。 - iframe の中身を自サイトのCSS・JSで触れないのは同一オリジンポリシー。
- CORS は「JavaScript で別オリジンのデータを取得して読む」ときの話。
エラーの確認場所は Console と Network(DevToolsのConsoleの見方(JavaScriptエラー・warning・CORS・404・外部script・フォーム/イベントが動かない)、DevToolsのNetworkタブの見方(HTTPステータス・CSS/JS/画像・API(Fetch/XHR)・読み込み時間・キャッシュ))。