Upgrading
Client types and token endpoint authentication
Earlier versions only checked the client secret when one was sent. A request that omitted it was accepted for any client, so an authorization code that leaked could be redeemed without the secret unless PKCE was used. From this release the token endpoint always authenticates confidential clients, and every client has a type.
What changes on upgrade
- The database schema is upgraded automatically on the next request. No re-activation is needed.
- All existing clients become confidential. Clients that already send their secret keep working unchanged.
- Clients that relied on PKCE without a secret (SPAs, mobile apps) will now get
401 invalid_clientuntil you open them under OIDC Provider → Clients and set the type to Public. - Public clients must use
S256PKCE. The authorize endpoint rejects anything else.
Other behavior changes
- HTTP Basic credentials are now URL-decoded as RFC 6749 requires. Secrets are hex strings, so this changes nothing in practice.
- Unknown
code_challenge_methodvalues and malformed challenges or verifiers are rejected instead of being treated asplain. - Discovery now lists
noneamong the token endpoint authentication methods.
Redirect URIs for native apps
Public clients may register reverse-domain private-use schemes such as com.example.app:/oauth2redirect, see Native apps. Redirect URIs are now validated when a client is saved: an invalid URI is rejected with an error instead of being stored as an empty entry. Existing clients keep working. The authorize endpoint also no longer redirects an unsupported_response_type error to a redirect_uri that is not registered.
Extension hooks and token revocation
New filters and actions let you customize sign-in, claims and token lifetimes, see Extending with hooks. Two behaviors change even if you use no hook:
- A user's tokens are now revoked when the user is deleted, resets their password or changes it. Applications will have to sign the user in again.
- A refresh token whose user no longer exists is rejected with
invalid_grant.