0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Mass AssignmentはDTOだけでは防げない――roleを足すと管理者になる

0
Posted at

表示名だけ変えるはずの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 表示名
email メールアドレス
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時間以内)とアカウントの復旧は、報道の記述による。

参考資料

まとめ

Mass Assignmentの対策は、DTOを作ることそのものではない。外部から変更してよい項目を明確にし、その項目だけをサーバー側で反映することである。受け取る型をDTOにしぼっても、Entityを受け取る別の経路が残っていれば、そこから同じ攻撃が通る。Jacksonの未知プロパティ拒否も、受け取る型がEntityのままではroleを弾けない。設定を入れたつもりで安心する前に、受け取る型を確認する。

自分のAPIで確かめるなら、仕様外の項目を1行足して、DBの何が変わるかを見るのが手早い。レスポンスが200 OKでも、DBを見なければ分からない。表示名の更新APIにroleを足して、管理者になれるかどうか。確かめる側がその1行を試す前に、作る側が試しておく。

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?