This pps demonstrates concept of separation of concerns (SOC) and is a simple implementation of the Clean Architecture. The pps provides user/authentication management for both a Web MVC project using cookies and a Web API project using JWT.

The Core project contains all domain entities.

General hashing functionality is provided via the PPS.Core.Security.Hasher class.

The Data project encapsulates all data related concerns. Internally it provides two implementations of the IUserService

1. Using a List that is persisted to a json file.
2. Using the Repository pattern implemented by Entityframework to handle data storage/retrieval. It defaults to using Sqlite for portability across platforms.

The Service is the only element exposed from this project and consumers of this project simply need reference it to access its functionalty.

Password hashing functionality added via the PPS.Data.Security.Hasher class. This is used in the Data project DataService to hash the user password before storing in database.

The Test project references the Data project and should implement unit tests to test the functionalty of the IUserService. The tests should be extended to fully exercise the functionality of your Service.

The API project provides a RESTful WebApi interface to User management. It references the Core and Data projects and uses the DataService and Models to access data management functionality.

CORS is also enabled and JWT tokens are used for authentication and are configured via a helper class PPS.Api.Helpers.JwtHelper called in Startup.cs.

JWT is configured via appsettings.json and includes configuration parameters JwtSecurityKey, JwtIssuer, JwtAudience, JwtExpiryInDays. These are already set with default values and can be amended as required. Recommended to change the JwtSecurityKey and ensure this is not committed to git in production.

The Web project uses the MVC pattern to implement a web application. It references the Core and Data projects and uses the DataService and Models to access data management functionality. This allows the Web project to be completely independent of EntityFrameworkCore (as used in this pps) or any other persistence framework used in the data project.

The project also uses cookie based user Identity without using the boilerplate pps used in the Visual Studio Web MVC project. This allows the developer to gain a better appreciation of how Identity is implemented. The data project implements a User model and the UserService provides user management functionality such as Authenticate, Register etc. The Web project implements a UserController with actions for Login/Register/NotAuthorized/NotAuthenticated etc.

Authentication is configured via an authorisation helper class PPS.Web.Helpers.AuthHelper that utilises CookieBased authentication. To enable authentication, call the AuthHelper.AddAuthSimple() extension method in Startup.cs configure services.

The pps replaces the locally installed Bootstrap 4 with Bootstrap 5(beta2) delivered via CDN link.

Any Controller that inherits from the Web project BaseController, can utilise the Alert functionality. Alerts can be used to display alert messages following controller actions.

Alert("The User Was Registered Successfully", AlertType.info);

Review the UserController for an example using alerts.

Two custom TagHelpers are included that provide

1. Authentication and authorisation Tags

• <p asp-authorized>Only displayed if the user is authenticated</p>

• <p asp-roles="Admin,Manager">Only displayed if the user has one of specified roles</p>

2. Conditional Display Tag

• <p asp-condtion="@some_boolean_expression">Only displayed if the condition is true</p>

To install this solution as a pps (pps name is termonclean)

1. Download current version of the pps

   $ git clone https://github.com/termon/DotNetPPS.git

2. Install the pps so it can be used by dotnet new command. Use the absolute path to the cloned pps directory without trailing '/'

   $ dotnet new -i /absolute_path/DotNetPPS

3. Once installed you can create a new project using this pps

   $ dotnet new termonclean -o SolutionName