メインコンテンツへスキップ
見出し画像

ログインなしで通るのは3本だけのつもりでした。自作WebアプリのAPI 47本をClaude Codeと19分30秒で洗い出し、ガードが素通りする9本を見つけた記録

    こんばんは、AIフクロウです。

    自分で作ったWebアプリは、だいたいログインしてから触ります。ログイン後の画面しか見ないので、ログインしていない人から見たときの姿を、私はほとんど確認していませんでした。

    個人開発のアプリに画面を1つ足したときに、ふと気になりました。ログイン判定を書く場所が、グローバルのミドルウェアとルーター単位の設定とハンドラの中と、あちこちに散っているのです。機能を足すたびにそのときの都合で書いているので、どれがどのエンドポイントに効いているのか、頭の中ではもう追えなくなっていました。

    そこで今夜は、Claude Codeにコードだけを根拠にして、エンドポイント1本ずつ「どこのガードが効いているか」を並べてもらいました。ログインなしで通ってよいつもりだったのは3本です。実際に未ログインで通る状態だったのは12本でした。

    ログイン後の画面しか見ていない、という状態

    個人開発だと、認可の設計を最初に全部決めてから作りはじめることはあまりないように思います。最初は自分しか使わないので、ログイン判定は「とりあえず全体に1枚かけておく」で足ります。

    そのあと、ヘルスチェック用のパスを除外したくなります。ログインそのもののエンドポイントも除外しないと動きません。公開プロフィールのような、見せてよい画面も出てきます。

    この「除外」が増えていくところが厄介です。除外の書き方は、パスの完全一致だったり前方一致だったり正規表現だったりします。/api/public を前方一致で除外したつもりが、/api/public_notes まで一緒に外れる、という種類のずれは、設定ファイルを目で見ているだけでは気づけません。

    さらに、ログインしているかどうかの判定と、そのデータが自分のものかどうかの判定は別物です。前者だけ通っていて後者がない場合、ログインさえしていれば他人のIDを指定して読める状態になります。これも、ハンドラを1本ずつ開かないと分かりません。

    要するに、確認すべきことが「エンドポイントの数 × ガードの置き場所の数」になっていて、手で回すには数が多すぎる、という状態でした。

    Claude Codeに読ませたもの

    渡したのはリポジトリそのものです。追加の資料は用意していません。ルーティングの定義ディレクトリだけをプロンプトの中で指定して、あとはコードを辿ってもらいました。

    狙いは「診断してもらうこと」ではなく、「全エンドポイントを1行ずつ表にしてもらうこと」でした。どれが危ないかは最後に自分で決めればよくて、その手前の「47本ぜんぶについて、ガードの根拠がどのファイルの何行目にあるか」の一覧が、手作業だと一番つくりたくない部分です。

    ガードが置かれうる場所は、私のアプリでは4か所ありました。グローバルのミドルウェア、ルーター単位のミドルウェア、ハンドラに付けるデコレータ、そしてハンドラ本体に直接書いた分岐です。この4か所を「必ず全部見る」と書いておくのが、今回の肝でした。

    画像

    もう1つ決めておいたのが、根拠が見つからなかったときの扱いです。何も指定しないと「フレームワークの既定で保護されているはずです」のような、確認できない説明が混ざります。これを封じるために、リポジトリ内に実物の設定が見つからない限り根拠として認めない、と明示しました。

    使ったプロンプト

    あなたはこのリポジトリのコードだけを根拠に、HTTP APIの認可ガードを棚卸しします。
    推測で埋めず、根拠にしたファイル名と行番号を必ず添えてください。
    
    【対象】
    (ここにルーティング定義の場所を書く 例: src/routes/ と src/middleware/)
    
    【手順】
    1. 対象配下のエンドポイントを全部拾い、1行1エンドポイントで
       メソッド / パス / ハンドラの定義場所(ファイル:行) を出す。
       数えたエンドポイントの総数も最後に書く。
    2. 各エンドポイントに効いている認可の仕組みを、コードを辿って特定する。
       次の4か所を必ず全部見る。1か所で見つかっても残りの3か所も確認する。
       (a) 全体にかけたミドルウェア
       (b) ルーター単位のミドルウェア
       (c) ハンドラに付いたデコレータ
       (d) ハンドラ本体に直接書かれた分岐
       除外設定(パスの完全一致・前方一致・正規表現)があれば、その実物も辿る。
       前方一致の除外が意図より広い範囲に効いている場合は、該当するパスを挙げる。
    3. 各エンドポイントを次の4判定のどれかに入れる。
       A: 未ログインで通る。公開が明らかに意図されている
       B: 未ログインで通る。公開してよいか確認が必要
       C: ログインは必須だが、対象データの持ち主を確かめる処理がない
       D: ログイン必須かつ持ち主の確認あり
    4. 出力は2つの表にする。
       表1: メソッド / パス / 判定(A-D) / ガードの根拠(ファイル:行)
            根拠が1つも見つからないときは根拠欄に「なし」と書く
       表2: 判定BとCだけを抜き出し、確認すべき点を60字以内で1行添える
    5. 守るルール
       - コードは変更しない。読むだけにする。
       - 根拠が1か所も見つからないものをDに入れてはいけない。BかCに入れる。
       - 「フレームワークの既定で守られているはず」は根拠にしない。
         該当する設定の実物がリポジトリ内にあるときだけ根拠として書く。
       - 判定を付けられないものは、表のあとに「判断できない」として
         理由を1行添えて並べる。数に含める。

    差し替えるのは【対象】の1行だけです。ルーティングが1ディレクトリにまとまっていない場合は、ミドルウェアの定義場所も一緒に書いておくと、辿り直しが減りました。

    実行はリポジトリのルートで claude を立ち上げて、このまま貼るだけです。コードを変更しないと書いてあるので、読み取りだけで進みます。

    戻ってきた表

    表1は47行でした。1行あたり「メソッド / パス / 判定 / 根拠」で、根拠の欄にはファイル名と行番号が入っています。ここを抜き打ちで5本開いて確かめたところ、5本とも書かれていた行に実際のガードがありました。

    【表1 抜粋】
    GET    /api/health              A   除外リスト server/auth.ts:18
    POST   /api/session             A   除外リスト server/auth.ts:19
    GET    /api/public_notes        B   除外リスト server/auth.ts:21(前方一致)
    GET    /api/notes/:id           C   requireLogin server/routes/notes.ts:34
    DELETE /api/notes/:id           D   requireLogin + ownerOf server/routes/notes.ts:102
    GET    /api/export/:userId      B   なし
    POST   /api/webhooks/mail       B   なし
    
    【前方一致で意図より広く外れているパス】
      除外: /api/public
      → /api/public_notes / /api/public_export / /api/public_stats / /api/public_feed
         の4本も一緒に外れている
    
    【判定の内訳】 A:3  B:9  C:12  D:21  判断できない:2  合計:47
    
    画像

    A(意図的な公開)3本

    ヘルスチェック、ログイン、パスワード再設定の受付です。ここは想定どおりでした。私が「3本だけ」と思っていたのはこの3本です。

    B(未ログインで通るが、公開してよいか確認が必要)9本

    9本のうち4本は、さきほどの前方一致の除外に巻き込まれていたものです。/api/public を外したつもりで、public_ で始まる別のパスまで外れていました。

    残りの5本は、根拠が「なし」でした。ルーターを分けたときにミドルウェアを付け直し忘れていたもので、外部サービスからの受け口2本と、CSVの書き出し1本が含まれていました。表2のほうに「誰が叩けると困るか」が1行ずつ付いていたので、優先順位はすぐ決まりました。

    C(ログインは通るが、持ち主の確認がない)12本

    これが一番多かった区分です。ログイン判定は効いているので画面上は正しく動きますが、IDをURLに含むエンドポイントで、そのIDが自分のものかを確かめていません。

    12本のうち9本は読み取り専用で、3本は更新系でした。更新系から見るべきなのは明らかなので、ここも順番で迷いませんでした。

    D(ログイン必須かつ持ち主の確認あり)21本

    半分近くはきちんと書けていました。ここは「安心していい」というより、「Cの12本をどう直すかのお手本が21本ある」という読み方ができます。実際、Cを直すときはDで使っている同じヘルパー関数を当てはめるだけで済みました。

    判断できない 2本

    動的にパスを組み立てている箇所で、コードを読むだけでは最終的なパスが決まらない2本でした。理由が1行付いていたので、そこだけ自分で開いて確かめました。これを無理に判定させないほうが、表全体の信用度は上がるように思います。

    効いた指示

    • 4か所を列挙して「1か所で見つかっても残りも見る」と書いた。これを書かない版では、グローバルのミドルウェアを見つけた時点で打ち切られて、ハンドラ内の分岐が拾われませんでした。Cの12本は、この一文がないと出てきません

    • 根拠にファイル名と行番号を必須にした。抜き打ちで確かめられる形になるので、表をそのまま信じるかどうかの判断が自分でできます。行番号がない要約だけだと、結局全部開き直すことになります

    • 「既定で守られているはず」を禁じた。これが一番効きました。根拠なしをDに入れさせない制約と合わせて、曖昧なものがBかCに落ちてくるので、見るべき一覧が自動的に絞られます

    • 除外設定の実物を辿らせた。前方一致の巻き込み4本は、除外リストを「そういう設定がある」で済ませていたら出ませんでした。該当パスを挙げさせたのが当たりでした

    • 判断できないものを数に含めさせた。合計が47で合うので、拾い漏れがないことを足し算で確認できます

    詰まった点

    • 1回目は根拠の欄が3割ほど空欄のまま返ってきました。「根拠なしはBかCに入れる」とは書いていたのですが、空欄のまま判定を付けていた行があったので、空欄を禁止する言い方に直して1度やり直しています

    • エンドポイントの総数は、1回目が45本、やり直しで47本でした。差分はルーターをループで登録している2本です。ルーティングを動的に組んでいる箇所があるアプリでは、総数を自分で数えて突き合わせたほうが安全です

    • この表は「コードにガードが書かれているか」しか見ていません。実際に未ログインで通るかどうかは別の確認が必要です。直すかどうかの最終判断は、表を鵜呑みにせず自分で確かめてからにしてください

    • 判定の名前を自分で4つ決めておかないと、「低・中・高」のような強さの表現に置き換わります。強さだと手が動かないので、何が足りないかが名前に入っている区分のほうが実用的でした

    ほかの用途への振り替え

    • 管理画面の操作: 判定の4区分を「誰でも / ログイン済み / 管理者 / 本人のみ」に差し替えると、管理系の画面にそのまま使えます

    • CLIツールのサブコマンド: 対象をコマンド定義に、ガードを「確認プロンプトの有無」に読み替えると、うっかり実行できる破壊的コマンドの一覧になります

    • バッチの実行経路: ガードを「多重起動の防止があるか」に置き換えると、同時に2本走ると困るジョブを洗い出せます

    • 環境変数の扱い: 判定を「必須 / 任意 / 既定値あり / 未使用」にすると、設定の棚卸しに振り替えられます

    所要時間のまとめ

    • 対象ディレクトリの確認とプロンプトの差し替え: 2分

    • 1回目の実行(45本の表が出るまで): 6分20秒

    • 空欄の指摘と2回目の実行(47本): 7分10秒

    • 根拠5本の抜き打ち確認: 1分30秒

    • 表2の読み合わせと直す順番を決める: 2分30秒

    合計で19分30秒でした。以前、同じことを手でやろうとして、23本まで進んだところで2時間半かかって止めています。しかもそのときは、前方一致の除外に巻き込まれていた4本を見落としていました。

    画像

    速くなったことより、47本を同じ基準で見られたことのほうが大きいと感じます。手でやると、後半は疲れて基準が緩みます。

    結びに

    ふむ、「3本だけのはず」が12本だった原因は、どれも単体では読めるコードでした。除外リストも、ルーターの分割も、ハンドラの分岐も、それぞれの場所では筋が通っています。通っていなかったのは、4か所を横に並べたときの全体像だけです。

    横に並べる作業は、たぶん人間が一番苦手で、Claude Codeが一番向いている種類の仕事なのだと思います。判定を自分で決めて、根拠に行番号を要求して、曖昧な逃げ道を塞ぐ。この3つを書いておけば、出てきた表はそのまま作業リストになりました。

    Cの12本のうち更新系3本は、その夜のうちに直りました。残りは週末です。

    #プロンプトエンジニアリング #ClaudeCode #個人開発 #Webアプリ開発 #エンジニア #コードレビュー #業務効率化 #セキュリティ #リファクタリング #夜活

     
     
    Claude Codeを相棒にいろんな副業に挑戦中の28歳エンジニアです。実際に試したプロンプトと結果をそのままシェアしていきます。夜な夜な書いています。

    あなたへのおすすめ