From d8a28dea12665b40ef9a3aa40272f1f8f5d46847 Mon Sep 17 00:00:00 2001
From: Andy Dixon <andy@andydixon.com>
Date: Thu, 26 Feb 2026 11:38:13 +0000
Subject: [PATCH] docs: document consent-time access_denied from provider
 revalidation

Clarify that providers may return access_denied at callback time even after consent UI is shown, when membership/tenant scope changes before consent submission. This aligns integration guidance with current provider-side security enforcement.
---
 README.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/README.md b/README.md
index 717210f..f4dcddd 100644
--- a/README.md
+++ b/README.md
@@ -129,6 +129,7 @@ This wrapper now delegates to `BlackWall\Auth\AuthClient`.
 
 - Always validate OAuth `state` in callback handlers.
 - Handle provider callback errors (`error`, `error_description`) explicitly; treat `access_denied` as an expected user/authorisation outcome rather than a transport failure.
+- Expect `access_denied` even after the consent page is displayed if provider-side project membership or tenant scope changes before consent submission.
 - For OIDC providers, include a per-request `nonce` in authorisation requests.
 - Always use HTTPS in production.
 - Store refresh tokens securely.