Skip to content

Correct two documented claims about the Web3Forms key - #8

Merged
zerotrustdavid merged 1 commit into
mainfrom
docs/correct-key-claims
Aug 22, 2026
Merged

Correct two documented claims about the Web3Forms key#8
zerotrustdavid merged 1 commit into
mainfrom
docs/correct-key-claims

Conversation

@zerotrustdavid

Copy link
Copy Markdown
Owner

Follow-up to #6. Both files described the access key more protectively than the facts support, and one was simply untrue.

.env.example

Claimed the key was "kept out of the repo so this public repository does not ship a ready-made endpoint for anyone to post to".

An earlier commit in this repository's history contains a real key, so that was false at the time it was written. A documented control that does not hold is worse than no claim at all, particularly here.

Now states what is true: the value is publishable rather than secret, it is readable from the deployed site by anyone viewing source, keeping it out of the source tree is hygiene rather than confidentiality, and one commit in history contains a real one.

Also records that the value is inlined at build time, so changing it in hosting does nothing to a deployment that already exists without a redeploy. That behaviour cost real time to rediscover and is worth writing down where the next person will look.

SECURITY.md

Presented the Web3Forms domain restriction as though it settled the question. It is enforced on a request header, which any client can set, so it raises the effort required rather than preventing abuse.

The wording no longer implies otherwise, and the invitation to report abuse now explicitly includes getting past that restriction, which is the more useful thing to ask for.

Verification

Lint, 155 tests and the production build all pass. Documentation only, no behaviour change.


Generated by Claude Code

Both files described the key more protectively than the facts support, and
one of them was simply untrue.

.env.example claimed the key was "kept out of the repo so this public
repository does not ship a ready-made endpoint for anyone to post to". An
earlier commit in this repository's history contains a real key, so that
statement was false at the time it was written. It now says what is
actually true: the value is publishable, it is readable from the deployed
site by anyone viewing source, keeping it out of the source tree is hygiene
rather than confidentiality, and one commit in history contains a real one.

It also now records that the value is inlined at build time, so changing it
in hosting does nothing to an existing deployment without a redeploy. That
behaviour cost real time to rediscover.

SECURITY.md presented the Web3Forms domain restriction as though it settled
the question. It is enforced on a request header, which any client can set,
so it raises effort rather than preventing abuse. The wording no longer
implies otherwise, and the invitation to report abuse now explicitly
includes getting past that restriction.

A documented control that does not hold is worse than no claim at all,
particularly in a repository published to demonstrate practice.
@vercel

vercel Bot commented Aug 22, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
payreckon Ready Ready Preview Aug 22, 2026 4:08am

@zerotrustdavid
zerotrustdavid merged commit 3bc5812 into main Aug 22, 2026
4 checks passed
@zerotrustdavid
zerotrustdavid deleted the docs/correct-key-claims branch August 27, 2026 06:35
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