Skip to main content

Authorized-use secret-intelligence suite: find -> verify -> capability ladder -> PROVEN/VALID/DENIED impact tiering -> court-ready evidence bundle. Built on top of TruffleHog.

Project description

██╗   ██╗████████╗██╗  ██╗     ██████╗ ███████╗ ██████╗ ██████╗ ███╗   ██╗
██║   ██║╚══██╔══╝╚██╗██╔╝     ██╔══██╗██╔════╝██╔════╝██╔═══██╗████╗  ██║
██║   ██║   ██║    ╚███╔╝█████╗██████╔╝█████╗  ██║     ██║   ██║██╔██╗ ██║
╚██╗ ██╔╝   ██║    ██╔██╗╚════╝██╔══██╗██╔══╝  ██║     ██║   ██║██║╚██╗██║
 ╚████╔╝    ██║   ██╔╝ ██╗     ██║  ██║███████╗╚██████╗╚██████╔╝██║ ╚████║
  ╚═══╝     ╚═╝   ╚═╝  ╚═╝     ╚═╝  ╚═╝╚══════╝ ╚═════╝ ╚═════╝ ╚═╝  ╚═══╝

vtx-recon (Python)

Secret intelligence for authorized engagements — find a key, then prove what it can actually do.

⚠️ Authorized use only. vtx-recon is for security testing of systems you are explicitly authorized to test (an in-scope bug-bounty program or signed engagement). Unauthorized use may violate the US CFAA, the UK Computer Misuse Act, and equivalent laws. Provided "as is", no warranty, no liability.

TruffleHog finds secrets and verifies they're live; vtx-recon picks up from there — it runs ordered, read-only capability ladders across 51 providers to prove depth of access, tiers each key as PROVEN / VALID / DENIED, and emits a redacted, timestamped evidence bundle.

Safe, read-only probes run by default. Probes that cost money, read PII, or change state are gated and unreachable unless you pass both --prove and --i-am-authorized "<scope>" — enforced in code, fail-closed.

Install

pipx install vtx-recon     # requires the trufflehog binary on PATH

Quick start

vtx-recon find . --i-am-authorized "bugbounty:acme"
echo "AIza..." | vtx-recon ladder --i-am-authorized "bugbounty:acme" --json

Full documentation, the complete 51-provider capability-ladder reference, and the safety model are in the project README.

Built by VTX Labs · MIT License · see TERMS.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vtx_recon-0.2.0.tar.gz (176.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

vtx_recon-0.2.0-py3-none-any.whl (213.9 kB view details)

Uploaded Python 3

File details

Details for the file vtx_recon-0.2.0.tar.gz.

File metadata

  • Download URL: vtx_recon-0.2.0.tar.gz
  • Upload date:
  • Size: 176.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for vtx_recon-0.2.0.tar.gz
Algorithm Hash digest
SHA256 2751450d0dd1e764f0d08caf8a84767c3c7d2d39b9b2fbe0418bea9e0a1f70b3
MD5 4010f0e22145ec5b190224edbf56cf5b
BLAKE2b-256 9cd60d2a43c876f286cd1b6194e104d2b4a353b3c15104cefed0c761bb4a8665

See more details on using hashes here.

Provenance

The following attestation bundles were made for vtx_recon-0.2.0.tar.gz:

Publisher: publish-pypi.yml on VTX-Labs/recon

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file vtx_recon-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: vtx_recon-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 213.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.13

File hashes

Hashes for vtx_recon-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 09052555eea3f0a0b348247146bcf2fbd79934515ced5731399dad7afeacd6cb
MD5 2f9448bf425d1db572c73d11524c0039
BLAKE2b-256 7a1f669bda4ea07bc08361093552ea3d80cffbf8698f08a07b988933bb359172

See more details on using hashes here.

Provenance

The following attestation bundles were made for vtx_recon-0.2.0-py3-none-any.whl:

Publisher: publish-pypi.yml on VTX-Labs/recon

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page