mcpField
S
security-scan

security-scan

github.com/aws-samplesセキュリティ5367 回インストール9 週間前に更新
リポジトリ

security-scan について

AWS CDK プロジェクトのセキュリティ、ライセンス、デプロイ準備状況を監査するスキルです。コード、コンテナ、複合的なセキュリティ分析を含む9段階の手順を実施し、生データと HTML レポートを出力します。

主な機能

  1. 019段階のセキュリティスキャン
  2. 02CloudFormation テンプレート生成
  3. 03Viperlight によるコード分析
  4. 04ライセンス適合性チェック
  5. 05Trivy と ASH によるスキャン
  6. 06HTML レポート生成

活用シーン

  1. 01AWS CDK プロジェクトの監査
  2. 02依存関係のライセンス適合性確認
  3. 03コンテナイメージの脆弱性スキャン
  4. 04確認用のセキュリティ結果レポート作成

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/aws-samples/sample-agent-skills-for-builders --skill security-scan

インストール後、Claude Code で/security-scanを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

README.md
references/
architecture-diagram.md
ash-scan.md
cdk-synthesis.md
deployment-verification.md
license-check.md
report-generation.md
trivy-scan.md
viperlight-scan.md
scripts/
generate-html-report.py
generate-license-report.py

詳細

セキュリティスキャン

マルチツール分析による、AWS CDK プロジェクトの包括的なセキュリティおよびコンプライアンススキャンです。

適用する場面

次の作業を行う際に、このスキルを参照してください。

  • CDK プロジェクトのセキュリティ監査を実施する
  • ライセンスのコンプライアンスを確認する
  • コンテナイメージの脆弱性をスキャンする
  • 集約型の SAST／IaC／シークレット分析を実行する（ASH 経由）
  • レビュー用のセキュリティレポートを生成する

仕組み

重要：9 つのステップはすべて必須です。時間の制約にかかわらず、ステップを省略しないでください。

  1. アーキテクチャ図 - システムアーキテクチャを記録します
  2. CDK 合成 - CloudFormation テンプレートを生成します
  3. Viperlight スキャン - コードのセキュリティ分析を行います
  4. ライセンスチェック - 依存関係のライセンスコンプライアンスを確認します
  5. Trivy スキャン - コンテナの脆弱性をスキャンします
  6. ASH スキャン - Automated Security Helper（SAST／IaC／シークレットスキャナーを集約）を実行します
  7. デプロイ検証 - デプロイの準備状況を検証します
  8. 概要レポート - 検出結果の概要を生成します
  9. HTML レポート - ビジュアルレポートを作成します

前提条件

  • AWS CDK プロジェクト
  • Viperlight CLI がインストールされていること
  • Trivy CLI がインストールされていること
  • ASH（Automated Security Helper）- https://github.com/awslabs/automated-security-helper から uvx 経由でインストール
  • Docker（ASH のコンテナモードに必要）

使用方法

# Run security scan
"Run security scan on my CDK project"
"Check this project for vulnerabilities"
"Generate security compliance report"

出力

結果は security-scan-results/{TIMESTAMP}/ に保存されます。

  • 各ツールのスキャン出力（生データ）
  • clean-results/ - 解析済みの検出結果
  • security-report.html - ビジュアルレポート

適用ルール

  • すべてのスキャンコマンドを実行する（省略しない）
  • 検出された問題を修正する（コメントするだけにしない）
  • 非インタラクティブ実行のみ
  • 個々のステップが失敗してもパイプラインを続行する

参照

コメント

Markdown 対応