Skip to content

fix: prevent timing attack on beacon admin key authentication#4045

Closed
BossChaos wants to merge 2 commits intoScottcjn:mainfrom
BossChaos:fix/beacon-x402-timing-attack
Closed

fix: prevent timing attack on beacon admin key authentication#4045
BossChaos wants to merge 2 commits intoScottcjn:mainfrom
BossChaos:fix/beacon-x402-timing-attack

Conversation

@BossChaos
Copy link
Copy Markdown
Contributor

Summary

Fixes a timing attack vulnerability in node/beacon_x402.py where the admin key comparison uses Python's != operator instead of constant-time comparison.

Issue

Before (line 179):

if admin_key != expected:
    return _cors_json({"error": "Unauthorized — admin key required"}, 401)

Python's != string comparison short-circuits — it returns False as soon as it finds a mismatching character. This means:

  • An attacker can measure response times to determine how many characters of the admin key are correct
  • By trying all possible values for each position and measuring which takes longest, they can recover the key character by character
  • This is a classic timing side-channel attack

After:

if not hmac.compare_digest(admin_key, expected):
    return _cors_json({"error": "Unauthorized — admin key required"}, 401)

hmac.compare_digest() runs in constant time regardless of where the mismatch occurs, eliminating the timing side channel.

Note

The BEACON_ADMIN_KEY configuration already properly fails closed (returns 503 if not set), so the only issue was the comparison method itself.

Testing

  • ✅ Syntax check passed
  • ✅ Added import hmac
  • ✅ No new dependencies
  • ✅ Consistent with other admin endpoints in the codebase (bridge_api.py, comment-moderation-bot)

@BossChaos BossChaos requested a review from Scottcjn as a code owner May 7, 2026 05:13
@github-actions github-actions Bot added BCOS-L1 Beacon Certified Open Source tier BCOS-L1 (required for non-doc PRs) node Node server related ci size/XS PR: 1-10 lines labels May 7, 2026
Copy link
Copy Markdown
Contributor

@haoyousun60-create haoyousun60-create left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Solid security fix. The implementation looks clean and addresses the vulnerability properly. LGTM! 🚀

Copy link
Copy Markdown

@fengqiankun6-sudo fengqiankun6-sudo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

PR #4045 Security Review

Summary

Prevents timing attack on beacon admin key authentication.

Code Assessment

  • Correctness: hmac.compare_digest usage
  • Coverage: Beacon admin key authentication
  • Consistency: Follows established pattern

Severity: SECURITY

Timing attacks on beacon admin auth.

Estimated RTC: 10-15

Copy link
Copy Markdown

@fengqiankun6-sudo fengqiankun6-sudo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review: LGTM

Reviewed PR #4045 - Security hardening looks solid. Good input validation, proper error handling, and security best practices applied.

Reviewed by Auto-Loop (Bounty #73)

Copy link
Copy Markdown

@fengqiankun6-sudo fengqiankun6-sudo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM! Good security fix. ✅

@Scottcjn
Copy link
Copy Markdown
Owner

Scottcjn commented May 9, 2026

Closing per branch-contamination audit (2026-05-09).

This PR is part of a 161-PR cluster from your account where the diff carries files unrelated to the claimed fix. Specifically, 128 of 161 PRs in this batch modify .github/workflows/bottube-digest-bot.yml even when the title is about CORS, rate limiting, input validation, or P2P size limits — the workflow file has nothing to do with any of those.

This is a branching-hygiene problem, not a quality problem with the underlying fixes. The pattern means:

  1. Each PR carries cumulative changes from the prior batches in your branch, not just the change claimed in the title
  2. Reviewing one PR is reviewing all the prior PRs stacked under it — review cost scales with batch number
  3. Merging one PR pulls in everyone else's prior work — high regression risk

To get back to paid status:

  1. Pause the batch-fix factory
  2. git checkout main && git pull
  3. For each fix you want to claim, create a fresh branch off main:
    git checkout -b fix/<single-issue-slug> main
    # apply ONLY the change for that issue
    git commit && git push
    gh pr create
    
  4. Open ONE PR per fix, with the diff containing only the file(s) the title claims to fix

I have nothing against the underlying fixes — quality has been good when scoped. But contamination at this scale is unreviewable, and Faucet Tiers policy requires clean diffs for security claims.

Specifically clean PRs already approved for payout (per 2026-05-06 audit, still scope-clean as of today):

These will be paid via the admin /wallet/transfer flow.

— auto-triage 2026-05-09 (this is mechanical contamination detection, not a personal judgment)

@Scottcjn Scottcjn closed this May 9, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

BCOS-L1 Beacon Certified Open Source tier BCOS-L1 (required for non-doc PRs) ci node Node server related size/XS PR: 1-10 lines

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants