TL;DR
簡単に利用できるよう作成した PowerShell スクリプトを OSS として公開しました。
# 初期化処理（初回だけ実行してください）
.\init.ps1
# セキュリティ情報を取得
.\fetch.ps1
# Docker for Windows 用にイメージをビルド
docker build -t vuls .
# Vuls を実行する
# （事前に ~/.ssh/ に SSH 秘密鍵を設置してください）
.\vuls.ps1 configtest -config="/vuls/config.toml"
.\vuls.ps1 scan -config="/vuls/config.toml"
また、OWASP Dependency Check と連携して依存ライブラリ等の脆弱性もスキャンすることもできます1：
Set-Location "dependency-check"
# 初期化処理（初回だけ実行してください）
.\init.ps1
# OWASP Dependency Check を実行する
# （事前に ./target に対象とするパッケージを設置してください）
.\check.ps1
[servers]
[servers.sample]
host = "192.168.1.2"
port = "22"
user = "admin"
sshConfigPath = "/root/.ssh/config"
keyPath = "/root/.ssh/id_rsa"
scanMode = ["fast"]
# path to OWASP Dependency Check Report in docker
owaspDCXMLPath ="/vuls/dependency-check/odc-reports/dependency-check-report.xml"
Vuls を Windows で利用するときの「つまづきポイント」
fetch gost（Go Security Tracker）が失敗する問題
公式のチュートリアル Step 3. を単純に PowerShell に翻訳すると、以下のようになります：
docker run --rm -i -v "${PWD}:/vuls" -v "${PWD}/gost-log:/var/log/gost" "vuls/gost" fetch redhat
実際に試すとわかりますが、これは失敗してしまいます。理由は gost が clone する aquasecurity/vuln-list というリポジトリに、ファイル名に Windows の禁則文字を含む箇所があるためです。2 3 マウント機能でコンテナとリポジトリの情報を共有しているため、エラーとなってしまうのです。
幸い redhat/ や debian/ 以下には Windows の禁則文字が含まれていないので、これらに対する脆弱性診断であれば、リポジトリの一部を Clone する方法で対応可能です。alpine ユーザの方はごめんなさい。
git init
git config core.protectNTFS false # git for Windows 2.25 以降で必須
git config core.sparsecheckout true
git config core.longpaths true
git remote add origin "https://github.com/aquasecurity/vuln-list.git"
Copy-Item "..\sparse-checkout" ".git\info"
git pull origin master
/redhat/*
Windows 側で一度 sparse-checkout の設定をしておけば、docker コンテナ内でも滞りなく利用できるようになります。
PowerShell で年次ごとに処理を繰り返す
範囲演算子を利用すれば簡単に実現できます：
2002..(Get-Date).Year | ForEach-Object {
# $_ に年次が格納される
Write-Host $_;
}
スキャン日時表記を JST にする / UNPROTECTED PRIVATE KEY FILE!
チュートリアル Step 6. では -v /etc/localtime:/etc/localtime:ro -e "TZ=Asia/Tokyo" のように、ホストマシンのタイムゾーン設定をマウントし JST 表記に変更しています。しかし Windows には /etc/localtime がないので、別の方法で解決する必要があります。
また、スキャン対象との SSH 接続に利用する SSH 秘密鍵をホストマシンからマウントしますが、Windows からマウントしたファイル・フォルダはパーミッションが 777 になっています。SSH から鍵が TOO OPEN であると怒られてしまうので、entrypoint で chmod してしまいましょう。
FROM vuls/vuls
# タイムゾーンを取得する
RUN apk --no-cache add tzdata && \
cp /usr/share/zoneinfo/Asia/Tokyo /etc/localtime && \
apk del tzdata
COPY docker-entrypoint.sh /usr/local/bin
ENTRYPOINT ["sh", "docker-entrypoint.sh", "vuls"]
# !/bin/bash
cp -R /tmp/.ssh /root/.ssh
chmod 700 /root/.ssh
chmod 600 /root/.ssh/id_rsa
exec "$@"
参考リンク
- Setting the timezone
- Docker Tip #56: Volume Mounting SSH Keys into a Docker Container
- Vuls using Docker on Windows
- OWASP Dependency Checkを、Vulsと連携して表示させる
-
OWASP Dependency Check と連携させる場合は（JVN だけでなく）NVDから脆弱性情報を取得してください。 ↩
-
https://github.com/aquasecurity/vuln-list/blob/master/oval/redhat/6/2010/RHSA-2010:0842.json ↩
-
https://github.com/aquasecurity/vuln-list/blob/master/alpine/3.9/main/xen/CVE-2020-%3F%3F%3F%3F%3F.json ↩