ホワイトリストとブラックリストの違いとは?ブラックリストだとダメな理由をNode.js実装で検証してみた
【要約】ホワイトリスト vs ブラックリストの違いまとめ
| 項目 | ブラックリスト方式 | ホワイトリスト方式 |
|---|---|---|
| 基本的な考え方 | 禁止する対象を定義する | 許可する対象だけを定義する |
| 判定ロジック | 禁止リスト以外はすべて許可 | 許可リスト以外はすべて拒否 |
| 未定義の操作/権限 | 許可されてしまう(素通りする) | 拒否される(安全にブロック) |
| 機能追加時のリスク | 設定漏れがあると即座に脆弱性に繋がる | 設定漏れがあっても「動かない」だけ |
| 権限(ロール)追加時 | 禁止対象を追加し忘れると意図せず権限昇格 | 許可対象を定義するまで何もできない |
| 推奨度 | × 原則避ける(デフォルト許可の罠) | ◎ 基本はこちら一択(デフォルト拒否) |
- 結論:セキュリティを考慮したアクセス制御では、 「明示的に許可したものだけを通し、それ以外はすべて拒否する(デフォルト拒否)」 を基本にするのが鉄則。
とはいえ、「禁止したいものだけ弾くブラックリストじゃだめなの?」と思ったりする。
なぜブラックリスト方式だと現場で事故りやすいのか、実際にNode.jsでAPIを作って挙動を比較してみた。
はじめに:ブラックリストじゃだめなの?という疑問
普段Web開発やAPIの設計をしていると、必ずぶつかるのが「ユーザーの権限管理(アクセス制御)」の話。
例えば、「管理者は全操作OK、一般ユーザーは閲覧のみOK」みたいなやつ。
こうしたアクセス制御の設計をしていると、よく「ホワイトリスト方式にすべき」という話が出てくる。
ただ、以前チームで設計について話していたときに、こんな疑問を投げかけられたことがあった。
「禁止するものを登録するか、許可するものを登録するか。表から見るか裏から見るかの違いだけでしょ?ブラックリストでもよくない?」
確かに、最初の仕様書を見ている段階だと、どちらで作っても同じ結果が得られるように思える。
「一般ユーザーは更新・削除を禁止にする」と書いても、「一般ユーザーは閲覧だけ許可する」と書いても、動かしてみれば同じに見えるからだ。
でもこれ、運用が始まって「新機能の追加」や「新しいロール(権限)の追加」が発生した瞬間に大事故になるやつだったりする。
なぜブラックリスト方式だとヤバいのか、具体的なシチュエーションとNode.jsの実装コードで確認していこう。
なぜブラックリスト方式だとダメなのか?
判定フローの違いを図解してみる
まず、両者の判定ロジックをフロー図にすると以下のようになる。
flowchart TD
subgraph Blacklist["【ブラックリスト方式】デフォルト許可の罠"]
B_Start["アクセス要求"] --> B_Check{"禁止リストに<br/>入っているか?"}
B_Check -- Yes --> B_Deny["403 Forbidden<br/>(拒否)"]
B_Check -- No --> B_Allow["200 OK<br/>(★許可)"]
B_Unknown["未定義の操作 / 新権限"] -.-> B_Check
style B_Allow fill:#ffebee,stroke:#c62828,stroke-width:2px
end
subgraph Whitelist["【ホワイトリスト方式】デフォルト拒否で安全"]
W_Start["アクセス要求"] --> W_Check{"許可リストに<br/>入っているか?"}
W_Check -- Yes --> W_Allow["200 OK<br/>(許可)"]
W_Check -- No --> W_Deny["403 Forbidden<br/>(★安全に拒否)"]
W_Unknown["未定義の操作 / 新権限"] -.-> W_Check
style W_Deny fill:#e8f5e9,stroke:#2e7d32,stroke-width:2px
end何が決定的に違うかというと、**「リストに載っていない未知のものが来たときに、開くのか閉じるのか」**という点。
- ブラックリスト:知っている危険だけを塞ぐスタイル。未知のものは全部素通り。
- ホワイトリスト:知っている安全だけを通すスタイル。未知のものは全部シャットアウト。
これが実際の開発現場でどういう事故を引き起こすのか、2つのパターンで見てみる。
パターン1:新機能が追加されたらどうなる?
例えば、最初のリリース時点で一般ユーザーに対して以下の権限を設定していたとする。
| 操作 | 一般ユーザー |
|---|---|
| 参照(read) | 許可 |
| 登録(create) | 拒否 |
| 更新(update) | 拒否 |
| 削除(delete) | 拒否 |
このとき、
- ブラックリスト方式:
['create', 'update', 'delete']を禁止リストに登録 - ホワイトリスト方式:
['read']を許可リストに登録
この時点ではどちらも同じ動きをする。
問題は、数ヶ月後に**「データのエクスポート(export)」機能が新しく追加されたとき**。
| 操作 | 一般ユーザー |
|---|---|
| 参照 | 許可 |
| 登録 | 拒否 |
| 更新 | 拒否 |
| 削除 | 拒否 |
| エクスポート(新機能) | 未設定 |
ここでブラックリスト方式だとどうなるか?
開発者が禁止リストに export を追加し忘れると、「禁止リストに含まれていない=許可」と判定されてしまい、一般ユーザーでもデータエクスポートが実行できてしまう。
一方、ホワイトリスト方式ならどうなるか?
許可リストに登録されているのは read だけなので、新機能の export は自動的に拒否される。
もし設定を忘れていたとしても、「動かない(403エラーになる)」という不具合として検知できるため、意図しない情報漏洩や権限昇格を防ぐことができる。
パターン2:ロール(権限)が増えたらどうなる?
機能追加だけじゃなく、新しいユーザーロールが追加されたときも全く同じことが起きる。
最初は以下の2つのロールしかなかったとする。
admin(管理者)user(一般ユーザー)
その後、要件定義が変わって新しく**「guest(ゲスト)」**権限を追加することになった。
ここでブラックリスト方式を採用していると、もし guest の禁止リストを定義し忘れた場合、「禁止設定がない=何でもやり放題」という最悪の状態になってしまう。
ホワイトリスト方式なら、guest の許可リストを明示的に書かない限り、何も実行できない(全拒否される)。
安全側に倒れる設計になっているかどうかが、保守の現場で決定的な差になる。
コードで見る判定ロジックの違い
JavaScriptのコードでこの判定ロジックを比較してみる。
ブラックリスト方式の実装
const deniedPermissions = {
admin: [],
user: ["create", "update", "delete"],
viewer: ["create", "update", "delete"]
};
function canExecute(role, action) {
return !deniedPermissions[role]?.includes(action);
}ここで注目したいのがこの1行。
return !deniedPermissions[role]?.includes(action);もし新しく追加した guest のように、deniedPermissions にキーが未定義のロールが渡された場合、
deniedPermissions[role]はundefinedになる- オプショナルチェーン(
?.)により全体がundefinedになる !undefinedはtrueになる!
つまり、設定を書き忘れただけで「すべて許可」になってしまう。
これがデフォルト許可の落とし穴。
ホワイトリスト方式の実装
一方、ホワイトリスト方式はこう書く。
const allowedPermissions = {
admin: ["read", "create", "update", "delete"],
user: ["read"],
viewer: ["read"]
};
function canExecute(role, action) {
return allowedPermissions[role]?.includes(action) ?? false;
}こちらはシンプル。
return allowedPermissions[role]?.includes(action) ?? false;許可リストに該当の操作が含まれていれば true、それ以外(未定義のロールや操作含む)はすべて Null合体演算子(??)で false に倒す。
2つの実装の決定的な差
// ブラックリスト方式:禁止リストになければ全部許可
return !deniedPermissions[role]?.includes(action);
// ホワイトリスト方式:許可リストになければ全部拒否
return allowedPermissions[role]?.includes(action) ?? false;「実装の手間」は1行程度しか変わらない。
なのに、バグや設定漏れが発生したときに**「全開通して情報漏洩する」のか「安全に閉じてエラーになる」のか**という天と地ほどの差が生まれる。
【実践・検証】Node.jsで実際に動かして比較してみた
理屈は分かったので、実際にHTTPリクエストを投げて動くサンプルをNode.js標準機能で作ってみた。
外部ライブラリ(Express等)は一切使わず、標準の node:http モジュールだけで完結させている。
リクエストと認証・認可のシーケンス図
今回作ったサンプルの全体像はこんな感じ。
「認証(auth.js)」でユーザーを特定し、「認可(permissions.js)」で実行可否をジャッジする構成にしている。
sequenceDiagram
autonumber
actor Client as クライアント (curl)
participant Server as HTTPサーバー (server.js)
participant Auth as 認証 (auth.js)
participant Perm as 認可 (permissions.js)
Client->>Server: HTTPリクエスト (Bearer Token付き)
Server->>Auth: トークンからロール特定 (認証)
Auth-->>Server: ロール返却 (admin / user / guest等)
Server->>Perm: ロールと操作の実行可否チェック (認可)
alt 許可された場合
Perm-->>Server: true
Server-->>Client: 200 OK (リソース返却)
else 拒否された場合
Perm-->>Server: false
Server-->>Client: 403 Forbidden (アクセス拒否)
endサンプルのディレクトリ構成
access-control-comparison/
├── src/
│ ├── auth.js # トークンからロールを判定(認証)
│ ├── permissions.js # ブラックリスト/ホワイトリストの判定(認可)
│ └── server.js # ルーティングとHTTPサーバー
├── tests/
│ └── access-control.test.js # Node.js標準テスト
├── package.json
└── README.md検証用にBearer Tokenを用意して、ヘッダーでロールを切り替えられるようにした。
| Token | ロール |
|---|---|
token-admin | admin |
token-user | user |
token-viewer | viewer |
token-guest | guest(未定義ロール検証用) |
※ 固定トークンは検証用の簡易的な実装。本番ではJWTやセッションを使う想定。
検証1:通常のアクセス制御(まずはどちらも期待通り動く)
まずは一般ユーザー(token-user)で、参照と登録を叩いてみる。
参照(GET)の場合:
curl http://localhost:3000/api/whitelist/users \
-H "Authorization: Bearer token-user"結果は 200 OK でデータが取得できる。
次に登録(POST)を叩いてみる:
curl -i -X POST http://localhost:3000/api/whitelist/users \
-H "Authorization: Bearer token-user" \
-H "Content-Type: application/json" \
-d '{"name":"新規ユーザー"}'結果は 403 Forbidden となり、きちんと拒否される。
ここまではブラックリストでもホワイトリストでも全く同じ結果になる。
検証2:新機能を追加したとき(ブラックリストだけ素通り!)
では、設定リストに登録していない新機能「エクスポート(/users/export)」を叩いてみる。
まずはブラックリスト方式のAPI:
curl -i http://localhost:3000/api/blacklist/users/export \
-H "Authorization: Bearer token-user"結果:
HTTP/1.1 200 OK
Content-Type: application/json
{"message":"エクスポート成功"}なんと 200 OK が返ってきてしまった!
禁止リストに export を入れ忘れたため、一般ユーザーなのにエクスポートが実行できてしまった形。
次にホワイトリスト方式のAPI:
curl -i http://localhost:3000/api/whitelist/users/export \
-H "Authorization: Bearer token-user"結果:
HTTP/1.1 403 Forbidden
Content-Type: application/json
{"error":"アクセス権限がありません"}こちらは 403 Forbidden で安全に弾いてくれた。
| 方式 | レスポンス | 挙動の違い |
|---|---|---|
| ブラックリスト | 200 OK | 禁止リストにないので素通りしてしまう(事故) |
| ホワイトリスト | 403 Forbidden | 許可リストにないので安全にブロックされる |
検証3:新ロールを追加したとき(未定義ロールが全開になる罠)
次に、認証には存在するけれど認可リストにはまだ追加していないロール guest(token-guest)でアクセスしてみる。
ブラックリスト方式の場合:
curl -i http://localhost:3000/api/blacklist/users \
-H "Authorization: Bearer token-guest"結果は 200 OK。guest の禁止リストが存在しないため、何でも見放題になってしまう。
ホワイトリスト方式の場合:
curl -i http://localhost:3000/api/whitelist/users \
-H "Authorization: Bearer token-guest"結果は 403 Forbidden。
許可リストに何も登録されていないので、安全にアクセスを拒否してくれる。
| 方式 | レスポンス | 理由 |
|---|---|---|
| ブラックリスト | 200 OK | guest の禁止設定が存在しないため全許可 |
| ホワイトリスト | 403 Forbidden | guest の許可設定が存在しないため全拒否 |
自動テストでも一発で違いが分かる
Node.js標準のテストランナー(node:test)を使ってテストを実行してみた。
npm test実行結果:
▶ access-control tests
✔ ヘルスチェック (200 OK)
✔ 認証トークンなしは弾かれる (401 Unauthorized)
✔ 一般ユーザーの閲覧は両方式とも通る (200 OK)
✔ 一般ユーザーの登録は両方式とも弾かれる (403 Forbidden)
✔ 【検証】新機能追加時:ブラックリストは素通り(200)、ホワイトリストは遮断(403)
✔ 【検証】新ロール追加時:ブラックリストは素通り(200)、ホワイトリストは遮断(403)
✔ 管理者は全操作可能 (200 OK)テストコードを走らせてみると、設定漏れが起きた時の挙動の違いが一発で浮き彫りになる。
ハマりやすいポイント・注意点
ブラックリスト方式そのものが悪というわけではない
ここまで検証すると「ブラックリストは絶対悪!」っぽく見えるが、厳密には「デフォルト許可の実装」が悪さをしている。
ブラックリスト方式を採用しつつも、「未定義の操作やロールはデフォルト拒否する」という安全弁を挟めば事故は防げる。
ただ、それをやるくらいなら最初からホワイトリストで作った方がシンプルで漏れがない。
認証と認可は別物
アクセス制御で初心者が一番混乱しやすいのがこれ。
- 認証(Authentication):「お前は誰?」を確認する(ログイン、トークン検証)
- 認可(Authorization):「お前は何をしていいの?」を確認する(ロール判定、権限チェック)
ログインできたからといって、すべてのAPIを叩いていいわけじゃない。
今回の検証でも、auth.js でログインさせた上で、permissions.js で厳密に操作権限をチェックしている。
ホワイトリスト方式でも油断禁物なポイント
ホワイトリストを使っていれば100%安全かというと、そうでもない。
- サーバー側でのチェック漏れ:フロントエンドのUIだけで非活性にして、バックエンドのAPIで認可チェックを忘れるやつ(一番多い)。
- 過剰な権限付与:「とりあえず動かないからadmin権限にしちゃえ」で放置するやつ。
- オブジェクトレベルの認可不備(BOLA / IDOR):「ユーザーID=123」の人が「ユーザーID=456」のデータを閲覧・更新できてしまう問題。
OWASPの「Authorization Cheat Sheet」でも、**「デフォルト拒否(Deny by Default)」「すべてのリクエストでサーバー側検証」「最小権限の原則」**の3つが強く推奨されている。
まとめ:迷ったら「デフォルト拒否」一択
「ブラックリストじゃダメなの?どっちでもよくない?」という疑問について、Node.jsで実際に実装して検証してみた。
最初の仕様通りに動かしているうちはどちらでも違いが分からない。
でも、システムは作って終わりではなく、運用の中で機能や権限がどんどん増えていく。
そのときに、
- ブラックリスト(デフォルト許可):設定を1箇所忘れただけでセキュリティ事故(意図しない全開通)
- ホワイトリスト(デフォルト拒否):設定を1箇所忘れてもただの不具合(403エラーで気付ける)
という決定的な差が出る。
「安全側に倒す」という意味でも、アクセス制御や入力バリデーションを作るときは、 「明示的に許可したものだけを通す(デフォルト拒否)」 を鉄則にしておきたい。
参考資料
今回検証に使用したソースコード一式はGitHubで公開している。