{"id":33109654,"url":"https://github.com/openfip/redfi","last_synced_at":"2026-01-12T11:24:52.719Z","repository":{"id":57501197,"uuid":"113923338","full_name":"openfip/redfi","owner":"openfip","description":"Redis Fault-Injection Proxy. Test the resiliency of your application against Redis' failures.","archived":false,"fork":false,"pushed_at":"2020-09-07T15:32:56.000Z","size":94,"stargazers_count":97,"open_issues_count":8,"forks_count":12,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-06-20T15:42:03.261Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://openfip.github.io/redfi","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/openfip.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-12-12T00:22:58.000Z","updated_at":"2023-08-11T06:20:48.000Z","dependencies_parsed_at":"2022-09-14T19:41:43.996Z","dependency_job_id":null,"html_url":"https://github.com/openfip/redfi","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/openfip/redfi","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openfip%2Fredfi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openfip%2Fredfi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openfip%2Fredfi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openfip%2Fredfi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/openfip","download_url":"https://codeload.github.com/openfip/redfi/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openfip%2Fredfi/sbom","scorecard":{"id":709397,"data":{"date":"2025-08-11","repo":{"name":"github.com/openfip/redfi","commit":"c02ae7a3ec00b8f8d2d9f5792247bb19203d1c16"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":2.7,"checks":[{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","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":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"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":"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":"Code-Review","score":0,"reason":"Found 1/26 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":"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":"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":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"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":"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":"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":"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/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"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: BSD 3-Clause \"New\" or \"Revised\" 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":0,"reason":"Project has not signed or included provenance with any releases.","details":["Warn: release artifact v0.2-RC1 not signed: https://api.github.com/repos/openfip/redfi/releases/10726599","Warn: release artifact v0.1 not signed: https://api.github.com/repos/openfip/redfi/releases/8866809","Warn: release artifact v0.2-RC1 does not have provenance: https://api.github.com/repos/openfip/redfi/releases/10726599","Warn: release artifact v0.1 does not have provenance: https://api.github.com/repos/openfip/redfi/releases/8866809"],"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":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"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":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 2 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"}}]},"last_synced_at":"2025-08-22T07:41:53.686Z","repository_id":57501197,"created_at":"2025-08-22T07:41:53.686Z","updated_at":"2025-08-22T07:41:53.686Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28338971,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-12T10:58:46.209Z","status":"ssl_error","status_checked_at":"2026-01-12T10:58:42.742Z","response_time":98,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: 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":[],"created_at":"2025-11-15T01:00:26.658Z","updated_at":"2026-01-12T11:24:52.714Z","avatar_url":"https://github.com/openfip.png","language":"Go","readme":"\u003cimg src=\"https://raw.githubusercontent.com/redfi/redfi/master/static/redfi@2x.png\" width=\"400px\"\u003e\n\nRedFI acts as a proxy between the client and Redis with the capability\nof injecting faults on the fly, based on the rules given by you.\n\n## Features\n- Simple to use. It is just a binary that you execute.\n- Transparent to the client.\n- Flexibility to inject failures on Redis Commands you define.\n- Limit failure injection to a percentage of the commands.\n- Limit failure injection to certain clients only.\n- Inject latency, drop connections, return empty responses.\n\n## Why?\nWe believe that to gain trust in your system,\nyou must test it against various scenarios of failures, before deploying it to production.  \nThese tests should also be part of your CI, to catch code changes that might introduce regressions.  \nThis would help you understand the limits of your system, and how resilient it is against Redis' failures.\n\n## How it Works\nRedFI is a proxy that sets between the client and the actual Redis server. On every incoming command from the client, it checks the list of failure rules provided by you, and then it applies the first rule that matches the request.\n\n## Usage\nFirst, download the [latest binary](https://github.com/redfi/redfi/releases/tag/v0.1).\n\nAfter that, execute the binary we downloaded earlier\n```bash\n$ ./redfi -addr 127.0.0.1:8083 -redis 127.0.0.1:6379\n\nRedFI is listening on 127.0.0.1:8083\nDon't forget to point your client to that address.\n\nRedFI Controller is listening on :6380\n```\n- **addr**: is the address on which the proxy listens on for new connections.\n- **redis**: address of the actual Redis server to proxy commands/connections to.\n- **plan**: path to the json file that contains the rules/scenarios for fault injection.\n\nAn example of controlling the proxy rules\n[![asciicast](https://asciinema.org/a/CJyxhZXfk7aaGJ9qfU865Gcy6.png)](https://asciinema.org/a/CJyxhZXfk7aaGJ9qfU865Gcy6)\n\n## Config Commands\n\nPoint redis-cli to RedFI Controller port\n```bash\n$ redi-cli -p 6380\n```\n\n### RULEADD rule_name option=value [option=value]\nAdds a rule to the engine of RedFI\n\n### Faults Options\n- `delay`: adds a delay, the value unit is milliseconds. Example: `delay=200`.\n- `return_empty`: returns an empty response. Example: `return_empty=true`.\n- `return_err`: returns an error response. Example: `return_err=ERR bad command.`\n- `drop`: drop connections, the value is a boolean. Example: `drop=true`.\n\n### Blast limiters\nThey limit the radius of the blast\n- `command`: only apply failure on certain commands. For example `command=HGET`.\n- `percentage`: limits how many times it applies the rule. For example `percentage=25` applies only to 25% of matching commands.\n- `client_addr`: scopes the radius to clients coming from a certain subnet,ip,ip:port. For example `client_addr=192.0.0.1`\n\n## Project Status\nRedFI is still in its early stages, so expect rapid changes.  \nAlso, for now, we advise you to use the proxy in development and staging area only.  \nIf you want to use it in production, you should limit the percentage of connections you send to the proxy.","funding_links":[],"categories":["3. Fault Injection"],"sub_categories":["Database"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenfip%2Fredfi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopenfip%2Fredfi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenfip%2Fredfi/lists"}