Skip to content
KitploitKITPLOIT
ツールエクスプロイトブログ
Log in
提出
ツールエクスプロイトブログ
提出

ハッキング、侵入テスト、サイバーセキュリティツールをあなたのセキュリティアーセナルに!

Kitploitはハッキング、サイバーセキュリティ、ペネトレーションテストのツールディレクトリです。最新のプロジェクトアップデートを見つけて、脆弱性の発見、システム分析、テストの自動化、セキュリティの強化を行いましょう。

フィードお問い合わせプライバシー© 2026 Kitploit

ツールディレクトリ

カテゴリ

すべてのカテゴリを見る
Loading categories
trivy-action — TrivyをGitHub Actionとして実行し、Dockerコンテナイメージを脆弱性スキャンします。 | Kitploit
ツール/GitHubGitHub/aquasecurity/trivy-action
脆弱性スキャナーコンテナセキュリティコード分析クラウドセキュリティDevSecOpsシークレット検出サプライチェーンセキュリティ設定ミス
GitHubaquasecurity/trivy-action

trivy-action

TrivyをGitHub Actionとして実行し、Dockerコンテナイメージを脆弱性スキャンします。

リポジトリを見る
1.4k3574913日前Kitploit レビュー済み
共有

Trivy Action

Trivy 用の GitHub Action

[![GitHub Release][release-img]][release] [![GitHub Marketplace][marketplace-img]][marketplace] [![License][license-img]][license]

目次

  • 使用方法
    • CI パイプラインのスキャン
    • CI パイプラインのスキャン(Trivy Config を使用)
    • キャッシュ
    • Trivy のセットアップ
    • Tarball のスキャン
    • テンプレートを使用した Trivy の利用
    • GitHub Code Scanning を使用した Trivy の利用
    • Trivy を使用した Git リポジトリのスキャン
    • Trivy を使用した rootfs ディレクトリのスキャン
    • Trivy を使用した Infrastructure as Code のスキャン
    • Trivy を使用した SBOM の生成
    • Trivy を使用したプライベートレジストリのスキャン
    • コードスキャンが有効になっていない場合の Trivy の利用
  • カスタマイズ
    • inputs
    • 環境変数
    • Trivy 設定ファイル

使用方法

CI パイプラインのスキャン

name: build
on:
  push:
    branches:
      - main
  pull_request:
jobs:
  build:
    name: Build
    runs-on: ubuntu-24.04
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
      - name: Build an image from Dockerfile
        run: docker build -t docker.io/my-organization/my-app:${{ github.sha }} .
      - name: Run Trivy vulnerability scanner
        uses: aquasecurity/[email protected]
        with:
          image-ref: 'docker.io/my-organization/my-app:${{ github.sha }}'
          format: 'table'
          exit-code: '1'
          ignore-unfixed: true
          vuln-type: 'os,library'
          severity: 'CRITICAL,HIGH'

CI パイプラインのスキャン(Trivy Config を使用)

name: build
on:
  push:
    branches:
    - main
  pull_request:
jobs:
  build:
    name: Build
    runs-on: ubuntu-24.04
    steps:
    - name: Checkout code
      uses: actions/checkout@v4

    - name: Run Trivy vulnerability scanner in fs mode
      uses: aquasecurity/[email protected]
      with:
        scan-type: 'fs'
        scan-ref: '.'
        trivy-config: trivy.yaml

この場合、trivy.yaml はリポジトリの一部としてチェックインされる YAML 設定です。詳細情報は Trivy のウェブサイトで入手できますが、例は以下のとおりです:

format: json
exit-code: 1
severity: CRITICAL
secret:
  config: config/trivy/secret.yaml

すべてのオプションは trivy.yaml ファイルで定義できます。アクション経由で個別のオプションを指定する方法は、後方互換性のために残されています。以下は設定ファイルでは定義できないため、指定が必須です:

  • scan-ref: fs, repo スキャンを使用する場合。
  • image-ref: image スキャンを使用する場合。
  • scan-type: スキャンタイプを定義する場合(例:image、fs、repo など)。

オプションの優先順位

Trivy は Viper を使用しており、オプションには定義された優先順位があります。順序は以下のとおりです:

  • GitHub Action フラグ
  • 環境変数
  • 設定ファイル
  • デフォルト

キャッシュ

このアクションには、スキャン中にダウンロードされた場合に脆弱性 DB、Java DB、およびチェックバンドルをキャッシュおよび復元する組み込み機能があります。 キャッシュはデフォルトで $GITHUB_WORKSPACE/.cache/trivy ディレクトリに保存されます。 キャッシュはスキャン開始前に復元され、スキャン終了後に保存されます。

内部的には actions/cache を使用していますが、必要な設定項目はより少なくなっています。 キャッシュの入力は任意であり、キャッシュはデフォルトで有効になっています。

キャッシュの無効化

キャッシュを無効にしたい場合は、cache 入力を false に設定しますが、レート制限の問題を避けるために有効のままにしておくことを推奨します。

    - name: Run Trivy scanner without cache
      uses: aquasecurity/[email protected]
      with:
        scan-type: 'fs'
        scan-ref: '.'
        cache: 'false'

デフォルトブランチでのキャッシュの更新

GitHub Actions では、ブランチ間のキャッシュアクセスに制限があることに注意してください。 デフォルトでは、ワークフローは現在のブランチまたはデフォルトブランチ(通常は main または master)で作成されたキャッシュにアクセスして復元できます。 ブランチ間でキャッシュを共有する必要がある場合は、デフォルトブランチでキャッシュを作成し、現在のブランチで復元する必要があります。

ワークフローを最適化するには、cron ジョブを設定してデフォルトブランチのキャッシュを定期的に更新できます。 これにより、後続のスキャンはキャッシュされた DB を再ダウンロードせずに使用できます。

# Note: This workflow only updates the cache. You should create a separate workflow for your actual Trivy scans.
# In your scan workflow, set TRIVY_SKIP_DB_UPDATE=true and TRIVY_SKIP_JAVA_DB_UPDATE=true.
name: Update Trivy Cache

on:
  schedule:
    - cron: '0 0 * * *'  # Run daily at midnight UTC
  workflow_dispatch:  # Allow manual triggering

jobs:
  update-trivy-db:
    runs-on: ubuntu-latest
    steps:
      - name: Setup oras
        uses: oras-project/setup-oras@v1

      - name: Get current date
        id: date
        run: echo "date=$(date +'%Y-%m-%d')" >> $GITHUB_OUTPUT

      - name: Download and extract the vulnerability DB
        run: |
          mkdir -p $GITHUB_WORKSPACE/.cache/trivy/db
          oras pull ghcr.io/aquasecurity/trivy-db:2
          tar -xzf db.tar.gz -C $GITHUB_WORKSPACE/.cache/trivy/db
          rm db.tar.gz

      - name: Download and extract the Java DB
        run: |
          mkdir -p $GITHUB_WORKSPACE/.cache/trivy/java-db
          oras pull ghcr.io/aquasecurity/trivy-java-db:1
          tar -xzf javadb.tar.gz -C $GITHUB_WORKSPACE/.cache/trivy/java-db
          rm javadb.tar.gz

      - name: Cache DBs
        uses: actions/cache/save@v4
        with:
          path: ${{ github.workspace }}/.cache/trivy
          key: cache-trivy-${{ steps.date.outputs.date }}

スキャンを実行する際は、環境変数 TRIVY_SKIP_DB_UPDATE と TRIVY_SKIP_JAVA_DB_UPDATE を設定してダウンロード処理をスキップしてください。

    - name: Run Trivy scanner without downloading DBs
      uses: aquasecurity/[email protected]
      with:
        scan-type: 'image'
        scan-ref: 'myimage'
      env:
        TRIVY_SKIP_DB_UPDATE: true
        TRIVY_SKIP_JAVA_DB_UPDATE: true

Trivy のセットアップ

デフォルトでは、このアクションは最初のステップとして aquasecurity/setup-trivy を呼び出し、version 入力で指定されたバージョンの trivy をインストールします。他の手段で既に trivy をインストールしている場合(例: aquasecurity/setup-trivy を直接呼び出した場合、またはこのアクションを複数回実行する場合)は、skip-setup-trivy 入力を使用してこのステップを無効にできます。

Trivy を手動でセットアップする

name: build
on:
  push:
    branches:
    - main
  pull_request:
jobs:
  build:
    name: Build
    runs-on: ubuntu-24.04
    steps:
    - name: Checkout code
      uses: actions/checkout@v4

    - name: Manual Trivy Setup
      uses: aquasecurity/[email protected]
      with:
        cache: true
        version: v0.76.2

    - name: Run Trivy vulnerability scanner in repo mode
      uses: aquasecurity/[email protected]
      with:
        scan-type: 'fs'
        ignore-unfixed: true
        format: 'sarif'
        output: 'trivy-results.sarif'
        severity: 'CRITICAL'
        skip-setup-trivy: true

Trivy Actionを複数回呼び出す際のセットアップのスキップ

もう一つの一般的なユースケースは、ビルドがこのアクションを複数回呼び出す場合です。この場合、後続の呼び出しで skip-setup-trivy を true に設定できます。例:

name: build

on:
  push:
    branches:
      - main
  pull_request:

jobs:
  test:
    runs-on: ubuntu-latest
    permissions:
      contents: read
    steps:
      - name: Check out Git repository
        uses: actions/checkout@v4

      # The first call to the action will invoke setup-trivy and install trivy
      - name: Generate Trivy Vulnerability Report
        uses: aquasecurity/[email protected]
        with:
          scan-type: "fs"
          output: trivy-report.json
          format: json
          scan-ref: .
          exit-code: 0

      - name: Upload Vulnerability Scan Results
        uses: actions/upload-artifact@v4
        with:
          name: trivy-report
          path: trivy-report.json
          retention-days: 30
ツールをダウンロード

人気

すべて見る →

コミュニティで最も使われているツールを見つけましょう。

  • 1

    OsintHunter

    letox4/osinthunter

    🎯 究極のOSINTツールキット:調査グラフ、信頼度スコアリング、エイリアスファミリー、マップ、タイムライン、レポート。49個のモジュール、400以上のサイト、APIキー不要。

    837
  • 2

    ghostlock-app

    yukonga/ghostlock-app

    GhostLock ワンタップ実行アプリ(CVE-2026-43499)

    536
  • 3

    ARTEX

    baarai/artex

    プランナー/ワーカーエージェント、資産グラフと探索グラフ、MITMトラフィック記録、脆弱性の再テストを備えたLLMマルチエージェント自律ペネトレーションテストプラットフォーム。

    424
  • 4

    redforge

    cybersecurity91/redforge

    ブラウザ側のレッドチームツールキット。偵察、ペイロード生成、認証情報攻撃、暗号、エンコーディング、エンゲージメントレポート向けの102のオフラインツールを備えています。

    355
  • 5

    looking-glass

    anonghosty/looking-glass

    ShadowserverレポートをMongoDBに取り込み、インタラクティブなマップ、分析、調査結果、アドバイザリ、エグゼクティブダッシュボードとして再生するCSIRTプラットフォーム。

    294
  • 6

    CyberStrikeAI

    ed1s0nz/cyberstrikeai

    AIネイティブなサイバーセキュリティのためのアクションシステム。意図がガバナンスされた実行に変わり、証拠が運用記憶となり、すべての操作が次の操作を改善する。

    276

すべてのツールを探索

ツールコレクションを閲覧

すべてのツールを見る →