ASP.NET JWT Single Sign-On (SSO) Setup Guide

1. Pre-requisites: Download & Installation

• Download miniOrange ASP.NET JWT SSO module.
• For Setting up the module, extract the asp-net-jwt-sso-module.zip, you will find a DLL file miniorange-jwt-sso.dll, a configuration file jwt.config and a integration.md file which contain the steps for adding the module into your application.

2. Add the module in your application

• Add miniorange-jwt-sso.dll in bin folder (where your other DLL files exists) for your application.
• Register miniorangejwtsso module in your application according to the provided steps in the integration.md file.
• Add the provided configuration file jwt.config in the root directory for your application.
• After integration open browser and browse the module dashboard with URL below:
  https:// <your-application-base-url>/?ssoaction=config
• If it pop up the registration page or login page, you have successfully added the miniOrange JWT SSO module for your application.

• Register or Login for configuring the module.

3. Configure miniOrange ASP.NET JWT Client

• Fill in the mandatory fields such as application name, Redirect/Callback URL, Token Endpoint and Userinfo Endpoint and click on Save.

4. Test Configuration

• After saving configuration, click on the Test Configuration button to verify if you have configured correctly.
• On successful configuration, you will get Attributes Name and Attribute Values on Test Configuration window. The below screenshot shows a successful result.

5. Attribute Mapping

• Map Attribute Names provided by your JWT Server with your ASP.NET application attributes given under Attribute Mapping Section and click on Save Attribute Mapping.

• Note: All the mapped attributes will be stored in the session so that you can access them in your application.

6. Integration Code

• You can find the integration code in Integration Code tab in the ASP.NET JWT module. Copy-paste that code snippet wherever you want to access the user attributes.

Additional Resources

• ASP.NET SAML Single Sign-On (SSO)
• DNN SAML Single Sign-On (SSO)
• nopCommerce SAML Single Sign-On (SSO)
• DNN REST API Authentication
• Web3 login for ASP.NET Applications