Step By Step Guide For WordPress Single Sign On (SSO) using Facebook

Step By Step Guide For WordPress Single Sign On (SSO) Using Facebook



If you want users to login to your WordPress site using their Facebook credentials, you can simply do it using our WP OAuth Client plugin. Once you configure the Facebook with WordPress plugin, you can allow users to SSO to your WordPress site using Facebook.
Similarly, you can map your WordPress roles based on your Facebook attributes/groups. To know more about other features we provide in WP OAuth Client plugin, you can click here.



You can download OAuth Client plugin using the following link.




Download And Installation

  • Log into your WordPress instance as an admin.
  • Go to the WordPress Dashboard -> Plugins and click on Add New.
  • Seach for a WordPress OAuth Single Sign On plugin and click on Install Now.
  • Once installed click on Activate.

Step 1: Setup Facebook as OAuth Provider

  • First of all, Login/ Signup in Facebook developer console at https://developers.facebook.com/
  • Facebook sso
  • Go to My apps -> Add New App.
  • Facebook sso
  • Enter the Display Name and Contact Email for your facebook app under the Display Name and Contact Email fields respectively and then click on Create App ID button to save your settings and create an App Id for your app.
  • fb3
  • Select Facebook Login by clicking on the set up button .
  • Facebook sso
  • Select Facebook Login -> Settings under Products option in the navigation bar .
  • Facebook sso
  • Under Client OAuth Settings, enter the Callback/Redirect URL (from your miniOrange Oauth Client plugin) in the Valid OAuth Redirect URIs field. Click on the Save button to save your configurations.
    Most importantly, your Callback/Redirect URI should be https and not http. It is mandatory while configuring Facebook as an OAuth Server.
  • Facebook sso
  • Go to Settings -> Basic to view your App Id and App Secret Refer to the image below).
  • Facebook sso
  • Enter your Privacy Policy URL in the Privacy Policy URL field and choose a category from the dropdown in the Category field. Then, click on Save Changes button to save your configurations.
  • Copy your App ID and your App Secret and save it in your miniOrange OAuth Client Plugin/Module. (under client id and client secret field respectively).
  • Facebook sso
  • Change you app status from In Development to Live by clicking on OFF as shown in the image below. Then, click on confirm to confirm your change of status.
  • Facebook sso

    Facebook Endpoints and Scope:


    Client ID : Click Here
    Client Secret : Click Here
    Scope: public_profile email
    Authorize Endpoint: https://www.facebook.com/dialog/oauth
    Access Token Endpoint: https://graph.facebook.com/v2.8/oauth/access_token
    Get User Info Endpoint: https://graph.facebook.com/me/?fields=id,name,email,age_range,first_name,gender,last_name,link

Step 2: Setup WordPress as OAuth Client

  • Go to Configure OAuth tab and configure App Name, Client ID, Client Secret from provided Endpoints.
  • openid is already filled but if it doesn't work then configure scope as User.Read and for fetching group info use scope is Directory.read.all.
  • Click on Save Settings to save the configuration.
  • wordpress oauth client plugin sso : save settings

Step 3: User Attribute Mapping.

  • User Attribute Mapping is mandatory for enabling users to successfully login into WordPress. We will be setting up user profile attributes for WordPress using below settings.
  • Finding user attributes

    • Go to Configure OAuth tab. Scroll down and click on Test Configuration.
    • wordpress oauth client plugin : test congifuration
    • You will see all the values returned by your OAuth Provider to WordPress in a table. If you don't see value for First Name, Last Name, Email or Username, make the required settings in your OAuth Provider to return this information.
    • wordpress oauth client plugin sso : test congifuration result
    • Once you see all the values in Test Configuration, go to Attribute / Role Mapping tab, you will get the list of attributes in a Username dropdown.
    • wordpress oauth client plugin sso : attribute/role mapping

Step 4: Login Settings / Sign In Settings.

  • The settings in SSO Settings tab define the user experience for Single Sign On. To add a login widget on your WordPress page, you need to follow below steps.
  • Sign In Settings

    • Go to WordPress Left Panel > Appearances > Widgets.
    • Select miniOrange OAuth. Drag and drop to your favourite location and save.
    • wordpress oauth client plugin sso: login button setting
    • Open your WordPress page and you can see the login button there. You can test the SSO now.

Need Guidance?

Mail us on oauthsupport@xecurify.com for quick guidance(via email/meeting) on your requirement and our team will help you to select the best suitable solution/plan as per your requirement.