docs: document cryptbin unwrap key proof requirement

Update SDK security guidance/examples to note that provider cryptbin unwrap calls must include key_b64url and now fail with 403 Forbidden on key mismatch.
2026-02-26 12:31:11 +00:00
parent ba8868cc12
commit 822b9b93c5
2 changed files with 2 additions and 0 deletions
@@ -134,6 +134,7 @@ This wrapper now delegates to `BlackWall\Auth\AuthClient`.
 - Use OAuth/portal authentication endpoints for end users; provider admin login endpoints enforce separate admin scope checks.
 - Never place client secrets, refresh tokens, or access tokens in URL query strings.
 - For OIDC providers, include a per-request `nonce` in authorisation requests.
+- For direct Cryptbin API usage, send `key_b64url` on unwrap calls; provider rejects key-mismatch unwrap attempts with `403 Forbidden`.
 - Always use HTTPS in production.
 - Store refresh tokens securely.
 - Keep access tokens out of logs and browser-visible output.