# secretsquirrel/BDFProxy

Patch Binaries via MITM: BackdoorFactory + mitmProxy.

Repository: https://github.com/secretsquirrel/BDFProxy
Canonical: https://ross.abutalabs.com/products/bdfproxy
Language: Python
License Family: other
Topics: bdf, python, bdfproxy, mitmproxy, mitm-attacks, mitm
Last push: 2021-07-31T01:29:09+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 4494, "days_push": 1860, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1015, forks 199 (observed 2026-08-28T04:03:14.237797+00:00)

## What it is
BDFProxy is a man-in-the-middle proxy that patches downloaded binaries on the fly by embedding payloads, combining the Backdoor Factory with mitmproxy. It is a security research and penetration testing tool for demonstrating the risk of binaries served over unencrypted HTTP.

## Use cases
- patch binaries during download via man-in-the-middle attack
- embed payloads into executables as they are downloaded over HTTP
- demonstrate risks of software distributed without TLS
- strip digital signatures from Windows PE binaries during transfer
- run a red team exercise injecting backdoors into downloaded tools
- test network defenses against MITM binary tampering

## When to choose
- you are a security professional demonstrating MITM binary patching attacks
- you need to patch PE or ELF binaries on the fly during a pentest
- you run Kali Linux and want an integrated binary backdooring proxy
- you are researching how unsigned binaries can be tampered with in transit

## When to avoid
- you need a maintained tool - the public version is old and the new version is sponsor-only
- you require modern mitmproxy compatibility - it only works with mitmproxy 0.11-0.17
- you want a general-purpose HTTP proxy without offensive capabilities
- you need a tool for defensive monitoring rather than attack simulation

## Facets
- artifact type: cli-tool
- maturity: maintenance
- function: security, proxy, penetration-testing, reverse-engineering
- domain: security, penetration-testing, networking, developer-tools
- platform: cli
- tags: mitm, man-in-the-middle, binary-patching, backdoor-factory, pentest, red-team, kali-linux, payload-embedding, pe-patching, elf-patching, linux, macos, docker

## Member repositories
- secretsquirrel/BDFProxy (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:14.237797+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T07:11:28.274548+00:00, confidence not recorded.
  - readme: https://github.com/secretsquirrel/BDFProxy (fetched 2026-08-28T04:03:14.237797+00:00, sha 762061e82dfa)
- Data as of 2026-08-30T08:39:29.467469+00:00.