401と403:拒否するリクエストに正しいステータスを選ぶ
401と403の違い
401と403:UnauthorizedかForbiddenか、どちらを返すべきか | We.Inc
401は認証されていないこと、403は認証済みだが許可されていないことを意味します。リクエストについて4つの質問に答えると、正しいステータスとヘッダー、コードがわかります。
トークンがない、セッションが期限切れ、署名が不正など、リクエストに有効な認証情報がない場合は401 Unauthorizedを返します。ログインすれば解決する可能性があり、レスポンスにはWWW-Authenticateヘッダーが必須です。呼び出し元が誰かわかっていて、それでもその操作が許されない場合は403 Forbiddenを返します。再ログインしても何も変わりません。
UnauthorizedとForbiddenの違い
- 401 Unauthorized
- 403 Forbidden
- 本当の意味
- 認証されていない
- 許可されていない
- ログインで解決するか
- はい
- いいえ
- 必須のヘッダー
- WWW-Authenticate
- 必須なし
- よくある原因
- トークンやセッションがない、または期限切れ
- ロールや所有者のチェックに失敗
- クライアントがすべきこと
- ログインするかトークンを更新して再試行する
- 中止して、アクセスに関するメッセージを表示する
サーバーが拒否しているリクエストについて、4つの質問に答えてください。返すべきステータス、それに付けるヘッダー、コードコメントに書ける1行の理由が表示されます。リソースの存在自体を明かしたくない場合にも対応しています。
- リクエストに認証情報が少しでも含まれていたかを答えます。
- その認証情報が正しかったかを答えます。
- この呼び出し元に、このリソースに対するこの操作の権限があるかを答えます。
- アクセス権のない呼び出し元に、リソースの存在を隠すべきかを決めます。
- Unauthorizedという名前は歴史的な間違いです。401は認証(あなたが誰か)、403は認可(何をしてよいか)に関するものです。
- シングルページアプリでは、401はトークンの更新やログイン画面表示のきっかけとして、403はログインしても解決できないことを伝えるメッセージとして扱いましょう。
- 他の顧客の請求書IDのように、存在自体が機密となる非公開リソースには、403ではなく404を使いましょう。
- 403はユーザーIDと失敗した権限と一緒にログに残しましょう。設定を誤ったロールを見つける最も早い方法です。
よくある質問
401と403の主な違いは何ですか?
401は、サーバーがあなたを誰か知らない、または送った証明を受け入れなかったことを示します。403は、誰かはわかっているが、それでも答えはノーであることを示します。
401にはWWW-Authenticateヘッダーが必須ですか?
はい。RFC 9110によると、401レスポンスを生成するサーバーは、トークンAPIならBearerのようなチャレンジを含むWWW-Authenticateヘッダーフィールドを少なくとも1つ送らなければなりません。
期限切れのトークンには401と403のどちらを返すべきですか?
401です。認証情報はもう有効ではなく、新しいものなら解決します。Bearerチャレンジでerror="invalid_token"を付けてそれを伝えられます。
403の代わりに404を返してもよいですか?
はい。仕様では、リソースが存在するかどうかを隠すために、403の代わりに404を送ることが認められています。他のユーザーに属するIDではよく使われる選択です。
403はIPアドレスがブロックされたという意味ですか?
その可能性はあります。サーバーは、IPルール、ファイル権限の不足、ファイアウォールのルール、ロールのチェック失敗など、そのリクエストに対して最終的と判断したあらゆる拒否で403を送ります。どれかは、たいていレスポンス本文かサーバーログに書かれています。
2つの異なる問い
- 保護されたリクエストは、2つの問いに順番に答えます。誰が呼び出しているのか。これが認証で、失敗すると401になります。この呼び出し元にこの操作が許されているか。これが認可で、失敗すると403になります。
- 両者を分けておくとクライアントが助かります。401は、フロントエンドにユーザーをログインへ案内するよう伝えます。403は、再ログインしても無駄で、代わりにアクセスに関するメッセージを表示すべきだと伝えます。
仕様が補足していること
- すでに認証情報を含んでいたリクエストが401を受けた場合、サーバーはその認証情報を拒否したと伝えています。403の場合、サーバーは本文で理由を説明してもよいし、何も言わなくても構いません。
コードでのチェック
Expressのミドルウェア:先に401、次に403
verifyTokenは、自分のセッションやJWTのチェックの代わりです。順序が重要で、まず認証、次に認可です。
フロントエンド:それぞれに異なる対応をする
一方の処理はユーザーをログインへ案内し、もう一方は拒否の理由を説明します。
どのステータスを返すべき?
はい
いいえ
リクエストに認証情報(セッションCookie、トークン、Authorizationヘッダー)が含まれていましたか?
その認証情報は有効で、期限切れではありませんでしたか?
この呼び出し元は、このリソースに対してこの操作を行うことが許可されていますか?
アクセス権のない呼び出し元に、リソースの存在を知られないようにすべきですか?
返すもの
誰もログインしていません。チャレンジを付けて認証情報を求めましょう。
認証情報は届きましたが、拒否されました。新しいものなら解決します。
呼び出し元はわかっていますが、権限がありません。再ログインしても解決しません。
呼び出し元には権限がなく、リソースの存在を明かさないほうが望ましい状況です。
認証済みで、許可もあります。リクエストを処理しましょう。
前の回答ですでにステータスが決まったため、質問していません。
無料トライアルを始める · 7日間の無料トライアル、本日$0
関連: ガイド|Webマーケティングと集客を学ぶ
- 404ページのデザイン例:コピーして使える20例
- カゴ落ちメールの例文とテンプレート
- カゴ落ちSMSメッセージ:テンプレートと同意ルール
- 会社概要ページの例:小規模事業者向け6選
- Webサイトで決済を受け付ける方法
- 小規模事業者向けADAウェブアクセシビリティガイド(2026年版)
- ビジネス向け AI エージェント:任せられる仕事と人が担う判断
- AIエージェントとエージェンティックAIの違いとは?
製品
- AI ホームページ作成ツール:作りたいサイトを普段の言葉で伝えるだけで、数分で公開
- ホワイトラベル プラットフォーム:自社ブランド、自社ドメイン、自社の利益で運営
- エンタープライズ:SSO、個別の SLA、専任サポート
- 開発者向け API:自社の SaaS にサイト生成機能を組み込み
ご利用いただける方
- 制作会社・代理店向け:自社ブランドで再販
- フリーランス向け:自分ブランドのビルダーを持つ
- ホスティング事業者向け:サービスにビルダーを追加
- SaaS プラットフォーム向け:API でサイト作成を組み込み
- スタートアップ向け
- 金融サービス向け
- 医療・ヘルスケア向け
機能
リソース
- ブログ
- ヘルプセンター
- 無料ビジネスツール
- ホームページ テンプレート
- テンプレート集
- サイト事例
- ガイド
- 比較
- 代替サービス
- おすすめ
- レビュー
- 料金ガイド
- 用語集・ガイド
- 連携サービス
- 開発者向け
- ベンチマーク
- Windows アプリ