DNN OAuth Single Sign-On (SSO) with Facebook as OAuth Provider

DNN OAuth Single Sign-On (SSO) module gives the ability to enable OAuth Single Sign-On for your DNN site. Using our Single Sign-On solution, you can use only one password to access your DNN sites and services. Our module is compatible with all the OAuth compliant identity providers. Here we will go through a step-by-step guide to configure Single Sign-On (SSO) between DNN and Facebook considering Facebook as OAuth Provider.

Pre-requisites: Download and Installation

• Download the DNN OAuth Single Sign On module with above link.
• Extract the package and upload the extension dnn-oauth-single-sign-on_xxx_Install by going to Settings > Extension > Install Extension

Configure DNN OAuth Single Sign-On using Facebook as OAuth Provider

1. Adding SSO module on DNN page

• Open any of the page on your DNN site (Edit mode) and Click on Add Module.

• Search for oauthclientsso and click on the oauthclientsso. Drag and drop the module on the page where you want.

• You have finished with the installation of the module on your DNN site.
• If you want to add module on every page of your dnn site, go to Module Settings >> Module Settings >> Advanced Settings.

• Check the box for Display Module on All Pages and click on Update.
• Under oauthclientsso settings tab, select Facebook as identity provider (IDP).

• Copy the Redirect/Callback URL and provide the same to your OAuth Provider.

• Please refer the below table for configuring the scope & endpoints for Facebook in the plugin.

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

2. Configure Facebook as OAuth Provider

• First of all, Login/ Signup in Facebook developer console at https://developers.facebook.com/

• Go to My apps.

• Click on Create app to create a new app.

• Select what your app is going to work for.

• Enter the required details and click on create app.

• Complete the security check and click on Submit button.

• Select Facebook Login by clicking on the set up button .

• Select Facebook Login -> Settings under Products option in the navigation bar.

• Enter the Callback/Redirect URL (from your DNN OAuth SSO module) in the Valid OAuth Redirect URIs field. Click on the Save button to save your configurations.
• Note: Your Callback/Redirect URI should be https and not http. It is mandatory while configuring Facebook as an OAuth Provider.

• Go to Settings -> Basic to view your App Id and App Secret as shown in the image below.

• 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 DNN OAuth SSO module under the respective fields.

• 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.

You have successfully configured Facebook as OAuth Provider to Single Sign-On into your DNN application.

3. Testing OAuth SSO

• After saving settings, you can see the list of applications you have configured.
• Click on Edit to update the configuration.

• Click on Test Configuration to check if the configuration is correct.
• On successful configuration, you will get Attributes Name and Attribute Values on Test Configuration window.

4. Attribute Mapping

• Go to the oauthclientsso settings >> Advanced Settings >> Attribute Mapping.

• Map email and username with Attribute Name you can see in Test Configuration window.

5. Adding Widget

• For adding the widget go to Add Widget.

• Click on Add Widget button. A button will be added on the DNN page.

You can configure the ASP.NET OAuth Single Sign-On (SSO) module with any identity provider such as ADFS, Azure AD, Bitium, Centrify, G Suite, JBoss Keycloak, Okta, OneLogin, Salesforce, AWS Cognito, OpenAM, Oracle, PingFederate, PingOne, RSA SecureID, Shibboleth-2, Shibboleth-3, SimpleSAML, WSO2 or even with your own custom identity provider.

Additional Resources

• ASP.NET OAuth Single Sign-On (SSO)
• Two-Factor Authentication for ASP.NET
• Two-Factor Authentication for DNN
• DNN SAML Single Sign-On (SSO)
• DNN REST API Authentication
• nopCommerce OAuth Single Sign-On (SSO)
• Kentico SAML Single Sign-On (SSO)

×