{"id":13531002,"url":"https://github.com/crazy-max/ghaction-virustotal","last_synced_at":"2025-10-10T17:06:58.225Z","repository":{"id":36996646,"uuid":"259383357","full_name":"crazy-max/ghaction-virustotal","owner":"crazy-max","description":"GitHub Action to upload and scan files with VirusTotal","archived":false,"fork":false,"pushed_at":"2025-06-16T19:03:50.000Z","size":13474,"stargazers_count":185,"open_issues_count":13,"forks_count":20,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-06-30T11:55:04.003Z","etag":null,"topics":["actions","github-actions","virustotal"],"latest_commit_sha":null,"homepage":"https://github.com/marketplace/actions/virustotal-github-action","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/crazy-max.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":".github/SUPPORT.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"crazy-max","custom":"https://www.paypal.me/crazyws"}},"created_at":"2020-04-27T16:06:21.000Z","updated_at":"2025-06-26T03:31:22.000Z","dependencies_parsed_at":"2024-04-27T11:36:11.152Z","dependency_job_id":"c2b1c940-6bd7-4fde-9c48-ef3b224cc9c9","html_url":"https://github.com/crazy-max/ghaction-virustotal","commit_stats":{"total_commits":293,"total_committers":7,"mean_commits":"41.857142857142854","dds":"0.38566552901023887","last_synced_commit":"93ce6fb8ca09fed3d3d2010a8be65552ae5d3854"},"previous_names":[],"tags_count":27,"template":false,"template_full_name":null,"purl":"pkg:github/crazy-max/ghaction-virustotal","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crazy-max%2Fghaction-virustotal","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crazy-max%2Fghaction-virustotal/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crazy-max%2Fghaction-virustotal/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crazy-max%2Fghaction-virustotal/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/crazy-max","download_url":"https://codeload.github.com/crazy-max/ghaction-virustotal/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/crazy-max%2Fghaction-virustotal/sbom","scorecard":{"id":307690,"data":{"date":"2025-08-11","repo":{"name":"github.com/crazy-max/ghaction-virustotal","commit":"d34968c958ae283fe976efed637081b9f9dcf74f"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":4.3,"checks":[{"name":"Code-Review","score":0,"reason":"Found 0/3 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Token-Permissions","score":10,"reason":"GitHub workflow tokens follow principle of least privilege","details":["Info: jobLevel 'contents' permission set to 'read': .github/workflows/labels.yml:28","Info: topLevel 'contents' permission set to 'read': .github/workflows/ci.yml:9","Info: topLevel 'contents' permission set to 'read': .github/workflows/labels.yml:9","Info: topLevel 'contents' permission set to 'read': .github/workflows/test.yml:9","Info: topLevel 'contents' permission set to 'read': .github/workflows/validate.yml:9","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":-1,"reason":"internal error: error during branchesHandler.setup: internal error: githubv4.Query: Resource not accessible by integration","details":null,"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 30 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:27: update your workflow using https://app.stepsecurity.io/secureworkflow/crazy-max/ghaction-virustotal/ci.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:30: update your workflow using https://app.stepsecurity.io/secureworkflow/crazy-max/ghaction-virustotal/ci.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/labels.yml:34: update your workflow using https://app.stepsecurity.io/secureworkflow/crazy-max/ghaction-virustotal/labels.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/labels.yml:37: update your workflow using https://app.stepsecurity.io/secureworkflow/crazy-max/ghaction-virustotal/labels.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/test.yml:24: update your workflow using https://app.stepsecurity.io/secureworkflow/crazy-max/ghaction-virustotal/test.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/test.yml:27: update your workflow using https://app.stepsecurity.io/secureworkflow/crazy-max/ghaction-virustotal/test.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/test.yml:37: update your workflow using https://app.stepsecurity.io/secureworkflow/crazy-max/ghaction-virustotal/test.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/validate.yml:26: update your workflow using https://app.stepsecurity.io/secureworkflow/crazy-max/ghaction-virustotal/validate.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/validate.yml:30: update your workflow using https://app.stepsecurity.io/secureworkflow/crazy-max/ghaction-virustotal/validate.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/validate.yml:45: update your workflow using https://app.stepsecurity.io/secureworkflow/crazy-max/ghaction-virustotal/validate.yml/master?enable=pin","Warn: containerImage not pinned by hash: dev.Dockerfile:5","Warn: containerImage not pinned by hash: dev.Dockerfile:15","Warn: containerImage not pinned by hash: dev.Dockerfile:24","Warn: containerImage not pinned by hash: dev.Dockerfile:36","Warn: containerImage not pinned by hash: dev.Dockerfile:45","Warn: containerImage not pinned by hash: dev.Dockerfile:57","Warn: containerImage not pinned by hash: dev.Dockerfile:67","Warn: containerImage not pinned by hash: dev.Dockerfile:73","Info:   0 out of   5 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   5 third-party GitHubAction dependencies pinned","Info:   0 out of   8 containerImage dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Vulnerabilities","score":5,"reason":"5 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GHSA-968p-4wvh-cqc8","Warn: Project is vulnerable to: GHSA-v6h2-p8h4-qcjw","Warn: Project is vulnerable to: GHSA-fjxv-7rqg-78g4","Warn: Project is vulnerable to: GHSA-2p57-rm9w-gvfp","Warn: Project is vulnerable to: GHSA-c2qf-rxjj-qqgw"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-17T22:29:23.536Z","repository_id":36996646,"created_at":"2025-08-17T22:29:23.537Z","updated_at":"2025-08-17T22:29:23.537Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279004815,"owners_count":26083783,"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-10T02:00:06.843Z","response_time":62,"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":["actions","github-actions","virustotal"],"created_at":"2024-08-01T07:00:58.942Z","updated_at":"2025-10-10T17:06:58.204Z","avatar_url":"https://github.com/crazy-max.png","language":"TypeScript","funding_links":["https://github.com/sponsors/crazy-max","https://www.paypal.me/crazyws"],"categories":["TypeScript","Community Resources"],"sub_categories":["Utility"],"readme":"\u003cp align=\"center\"\u003e\u003ca href=\"https://github.com/crazy-max/ghaction-virustotal\" target=\"_blank\"\u003e\u003cimg height=\"160\" src=\"https://raw.githubusercontent.com/crazy-max/ghaction-virustotal/master/.github/virustotal-github-actions.png\"\u003e\u003c/a\u003e\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/crazy-max/ghaction-virustotal/releases/latest\"\u003e\u003cimg src=\"https://img.shields.io/github/release/crazy-max/ghaction-virustotal.svg?style=flat-square\" alt=\"GitHub release\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/marketplace/actions/virustotal-github-action\"\u003e\u003cimg src=\"https://img.shields.io/badge/marketplace-virustotal--github--action-blue?logo=github\u0026style=flat-square\" alt=\"GitHub marketplace\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/crazy-max/ghaction-virustotal/actions?workflow=ci\"\u003e\u003cimg src=\"https://img.shields.io/github/actions/workflow/status/crazy-max/ghaction-virustotal/ci.yml?branch=master\u0026label=ci\u0026logo=github\u0026style=flat-square\" alt=\"CI workflow\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/crazy-max/ghaction-virustotal/actions?workflow=test\"\u003e\u003cimg src=\"https://img.shields.io/github/actions/workflow/status/crazy-max/ghaction-virustotal/test.yml?branch=master\u0026label=test\u0026logo=github\u0026style=flat-square\" alt=\"Test workflow\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://codecov.io/gh/crazy-max/ghaction-virustotal\"\u003e\u003cimg src=\"https://img.shields.io/codecov/c/github/crazy-max/ghaction-virustotal?logo=codecov\u0026style=flat-square\" alt=\"Codecov\"\u003e\u003c/a\u003e\n  \u003cbr /\u003e\u003ca href=\"https://github.com/sponsors/crazy-max\"\u003e\u003cimg src=\"https://img.shields.io/badge/sponsor-crazy--max-181717.svg?logo=github\u0026style=flat-square\" alt=\"Become a sponsor\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.paypal.me/crazyws\"\u003e\u003cimg src=\"https://img.shields.io/badge/donate-paypal-00457c.svg?logo=paypal\u0026style=flat-square\" alt=\"Donate Paypal\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n## About\n\nGitHub Action to upload and scan files with [VirusTotal](https://www.virustotal.com).\n\n___\n\n* [Usage](#usage)\n  * [Scan local files](#scan-local-files)\n  * [Scan assets of a published release](#scan-assets-of-a-published-release)\n  * [Scan through VirusTotal Monitor](#scan-through-virustotal-monitor)\n* [Customizing](#customizing)\n  * [inputs](#inputs)\n  * [outputs](#outputs)\n* [Contributing](#contributing)\n* [License](#license)\n\n## Usage\n\n### Scan local files\n\nThis action can be used to scan local files with VirusTotal:\n\n![VirusTotal GitHub Action](.github/ghaction-virustotal-files.png)\n\n```yaml\nname: build\n\npermissions:\n  contents: read\n\non:\n  push:\n\njobs:\n  build:\n    runs-on: ubuntu-latest\n    steps:\n      -\n        name: Checkout\n        uses: actions/checkout@v4\n      -\n        name: Set up Go\n        uses: actions/setup-go@v5\n      -\n        name: Build\n        run: |\n          GOOS=windows GOARCH=386 go build -o ./ghaction-virustotal-win32.exe -v -ldflags \"-s -w\"\n          GOOS=windows GOARCH=amd64 go build -o ./ghaction-virustotal-win64.exe -v -ldflags \"-s -w\"\n      -\n        name: VirusTotal Scan\n        uses: crazy-max/ghaction-virustotal@v4\n        with:\n          vt_api_key: ${{ secrets.VT_API_KEY }}\n          files: |\n            ./ghaction-virustotal-win32.exe\n            ./ghaction-virustotal-win64.exe\n```\n\n### Scan assets of a published release\n\nYou can also use this action to scan assets of a published release on GitHub\nwhen a [release event](https://help.github.com/en/actions/reference/events-that-trigger-workflows#release-event-release)\nis triggered:\n\n```yaml\nname: released\n\npermissions:\n  contents: read\n\non:\n  release:\n    types:\n      - published\n\njobs:\n  virustotal:\n    runs-on: ubuntu-latest\n    steps:\n      -\n        name: VirusTotal Scan\n        uses: crazy-max/ghaction-virustotal@v4\n        with:\n          vt_api_key: ${{ secrets.VT_API_KEY }}\n          files: |\n            .exe$\n```\n\nIf you set `update_release_body: true` input, analysis link(s) will be appended\nto the release body:\n\n```yaml\nname: released\n\npermissions:\n  contents: read\n\non:\n  release:\n    types:\n      - published\n\njobs:\n  virustotal:\n    runs-on: ubuntu-latest\n    permissions:\n      # required to write GitHub Release body\n      contents: write\n    steps:\n      -\n        name: VirusTotal Scan\n        uses: crazy-max/ghaction-virustotal@v4\n        with:\n          vt_api_key: ${{ secrets.VT_API_KEY }}\n          update_release_body: true\n          files: |\n            .exe$\n```\n\nAnd will look like this:\n\n![VirusTotal GitHub Action update release body](.github/ghaction-virustotal-release-body.png)\n\n### Scan through VirusTotal Monitor\n\nTo scan your assets through VirusTotal Monitor you can use the following\nworkflow:\n\n```yaml\nname: build\n\npermissions:\n  contents: read\n\non:\n  push:\n\njobs:\n  build:\n    runs-on: ubuntu-latest\n    steps:\n      -\n        name: Checkout\n        uses: actions/checkout@v4\n      -\n        name: Set up Go\n        uses: actions/setup-go@v5\n      -\n        name: Build\n        run: |\n          GOOS=windows GOARCH=386 go build -o ./ghaction-virustotal-win32.exe -v -ldflags \"-s -w\"\n          GOOS=windows GOARCH=amd64 go build -o ./ghaction-virustotal-win64.exe -v -ldflags \"-s -w\"\n      -\n        name: VirusTotal Monitor Scan\n        uses: crazy-max/ghaction-virustotal@v4\n        with:\n          vt_api_key: ${{ secrets.VT_API_KEY }}\n          vt_monitor: true\n          monitor_path: /ghaction-virustotal\n          files: |\n            ./ghaction-virustotal-*.exe\n```\n\n## Customizing\n\n### inputs\n\nFollowing inputs can be used as `step.with` keys\n\n| Name                       | Type   | Default | Description                                                                                                                                                                                               |\n|----------------------------|--------|---------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `vt_api_key`               | String |         | [VirusTotal API key](https://developers.virustotal.com/v3.0/reference#authentication) to upload assets (**required**)                                                                                     |\n| `files`                    | String |         | Newline-delimited list of path globs/patterns for asset files to upload for analysis (**required**)                                                                                                       |\n| `vt_monitor`               | Bool   | `false` | If enabled, files will be uploaded to [VirusTotal Monitor](https://developers.virustotal.com/v3.0/reference#monitor) endpoint                                                                             |\n| `monitor_path`**¹**        | String | `/`     | A path relative to current monitor user root folder to upload files                                                                                                                                       |\n| `update_release_body`**²** | Bool   | `false` | If enabled, analysis link(s) will be appended to the release body                                                                                                                                         |\n| `github_token`**³**        | String |         | [GitHub Token](https://help.github.com/en/actions/configuring-and-managing-workflows/authenticating-with-the-github_token) used to create an authenticated client for GitHub API as provided by `secrets` |\n| `request_rate`             | Number | `0`     | API request-rate in requests/minute. Set to `4` or lower when using the standard free public API. `0` to disable rate-limit.                                                                              |\n\n\u003e [!NOTE]\n\u003e * **¹** Only available if `vt_monitor` is enabled.\n\u003e * **²** Only available if [release event is triggered](#scan-assets-of-a-published-release) in your workflow.\n\u003e * **³** Required if [release event is triggered](#scan-assets-of-a-published-release) in your workflow.\n\n### outputs\n\nThe following outputs are available\n\n| Name          | Type    | Description                                                                |\n|---------------|---------|----------------------------------------------------------------------------|\n| `analysis`    | String  | Analysis results formatted as `\u003cfilename\u003e=\u003canalysisURL\u003e` (comma separated) |\n\n## Contributing\n\nWant to contribute? Awesome! The most basic way to show your support is to star\nthe project, or to raise issues. You can also support this project by [**becoming a sponsor on GitHub**](https://github.com/sponsors/crazy-max)\nor by making a [PayPal donation](https://www.paypal.me/crazyws) to ensure this\njourney continues indefinitely!\n\nThanks again for your support, it is much appreciated! :pray:\n\n## License\n\nMIT. See `LICENSE` for more details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcrazy-max%2Fghaction-virustotal","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcrazy-max%2Fghaction-virustotal","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcrazy-max%2Fghaction-virustotal/lists"}