ローカ ルのセキュリティワークフロー
セキュリティ検査はワークステーション上で実行されます。スキャナは、チェックアウト済みのソースとロックファイルをローカルで検査します。いずれもスキャンサービスへはアップロードしません。ネットワークアクセスが使われるのは、ピン留めされたスキャナバイナリのインストール、ブートストラップ中の Go モジュールの取得、公開脆弱性データベースの更新だけです。
一度きりのセットアップ
make security-tools-install
make security-db-update
これにより、ハッシュ検証済みの Trivy v0.75.0 と Gitleaks v8.30.1 のリリースバイナリが $(go env GOPATH)/bin にインストールされ、Go と Trivy の脆弱性データベースが ~/.cache/yabanin-security と Trivy のローカルキャッシュ(macOS では ~/Library/Caches/trivy)にダウンロードされます。Go のバイナリフォルダを PATH 上に置いたままにします。データベースは毎日更新します。データベースがない、または 24 時間より古い場合は、クリーンなスキャンではなく失敗した検査です。
make security-db-update
make security-db-status
開発中
現在のブランチでローカルワーカーを起動します。
make security-start
make security-status
make security-stop
ワーカーは 10 秒ごとにブランチを検査します。保留中のコミットを最新の SHA にまとめ、シークレット検出のために未スキャンの範囲全体を保持し、使い捨てで切り離された worktree で一度に 1 件ずつスキャンします。作業中の開発ツリーは引き続き使えます。ワーカーは Git フックをインストールせず、外部サービスへメッセージを送りません。以前に成功した SHA が、現在のブランチ先端の代わりになることはありません。
即座に単一コミットをスキャンする場合:
make security-scan SECURITY_HEAD=HEAD SECURITY_BASE=<last-checked-sha>
最初のスキャンでは SECURITY_BASE を省略します。シークレットスキャナは、到達可能なコミット履歴を検査します。ワーカーレポート内の、artifacts/security-local/reports/ にあるマニフェストのパスを読みます。そこにある通常の品質マニフェストはソースのフィンガープリントに結び付いており、ゲートごとのログを持っています。
ランタイムとリリースの検査
make security-runtime SECURITY_HEAD=<sha>
make security-release SECURITY_HEAD=<sha> SECURITY_IMAGE=<local-image-tag>
ランタイム検査には、動作しているローカルの Docker デーモンが必要です。隔離されたチェックアウトに対して、既存のレース検査、モジュール統合、RLS、ゲートウェイ統合テストを実行します。リリースプロファイルは、指定されたローカルイメージをそのローカルの Docker 参照によってもスキャンします。そのイメージを pull したり push したりすることはありません。発見事項は品質マニフェストに現れ、合格という結果を阻みます。
結果の意味
passed は、その SHA について選択されたすべてのゲートが成功裡に完了し、正確なマニフェストを quality.py evidence で確認できることを意味します。failed は、スキャナが実行されて発見事項を報告したか、品質検査が失敗したことを意味します。データベースまたはスキャナのエラーはエラーとして表示され、再試行のためにキューに残ります。詳細は、名前の付いたゲートのログを調べます。シークレットスキャナの出力は、一致した値を伏せ字にします。
例外には、スキャナの発見事項、正確なパッケージとバージョン、またはシークレットルールとパス、所有者、理由、期限を特定しなければなりません。パッケージレベルの例外が、そのディレクトリ内の他の発見事項を抑制してはなりません。
検査の対象は、既知のシークレット形式、到達可能な Go のアドバイザリ、High および Critical の依存関係とイメージの脆弱性、静的解析、宣言されたコンテナ方針、既存の認可、テナント、SSRF のテストです。これらは脆弱性がないことを証明せず、セキュリティ境界の変更に対するレビューの代わりにもなりません。