This example shows how to use Okta, OpenID Connect, and ASP.NET Core 2.0 MVC.
You can follow the quickstart for this project to see how it was created.
Prerequisites: .NET Core 2.0 or higher.
Okta has Authentication and User Management APIs that reduce development time with instant-on, scalable user infrastructure. Okta's intuitive API and expert support make it easy for developers to authenticate, manage and secure users and roles in any application.
To install this example application, clone this repository with Git:
git clone git@github.com:oktadeveloper/okta-aspnetcore-mvc-example.git
cd okta-aspnetcore-mvc-example
Or download a zip archive of the repository from GitHub and extract it on your machine.
You will need to create an application in Okta to to perform authentication.
Log in to your Okta Developer account (or sign up if you don’t have an account) and navigate to Applications > Add Application. Click Web, click Next, and give the app a name you’ll remember.
Change the Base URI to:
http://localhost:60611/
Change the Login redirect URI to:
http://localhost:60611/authorization-code/callback
Click Done. On the General Settings screen, click Edit.
Add a Logout redirect URI:
http://localhost:60611/signout-callback-oidc
Scroll to the bottom of the Okta application page to find the client ID and client secret. You'll need those values in the next step.
Update the appsettings.json
file with these values:
Okta:ClientId
- The client ID of the Okta applicationOkta:ClientSecret
- The client secret of the Okta applicationOkta:Issuer
- Replace{yourOktaDomain}
with your Okta domain, found at the top-right the Dashboard page, or in the address bar.
Note: The value of {yourOktaDomain}
should be something like dev-123456.oktapreview.com
. Make sure you don't include -admin
in the value!
Run the project with Visual Studio, or with this command:
dotnet run
Browse to http://localhost:60611
to test the application.
- ASP.NET Core + Okta authentication quickstart
- Use the Okta .NET SDK if you need to call Okta APIs for management tasks
Please post any questions on the Okta Developer Forums. You can also email developers@okta.com if you would like to create a support ticket.
Apache 2.0, see LICENSE.