About this plugin
This plugin allows sign in to WordPress using a JSON Web Token (JWT) contained in a HTTP Header that is added by a reverse proxy that sits in front of your WordPress deployment.
Authentication and optionally role assignment is handled by claims contained in the JWT.
If configured, the plugin also validates the JWT aud and iss claims against the expected application audience and JWT issuer values.
Verification of the JWT is handled by either:
- a shared secret for HS256 (as per RFC 7518 this must be at least 256-bits in size)
- a PEM encoded public key for RS256
- retrieving a JSON Web Key Set (JWKS) from a configured URL (also for RS256)
During the login process if the user does not exist an account will be created with a matching role from the JWT, unless automatic user creation has been disabled in the plugin settings.
If the JWT did not contain a role claim then user is created with the role set in the plugin settings (by default this is the subscriber role).
Automatic user creation is enabled by default for backwards compatibility. It can be disabled when user provisioning should remain manual.