The EmpowerID SSO framework allows you to configure Facebook as an identity provider (IdP) for EmpowerID. EmpowerID integrates with Facebook using OAuth 2.0.

Prerequisites:

Before configuring Facebook as an OAuth Identity Provider in EmpowerID, you need to meet the following conditions:

You must have a Facebook developer account
Create an application for EmpowerID in Facebook

Once the IDP Connection has been set up for Facebook, you can create a link similar to the one below to allow users to login to EmpowerID using Facebook.

https://FQDN_OF_YOUR_EMPOWERID_SERVER/WebIdPForms/Login/Portal/Facebook?returnUrl=%2FWebIdPForms%2F

Be sure to replace FQDN_OF_YOUR_EMPOWERID_SERVER with the FQDN of your EmpowerID server.

Steps

To configure Facebook as an Identity Provider for EmpowerID, you need to do the following:

Create an application for EmpowerID in Facebook
Configure the default Facebook OAuth Provider app
Add a Login button to the Login page for Facebook
Test the OAuth provider app

Create an application for EmpowerID in Facebook

To allow users to authenticate to EmpowerID using their Facebook credentials, you must register EmpowerID as an OAuth application in the Facebook developer console. See Facebook’s article at https://developers.facebook.com/docs/apps#register for directions on how to do this. During the app registration process, Facebook will generate an AppID and App secret for the application. You will use these when you create an OAuth Provider App for Facebook in EmpowerID.

When creating an application for EmpowerID in Facebook , set the following:

Setting	Value

Setting	Value
Display Name	Name of the application you are creating. This can be any value.
Valid OAuth redirect URIs	`https://YOUR_EMPOWERID_SERVER/WebIdPForms/oauth/v2`

Configure the default Facebook OAuth Provider app

On the navbar, expand Single Sign-On > SSO Connections and click OAuth / OpenID Connect.
Select the External OAuth Services tab and then search for Facebook.
Click the Provider link for Facebook.
Click the Edit button for the default Facebook OAuth provider app.
Under General Settings, fill in the following information and then click Save.

Field	Description

Field	Description
Consumer Key	App ID generated by Facebook
Consumer Secret	App Secret generated by Facebook
Is Identity Provider	Select this option to flag the OAuth provider as an Identity Provider app.
Select existing Account Directory	Select Facebook to place authenticated users in the selected account store.
Callback Url	This is the URI that Facebook redirects users after they have authenticated with Facebook. The URL should look like the following: `https://YOUR_EMPOWERID_SERVER/WebIdPForms/oauth/v2`, where YOUR_EMPOWERID_SERVER is the FQN of your EmpowerID Web server.

Add a Login Button for Facebook

On the navbar, expand Single Sign-On > SSO Connections and click SSO Connections.
Select the IdP Domains tab and then click the IdP Domains link for the IdP Domain where you want the Login tile to appear.
Select the External OAuth Providers tab and then select the Facebook provider.
Click Save.

To give users the ability to log in using their EmpowerID credentials, be sure to select EmpowerID from the SAML Identity Providers tab of the IdP Domain Details page.

Test the OAuth Provider App

Log out of the EmpowerID Web interface and navigate your browser to the domain name you configured for the Facebook IdP connection.
Click the Login Using Facebook button.
Click Okay to allow EmpowerID to retrieve the information it needs to link your Facebook account to your EmpowerID identity (Person object).
You should be authenticated to EmpowerID.

IN THIS ARTICLE