Facebook OAuth2

OVERVIEW

OAuth 2 Facebook login is used to simplify the login for users who are used to logging into facebook. Login in with a OAuth2 authentication means that you can login with your facebook credentials.

USE CASE EXAMPLE:

Facebook OAuth2 can be used in a Learning Management System (LMS) for internal staff training to facilitate user authentication and authorization.

Scenario: ABC Corporation has an internal LMS to train its employees on various topics and wants to integrate Facebook OAuth2 for a seamless login experience.

However, it's essential to ensure that user data privacy and security are maintained throughout the process, and users should have the option to use traditional username/password authentication if they prefer not to link their Facebook account.

STEP 1: SET UP AN OAUTH 2 CLIENT WITH FACEBOOK

Step 1.1: Log in to Facebook for Developers Apps and click the 'Create App' button:

Step 1.2: Select your app type, then continue:

Step 1.3: Set your App Display name and Contact Email:

Step 1.4: Click Settings -> Basic on the left:

STEP 2: SAVE THE CREDENTIALS

Step 2.1: Save your App ID and App Secret as shown below. Fill out the required fields prompted by Facebook, then save changes:

Note: These settings belong to your legal entity.

Step 2.2: Submit your app for verification by scrolling down the page and filling out the required fields:

If your business and app are not verified by Facebook, you may get this error message at the end of this setup process when trying to login for the first time. Please submit your review to Facebook and wait for their approval of your business.

STEP 3: ADD PRODUCT

Step 3.1: Click on "Add Product" as shown below:

Step 3.2: Setup Facebook login:

Step 3.3: Select Web:

Step 3.4: Enter your Pluto LMS domain: (eg: https://courses.yoursite.com):, then Save.

Step 3.5: Click Settings under 'Facebook Login' on the left, then configure the Client OAuth Settings as follows:

Set 'Web OAuth Login', 'Enforce HTTPS' and 'Use Strict Mode for Redirect URIs' to Yes and everything else to No.

Then set the "Valid OAuth Redirect URIs" to "your Pluto LMS site URL + /admin/oauth2callback.php". If your Pluto LMS site is available at https://courses.yoursite.com the callback URL would be https://courses.yoursite.com/admin/oauth2callback.php.

then click the button 'Save Changes'.

STEP 4: MAKE YOUR FACEBOOK APP LIVE:

Step 4.1: Toggle your app to make it live.

STEP 5: ADD CREDENTIALS TO PLUTO LMS

Step 5.1: Click on "Site admin", "Integrations" then "0Auth2" under SSO:

Step 5.2: Click on the Facebook gear icon as shown below:

Step 5.3: Add your Client ID and Client Secret (from Step 2 above), then leave other settings and click on save changes:

Step 5.4: (1) Connect a test account, and once you have the green tick, (2) unhide the integration so that users can begin logging into your LMS with their Facebook accounts.

SUCCESSFUL SETUP

If the Facebook OAuth2 SSO login button has been successfully setup on your Pluto LMS, you will see this:

Click on the Facebook button to test if you are able to SSO through your personal Facebook account.

FACEBOOK MAY REQUIRE A REVIEW OF YOUR BUSINESS:

If you get this prompt, please "Submit for review now" in order to get Facebook approval. Please contact their support team if you business does not get verified with what you require in order to complete this process.