Skip to content

agw-standalone feedback: security/http-authz - clarify require and ...#558

Open
artberger wants to merge 2 commits into
mainfrom
issue-2433
Open

agw-standalone feedback: security/http-authz - clarify require and ...#558
artberger wants to merge 2 commits into
mainfrom
issue-2433

Conversation

@artberger
Copy link
Copy Markdown
Collaborator

Single-package documentation correction to the HTTP authorization page, applied identically to both the latest (v1.2.x) and main doc branches.

Closes #2433

@cloudflare-workers-and-pages
Copy link
Copy Markdown

cloudflare-workers-and-pages Bot commented Jun 3, 2026

Deploying agentproxy with  Cloudflare Pages  Cloudflare Pages

Latest commit: 40d99d0
Status: ✅  Deploy successful!
Preview URL: https://02607cf7.agentproxy.pages.dev
Branch Preview URL: https://issue-2433.agentproxy.pages.dev

View logs

Comment thread content/docs/standalone/latest/configuration/security/http-authz.md Outdated
Comment thread content/docs/standalone/latest/configuration/security/http-authz.md Outdated
Comment thread content/docs/standalone/main/configuration/security/http-authz.md Outdated
Comment thread content/docs/standalone/main/configuration/security/http-authz.md Outdated
artberger and others added 2 commits June 3, 2026 17:17
…docs

Rewrite the rule evaluation list to accurately describe the denylist/allowlist
fallback in terms of whether allow rules are configured (not "only deny rules
exist"), which correctly accounts for require rules.

Add a warning callout documenting CEL evaluation error behavior: require is
fail-closed, deny is fail-open. Correct the misleading claim that require and
deny rules are "equivalent" — they differ when the CEL expression errors.

Signed-off-by: Art Berger <art.berger@solo.io>
Co-authored-by: Art <artberger@users.noreply.github.com>
Signed-off-by: Art Berger <art.berger@solo.io>
@artberger artberger marked this pull request as ready for review June 3, 2026 21:17
```

Unlike `allow` rules, all `require` rules must match for the request to proceed. Use `require` rules to express invariants like "all requests must have a valid audience claim." No newline at end of file
These behave the same when a JWT with an audience claim is present, but they differ when the claim is missing. With no JWT, `jwt.aud` is undefined and both expressions error:
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Suggested change
These behave the same when a JWT with an audience claim is present, but they differ when the claim is missing. With no JWT, `jwt.aud` is undefined and both expressions error:
These rules behave the same when a JWT with an audience claim is present, but they differ when the claim is missing. With no JWT, `jwt.aud` is undefined and both expressions error:

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.

2 participants