jeremyjsimmons

TWL SSO is a secure single sign-on plugin for WordPress that enables seamless authentication using RS256 JWT tokens from an external SSO application. 
This plugin provides login security features and is designed for allowing Twelve Legs Marketing centralized authentication management.
<h4>Key Features</h4>
<ul>
<li>Single Sign In: Agency employees can log into websites they manage from a central dashboard.</li>
<li>Just-in-Time User Provisioning: Automatic user creation and role assignment</li>
<li>JWT Validation: Full RS256 signature verification with JWKS endpoint integration</li>
<li>Key Rotation: Support key rotation through JWKS endpoint</li>
<li>Role Management: Flexible role assignment from JWT claims</li>
<li>Referrer Validation: Enhanced security through referrer validation</li>
<li>Audience Validation: Ensures tokens are valid for the specific WordPress site</li>
<li>Token Expiration: Built-in token expiration and clock skew tolerance</li>
<li>Email Validation: Comprehensive email validation with optional allowlist</li>
<li>Caching: JWKS caching for improved performance</li>
</ul>
<h4>Security Features</h4>
<ul>
<li>Referrer validation to prevent unauthorized access</li>
<li>JWT signature verification using public key cryptography</li>
<li>Issuer validation to ensure tokens come from trusted sources</li>
<li>Audience validation to prevent token reuse across sites</li>
<li>Token expiration validation with configurable leeway</li>
<li>Email format validation and filtering via hook</li>
</ul>
<h4>Use Cases</h4>
<ul>
<li>WordPress installations managed centrally by agency</li>
<li>Organization using Google for external identity provider</li>
</ul>
<h3>Usage</h3>
<h4>Authentication Flow</h4>
<ol>
<li>User clicks login link from SSO application sso.twelvelegsmarketing.com</li>
<li>SSO application redirects to WordPress with JWT token: <code>/wp-login.php?action=twl_sso&token=JWT_TOKEN</code></li>
<li>Plugin validates the JWT token signature and claims</li>
<li>Plugin extracts user information from JWT claims</li>
<li>Plugin creates or retrieves WordPress user</li>
<li>Plugin assigns appropriate role based on JWT claims</li>
<li>User is logged into WordPress</li>
</ol>
<h4>JWT Claims</h4>
The plugin expects the following JWT claims:
<ul>
<li><code>email</code> or <code>sub</code>: User’s email address</li>
<li><code>iss</code>: Issuer (must match allowed issuers)</li>
<li><code>aud</code>: Audience (must match WordPress site URL)</li>
<li><code>exp</code>: Expiration time</li>
<li><code>nbf</code>: Not before time (optional)</li>
<li><code>wp_role</code>: WordPress role to assign (optional)</li>
<li><code>name</code>: User’s display name (optional)</li>
<li><code>given_name</code>: User’s first name (optional)</li>
<li><code>family_name</code>: User’s last name (optional)</li>
</ul>
<h4>Configuration</h4>
The plugin automatically configures itself based on the WordPress environment:
<ul>
<li>Production: Only allows <code>https://sso.twelvelegsmarketing.com</code> as issuer</li>
<li>Development/Staging: Also allows <code>https://localhost:8443</code> as issuer</li>
</ul>
<h4>Customization</h4>
You can customize the plugin behavior using WordPress filters:
<ul>
<li><code>twl_sso_allow_email</code>: Filter to control which email addresses are allowed</li>
<li><code>twl_sso_allowed_roles</code>: Filter to control which roles can be assigned</li>
<li><code>twl_sso_allowed_issuers</code>: Filter to control which issuers are allowed</li>
</ul>
<h3>Support</h3>
For support, please contact Twelve Legs Marketing at https://twelvelegsmarketing.com
<h3>Privacy Policy</h3>
This plugin does not collect, store, or transmit any personal data. All authentication is handled through secure JWT tokens from your configured SSO provider.

Twelve Legs Marketing SSO

Single sign-on plugin for WordPress that accepts RS256 JWTs from the TWL SSO application for secure authentication.

Ahmed Hnewa

WordPress is a good content mangement system for building websites, but it will be better if you build like mobile apps, 
With the wordpress rest api you can create posts, edit posts, view posts, Users, Uploading Media etc… 
but the problem with the wordpress rest api it does not provide any authentication methods for third party application like mobile apps 
The Jwt Plugin on wordpress.org does provide that
and this plugin is just a addon for that plugin
So this plugin is useful if you don’t want to make another request to fetch user data like Id etc.. 
because you have to get the id of the user in ordet to get all data
It really simple plugin 
it writed with 50 lines of code, the size of the plugin is 3Kb
Note: This Is Plugin For 
<a href="https://wordpress.org/plugins/jwt-authentication-for-wp-rest-api/" rel="ugc">JWT Authentication for WP REST API Plugin</a>
so if the jwt authentication plugin is not installed 
this plugin will not add the fields to it endpoints
and the fields will be added only if the token is getted successfully
Example request (before install the plugin): 
{ 
    “token”: “eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOlwvXC8xOTIuMTY4LjAuMTgyIiwiaWF0IjoxNjE0MDg3NDQ2LCJuYmYiOjE2MTQwODc0NDYsImV4cCI6MTYxNDY5MjI0NiwiZGF0YSI6eyJ1c2VyIjp7ImlkIjoiMSJ9fX0.KeAUc7PiTne0_PThsSAWo1ruvl2Ocu-fbCn2jG7zkoE”, 
    “user_email”: “example@example.com”, 
    “user_nicename”: “admin”, 
    “user_display_name”: “admin” 
}
Example response (after install the plugin): 
{ 
    “token”: “eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwOlwvXC8xOTIuMTY4LjAuMTgyIiwiaWF0IjoxNjE0MDg2NjQyLCJuYmYiOjE2MTQwODY2NDIsImV4cCI6MTYxNDY5MTQ0MiwiZGF0YSI6eyJ1c2VyIjp7ImlkIjoiMSJ9fX0.nyDOICdQcZKbWZo2kQRp_eLBkuxjnK_rpxs-HJREyCg”, 
    “user_email”: “example@example.com”, 
    “user_nicename”: “admin”, 
    “user_display_name”: “admin”, 
    “user_id”: 1, 
    “user_login”: “admin”, 
    “user_first_name”: “sfd”, 
    “user_last_name”: “”, 
    “user_roles”: [ 
        “administrator” 
    ], 
    “user_role”: “administrator”, 
    “user_registered”: “2021-02-17 09:21:29”, 
    “user_url”: “http://localhost”, 
    “user_status”: “0”, 
    “user_avatar_url”: “https://secure.gravatar.com/avatar/22feea4605ac5b7163eac439b5241034?s=96&d=mm&r=g”, 
    “user_activation_key”: “” 
}
Of course you can add the code of this plugin to your Theme, 
but this is not recommened because when you change the theme or update it 
the changes will revert back, you can create child theme for that 
but instead you can just install this simple plugin
Don’t forget to setup (JwtAuthenticatonForWordpress)[https://wordpress.org/plugins/jwt-authentication-for-wp-rest-api/]
<a href="https://github.com/ahmedhnewa/user-data-fields-jwt-plugin" rel="nofollow ugc">Github</a>
<h3>Can Add User Data Fields To Validate Token Endpoint ?</h3>
This plugin can also add user data fields to validate token endpoint,
Unfortunately, the jwt extension does not support using the filter for validate_token function, 
So You Will Need To Modify Some Codes Inside Jwt Plugin Codes 
Go To \wp-content\plugins\jwt-authentication-for-wp-rest-api\public\class-jwt-auth-public.php 
And At The End Of Function That Named validate_token 
In Line 302
Edit This Code 
From : 
/** If the output is true return an answer to the request to show it */ 
 return array( 
 ‘code’ => ‘jwt_auth_valid_token’, 
 ‘data’ => array( 
 ‘status’ => 200, 
 ), 
 ); 
To : 
$value = array( 
 ‘code’ => ‘jwt_auth_valid_token’, 
 ‘data’ => array( 
 ‘status’ => 200, 
 ) 
 ); 
 /** If the output is true return an answer to the request to show it */ 
 return apply_filters(‘jwt_auth_validate_token’, $value, $token);
Now you have done, 
the plugin should be able to add new values by adding a filter
Note : 
If you updated the jwt plugin, 
you should again edit the code because it will be removed
<h3>REQUIREMENTS</h3>
<a href="https://wordpress.org/plugins/jwt-authentication-for-wp-rest-api/" rel="ugc">JWT Authentication for WP REST API Plugin</a>

User Data Fields For JWT Authentication

Good And Very Simple Plugin For Jwt Authentication

The JWT team should add a filter for validating requests too.

Well Self Usage Plugin

Wordpress is a good content mangement system for building websites, but it will be better if you build like mobile apps,

Twelve Legs Marketing SSO vs User Data Fields For JWT Authentication