CORS credentials — Cookie とワイルドカード

credentials: include で ACAO: * が拒否される理由をシミュレーション。Allow-Credentials とオリジン明示がセットな理由が分かります。

シナリオプリセット

リクエスト — ブラウザ(ページ)側

Method

Content-Type

カスタムヘッダー

レスポンス — サーバーが返すヘッダー

Access-Control-Allow-Origin

Access-Control-Allow-Methods

Access-Control-Allow-Headers

リクエストに必要なヘッダー+よく使う値 — クリックで切替

ブラウザの処理ステップ

→

ページから fetch リクエスト発生

•

単純リクエスト(CORS-safelisted)— プリフライトなしで直接送信

→

本リクエスト送信

GET /data HTTP/1.1
Origin: https://myapp.example.com
Content-Type: text/plain
Cookie: session=abc123
←

サーバーの本応答が到着

HTTP/1.1 200 OK
Access-Control-Allow-Origin: *
Access-Control-Allow-Credentials: true

{"status": "ok"}
✗

credentials リクエストに '*' は使えません

✗

ブラウザが応答をブロックし fetch を reject

ブラウザコンソール

✕ Access to fetch at 'https://api.example.com/data' from origin 'https://myapp.example.com' has been blocked by CORS policy: The value of the 'Access-Control-Allow-Origin' header in the response must not be the wildcard '*' when the request's credentials mode is 'include'.

(index):1

値を変えると下のステップが即座に再計算されます。「credentials + *」シナリオでワイルドカードがなぜ失敗するか確かめてみてください。

credentials: 'include' で Cookie・認証がクロスオリジンに乗るため、ブラウザは厳格になり ACAO: * を拒否します。ログイン中の応答を全サイトに開放できないためです。

通過には2つがセットです:サーバーが正確なオリジンを ACAO に書き(反映許可)、Allow-Credentials: true を返すこと。片方でも欠けると別の理由でブロックされます。

SameSite Cookie とも絡みます。クロスサイトで Cookie を送るには SameSite=None; Secure が必要で、CORS と Cookie 両方の設定が要ります。 CORS シミュレーター

よくある質問

ACAO を * のまま ACAC: true を足せば?
ダメです。credentials モードでは ACAC の有無に関係なく * は常に拒否されます。許可するオリジンを ACAO に反映させてください。
複数オリジンは ACAO にカンマで並べられる?
できません。単一値のみなので、サーバーが Origin をホワイトリストと照合して許可分だけ返します。

他のシナリオ