ASP.NET Core samples demonstrating how to use the ASP.NET OpenID Connect server with MVC or JS apps.

Note: the samples hosted on this repository target ASP.NET Core 1.0 RTM ; see AspNet.Security.OpenIdConnect.Server/samples for samples targeting the latest pre-release versions.

This sample shows two separate web applications, potentially running on separate servers, playing the roles of a client and a server with regard to authentication.

To the user, Mvc.Client is the main web application, offering for example a login page and a home page (see HomeController). It plays as the client from the point of view of authentication, as it does not implement authentication services on its own and asks the Mvc.Server project for those through interactive OpenID Connect requests.

To the user, Mvc.Server is almost invisible. It offers authentication services to client web application by means of its REST API endpoints, playing as the authorization server mentioned in OpenID Connect scenarios. In this role, it's also responsible of rendering the authorization consent form (see AuthorizationController).

Besides from APIs to request and refresh tokens, Mvc.Server also offers an API to access a protected resource, whose data are only accessible to authenticated users (see ResourceController). Thus, it also plays as the resource server of an OpenID Connect scenario.

Note that, generally speaking, authorization server and resource server could also be split in two separate web applications.

Need help or wanna share your thoughts? Don't hesitate to join us on Gitter or ask your question on StackOverflow:

• Gitter: https://gitter.im/aspnet-contrib/AspNet.Security.OpenIdConnect.Server
• StackOverflow: https://stackoverflow.com/questions/tagged/aspnet-contrib

AspNet.Security.OpenIdConnect.Samples is actively maintained by Kévin Chalet. Contributions are welcome and can be submitted using pull requests.

This project is licensed under the Apache License. This means that you can use, modify and distribute it freely. See http://www.apache.org/licenses/LICENSE-2.0.html for more details.