Installing DotNetNuke Authentication Providers 

DotNetNuke 4.6 and later provided us with a very helpful new development method known as Authentication Providers.  This process created a new development package that developers could use to replace the standard DotNetNuke authentication system.  When this was released three providers were provided by the core; DNN, LiveId, and OpenId.  These providers all came pre-installed, the true question then becomes how do we actually install a NEW authentication provider?  This was something that is very easy, but you must know where to look when doing so.  This tutorial will walk you through the installation process for a separate authentication provider.  I will walk through the installation of the Active Directory Authentication Provider on a DotNetNuke 4.7.0 site.

Prerequisites

Before you can follow these instructions you must ensure that you have a DNN 4.6.0 or later installation AND a valid authentication provider .zip package for installation.  Be very careful, an Authentication Provider package is NOT the same as a DotNetNuke module.

Installation

To install your new authentication provider you must first login to your portal as the host user, then navigate to the host settings under the "Host" menu.  You will then follow the below steps to actually install the provider of your choice.

1. Expand the "Authentication Settings" section
   
2. Click the "Install New Authentication System" link to bring up the selection page
3. Use the "Browse" button on this page to select your provider install package, then press "Next"
4. Now you will see a summary of the provider to be installed, check the box to accept the license, then press "Next"
   
5. You should see a "Success" message similar to the below. Click the "Return" link to go back to "Host Settings"
   
6. Ensure that your new provider shows as "Enabled", this completes the installation process
   

Configuration (If Needed)

Depending on the installed Authentication Provider you might need to configure the provider before it can be successfully used.  To check for configuration settings select "Authentication" from the "Admin" menu. This page will contain a settings section for each provider.

Share/Save This Article:      

Comments