Skip to content

docs(security): 2.4.0 at-rest encryption key advisory + --encryption-key - #79

Open
lakhansamani wants to merge 1 commit into
mainfrom
docs/2.4.0-encryption-key-advisory
Open

docs(security): 2.4.0 at-rest encryption key advisory + --encryption-key#79
lakhansamani wants to merge 1 commit into
mainfrom
docs/2.4.0-encryption-key-advisory

Conversation

@lakhansamani

Copy link
Copy Markdown
Contributor

Documents the security advisory and breaking change from authorizerdev/authorizer#742.

  • New: security advisory section — affected versions 2.2.1-rc.22.4.0-rc.13, RSA/ECDSA only, with an affected/not-affected table and remediation steps.
  • Corrected: the existing OTP and TOTP at rest and Key rotation sections still said --jwt-secret keys the encryption. It doesn't any more, and the runtime error message they quoted was stale.
  • New: --encryption-key reference in server-config, with the three-state behaviour table (set / falls back / refuses to start).

Also advises setting --encryption-key explicitly even on HMAC installs: while it and --jwt-secret are the same value, rotating the JWT secret — routine on its own — silently destroys every TOTP enrolment, because the at-rest key has no re-encryption path.

Verified with npm run build; new anchors resolve.

The at-rest key was keyed to --jwt-secret, which RSA/ECDSA installs
legitimately leave empty, so TOTP seeds and OTP digests were protected
by a publicly computable constant. Documents affected versions
(2.2.1-rc.2 through 2.4.0-rc.13), who is and is not affected, and the
remediation.

Also corrects the existing at-rest and key-rotation sections, which
still named --jwt-secret as the encryption key, and adds the
--encryption-key flag reference.
@netlify

netlify Bot commented Aug 4, 2026

Copy link
Copy Markdown

Deploy Preview for authorizerdev-docs ready!

Name Link
🔨 Latest commit 7edc3f0
🔍 Latest deploy log https://app.netlify.com/projects/authorizerdev-docs/deploys/6a71b05f7953b30008c55933
😎 Deploy Preview https://deploy-preview-79--authorizerdev-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

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