Log4j-CVE-2021-44228 detector scanner playbook

Log4Shell（CVE-2021-44228）用の公式Red Hat Log4j検出スクリプトを使用して、対象のLinuxホストを検証するAnsible playbookです。

Red Hat バージョン 1.3 detector 2022-01-10。

結果は detector_dir（デフォルト: /opt/cve-2021-44228/）の下にあるtxtファイルに保存されます。

Ansible Galaxy ロール

コードはAnsible Galaxyロール lucab85.ansible_role_log4shell としても利用できます。```bash ansible-galaxy install lucab85.ansible_role_log4shell

## Ansible Playbook の実行方法

デフォルトの変数は、影響を受けるファイルを `/var/` パス全体でスキャンします。
`vars.yml` ファイルをカスタマイズして、追加のオプションを設定できます。```bash
ansible-playbook log4j-cve-2021-44228.yml

依存関係

なし。

要件

ansible 2.9+

変数 vars.yml

デフォルト値:```yaml rh_bullettin: >- https://access.redhat.com/security/vulnerabilities/RHSB-2021-009 intro: | Ansible Playbook tested with detector version 1.3 released 2022-01-10. If a 404 error occur please adjust the URL with the latest version available for detector URL. Please refer to the Red Hat Security Bullettin for up-to-date information and adjust the playbook variables accordingly. {{ rh_bullettin }}. vulnerable: | System MIGHT be vulnerable to log4j (CVE-2021-44228) not_vulnerable: | System IS NOT vulnerable to log4j (CVE-2021-44228) report_txt: "/report/vuln_log4j2_path_*.txt" sh_detector: "cve-2021-44228--2022-01-10-1242.sh" sh_signature: "cve-2021-44228--2022-01-10-1242.sh.asc" detector_baseurl: "https://access.redhat.com/sites/default/files/" force_download: false detector_path: "/var/" detector_dir: "/opt/cve-2021-44228/" detector_run_dir: "tmp" detector_options: '-n -d --no-progress --scan {{ detector_path }}' gpg_keyid: "7514F77D8366B0D9" gpg_server: "pgp.mit.edu" gpg_public_key: 'gpg --keyserver {{ gpg_server }} --recv {{ gpg_keyid }}' clean_run_before: true delete_after: false verify_gpg: true

- `rh_bullettin`: RHSBのリンク (デフォルト: [https://access.redhat.com/security/vulnerabilities/RHSB-2021-009](https://access.redhat.com/security/vulnerabilities/RHSB-2021-009))
- `intro`: 導入テキスト
- `vulnerable`: 脆弱性ありテキスト (デバッグレベル2の実行 `-vv` でのみ表示)
- `not_vulnerable`: 脆弱性なしテキスト (デバッグレベル2の実行 `-vv` でのみ表示)
- `report_txt`: 出力するレポートパス (デフォルト: `/report/vuln_log4j2_path_*.txt`)
- `sh_detector`: 検出用bashスクリプトファイルのファイル名
- `sh_signature`: 検出用GPG署名ファイルのファイル名
- `detector_baseurl`: 上記のファイルをダウンロードするベースURL
- `force_download`: 毎回実行時にコードのダウンロードを強制する (デフォルト: `false`)
- `detector_path`: 検査するパス (デフォルト: `/var/`)
- `detector_dir`: 検出器のダウンロード先パス (デフォルト: `/opt/cve-2021-44228/`)
- `detector_run_dir`: 実行前に作成するサブディレクトリ (デフォルト: `tmp`)
- `detector_options`: 検出スクリプトのコマンドラインオプション (デフォルト: `-n -d --no-progress --scan {{ detector_path }}`)
- `gpg_keyid`: 検証用にダウンロードするGPG公開鍵 (デフォルト: Red Hat Product Security `7514F77D8366B0D9`)
- `gpg_server`: GPGキーサーバー (デフォルト: `pgp.mit.edu`)
- `gpg_public_key`: gpg検証用のコマンド (デフォルト: `gpg --keyserver {{ gpg_server }} --recv {{ gpg_keyid }}`)
- `clean_run_before`: 実行前に実行ディレクトリを削除して再作成する - 検出器は空のディレクトリを必要とする (デフォルト: `true`)
- `delete_after`: 実行後に _detector_dir_ を削除する (デフォルト: `false`)
- `verify_gpg`: GPG署名のダウンロードと検証を実行する (デフォルト: `true`)


## デモ実行

RHEL8デモ対象ホストに対するプレイブック実行の完全な出力:```bash
$ ansible-playbook -i test/inventory log4j-cve-2021-44228.yml -vv
ansible-playbook [core 2.12.1]
  config file = None
  configured module search path = ['/Users/lberton/.ansible/plugins/modules', '/usr/share/ansible/plugins/modules']
  ansible python module location = /usr/local/Cellar/ansible/5.1.0/libexec/lib/python3.10/site-packages/ansible
  ansible collection location = /Users/lberton/.ansible/collections:/usr/share/ansible/collections
  executable location = /usr/local/bin/ansible-playbook
  python version = 3.10.1 (main, Dec  6 2021, 23:20:29) [Clang 13.0.0 (clang-1300.0.29.3)]
  jinja version = 3.0.3
  libyaml = True
No config file found; using defaults
Skipping callback 'default', as we already have a stdout callback.
Skipping callback 'minimal', as we already have a stdout callback.
Skipping callback 'oneline', as we already have a stdout callback.

PLAYBOOK: log4j-cve-2021-44228.yml *********************************************************************************************************************************************************
2 plays in log4j-cve-2021-44228.yml

PLAY [download detector for Apache Log4j (CVE-2021-44228)] *********************************************************************************************************************************
META: ran handlers

TASK [include_vars] ************************************************************************************************************************************************************************
task path: /Users/lberton/prj/github/log4j-cve-2021-44228/log4j-cve-2021-44228.yml:29
ok: [localhost] => {"ansible_facts": {"clean_run_before": true, "delete_after": false, "detector_baseurl": "https://access.redhat.com/sites/default/files/", "detector_dir": "/opt/cve-2021-44228/", "detector_options": "-n -d --no-progress --scan {{ detector_path }}", "detector_path": "/var/", "detector_run_dir": "tmp", "force_download": false, "gpg_keyid": "7514F77D8366B0D9", "gpg_public_key": "gpg --keyserver {{ gpg_server }} --recv {{ gpg_keyid }}", "gpg_server": "pgp.mit.edu", "intro": "Ansible Playbook tested with detector version 1.3 released 2022-01-10.\nIf a 404 error occur please adjust the URL with the latest version available\nfor detector URL.\nPlease refer to the Red Hat Security Bullettin for up-to-date information and\nadjust the playbook variables accordingly.\n{{ rh_bullettin }}.\n", "not_vulnerable": "System IS NOT vulnerable to log4j (CVE-2021-44228)\n", "report_txt": "/report/vuln_log4j2_path_*.txt", "rh_bullettin": "https://access.redhat.com/security/vulnerabilities/RHSB-2021-009", "sh_detector": "cve-2021-44228--2022-01-10-1242.sh", "sh_signature": "cve-2021-44228--2022-01-10-1242.sh.asc", "verify_gpg": true, "vulnerable": "System MIGHT be vulnerable to log4j (CVE-2021-44228)\n"}, "ansible_included_var_files": ["/Users/lberton/prj/github/log4j-cve-2021-44228/vars.yml"], "changed": false}

TASK [print information] *******************************************************************************************************************************************************************
task path: /Users/lberton/prj/github/log4j-cve-2021-44228/log4j-cve-2021-44228.yml:31
ok: [localhost] => {
    "msg": "Ansible Playbook tested with detector version 1.3 released 2022-01-10.\nIf a 404 error occur please adjust the URL with the latest version available\nfor detector URL.\nPlease refer to the Red Hat Security Bullettin for up-to-date information and\nadjust the playbook variables accordingly.\nhttps://access.redhat.com/security/vulnerabilities/RHSB-2021-009.\n"
}

TASK [download detector] *******************************************************************************************************************************************************************
task path: /Users/lberton/prj/github/log4j-cve-2021-44228/log4j-cve-2021-44228.yml:35
ok: [localhost] => {"changed": false, "dest": "./cve-2021-44228--2022-01-10-1242.sh", "elapsed": 0, "gid": 20, "group": "staff", "mode": "0644", "msg": "HTTP Error 304: Not Modified", "owner": "lberton", "size": 67710, "state": "file", "status_code": 304, "uid": 501, "url": "https://access.redhat.com/sites/default/files/cve-2021-44228--2022-01-10-1242.sh"}