表示名だけ変えるはずのPATCHに、roleを1行足すと管理者になれる。DTOを作っても、Entityを直接受け取る実装が1か所でも残っていれば直らない。防ぐのは「受け取る型」と「反映する項目」の両方である。
この記事では、2026年11月15日に学んだOWASPのMass Assignmentを、JavaとSpring Bootの実装で掘り下げる。OWASPのチートシート、2012年のGitHub事件、Springのバインドの仕組みを横断し、DTOだけでは防げない3つの穴と、直し方の型を示す。
表示名だけ変えるはずのPATCHが、管理者を作る
会員情報の更新APIを考える。仕様では表示名だけを変更できる。
PATCH /api/users/me
Content-Type: application/json
{"displayName": "Tanaka"}
DBのUserテーブルには、画面に出ていない項目もある。
| 項目 | 内容 |
|---|---|
| display_name | 表示名 |
| メールアドレス | |
| role | 一般ユーザー・管理者 |
| verified | 本人確認済みか |
| account_status | アカウントの状態 |
攻撃者は、リクエストに項目を1行足すだけである。
{"displayName": "Tanaka", "role": "ADMIN", "verified": true}
次の実装では、このJSONがそのままDBに届く。
@PatchMapping("/users/me")
public void update(@RequestBody User user) {
userRepository.save(user);
}
UserがJPAのEntityで、roleやverifiedも持っていた場合、JSONの内容がそれらに反映される。表示名の更新APIが、管理者の作成APIに変わる。しかもレスポンスは200 OKで返る。画面にない項目は、画面にないから安全なのではない。サーバーが受け取って反映してしまうことが問題である。
関連する自記事として、ログに残す情報の扱いを掘り下げた記事がある。同じOWASPの学習から出た記事である。
JavaのログにパスワードやBearerトークンを残さない――OWASPの除外リストとマスキングの置き場所
200 OKで通る理由――JSONのキーはsetterにそのまま流れる
なぜこの攻撃は素通りするのか。Spring Bootで@RequestBodyを受け取ると、JSONの変換はJacksonが担う。MappingJackson2HttpMessageConverterがJSONのキーを、対象クラスのフィールドやsetterに結びつける。JSONにroleがあれば、setRole("ADMIN")が呼ばれる。変換の段階では、「この項目はこのエンドポイントで変えてよいか」は誰も見ていない。
ここで混同しやすいのが、OWASPチートシートのSpringの節に出てくるsetAllowedFieldsである。
@InitBinder
public void initBinder(WebDataBinder binder, WebRequest request) {
binder.setAllowedFields("userid", "password", "email");
}
この設定はWebDataBinderのもので、@ModelAttributeやフォーム送信のバインドを制御する。@RequestBodyのJSON変換は別の経路で、Jacksonが担うため、@InitBinderでは守れない。チートシートの例自体、フォーム送信(/addUser)のものである。JSONのAPIにフォーム用の対策を持ち込んでも、穴はふさがらない。
もう1つ、通る理由がある。認証・認可は「このユーザーが、このデータを操作してよいか」を見る。自分のプロフィールは自分で編集できる。認可が通ったあと、「そのデータの、どの項目を変更してよいか」は別の層の話になる。認可が通ったからといって、すべての項目が書き換えてよいわけではない。OWASPは2023年のAPI Security Top 10で、この問題をAPI3:2023 Broken Object Property Level Authorization(BOPLA)に吸収した。2019年版のAPI6:2019 Mass Assignmentと、Excessive Data Exposureを統合した分類である。オブジェクト単位の認可と、項目単位の認可は別の層で見る。
検知の面でも厄介である。200 OKで返り、例外も出ない。ログに残るのは普通の更新リクエストと変わらない。検知の仕組みがなければ、気づかないまま権限が変わる。検知がなかった事件については、別の記事で扱った。
AIエージェントが5日間気づかれず顧客情報を抜いた――WorkOS事件の4つの弱点
DTOを作っても残る3つの穴
入力専用DTOを作るのは、OWASPが推奨する代表的な対策である。DTOには変えてよい項目だけを入れる。だが、DTOを作っただけでは防げない穴が3つ残る。
穴1:別の受け取り口が残っている
DTOを作ったエンドポイントだけが直っても、別の場所でEntityを直接受け取っていれば、そこから同じ攻撃が通る。コードレビューで探すのは、次のような処理である。
objectMapper.convertValue(requestBody, User.class);
BeanUtils.copyProperties(request, entity);
これらのAPI自体が危険なのではない。入力元のオブジェクトに、変更を許可していない項目が含まれていないかが問題である。convertValueでJSONをEntityに変換すれば、DTOの意味がなくなる。copyPropertiesでリクエストをEntityに丸ごと写せば、同じことになる。受け取り口は1か所だけ見るのでは足りず、Entityに触れる経路をすべて洗う必要がある。
穴2:未知の項目を黙って捨てるだけでは、気づけない
Spring Bootでは、Jacksonのfail-on-unknown-propertiesが既定で無効になっており、DTOに存在しないJSON項目は黙って無視される。roleを送ってもエラーにならず、単に捨てられる。DBの更新は防げるが、仕様外の入力が来たことに気づけない。検知したいなら、次の設定も検討する。
spring:
jackson:
deserialization:
fail-on-unknown-properties: true
ただし、この設定には罠がある。Entityを直接受け取る実装では、roleはEntityの既知の項目であるため、この設定でも弾けない。設定が効くのは、受け取る型がDTOのときだけである。設定を入れたつもりで、受け取る型がEntityのままでは、何も変わらない。
バインドの挙動を、フィールド集合のモデルで確かめた結果が次の表である。
| 受け取る型 | ペイロード | fail-on-unknown-properties | 結果 |
|---|---|---|---|
| Entity | role: ADMINを追加 | 既定(false) | roleがADMINで書き込まれる |
| DTO | role: ADMINを追加 | 既定(false) | roleは黙って捨てられ、displayNameだけ反映 |
| DTO | role: ADMINを追加 | true | エラー(400相当) |
| Entity | role: ADMINを追加 | true | roleがADMINで書き込まれる(弾けない) |
| Entity / DTO | 表示名だけ | どちらでも | displayNameだけ反映 |
穴3:save() は部分更新ではない
userRepository.save(user)は、PATCHのつもりでも部分更新ではない。Entityの状態によって、新規作成や既存レコードのマージなど挙動が変わる。切り離されたEntityを丸ごとマージすると、クライアントが送らなかった項目がnullで上書きされる場合がある。表示名だけ送ったつもりが、emailやroleやverifiedがnullで消える。更新対象を制御しにくい、というのがsave()の直呼びの問題である。
GitHubは2012年に同じ穴で破られた
Mass Assignmentは、机上の脆弱性ではない。2012年3月、GitHubが同じ穴で破られた。研究者のEgor Homakovは、公開鍵の更新フォームにuser_idの項目を追加し、自分のSSH公開鍵をRails組織のアカウントに結びつけた。フォームはupdate_attributesで送られた項目をすべて反映したため、彼はrails/railsリポジトリへのコミット権を得て、実証としてファイルを1つpushした。GitHubは1時間以内に修正し、アカウントを一時停止したのち、悪意がなかったとして復旧した。Railsはその後、許可する項目を明示するstrong parametersへ移行した。
同じ構造の失敗は、Springでも起きている。2022年のSpring4Shell(CVE-2022-22965)では、データバインドの経路からクラスローダへ到達できた。ブロックリストでの回避策は2度すり抜けられた。許可する項目を明示するallow-listなら、最初の1歩で止まった。ブロックリストは、後から追加された項目や見落とした項目を守れない。OWASPのチートシートも、CWE-915の勧告としてallow-listを推奨し、ブロックリストだけに頼るなと書いている。
直し方:受け取る型と反映する項目を両方しぼる
直し方は、受け取る型と反映する項目の両方をしぼることである。入力専用DTOには、変えてよい項目だけを入れる。
public record UpdateProfileRequest(
@NotBlank
@Size(max = 50)
String displayName
) {}
このDTOには、roleもverifiedもない。コントローラはEntityを受け取らず、DTOだけを受け取る。
@PatchMapping("/users/me")
public void update(
@Valid @RequestBody UpdateProfileRequest request,
Authentication authentication) {
profileService.update(
authentication.getName(),
request.displayName()
);
}
Serviceでは、認証済みのログインIDから更新対象を決め、許可した項目だけを反映する。
@Service
public class ProfileService {
private final UserRepository repository;
public ProfileService(UserRepository repository) {
this.repository = repository;
}
@Transactional
public void update(String loginId, String displayName) {
User user = repository.findByLoginId(loginId)
.orElseThrow();
user.setDisplayName(displayName);
}
}
@Transactionalの中で管理対象のEntityを更新すれば、JPAの変更検知によってDBへ反映される。save()の直呼びでEntityを丸ごと渡すのではなく、DBから取ったEntityの、許可した項目だけを書き換える。更新対象はクライアントの指定ではなく、認証済みのログインIDから決める。他人のユーザーIDを指定しても、他人の情報は変わらない。
テストは、HTTPレスポンスだけでなくDBの更新結果まで確認する。OWASPのREST Assessment Cheat Sheetでも、仕様外の項目を追加し、実際に保存されたか、後続の処理に影響したかまで検証するよう説明している。確認する観点は次の通りである。
| テストケース | 期待する結果 |
|---|---|
| 表示名だけ変更 | 正常に更新される |
| role: ADMINを追加 | 拒否されるか、無視されてDBに反映されない |
| verified: trueを追加 | DBの本人確認状態は変わらない |
| 表示名が51文字 | バリデーションエラー |
| 未認証ユーザー | 更新拒否 |
| 他人のユーザーIDを指定 | 他人の情報は変更されない |
DBの更新結果まで確認する姿勢は、障害の記事でも同じである。冪等性の検証で、再送時に何回処理されたかを数えた記事がある。
128の信用金庫が13時30分に止まり19時05分に復旧した――通信機器の故障と、振込だけ最後まで戻らなかった理由
今後見るべきもの
- OWASP Mass Assignment Cheat Sheetの更新:SpringやJacksonの節が、JSONのAPI向けにどう書き換わるかを見る。フォーム送信の例のままか、DTOとJacksonの設定まで踏み込むかで、推奨の重心が読める。
-
SpringのDataBinder Security Considerations:
setAllowedFieldsとsetDisallowedFieldsの扱いが、今後どう整理されるか。フォーム送信とJSONのAPIで、守備範囲の説明が分かれているかを確認する。 - Jacksonのfail-on-unknown-propertiesの既定:Spring Bootの既定がfalseのままか、将来の版で変わるか。既定が変われば、未知の項目を送る既存クライアントが400で落ちるため、移行時の影響範囲も見る。
- API3:2023 BOPLAの動向:OWASP API Security Top 10の次版で、項目単位の認可がどう扱われるか。読み取り側の過剰な露出と、書き込み側のMass Assignmentは対になる問題である。
- CSV取込やバッチの同じ問題:APIだけでなく、外部ファイルの項目をEntityへ一括コピーする処理でも同じ穴が開く。JP1の夜間バッチのような、DBから取り出したデータをCSVや.datへ出す処理でも、入力項目と更新可能項目の分離が必要になる。
- 静的解析の指摘:SonarのルールS4684のように、Entityをリクエスト引数に使う実装は指摘対象になる。自プロジェクトで同じ指摘が出ていないか、定期的に確認する。
検証環境
- Javaのコードは、この環境にJDKがないためJVMで実行していない。構文は目視で確認した。コード例は、2026年11月15日のOWASP実務セキュリティ学習の会話で扱ったものと、OWASP Mass Assignment Cheat Sheetの例をもとにしている。
- バインドの挙動の表は、フィールド集合のモデルをPython 3.12.3に写して検証した(検証スクリプトは
verify-2026-11-15-evening-mass-assignment.py)。Spring Bootそのものの実行結果ではない。検証したのは、Entity受け取りではroleが書き込まれること、DTO受け取りではroleが捨てられるかエラーになること、Entity受け取りではfail-on-unknown-propertiesを有効にしてもroleが弾けないこと、Entityの丸ごとsaveでは未送信項目がnullで上書きされるモデルの4点である。 - GitHub事件の経緯は、OWASPチートシートのケーススタディと、The Register・The Hacker Newsの2012年3月5日の報道で横断確認した。修正までの時間(1時間以内)とアカウントの復旧は、報道の記述による。
参考資料
- OWASP Mass Assignment Cheat Sheet
- OWASP API Security Top 10: 2023 - API3:2023 Broken Object Property Level Authorization
- GitHub reinstates Russian who hacked site to expose flaw - The Register
- GitHub hacked with Ruby on Rails public key vulnerability - The Hacker News
- Mass assignment and BOPLA: field and function authorization
まとめ
Mass Assignmentの対策は、DTOを作ることそのものではない。外部から変更してよい項目を明確にし、その項目だけをサーバー側で反映することである。受け取る型をDTOにしぼっても、Entityを受け取る別の経路が残っていれば、そこから同じ攻撃が通る。Jacksonの未知プロパティ拒否も、受け取る型がEntityのままではroleを弾けない。設定を入れたつもりで安心する前に、受け取る型を確認する。
自分のAPIで確かめるなら、仕様外の項目を1行足して、DBの何が変わるかを見るのが手早い。レスポンスが200 OKでも、DBを見なければ分からない。表示名の更新APIにroleを足して、管理者になれるかどうか。確かめる側がその1行を試す前に、作る側が試しておく。