docs: require non-URL handling for enrollment links

Clarify that enrollment URLs are sensitive bearer material and must not be transported in redirect query strings or logs.
This commit is contained in:
Andy Dixon
2026-02-26 12:40:33 +00:00
parent fb60a1eccb
commit 6cc2ddabd0
2 changed files with 2 additions and 0 deletions
+1
View File
@@ -135,6 +135,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.
- For provider admin enrollment URL export operations, use `POST` with CSRF protection; do not automate them via unauthenticated `GET` links.
- Handle provider CSV exports with formula-injection safety in mind if opening them in spreadsheet applications.
- Treat generated enrollment URLs as secrets and keep them out of URL query strings and request logs.
- 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`.