{"id":19940839,"url":"https://github.com/spectolabs/hoverfly-github-action","last_synced_at":"2026-04-22T10:01:43.491Z","repository":{"id":37012676,"uuid":"283365071","full_name":"SpectoLabs/hoverfly-github-action","owner":"SpectoLabs","description":"Install Hoverfly (https://docs.hoverfly.io) so that other GitHub Actions can use it easily (e.g. for testing)","archived":false,"fork":false,"pushed_at":"2025-10-14T19:01:16.000Z","size":139,"stargazers_count":3,"open_issues_count":9,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-22T03:55:27.621Z","etag":null,"topics":["api-simulation","github-actions","hoverfly","http","https","mitm","mocking","proxy","service-virtualization","stubbing","testing","testing-tools"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/SpectoLabs.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}},"created_at":"2020-07-29T01:14:31.000Z","updated_at":"2025-08-05T07:02:20.000Z","dependencies_parsed_at":"2025-08-05T09:04:11.936Z","dependency_job_id":"6439e2b7-883a-4c96-8ca7-0fb943b09053","html_url":"https://github.com/SpectoLabs/hoverfly-github-action","commit_stats":null,"previous_names":[],"tags_count":89,"template":false,"template_full_name":"actions/container-action","purl":"pkg:github/SpectoLabs/hoverfly-github-action","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SpectoLabs%2Fhoverfly-github-action","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SpectoLabs%2Fhoverfly-github-action/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SpectoLabs%2Fhoverfly-github-action/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SpectoLabs%2Fhoverfly-github-action/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SpectoLabs","download_url":"https://codeload.github.com/SpectoLabs/hoverfly-github-action/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SpectoLabs%2Fhoverfly-github-action/sbom","scorecard":{"id":132801,"data":{"date":"2025-08-04","repo":{"name":"github.com/SpectoLabs/hoverfly-github-action","commit":"472fb2da5fa491197c538f24bd37d577380a3ddb"},"scorecard":{"version":"v5.2.1-28-gc1d103a9","commit":"c1d103a9bb9f635ec7260bf9aa0699466fa4be0e"},"score":4.7,"checks":[{"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/c1d103a9bb9f635ec7260bf9aa0699466fa4be0e/docs/checks.md#binary-artifacts"}},{"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/c1d103a9bb9f635ec7260bf9aa0699466fa4be0e/docs/checks.md#dangerous-workflow"}},{"name":"Code-Review","score":0,"reason":"Found 1/14 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/c1d103a9bb9f635ec7260bf9aa0699466fa4be0e/docs/checks.md#code-review"}},{"name":"Maintained","score":5,"reason":"6 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 5","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/c1d103a9bb9f635ec7260bf9aa0699466fa4be0e/docs/checks.md#maintained"}},{"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/c1d103a9bb9f635ec7260bf9aa0699466fa4be0e/docs/checks.md#cii-best-practices"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/c1d103a9bb9f635ec7260bf9aa0699466fa4be0e/docs/checks.md#vulnerabilities"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/check-commit-message.yml:1","Warn: no topLevel permission defined: .github/workflows/check_semver_labels.yml:1","Warn: no topLevel permission defined: .github/workflows/dependabot_hack.yml:1","Warn: no topLevel permission defined: .github/workflows/github_tag_and_release.yml:1","Warn: no topLevel permission defined: .github/workflows/reviewdog.yml:1","Warn: no topLevel permission defined: .github/workflows/test.yml:1","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/c1d103a9bb9f635ec7260bf9aa0699466fa4be0e/docs/checks.md#token-permissions"}},{"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/c1d103a9bb9f635ec7260bf9aa0699466fa4be0e/docs/checks.md#security-policy"}},{"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/c1d103a9bb9f635ec7260bf9aa0699466fa4be0e/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/c1d103a9bb9f635ec7260bf9aa0699466fa4be0e/docs/checks.md#license"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: third-party GitHubAction not pinned by hash: .github/workflows/check-commit-message.yml:21: update your workflow using https://app.stepsecurity.io/secureworkflow/SpectoLabs/hoverfly-github-action/check-commit-message.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/check_semver_labels.yml:18: update your workflow using https://app.stepsecurity.io/secureworkflow/SpectoLabs/hoverfly-github-action/check_semver_labels.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/dependabot_hack.yml:20: update your workflow using https://app.stepsecurity.io/secureworkflow/SpectoLabs/hoverfly-github-action/dependabot_hack.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/dependabot_hack.yml:24: update your workflow using https://app.stepsecurity.io/secureworkflow/SpectoLabs/hoverfly-github-action/dependabot_hack.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/dependabot_hack.yml:27: update your workflow using https://app.stepsecurity.io/secureworkflow/SpectoLabs/hoverfly-github-action/dependabot_hack.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/github_tag_and_release.yml:30: update your workflow using https://app.stepsecurity.io/secureworkflow/SpectoLabs/hoverfly-github-action/github_tag_and_release.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/github_tag_and_release.yml:35: update your workflow using https://app.stepsecurity.io/secureworkflow/SpectoLabs/hoverfly-github-action/github_tag_and_release.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/github_tag_and_release.yml:40: update your workflow using https://app.stepsecurity.io/secureworkflow/SpectoLabs/hoverfly-github-action/github_tag_and_release.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/github_tag_and_release.yml:16: update your workflow using https://app.stepsecurity.io/secureworkflow/SpectoLabs/hoverfly-github-action/github_tag_and_release.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/reviewdog.yml:19: update your workflow using https://app.stepsecurity.io/secureworkflow/SpectoLabs/hoverfly-github-action/reviewdog.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/reviewdog.yml:21: update your workflow using https://app.stepsecurity.io/secureworkflow/SpectoLabs/hoverfly-github-action/reviewdog.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/reviewdog.yml:30: update your workflow using https://app.stepsecurity.io/secureworkflow/SpectoLabs/hoverfly-github-action/reviewdog.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/reviewdog.yml:32: update your workflow using https://app.stepsecurity.io/secureworkflow/SpectoLabs/hoverfly-github-action/reviewdog.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/reviewdog.yml:41: update your workflow using https://app.stepsecurity.io/secureworkflow/SpectoLabs/hoverfly-github-action/reviewdog.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/reviewdog.yml:43: update your workflow using https://app.stepsecurity.io/secureworkflow/SpectoLabs/hoverfly-github-action/reviewdog.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/reviewdog.yml:55: update your workflow using https://app.stepsecurity.io/secureworkflow/SpectoLabs/hoverfly-github-action/reviewdog.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/reviewdog.yml:56: update your workflow using https://app.stepsecurity.io/secureworkflow/SpectoLabs/hoverfly-github-action/reviewdog.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/reviewdog.yml:65: update your workflow using https://app.stepsecurity.io/secureworkflow/SpectoLabs/hoverfly-github-action/reviewdog.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/reviewdog.yml:66: update your workflow using https://app.stepsecurity.io/secureworkflow/SpectoLabs/hoverfly-github-action/reviewdog.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/test.yml:109: update your workflow using https://app.stepsecurity.io/secureworkflow/SpectoLabs/hoverfly-github-action/test.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/test.yml:130: update your workflow using https://app.stepsecurity.io/secureworkflow/SpectoLabs/hoverfly-github-action/test.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/test.yml:28: update your workflow using https://app.stepsecurity.io/secureworkflow/SpectoLabs/hoverfly-github-action/test.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/test.yml:47: update your workflow using https://app.stepsecurity.io/secureworkflow/SpectoLabs/hoverfly-github-action/test.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/test.yml:65: update your workflow using https://app.stepsecurity.io/secureworkflow/SpectoLabs/hoverfly-github-action/test.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/test.yml:81: update your workflow using https://app.stepsecurity.io/secureworkflow/SpectoLabs/hoverfly-github-action/test.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/test.yml:94: update your workflow using https://app.stepsecurity.io/secureworkflow/SpectoLabs/hoverfly-github-action/test.yml/main?enable=pin","Warn: containerImage not pinned by hash: Dockerfile:1: pin your Docker image by updating alpine:3.10 to alpine:3.10@sha256:451eee8bedcb2f029756dc3e9d73bab0e7943c1ac55cff3a4861c52a0fdd3e98","Info:   0 out of  14 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of  12 third-party GitHubAction dependencies pinned","Info:   0 out of   1 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/c1d103a9bb9f635ec7260bf9aa0699466fa4be0e/docs/checks.md#pinned-dependencies"}},{"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/c1d103a9bb9f635ec7260bf9aa0699466fa4be0e/docs/checks.md#branch-protection"}},{"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/c1d103a9bb9f635ec7260bf9aa0699466fa4be0e/docs/checks.md#signed-releases"}},{"name":"Packaging","score":10,"reason":"packaging workflow detected","details":["Info: Project packages its releases by way of GitHub Actions.: .github/workflows/github_tag_and_release.yml:23"],"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/c1d103a9bb9f635ec7260bf9aa0699466fa4be0e/docs/checks.md#packaging"}},{"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/c1d103a9bb9f635ec7260bf9aa0699466fa4be0e/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-16T05:36:28.239Z","repository_id":37012676,"created_at":"2025-08-16T05:36:28.239Z","updated_at":"2025-08-16T05:36:28.239Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32130776,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-22T08:34:57.708Z","status":"ssl_error","status_checked_at":"2026-04-22T08:34:55.583Z","response_time":58,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["api-simulation","github-actions","hoverfly","http","https","mitm","mocking","proxy","service-virtualization","stubbing","testing","testing-tools"],"created_at":"2024-11-13T00:07:09.112Z","updated_at":"2026-04-22T10:01:43.485Z","avatar_url":"https://github.com/SpectoLabs.png","language":"Shell","readme":"# Hoverfly GitHub Action\n\n[![tests](https://github.com/SpectoLabs/hoverfly-github-action/workflows/Test/badge.svg?branch=main\u0026event=push)](https://github.com/SpectoLabs/hoverfly-github-action/actions?query=workflow%3ATest+event%3Apush+branch%3Amain)\n[![reviewdog](https://github.com/SpectoLabs/hoverfly-github-action/workflows/reviewdog/badge.svg?branch=main\u0026event=push)](https://github.com/SpectoLabs/hoverfly-github-action/actions?query=workflow%3Areviewdog+event%3Apush+branch%3Amain)\n[![License](https://img.shields.io/badge/license-MIT-blue.svg?maxAge=43200)](LICENSE)\n\n**[GitHub Action](https://github.com/features/actions) that installs [Hoverfly](https://docs.hoverfly.io/), so that it can be used in subsequent steps in your GitHub Actions CI/CD pipeline (e.g. when running tests that use Hoverfly).**\n\n## Using the Hoverfly action\n\nUsing this action is as simple as:\n\n1. **create a `.github\\workflows` directory** in your repository\n2. **create a\n   [YAML](https://docs.github.com/en/actions/reference/workflow-syntax-for-github-actions#about-yaml-syntax-for-workflows)\n   file** in the `.github\\workflows` directory (file name can be anything you like,\n   with either a `.yml` or `.yaml` file extension), with this content:\n\n```yml\n---\nname: Hoverfly\non:\n  push:\n\njobs:\n\n  install-hoverfly:\n  name: Install\n  runs-on: ubuntu-latest\n  steps:\n    - name: Install Hoverfly\n      uses: SpectoLabs/hoverfly-github-action@main\n      with:\n        version: v1.11.3\n        runner_github_workspace_path: ${{ github.workspace }}\n```\n\nYou will also typically have additional steps both before and after the Hoverfly installation step,\ne.g. to checkout your code and to run your tests. Here's an example:\n\n```yml\n---\nname: Run tests\non:\n  push:\n\njobs:\n\n  run-tests:\n  name: Install Hoverfly and run tests\n  runs-on: ubuntu-latest\n  steps:\n    - name: Checkout code\n        uses: actions/checkout@v2\n    - name: Install Hoverfly\n      uses: SpectoLabs/hoverfly-github-action@main\n      with:\n        version: v1.11.3\n        runner_github_workspace_path: ${{ github.workspace }}\n    - name: Run Tests\n        run: \u003ccommand-to-run-your-tests\u003e\n```\n\nOnce the Hoverfly installation has completed, both the\n[Hoverfly](https://docs.hoverfly.io/en/latest/pages/reference/hoverfly/hoverflycommands.html) and\n[Hoverctl](https://docs.hoverfly.io/en/latest/pages/keyconcepts/hoverctl.html)\ncommands are available to you for the remainder of your GitHub Actions workflow:\n\n- `hoverfly`\n- `hoverctl`\n\n## Specifying the Hoverfly version\n\nExample:\n\n```yml\n  steps:\n    - name: Install Hoverfly\n      uses: SpectoLabs/hoverfly-github-action@main\n      with:\n        version: v1.11.3\n        runner_github_workspace_path: ${{ github.workspace }}\n```\n\n`version` can be any [released Hoverfly version](https://github.com/SpectoLabs/hoverfly/releases).\nIf you do not provide a version, it will default to the\n[latest](https://github.com/SpectoLabs/hoverfly/releases/latest) release.\n\n## Runner GitHub Workspace path and Hoverfly installation location\n\nAs per the above examples, you have to provide the following parameter:\n\n`runner_github_workspace_path: ${{ github.workspace }}`\n\nThe value must always be `${{ github.workspace }}`\n\nThis is so that the Hoverfly binaries are added to the path properly.\n\nThe Hoverfly binaries are installed at `${{ github.workspace }}/bin`\n\n(The [GitHub workspace directory is persistent throughout the GitHub Action workflow](https://docs.github.com/en/actions/reference/virtual-environments-for-github-hosted-runners#filesystems-on-github-hosted-runners), which means that the binaries are available to any subsequent workflow steps.)\n\n## Enabling HTTPS Hoverfly simulations\n\nTo enable [HTTPS Hoverfly simulations](https://docs.hoverfly.io/en/latest/pages/tutorials/basic/https/https.html), follow this example:\n\n```yml\n  steps:\n    - name: Install Hoverfly\n      uses: SpectoLabs/hoverfly-github-action@main\n      with:\n        runner_github_workspace_path: ${{ github.workspace }}\n      - name: Enable https calls to be simulated by Hoverfly\n        run: install-and-trust-hoverfly-default-cert.sh\n```\n\nThis script\n[installs and trusts the default Hoverfly certificate](https://docs.hoverfly.io/en/latest/pages/tutorials/advanced/configuressl/configuressl.html),\nafter which you can go ahead and simulate HTTPS calls (see\n[this example](https://github.com/SpectoLabs/hoverfly-github-action/blob/a0a08dae5c28d0980205c7997ce4accc20d1fc48/.github/workflows/tests.yml#L95-L113)\nin the [end-to-end tests](.github/workflows/tests.yml)).\n\nOur Hoverfly GitHub Action automatically makes this https cert\n[install script](./install-and-trust-hoverfly-default-cert.sh) available\n(in the same `${{ github.workspace }}/bin` directory which we add to the path and which the\nHoverfly binaries are located in too).\n\n## Tests / examples\n\nThe [tests](.github/workflows/tests.yml) contain further configuration examples.\n\n## Suggestions / bug reports / contributions\n\nThe project is [open source](https://opensource.guide/how-to-contribute/) and all contributions are very welcome :slightly_smiling_face: :boom: :thumbsup:\n\n- [How to report a bug or suggest a new feature](CONTRIBUTING.md#how-to-report-a-bug-or-suggest-a-new-feature)\n\n- [How to make a contribution](CONTRIBUTING.md#how-to-make-a-contribution)\n\n## Updating dependencies\n\nSee the [DEPENDENCIES.md](.github/DEPENDENCIES.md)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspectolabs%2Fhoverfly-github-action","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fspectolabs%2Fhoverfly-github-action","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspectolabs%2Fhoverfly-github-action/lists"}