Basic認証付きのJSONをfetchできないときはcredentialsを確認する
作成日:2026.11.19
Basic認証を通過したページからJSONを取得できなかった原因は、fetchの credentials: 'omit' 指定でした。実際の修正例と検証結果をもとに、`omit`・`same-origin`・`include`の違い、取得先のオリジンやHTTP応答を確認する方法を紹介します。
目次
Basic認証をかけたページで、同じように認証が必要なJSONをfetchで取得できないことがありました。今回は、取得処理に指定していたcredentials: 'omit'を見直すことで取得できるようになりました。
修正ではincludeを使いましたが、同一オリジンならsame-originでも認証情報を利用できます。その違いも整理しておきます。
credentialsは認証情報を利用する範囲の指定
credentialsは、ブラウザーが保持するCookieやHTTP認証情報などをリクエストで利用するかを指定するオプションです。Basic認証もHTTP認証の一つです。
| 指定 | ブラウザーが保持する認証情報の扱い |
|---|---|
omit | 同一オリジンでも利用しない |
same-origin | 同一オリジンの場合に利用する。省略時の既定値 |
include | 別オリジンも含めて利用する。ただし、送信できる認証情報やブラウザーの制約による |
オリジンは、URLのスキーム・ホスト・ポートの組み合わせです。同じホストでも、HTTPとHTTPS、ポート番号が違うURLは別オリジンになります。
また、この指定だけでユーザー名やパスワードが用意されるわけではありません。以下は、ブラウザーでBasic認証を通過していて、対象のJSONにも再利用できる認証情報がある場合を前提にしています。実際のサイトで認証情報を送るときはHTTPSを使ってください。
同一オリジンのJSONならsame-originで取得する
問題になった処理では、次のようにomitを明示していました。
const response = await fetch(url, {
cache: 'no-cache',
credentials: 'omit',
});
これでは、ページ側でBasic認証を通過していても、その認証情報をJSONの取得に利用しません。同一オリジンへの取得なら、次のようにsame-originへ変更します。
async function fetchJson(url) {
const response = await fetch(url, {
cache: 'no-cache',
credentials: 'same-origin',
});
if (!response.ok) {
throw new Error(`HTTP ${response.status}`);
}
return response.json();
}
same-originは既定値なので、credentials自体を省略しても同じ指定になります。今回は、認証情報を利用する範囲が分かるよう明示しています。
cache: 'no-cache'はキャッシュの再検証に関する指定で、認証情報を送るための指定ではありません。また、fetchは401などのHTTPエラーでも通常はレスポンスを返すため、JSONとして読む前にresponse.okを確認しています。
実際の修正では、同一オリジンだけincludeにした
元の処理は外部のJSONも取得する共通関数だったため、実際の修正では取得先のオリジンを判定して、次のように分けました。変数名と整形は説明用にそろえています。
const sameOrigin = new URL(url, window.location.href).origin
=== window.location.origin;
const response = await fetch(url, {
cache: 'no-cache',
credentials: sameOrigin ? 'include' : 'omit',
});
この変更で、同一オリジンのJSONには認証情報を利用し、最初から別オリジンのURLを指定した場合はomitにする形になりました。
ただし、同一オリジンの取得で重要なのは、omitによる除外をやめたことです。今回の用途なら、先ほどのsame-originを使う方法も選べます。なお、上の分岐は最初のURLの判定なので、リダイレクト先まで常に同一オリジンに制限する処理ではありません。転送がある場合は、その行き先も確認してください。
開発者ツールで、指定と応答を比べる
自分の環境で確認するなら、Basic認証を通過したページの開発者ツールで、同じJSONに対する指定を比べてみます。次の./data/section.jsonは例なので、確認してよいJSONのパスへ置き換えてください。
(async () => {
const url = './data/section.json';
const modes = [undefined, 'omit', 'same-origin', 'include'];
const results = [];
for (const credentials of modes) {
const options = { cache: 'no-cache' };
if (credentials !== undefined) {
options.credentials = credentials;
}
try {
const response = await fetch(url, options);
results.push({
credentials: credentials ?? '(省略)',
status: response.status,
ok: response.ok,
redirected: response.redirected,
});
} catch (error) {
results.push({
credentials: credentials ?? '(省略)',
error: error.message,
});
}
}
console.table(results);
})();
切り分け用に、Windows 11・Google Chrome 157.0.8103.52のheadlessモード・Python 3.9.7のダミー認証サーバーで、認証済みページから同一オリジンのJSONを取得して比較しました。結果は次のとおりです。
| credentials | HTTPステータス | サーバーが受け取った認証情報 |
|---|---|---|
| 省略 | 200 | あり |
omit | 401 | なし |
same-origin | 200 | あり |
include | 200 | あり |
この比較はループバック上のHTTPとダミー認証情報によるものです。
Networkタブでは、JSONのリクエストに対するステータス、WWW-Authenticate、転送後のURL、レスポンス本文を確認します。認証エラーのHTMLをJSONとして読もうとして、JSON解析エラーとして見えている場合もあります。
認証情報の再利用にはパスやrealm、ブラウザーの認証状態も関係するため、同一オリジンであることだけで取得成功を保証できるわけではありません。includeにしても取得できない場合は、JSONのURLを直接開いたときの認証要求や、サーバーの設定も確認しましょう。
別オリジンの場合はCORSも関係します。includeでレスポンスを読み取るには、サーバー側で具体的な許可元を返すAccess-Control-Allow-Originと、Access-Control-Allow-Credentials: trueなどの条件を満たす必要があります。includeだけでCORS制限を回避できるわけではありません。
curlで認証前後のHTTP応答を確認する方法は、Basic認証付きURLにcurlでアクセスする記事でもまとめています。ただし、curlの成功だけではブラウザーの認証状態やCORSの確認にはなりません。
まずは取得先のURLと、credentials: 'omit'を明示していないかを確認するとよいかと思います。同一オリジンの認証情報を利用したいなら、same-originを基本に考えればOKです。
参考資料
奈良市を拠点に、27年以上の経験を持つフリーランスWebエンジニア、阿部辰也です。
これまで、ECサイトのバックエンド開発や業務効率化システム、公共施設の予約システムなど、多彩なプロジェクトを手がけ、企業様や制作会社様のパートナーとして信頼を築いてまいりました。
【制作会社・企業様向けサポート】
Webシステムの開発やサイト改善でお困りの際は、どうぞお気軽にご相談ください。小さな疑問から大規模プロジェクトまで、最適なご提案を心を込めてさせていただきます。
ぜひ、プロフィールやWeb制作会社様向け業務案内、一般企業様向け業務案内もご覧くださいね。
curlでBasic認証付きURLにアクセスする:パスワードの指定と401の確認
2026.11.15
curlの`-u`オプションでBasic認証付きURLへアクセスする方法を、WindowsのPowerShellで紹介します。パスワードの対話入力、認証前後の応答比較、HTTPステータスと終了コードの違い、認証情報やログを扱う際の注意点をまとめます。
Clipboard APIの落とし穴:localhost・HTTPS・ユーザー操作の違い
2026.09.16
navigator.clipboard.writeText()によるクリップボードへの自動コピーが、localhostでは動くのにLAN内IPのHTTPアクセスでは失敗する理由を、Secure Context、ユーザー操作、ブラウザ権限の観点から整理します。HTTPS化の考え方、JavaScriptによる確認方法、失敗時に手動コピーへ切り替える実装例、document.execCommand('copy')を使う場合の注意点も紹介します。
自動取得後の大量データ確認を一日半から2時間に短縮した、ワークキュー型UIの設計
2026.09.12
自動取得後の大量データの確認・補正作業を題材に、管理画面をワークキュー型UIへ改善した事例を紹介します。少数件のキュー、自動補充、解決済み項目の非入力化、例外の別レーン化、unknown_resultや楽観的ロックなど、人間が大量データを安全かつ効率的に処理するための設計をまとめます。
ViteのJavaScriptチャンクサイズ警告が出たときの判断基準:コード分割・閾値変更・現状維持
2026.09.08
ViteのビルドでJavaScriptチャンクサイズ警告が出たときに、ビルドエラーとの違い、非圧縮サイズとgzipサイズの見方、静的importによるチャンク肥大化の原因を整理する。動的importや依存ライブラリの見直し、警告閾値の変更、現状維持について、一般ユーザー向けサービス・社内管理画面・自分専用の管理画面ごとの判断基準と本番運用上の注意点を紹介する。