Skip to content

docs: say that the clearance scope option limits nothing - #91

Open
cport1 wants to merge 1 commit into
mainfrom
fix/clearance-scope-comment-1122
Open

cport1 wants to merge 1 commit into
mainfrom
fix/clearance-scope-comment-1122

Conversation

@cport1

@cport1 cport1 commented Sep 21, 2026

Copy link
Copy Markdown
Contributor

Found while closing WebDecoy/app#1122, which removed data-scope from the customer-facing docs because nothing enforces it.

The plugin still carries clearance_scope, emits it as data-scope, and its comment read "Optional scope passed to the clearance client (advanced)" — which reads like it narrows where a token is valid. It does not: a clearance token is bound to the organization, and no validator reads a token's scope.

Comments only. The option is still read, sanitized and emitted, so a site that set it behaves exactly as before. There is no settings field for it, so nothing in the admin UI changes either.

No release needed; it rides along with the next one.

php -l clean, phpcs unchanged, phpstan [OK] No errors (with --memory-limit=1G; the default 128M crashes the worker on this repo regardless of this change).

The plugin carries a clearance_scope option, passes it to the client as
data-scope, and described it as "optional scope passed to the clearance
client (advanced)". Nothing enforces it: a clearance token is bound to
the organization, and no validator reads a token's scope.

Comments only. The option keeps being read and emitted, so a site that
set it behaves exactly as before.

Refs WebDecoy/app#1122.
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