chromepatrol

Headless Chrome 経由で、サイト上のリスクを検出するツールです。

使い方

1. プロジェクトのルートでdocker build -t gpioblink/chromepatrol .を実行しビルド
2. docker run --name hogehoge -it gpioblink/chromepatrolでコンテナを立ち上げる
3. docker exec -it hogehoge node index.js https://<検証したいURL>でリスク検出を実行
4. docker stop hogehogeとdocker rm hogehogeを実行して終了

NT-Dとの統合について

minikubeで立ち上げる場合

1. NT-DのREADMEを参考にNT-Dが起動できるようにします
2. eval $(minikube docker-env)とdocker build -t gpioblink/chromepatrol:v1.0 .を実行してminikube内にイメージをビルドします
3. このプロジェクトのfor-ntd/chromepatrol_latest.pyをNT-Dのcore/detectorsにコピーします
4. NT-DのUI上からchromepatrol_latestを用いて検証を試してみてください

Tips

ChromeDevToolsProtocolから取れる情報について

重要なイベントやメソッドをdocs/useful-cdp-functions.mdにまとめていますので参考にしてください。

ChromeのDevToolsをDevToolsで開く方法

この方法を使用すると、Chromeが開発者ツール上から叩いている情報を知ることができます。Chromeが使用しているメソッドやイベントを参考にしながらルール作成の参考にできます。

1. alias chrome="/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome"
2. chrome --headless --disable-gpu --remote-debugging-port=9222 https://example.com
3. 別のchromeから http://localhost:9222 にアクセス
4. 開きたいタブを選択するとデバッグ画面が出る
5. さらにショートカットキーで開発者ツールをを開く
6. 5で開いた開発者ツールのネットワークから、websocketの通信を覗くと、CDPでやってることが分かる