DNN OAuth Single Sign-On Setup Guides

Step 1: Download and Install the module in DotNetNuke.

• Download the package for DNN OAuth Single Sign-On (SSO) module.
• Upload the installation package dnn-oauth-single-sign-on_xxx_Install by going in Settings > Extension > Install Extension.

Step 2: Adding 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.

Step 3: Configure Module for Setting up OAuth Single Sign-On (SSO)

• Go to Module Settings >> oauthclientsso settings.

• Search your OAuth/OpenID/JWT provider application or click on your OAuth/OpenID/JWT provider application from the given application’s list.
• If your application/ server name is not there in the default list. You can click on Custom OAuth 2.0 App or Custom OpenID Connect App to add a custom OAuth/OpenID/JWT Connect Server.

Step 4: Configuring OAuth Provider

• Copy Redirect/Callback Url from the module’s Basic Settings tab.
• Provide it to your OAuth/OpenID/JWT provider to configure it on their side.

Step 5: Configuring OAuth Client

1. If you are using any custom Oauth/JWT provider

• Configure your OAuth/JWT provider and you will get Client ID, Client Secret, Authorize Endpoint, Access Token Endpoint and UserInfo Endpoint from your OAuth/OpenID/JWT provider.
• Add the supported scopes by your OAuth/OpenID/JWT provider.
• Click on the Save/Update button to save module configurations.

2. If you have selected any of the default OAuth/JWT provider from the given list

• Note: For Default Applications in the default list, endpoints and scopes are auto-filled. But you can change it if required.
• Your OAuth/JWT provider will provide you with Client / App ID and Client secret. Copy Client/App ID and Client secret and paste it under Client Id and Client secret in the module configuration window.
• Confirm you have filled all required fields and click on Update / Save.

Step 6: Test Configuration

• Click the Test Configuration button to verify if you have configured the plugin correctly.
• On successful configuration, you will get Attribute Name and Attribute Values in the Test Configuration window.

Step 7: Mapping the basic attributes

• Go to the oauthclientsso settings >> Advanced Settings >> Attribute Mapping.
• Map email and username with Attribute Name you can see in Test Configuration window.
• Click on the Save button to save the settings.

Step 8: Adding login/SSO widget on DNN Page

• For Adding Button on the DNN page beside the module settings click on the Add Item (Pencil Icon).

• Click on Add widget option to add the login button.