Skip to content

Security: DJLougen/hive

Security

SECURITY.md

Security Policy

Supported Versions

Hive is currently in Step 1 (Python meta-package). Security fixes are issued for the latest released minor version and the immediately preceding one. Earlier versions are best-effort.

Version Supported
0.2.x
0.1.x
< 0.1

Reporting a Vulnerability

Please do not open a public GitHub issue for security-sensitive bugs. Send a report to djlougen+hive-security [at] gmail.com with:

  • a description of the vulnerability and the impact you observe,
  • a minimal reproducer (transcript, command, or test case),
  • the version of hive you are running,
  • the version of the sibling packages (busybee-cpu, honeycomb) and Python you are running.

You can expect an acknowledgement within 72 hours. We aim to ship a fix within 14 days for critical issues and 30 days for moderate ones. The reporter is credited in the CHANGELOG unless they ask to remain anonymous.

Scope

The Hive meta-package itself is a thin orchestrator. The main attack surfaces are:

  • hive.llm — outbound HTTP to vLLM / llama.cpp servers. Sanity-check endpoints and never log full message bodies.
  • hive.rust_brain — monotonic-timestamp guard rejects replays of older writes. The trust score is the user-controlled input; do not treat high-trust nodes as authoritative in a multi-tenant setting.
  • hive.hardware — pynvml is read-only; no attack surface.

Report issues in busybee-cpu or honey-comb to the same security contact; fixes may land in the sibling repo and be pulled into Hive releases.

Self-service penetration testing

Modular checks cover each installable component. Siblings are optional; skipped modules print install instructions.

# Hive core only (matches default CI on PRs)
pip install -e ".[dev]"
python scripts/hive_pentest.py --module hive

# Full stack (busyBee-cpu + honey-comb side-by-side)
git clone https://github.com/DJLougen/busyBee-cpu ../busyBee-cpu
git clone https://github.com/DJLougen/honey-comb ../honey-comb
pip install -e ../busyBee-cpu ../honey-comb -e ".[dev]"
python scripts/hive_pentest.py --fail-on-skip

python -m bandit -r hive/ -ll
Module Package Focus
hive hive JWT, tenancy, health bind, feedback poisoning, LLM URLs
busybee busybee_cpu joblib trust, /v1/learn, CORS, body limits, predict DoS
honeycomb honeycomb model fallback, CORE system prompts, tee paths, large inputs
integration all three HiveStack wired to real busybee + honeycomb

For Kubernetes deployments, set HIVE_HEALTH_BIND=0.0.0.0 only inside the pod network; the default is loopback (127.0.0.1). Always configure HIVE_JWKS_URL or HIVE_JWT_PUBLIC_KEY before calling JWTValidator.validate().

Never expose bee-serve (busybee_cpu.server) to untrusted networks without authentication. Apply patches/busybee-secure-learn.patch upstream (or set BUSYBEE_LEARN_API_KEY); /v1/learn mutates the routing policy.

Active pentest (exploit probes):

python scripts/hive_pentest.py --active --fail-on-skip

Known residual risk: joblib/pickle model files are executable if tampered — only load .joblib from trusted, signed distribution paths.

There aren't any published security advisories