ASP.NET SAML Single Sign-On (SSO) using miniOrange As IDP
ASP.NET SAML Single Sign-On (SSO)
module gives the ability to enable SAML Single Sign-On for your ASP.NET
applications. Using Single Sign-On you need only one password to access your
ASP.NET application and services. Our module is compatible with all SAML
identity providers. Here, we will go through a step-by-step guide to configure Single Sign-On
(SSO) between ASP.NET and miniOrange, considering miniOrange as IdP. To know
more about the other features we provide, click
Platform Support: The ASP.NET SAML module supports ASP.NET 4.0 and
To set up the module, extract the file
asp.net-saml-sso-module-xxx.zip. You will find a DLL named
miniorange-saml-sso.dll, a configuration file named
saml.config and an integration.md file which contains
steps for adding the module into your application.
Add miniorange-saml-sso.dll into your bin folder (where other DLL
files for your application exist).
Register minorangesamlsso module in your application according to
the steps provided in the file named integration.md.
Add the provided configuration file saml.config in the root
directory of your application.
After integration, open your browser and browse the connector dashboard with
the URL below: https://<your-application-base-url>/?ssoaction=config
If the registration page or login page pops up, you have successfully added
the miniOrange SAML SSO connector to your application.
Register or log in with your account by clicking the Register button
to configure the module.
Steps to configure miniOrange Single Sign-On (SSO) Login into ASP.NET
1. Configure miniOrange as identity provider
You need to send your SP metadata to identity provider, miniOrange. For SP
metadata, use the SP metadata URL or download the SP metadata as a .xml file
and upload it at your IdP end. You can find both these options under the
Service Provider Settings tab.
There are two ways detailed below with which you can get the SAML SP
metadata to configure onto your identity provider end.
A] Using SAML metadata URL or metadata file:
Under Service Provider Settings you can find the metadata URL as
well as the option to download the SAML metadata.
Copy metadata URL or download the metadata file to configure the same on
your identity provider end.
You may refer to the screenshot below:
B] Uploading metadata manually:
From the Service Provider Settings section, you can manually copy
the service provider metadata like
SP Entity ID, ACS URL, Single Logout URL
and share it with your identity provider for configuration.
In the right upper corner, select Add Application.
Choose the Application type as SAML/WS-FED.
In the search apps textbox, type Custom SAML App.
Click on the Custom SAML App application.
Fill in the metadata details in the textboxes below manually or you can
Import SP Metadata.
Custom Application Name
App name you like to provide.
SP Entity ID or Issuer
Enter SP Entity ID / Issuer from Service Provider
Info tab of the plugin
(Assertion Consumer Service)
from Service Provider Info tab of the plugin
Single Logout URL
Enter Single Logout URL from Service Provider Info
tab of the plugin
Click on Save to add the App.
Under the Login Policy, select the Default from the
Group Name dropdown.
Enter Policy Name you would like to provide.
Select Password from the Login Method dropdown.
Click on Save.
Navigate to the Apps in the left menu.
Click on the metadata link against your app.
Download the Metadata XML File or note down the given
information and keep it handy to configure the Service Provider
2. Configure ASP.NET application as service provider
Note: After installation of the plugin, we need to setup the trust
between your ASP.NET application and your miniOrange account. SAML metadata is
shared with miniOrange so they can update their inbuilt configuration to
support Single Sign-On.
Import miniOrange SAML metadata
Select miniOrange from the list of identity providers shown below.
There are two methods for configuring ASP.NET as service provider:
A] Upload metadata using the Upload IDP Metadata button:
If your identity provider has provided you with the metadata URL or
metadata file (.xml format only), then you can simply configure the
identity provider metadata in the module using the
Upload IDP Metadata option.
You may refer to the screenshot below:
You can choose any one of the options according to the metadata format you
B] Configure the identity provider metadata manually:
After configuring your Identity Provider, it will provide you
with IDP Entity ID, IDP Single Sign On URL and
SAML X509 Certificate fields respectively.
Click Save to save your IDP details.
3. Testing SAML SSO
Click on the Test Configuration button to test whether the SAML
Configuration you’ve done is correct.
The screenshot below shows a successful result. Click on
SSO Integration where you will be redirected to
Attribute Mapping section.
If you are experiencing any error on the module end you’ll be shown with the
window similar to below.
To troubleshoot the error you can follow the below steps:
tab, enable the toggle to receive the plugin logs.
Once enabled, you will be able to retrieve plugin logs by navigating to
Identity Provider Settings tab and clicking on
Download the log file from the Troubleshoot tab to see what
You can even configure the
DNN SAML 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. To check other identity
Not able to find your identity provider? Mail us on
and we'll help you set up SSO with your IDP and for quick guidance (via
email/meeting) on your requirement and our team will help you to select the
best suitable solution/plan as per your requirement.
Need Help? We are right here!
Contact miniOrange Support
Thanks for your inquiry.
If you dont hear from us within 24 hours, please feel free to send a follow up email to firstname.lastname@example.org