WordPress YourMembership Single Sign-On (SSO) plugin gives the ability to
enable Single Sign-On (SSO) for your WordPress sites. Here we will go through
a step-by-step guide to configure SSO between WordPress site and
YourMembership.
You can download the WordPress YourMembership SSO plugin
using below link:
Pre-requisites: Download And Installation
- Log into your WordPress instance as an admin.
-
Go to the WordPress Dashboard → Plugins and click on
Add New.
-
Search for miniOrange WordPress YourMembership SSO plugin and click
on Install Now.
- Once installed click on Activate.
Steps to configure YourMembership Single Sign-On (SSO) into WordPress
1. Configure YourMembership SSO Plugin
Configure YM SSO using REST APIs
Configure YM SSO using legacy APIs
Step A: Configure App in YourMembership
- Login into YourMembership as an admin.
- Go to the Content & Settings tab.
-
Select General Settings from left navigation and go to the
API Configuration tab.
- Copy the Client ID.
-
Go to the OAuth Management tab and click on Add Client App.
-
From the Credentials tab, copy the
Client ID and Client App Secret.
-
Enter the Redirect URL obtained from the miniOrange Yourmembership
plugin. Please make sure that the Redirect URL is secured
(https).
- Go to the Information tab and fill the required information.
- click on Save.
Step B: Configure the miniOrange Yourmembership plugin
-
In miniOrange YourMembership SSO plugin, navigate to the
Add Application tab and enter the Client ID, App ID and
App Secret which you have obtained from the YourMembership admin
panel.
-
Note the Redirect URL which you have to add while configuring the
YourMembership App.
- Click on Save.
- click on Save.
Step C: Initiate YourMembership Single Sign-On (SSO)
-
Add a Single Sign on button on the WordPress login page.
-
Go to SSO Settings tab and scroll to the
Option 1: Use a Single Sign-On button and turn on the switch.
-
To initiate the single sign-on (SSO) link, you need to add a login widget
to your homepage.
-
Go to Appearance → Widgets and drag & drop the
Login with Your Membership widget to Footer section.
-
You can now test the Single Sign-On using
Login Using YourMembership widget.
Note: YM will cease support for Legacy APIs soon.
Step A: Enter API Key to enable SSO
-
In the miniOrange YourMembership SSO plugin, navigate to
SSO Settings tab.
- Enter your Public API Key in the text box.
- Click on Save.
Step B: Test SSO Connection
-
After your API Key has been saved, click on
Test Configuration button.
-
You will be redirected to YourMembership login page, where you can enter
your credentials and test the configurations.
Note: Attribute Mapping, Role Mapping and SSO Settings features are
included in the Paid Plugin.
For any queries please contact us at
samlsupport@xecurify.com
2. Attribute Mapping
-
Attribute Mapping feature allows you to map the user attributes sent
by YourMembership during SSO to the user attributes at WordPress.
-
Go to Attribute/Role Mapping tab and fill up the fields in Attribute
Mapping section with the user profile attributes you want to map.
3. Role Mapping
-
This feature allows you to assign and manage roles of the users when they
perform SSO. Along with the default WordPress roles, this is compatible with
any custom roles as well.
-
From the Attribute Mapping section of the plugin, provide a mapping
for the field named Group/Role. This attribute will contain the role
related information sent by YourMembership and will be used for Role
Mapping.
-
Navigate to role mapping section and provide the mappings for the roles
according to your needs.
4. SSO Settings
-
Login Widget: You can add a YourMembership login widget to initiate
SSO on your site.
-
Shortcode: You can add SSO links anywhere on your site using the
Shortcode option to initiate SSO.
-
Auto-Redirection from site: If this option is enabled, any
unauthenticated user trying to access your site will get redirected to the
YourMembership login page and after successful authentication they will be
redirected back to the same page on your site which they were trying to
access.
-
Auto-Redirection from WordPress Login: If this option is enabled, any
unauthenticated user trying to access the default WordPress login page will
get redirected to YourMembership login page for authentication. After
successful authentication, they will be redirected back to the WordPress
site.