A set of libraries to easily integrate and extend authentication in ASP.NET Core projects, using ASP.NET Core Identity.
🏷️ Description
MinimalApi.Identity is a dynamic and modular identity manager for managing users, roles, claims and more for access control in Asp.Net Mvc Core and Web API, using .NET 8 Minimal API, Entity Framework Core and relational database (of your choice).
[!IMPORTANT]
This library is still under development of new implementations and in the process of creating the related documentation.
🧩 Features
Minimal API: Built using .NET 8 Minimal API for a lightweight and efficient implementation.
Entity Framework Core: Uses EF Core for data access, making it easy to integrate with your existing database.
Modular: The library is designed to be modular, allowing you to add or remove features as needed.
Dynamic: Supports dynamic management of users, roles, claims, forms, licensing and policies.
Flexible Configuration: Easily configurable via appsettings.json to suit your application's needs.
The library is available on NuGet, just search for Identity.Module.API in the Package Manager GUI or run the following command in the .NET CLI:
dotnet add package Identity.Module.API
⚙️ Configuration
The configuration can be completely managed by adding this section to the appsettings.json file:
[!WARNING]
The library is still under development, so the configuration may change in future updates.
[!NOTE]
For migrations you can use a specific project to add to your solution, then configuring the assembly in ConnectionStrings:MigrationsAssembly, otherwise leave it blank and the assembly containing the Program.cs class will be used.
The library uses Entity Framework Core to manage the database.
The connection string is configured in the ConnectionStrings section of the appsettings.json file.
Database Type: Set via ConnectionStrings:DatabaseType (supported values: sqlserver)
After setting the type of database you want to use, modify the corresponding connection string.
Migrations
[!TIP]
To update the database schema you need to create migrations, they will be applied automatically at the next application startup.
To create database migrations select MinimalApi.Identity.Core as the default project from the drop-down menu in the Package Manager Console
and run the command: Add-Migration MIGRATION-NAME
[!NOTE]
if you use a separate project for migrations (It is recommended to add a reference in the project name to the database used, in this case it is SQL Server),
make sure to set the -Project parameter to the name of that project.
Move the configuration of the claims to a dedicated library
Move the configuration of the module to a dedicated library
Move the configuration of the profile manager to a dedicated library
Move the configuration of the roles to a dedicated library
Add CancellationToken to API endpoints (where necessary)
Add automatic creation of a default administrator account
Replacing exceptions with implementation of operation results
Replacing the hosted service email sender using Coravel jobs
Replacing the hosted service authorization policy updater using Coravel jobs
Migrate SmtpOptions configuration to database
Migrate FeatureFlagsOptions configuration to database
Add support for the MySQL database
Add support for the PostgreSQL database
Add support for the SQLite database
Add endpoints for two-factor authentication and management
Add endpoints for downloading and deleting personal data
Future implementations
Add support for the AzureSQL database
Add support for multi tenancy
Add authentication support from third-party providers (e.g. GitHub, Azure)
📜 License
This project is licensed under the MIT License - see the LICENSE file for details.
⭐ Give a Star
Don't forget that if you find this project useful, put a ⭐ on GitHub to show your support and help others discover it.
🤝 Contributing
The project is constantly evolving. Contributions are always welcome. Feel free to report issues and submit pull requests to the repository, following the steps below:
Fork the repository
Create a feature branch (starting from the develop branch)
Make your changes
Submit a pull requests (targeting develop)
🆘 Support
If you have any questions or need help, read here to find out what to do.
