実運用に向けた調整

ここまでで「プルリクエストで脆弱性が検知されたらワークフローをエラーにする」基本動作は体験できました。ただし実際のプロジェクトに同じ設定をそのまま入れると、開発が止まったりチェックがすり抜けられたりといった問題が出てきます。ここからは、実運用でよく直面する3つの問題と、その解決策・具体的な設定を順に見ていきます。

1. 軽微な指摘が多く検知される

1.1 よくある問題

Semgrepは、以下のような重要度(Severity)を持っています。

  • ERROR: 即座に対処すべき重大な脆弱性が含まれる(SQLインジェクション可能箇所など)
  • WARNING: 潜在的なリスクが含まれる(例外メッセージにユーザ入力をそのまま含めるなど)
  • INFO: コード品質寄りの軽微な指摘が含まれる(変数名の命名スタイルなど)

これらの性質の違う指摘が同じ仕組みで一律に検知されます。

重要度に関係なく 検知された全件をワークフロー失敗扱い にしてしまうと、致命的な脆弱性とコード品質寄りの好みが同列に扱われ、プルリクエストごとに大量の軽微な指摘でワークフローがエラーとなります。本当に対応すべき重大な問題が埋もれるうえに、軽微な指摘を直すだけのコミットが量産されてマージサイクルが大きく遅れます。「セキュリティチェックのせいでマージが進まない」という空気ができると、SAST導入そのものが「使いづらい仕組み」と見なされて、最終的にワークフローから外されて頓挫します。

1.2 解決策

Semgrepには検知ルールごとに重要度(Severity)が設定されており、これを使って「ワークフローをエラーにする対象」を絞り込めます。よく取られる方針は、ワークフローエラーの対象を ERROR レベルの問題だけ に限定し、それ以下のレベル(WARNING / INFO)は検知結果として表示はしてもワークフローは通すという形です。これにより、致命的な問題はそのままブロックしつつ、軽微な指摘で開発が止まることを防げます。

導入初期はこの「ERROR だけブロック」状態でチームに慣れてもらい、SASTのフィードバックが日常の開発フローに馴染んできたら、徐々に対象レベルを下げて検知範囲を広げていきます。最初から全件をブロックするより、開発を止めずにSAST運用を定着させる方が、結果として最終的に守れる範囲が広がります。

1.3 具体的な設定方法

Semgrepには --severity オプションがあり、検知する重要度をフィルタできます。ERROR レベルだけでワークフローを失敗させたい場合は、ワークフローを以下のように修正します。

- name: Run Semgrep
  run: semgrep scan --config auto --error --severity ERROR .

これにより、WARNING や INFO の問題は検知結果に表示はされるものの、ワークフローは失敗しなくなります。新規コードでは厳しく、既存コードでは緩やかに、というメリハリのついた運用が可能になります。

2. 過去の資材に対する指摘が検知される

2.1 よくある問題

SASTを既存のコードベースに後から導入すると、これまで蓄積されてきた大量のコードが一度に検知対象になります。何年も運用されてきたプロジェクトでは、重要度フィルタで ERROR に絞ってもなお数十件〜数百件残る ということも珍しくありません。

これらは過去に書かれたコードであって、今このプルリクエストで悪化させたわけではありません。しかしワークフローの仕組み上は「現在のコードに含まれている検知」として扱われるため、自分のプルリクエストと無関係な既存コードの問題まで直さないとマージできない 状態になります。担当者にとっては理不尽な体験で、「自分が変更してもいないコードまで巻き取らされるのか」という不満につながり、結局プルリクエストが詰まって新機能の開発が事実上ストップしてしまいます。

2.2 解決策

理想を言えば、SAST導入時にすべての指摘事項を一度きれいに潰しておく のがベストです。現在のコードに脆弱性がない状態を起点にできれば、それ以降の運用は「新しく入る変更だけを止める」というシンプルなかたちになり、変な抜け道を考える必要がありません。長期運用するプロジェクトであれば、可能な限りこの状態を目指す価値があります。

ただし、長く運用されてきたプロジェクトでは検知件数が膨大で、すべて直すための工数とリリーススケジュールがそもそも折り合わない場合がほとんどです。そういった現実的なケースでは、「プルリクエストで変更されたファイルだけ」をスキャン対象にし、それ以外のファイルは対象から外す方針にします。git diff で取得したプルリクエストの変更ファイル一覧をSemgrepに渡し、変更されたファイルだけをスキャンする方式です。変更ファイル内に含まれる検知は、過去から残っているものも含めてすべてワークフローエラー対象になります。

シナリオ 扱い
プルリクエストで変更したファイルに以前からあった指摘 対象(変更した機会に拾い直す)
プルリクエストで追加・変更した部分の新しい指摘 対象
プルリクエストで変更していないファイルの指摘 対象外

これは「自分が対応した部分には責任を持つ」という方針です。変更していないファイルは責任範囲の外として扱い、変更した機会にはそのファイルに残っている既存問題も含めて拾い直すかたちです。これにより、自分のプルリクエストと無関係なファイルの問題に巻き込まれずに済みつつ、コードベース全体は変更する機会ごとに少しずつきれいになっていきます。

2.3 具体的な設定方法

git diff で変更ファイル一覧を取得し、それを Semgrep に渡します。差分を取るために actions/checkout のステップで fetch-depth: 0 を指定し、ベースブランチを含む全履歴を取得しておく必要があります。

- name: Checkout
  uses: actions/checkout@v4
  with:
    fetch-depth: 0

- name: Get changed files
  id: changed
  run: |
    echo "files=$(git diff --name-only --diff-filter=ACMR origin/${{ github.base_ref }}...HEAD | tr '\n' ' ')" >> $GITHUB_OUTPUT

- name: Run Semgrep on changed files
  if: steps.changed.outputs.files != ''
  run: semgrep scan --config auto --error ${{ steps.changed.outputs.files }}

--diff-filter=ACMR で削除済みファイル(D)を除外しているのは、プルリクエストで削除されたファイルがリストに残っているとSemgrepがファイルを見つけられずエラーになるためです。if: steps.changed.outputs.files != '' は、変更ファイルが0件のプルリクエスト(ドキュメントのみの変更など)でステップを空打ちしないためのガードです。

💡 ポイント
もうひとつのアプローチに「ベースライン方式」があります。Semgrepの --baseline-commit オプションに基準点となるコミットSHAを渡し、ベースライン時点と比較して 新しく増えた検知だけ をワークフロー失敗対象にする方式です。「触ったファイルかどうか」ではなく「悪化させていなければOK」という基準で、既存コードに完全にノータッチで運用できる利点はあります。ただし、プルリクエストで触ったファイルに既存問題があっても無視されるため、コードベース全体が少しずつきれいになっていく動きが起きにくく、既存問題が長く放置されやすい傾向があります。「現状維持で十分」と割り切れる場合に選ぶ選択肢で、本章では汎用性の高い変更ファイル方式を中心に紹介しています。

3. エラーが出てもマージを止められない

3.1 よくある問題

プルリクエストに対してSASTがワークフローで失敗する状態を作っても、リポジトリ側にルールを追加していないと、現実にはチェックがすり抜けられる経路がいくつも残ります。例えば、リリース直前で時間が無いときに「今回は急ぎなのでワークフローがエラーのままマージしてしまおう」と判断されたり、緊急の hotfix で main に直接Pushされたり、Push前にSASTのワークフローを一時的にコメントアウトされたりといった具合です。

このような運用上の判断は 悪意なく日常的に起こります。GitHubのデフォルト設定ではこれらをすべて許してしまうため、SASTのチェックが仕組みとして存在していても、「いざという時には回避できる」状態が続いてしまい、長期的に見ると脆弱性混入の防壁としては機能しません。SASTを実効性のある防壁にするには、運用の善意に頼らず、リポジトリのルールとして物理的に止める 仕組みが別途必要になります。

3.2 解決策

GitHubには 保護ブランチ(Branch protection rules / Rulesets)という機能があり、特定のブランチに対して「プルリクエストを通さずに直接Pushすることを禁止する」「指定したワークフローがすべて成功するまでマージボタンを押せなくする」「Force pushを禁止する」といったルールを、リポジトリ管理者が宣言的に設定できます。

main ブランチにこれらのルールを適用すれば、SAST のチェックを通らない限り main にコードが入らない状態を リポジトリ自身のルールとして強制 できます。担当者の善意や運用ルールに頼ることなく、ワークフローすり抜けマージの経路をGitHub側で物理的に塞ぐかたちです。SASTを「動いているけれど誰も困っていないから無視される」状態にしないために、ワークフローへの組み込みと合わせて入れておきたい設定です。

3.3 具体的な設定方法

これはSemgrep側ではなくGitHub側の設定で行います。main ブランチに対する保護ブランチを有効化し、必須ステータスチェック の対象として今回作成した Semgrep scan のジョブを指定するだけです。具体的な手順は別セクションGitHubで保護ブランチを設定しようで扱っているので、そちらを参考に設定してください。

💡 ポイント
マージ前チェックは「ぜんぶ失敗 vs ぜんぶ通す」の二択ではなく、重要度・変更ファイル範囲・ブランチ保護など多軸でチューニングできます。最初は重要度フィルタで ERROR のみエラー扱いにし、次に変更ファイル方式で触った範囲だけに絞り、最後に保護ブランチでマージ自体を物理的にブロックする、という順序で段階的に締めていくのが現実的です。