DNN SAML Single Sign-On (SSO) with Azure AD as IDP

Overview

DNN SAML Single Sign-On (SSO) authentication provider gives the ability to enable SAML Single Sign-On for your DotNetNuke applications. Using Single Sign-On you can use only one password to access your DotNetNuke application and services. Our authentication provider is compatible with all the SAML-compliant identity providers. Here we will go through a step-by-step guide to configure Single Sign-On (SSO) between DotNetNuke and Azure AD considering Azure AD as IdP.

Download

Pricing Plans

Pre-requisites : Download And Installation

Download the DNN SAML Single Sign On authentication provider with above link.
Upload the installation package dnn-saml-single-sign-on_xxx_Install by going in Settings > Extension > Install Extension.
Navigate to the Installed Extensions tab and select Authentication Systems. You will find the miniOrange DNN SAML Authentication Provider listed there.

miniOrange DNN SAML Authentication Provider

Click on the pencil icon (as shown in the image below) to begin configuring the DNN SAML Authentication Provider.

DNN SAML Authentication Provider - Pencil Icon

Navigate to the Site Settings tab to configure DNN SAML SSO.

DNN SAML Authentication Provider - Site Settings

To activate DNN SAML SSO, enter the license key received via email in the provided input field.
If you haven’t received the license key, click on the “here” link to download it, and then upload the license file using the Choose File button.
Click on the Activate License button to complete the activation.

DNN SAML Authentication Provider - License Key

Configuration Steps

Step by Step guide for DNN SAML SSO using Azure AD as Identity Provider.

1. Provide DNN SAML Metadata to Azure AD Identity Provider

After successful license activation, the plugin dashboard will open as shown below.

In the plugin dashboard, click on the Service Provider Metadata button from the top menu. This will open the Service Provider Metadata page.

DNN SAML SSO - Service Provider Metadata Button

Scroll down to the Share SAML Metadata section.

You can obtain the SAML SP metadata using either of the two methods described below to configure it on your Identity Provider end.

A] Using SAML metadata URL or metadata file

On this page, you can find the Metadata URL as well as the option to download the SAML metadata XML file.
Copy the Metadata URL or download the metadata file to configure the same on your Identity Provider end.
You may refer to the screenshot below:

DNN SAML SSO - Metadata url and download option

B] Uploading Metadata Manually

On this page, you can manually copy the service provider metadata such as SP Entity ID, ACS URL, SP Logout Url and share it with your Identity Provider for configuration.
You may refer to the screenshot below:

Steps to Configure Azure AD IdP

Select Azure Active Directory.

Select Enterprise Application.

Click on New Application.

Click on Create your own Application.

Enter the name for your app, then select Non-gallery application section and click on Create button.

Click on Setup Single sign-on.

Select the SAML tab.

After clicking on Edit, enter the SP Entity ID for Identifier and the ACS URL for Reply URL from Service Provider Metadata tab of the plugin, which you will get from Step 2B.

Azure AD - Select SAML authentication SSO

By default, the following Attributes will be sent in the SAML response. You can view or edit the claims sent in the SAML response to the application under the Attributes tab.

Copy the App Federation Metadata Url to get the Endpoints required for configuring your Service Provider.

Assign users and groups to your SAML application
- Navigate to Users and groups tab and click on Add user/group.
- Click on Users to assign the required user and then click on select.
- You can also assign a role to your application under Select Role section.

You have successfully configured Microsoft Entra ID (formerly Azure AD) as SAML IDP (Identity Provider) for achieving nopCommerce Single Sign-On (SSO).

2. Configure Azure AD Identity Provider Metadata in DNN SAML SSO

Click on the Add new IDP button to configure a new Identity Provider.

Under the Plugin Settings tab, select Azure AD as your identity provider from the list shown.

After selecting your IdP from the list, the Identity Provider Settings page will open. Here, you can either click on the Upload IdP Metadata button to configure the Identity Provider automatically using metadata, or manually enter the required Identity Provider details under the Identity Provider Settings.

There are two ways detailed below with which you can configure your SAML Identity Provider metadata in the plugin.

A] Upload metadata using the Upload IDP Metadata button:

Click Choose File to upload the metadata XML file using the Upload XML File option, then click Upload. Alternatively, provide the metadata URL in the Enter metadata URL section and click Fetch Metadata to retrieve the Identity Provider configuration automatically.
You may refer to the screenshot below:

DNN SAML SSO - metadata url or metadata file

B] Configure the identity provider metadata manually:

Alternatively, under the Identity Provider Settings tab, you can manually fill in the mandatory fields like IDP Name, IDP Entity ID and Single Sign-On URL and click Save Settings.

nopCommerce - Entity Id, SSO Url, SAML Certificate

3. Testing SAML SSO

After uploading the metadata details, navigate back to the Dashboard. Hover over the Select Actions dropdown next to the configured Identity Provider and click Test Configuration.

On successful configuration, you will get attributes name and attribute values in the test configuration window.

DNN SAML SSO - Successful Test Configuration

4. Adding SSO Link for Your DNN Portal

Hover over the Select Actions dropdown next to the configured Identity Provider and click Copy SSO Link.
Use this SSO link to initiate Single Sign-On (SSO) for users logging into your DNN portal.

User gets logged in to the DNN site by entering the credentials of Azure AD.

Thank you for your response. We will get back to you soon.

Something went wrong. Please submit your query again

Contents

DNN SAML Single Sign-On (SSO) with Azure AD as IDP

Overview