{"id":31956038,"url":"https://github.com/cisagov/clamav-report","last_synced_at":"2025-10-30T22:43:53.335Z","repository":{"id":40463329,"uuid":"206657926","full_name":"cisagov/clamav-report","owner":"cisagov","description":"Generate reports from groups of hosts running ClamAV","archived":false,"fork":false,"pushed_at":"2025-10-14T18:10:56.000Z","size":1045,"stargazers_count":11,"open_issues_count":4,"forks_count":6,"subscribers_count":2,"default_branch":"develop","last_synced_at":"2025-10-23T19:51:56.019Z","etag":null,"topics":["anti-virus","clamav","csv","reporting"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc0-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cisagov.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2019-09-05T21:10:13.000Z","updated_at":"2025-07-29T17:50:42.000Z","dependencies_parsed_at":"2025-05-20T18:33:00.555Z","dependency_job_id":"bbf6d0d3-de2c-45cb-b046-1dea90c42045","html_url":"https://github.com/cisagov/clamav-report","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/cisagov/clamav-report","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cisagov%2Fclamav-report","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cisagov%2Fclamav-report/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cisagov%2Fclamav-report/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cisagov%2Fclamav-report/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cisagov","download_url":"https://codeload.github.com/cisagov/clamav-report/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cisagov%2Fclamav-report/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":281896642,"owners_count":26580138,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-30T02:00:06.501Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["anti-virus","clamav","csv","reporting"],"created_at":"2025-10-14T14:47:21.952Z","updated_at":"2025-10-30T22:43:53.317Z","avatar_url":"https://github.com/cisagov.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# clamav-report 🦪📊 #\n\n[![GitHub Build Status](https://github.com/cisagov/clamav-report/workflows/build/badge.svg)](https://github.com/cisagov/clamav-report/actions)\n[![CodeQL](https://github.com/cisagov/clamav-report/workflows/CodeQL/badge.svg)](https://github.com/cisagov/clamav-report/actions/workflows/codeql-analysis.yml)\n[![Coverage Status](https://coveralls.io/repos/github/cisagov/clamav-report/badge.svg?branch=develop)](https://coveralls.io/github/cisagov/clamav-report?branch=develop)\n[![Known Vulnerabilities](https://snyk.io/test/github/cisagov/clamav-report/develop/badge.svg)](https://snyk.io/test/github/cisagov/clamav-report)\n\nThis is a tool that will collect ClamAV data using an\n[Ansible](https://www.ansible.com) inventory and create a CSV file\nthat is able to be ingested by legacy compliance tools.\n\nIt assumes that ClamAV has been installed using the\n[Ansible ClamAV role](https://github.com/cisagov/ansible-role-clamav).\n\n## Usage ##\n\n```console\n$ clamav-report tests/files/inventory.txt clamav-201909.csv\n\n2019-09-09 15:39:41,256 INFO Gathering ClamAV data from remote servers.\n2019-09-09 15:39:42,292 WARNING Task callback UNREACHABLE: borked.foo.gov - Gathering Facts\n2019-09-09 15:39:47,268 INFO Generating consolidated virus report: clamav-201909.csv\n```\n\nFor gathering ClamAV log data from AWS instances that are accessible via\n[SSM](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html),\nthe `clamav_log_report.sh` shell script has been provided in the `extras`\ndirectory:\n\n```console\n$ ./extras/clamav_log_report.sh i-0123456789abcdef0\n\nStarting session with SessionId: iam.username-0123456789abcdef0\n\nbar.foo.gov\n----------- SCAN SUMMARY -----------\nKnown viruses: 8654853\nEngine version: 0.103.6\nScanned directories: 5141\nScanned files: 42629\nInfected files: 0\nData scanned: 2949.27 MB\nData read: 3249.70 MB (ratio 0.91:1)\nTime: 574.106 sec (9 m 34 s)\nStart Date: 2023:03:05 06:47:01\nEnd Date:   2023:03:05 06:56:35\n\nExiting session with sessionId: david.redmin-0123456789abcdef0.\n```\n\n## Contributing ##\n\nWe welcome contributions!  Please see [`CONTRIBUTING.md`](CONTRIBUTING.md) for\ndetails.\n\n## License ##\n\nThis project is in the worldwide [public domain](LICENSE).\n\nThis project is in the public domain within the United States, and\ncopyright and related rights in the work worldwide are waived through\nthe [CC0 1.0 Universal public domain\ndedication](https://creativecommons.org/publicdomain/zero/1.0/).\n\nAll contributions to this project will be released under the CC0\ndedication. By submitting a pull request, you are agreeing to comply\nwith this waiver of copyright interest.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcisagov%2Fclamav-report","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcisagov%2Fclamav-report","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcisagov%2Fclamav-report/lists"}