Steps to Configure the ASP.NET OAuth 2.0 Module
Step 1: Download and extract package.
miniOrange ASP.NET OAuth 2.0 Module.
For Setting up the connector, extract the
asp-net-oauth-sso-module.zip, you will find a DLL file
miniorange-oauth-sso.dll, a configuration file
oauthsso.config and a integration.md file which contain the
steps for adding the module into your application.
Step 2: Add the connector in your application.
Add miniorange-oauth-sso.dll in bin folder (where your other DLL
files exists) for your application.
Register miniorangeoauthsso module in your application according to
the provided steps in the integration.md file.
Add the provided configuration file oauthsso.config in the root
directory for your application.
After integration open browser and browse the connector dashboard with URL
If it pop up the registration page or login page, you have successfully
added the miniOrange oauth sso connector for your application.
- Register or Login for configuring the connector.
Step 3: Configure miniOrange ASP.NET OAuth Client
Configure your OAuth/JWT Server. While configuring your OAuth/JWT server
provide the Redirect/Callback URL from the OAuth/JWT Client.
You will get the Client ID, Client Secret, Authorize Endpoint, Access
Token Endpoint, Get User Info Endpoint from your OAuth/JWT Server. You
need to verify the supported scope with the OAuth/JWT Server.
Fill all the required details and click on Save Configuration.
Step 4: Test Configuration
After saving configuration, click on the
Test Configuration button to verify if you have configured
On successful configuration, you will get Attributes Name and
Attribute Values on Test Configuration window. The below screenshot
shows a successful result.
Step 5: Attribute Mapping
Map Attribute Names provided by your OAuth/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.
Step 6: Integration Code
You can find the integration code in Integration Code tab in the
connector. Just copy-paste that code snippet wherever you want to access
the user attributes.
Step 7: Add following link in your application for Single Sign-On (SSO)
Use the following URL as a link in your application from where you want to
For example you can use it as:
You can configure the ASP.NET OAuth/JWT Single Sign-On (SSO) module with any
OAuth/JWT Provider such as
AWS Cognito, Azure AD, WHMCS, Ping Federate, Slack, Discord, LinkedIn,
Shibboleth, WSO2 or even with your own custom oauth/JWT provider
and secure your ASP.NET / ASP.NET MVC / ASP.NET Core / VB.NET applications by
performing Single Sign-on (SSO) into them.
List of popular OAuth/JWT Providers we support
- Azure AD
- AWS Cognito
- Ping Federate
- HR Answerlink / Support center
- Blizzard (Formerly Battle.net)
- Gluu Server
LIST OF POPULAR OPENID CONNECT (OIDC) PROVIDERS WE SUPPORT
- AWS Cognito
- Swiss-RX-Login (Swiss RX Login)
Not able to find your IdP? Contact us at
and we'll help you set up SSO with your IdP in no time.
The miniOrange ASP.NET OAuth 2.0 Connector supports
C# and Visual Basic languages.
We also provide ASP.NET Single Sign-On SAML Connector.Click Here
to know more.
We also provide DotNetNuke (DNN) Single Sign-On SAML Connector.
to know more.
miniOrange also provides you modules for integration with legacy apps such as
Active Directory, SiteMinder, Radius, Unix and so on.
helps you for adding login/authentication into your ASP.NET site using
OAuth/JWT, OpenID, ADFS, SAML and WSFED protocols.
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.