Skip to content

Surface the canary and email the admin when it trips (WebDecoy/app#679) - #81

Merged
cport1 merged 1 commit into
mainfrom
feat/canary-surfacing
Aug 18, 2026
Merged

Surface the canary and email the admin when it trips (WebDecoy/app#679)#81
cport1 merged 1 commit into
mainfrom
feat/canary-surfacing

Conversation

@cport1

@cport1 cport1 commented Aug 18, 2026

Copy link
Copy Markdown
Contributor

WP side of WebDecoy/app#679 (app side: WebDecoy/app#700).

The plugin already plants a live canary on every zero-config install (the honeytoken path plus its invisible link) — but the owner could never see it, and tripping it produced a silent database row. This PR makes the canary a first-class trip-it-yourself experience, canarytokens-style, with zero cloud dependency:

  • Settings, Tripwires tab: the canary URL is shown with a 'Trip it now' link; new 'Email on Trip' toggle (default on)
  • Detections page empty state: 'Nothing here yet. Trip your canary and watch this page catch it.' with the URL and a button
  • Dashboard widget: offers the canary while there are no detections to show
  • wp_mail on honeytoken trip: at most one email per hour, to the site admin, whether it was a bot that found the hidden link or the owner testing the pipeline. Bait-path and fake-plugin tripwires stay email-silent (public scanners hit those constantly; nothing legitimate ever touches the honeytoken).

94 tests pass; phpcs 0 errors. Ships with the next release (2.7.0) via bin/release-all.sh — not releasing here.

…app#679)

Every zero-config install already arms a honeytoken canary; until now
the owner could never see it (the hidden link skips logged-in users and
the path appeared nowhere in admin) and a trip produced a database row
and nothing else. Now:

- the honeytoken settings section shows the canary URL with a 'Trip it
  now' link (and notes that an allowlisted IP's trip is ignored)
- the Detections page empty state becomes the trip-it-yourself prompt
- the dashboard widget offers the canary while there is nothing to show
- a honeytoken trip emails the site admin (wp_mail, at most one per
  hour, canary_email_enabled default on, toggle in settings). Other
  tripwires stay email-silent: public scanners hit bait paths all day,
  but nothing legitimate ever touches the honeytoken.
@cport1
cport1 merged commit b13f786 into main Aug 18, 2026
3 checks passed
@cport1
cport1 deleted the feat/canary-surfacing branch August 18, 2026 19:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant