CORS ヘッダー不許可 — Allow-Headers

'Request header field x-auth-token is not allowed' の原因と Allow-Headers の設定法をシミュレーションで確認。

シナリオプリセット

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

Method

Content-Type

カスタムヘッダー

Access-Control-Request-Headers: content-type, x-auth-token

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

Access-Control-Allow-Origin

Access-Control-Allow-Methods

Access-Control-Allow-Headers

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

ブラウザの処理ステップ

→

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

•

単純リクエストではない — OPTIONS プリフライトが必要

→

OPTIONS プリフライト送信

OPTIONS /data HTTP/1.1
Origin: https://myapp.example.com
Access-Control-Request-Method: POST
Access-Control-Request-Headers: content-type, x-auth-token
←

サーバーのプリフライト応答が到着

HTTP/1.1 204 No Content
Access-Control-Allow-Origin: https://myapp.example.com
Access-Control-Allow-Methods: GET, POST, PUT
Access-Control-Allow-Headers: content-type
✓

Allow-Origin がオリジンと一致 — 通過

✓

メソッドが Allow-Methods に含まれる — 通過

✗

リクエストヘッダーが Allow-Headers に含まれないx-auth-token

—

credentials 未使用 — 検査スキップ

✗

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

ブラウザコンソール

✕ Access to fetch at 'https://api.example.com/data' from origin 'https://myapp.example.com' has been blocked by CORS policy: Request header field content-type is not allowed by Access-Control-Allow-Headers in preflight response.

(index):1

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

Authorization・X-Api-Key のようなカスタムヘッダーや application/json Content-Type は safelist 外で、プリフライトの ACRH に乗ります。Allow-Headers が全部をカバーしなければ 'header field X is not allowed' でブロックされます。

落とし穴は大文字小文字ではなく漏れです — content-type 自体も許可リストに必要だと見落としがちです。authorization だけ書いて content-type が抜けると失敗します。 CORS シミュレーター

よくある質問

Authorization も Allow-Headers に必要?
はい、safelist 外なので必要です。JWT API なら content-type, authorization の両方が一般的です。
Allow-Headers に * は使える?
credentials なしなら概ね可。credentials では明示リストが確実です。

他のシナリオ