AuthPlus.Identity 1.0.16

AuthPlus.Identity

AuthPlus.Identity is a .NET 8+ class library designed to simplify user authentication and authorization in your ASP.NET Core applications. It provides ready-to-use APIs for users, roles, JWT authentication, email confirmation, password reset, and external login providers.

Features

• User Registration and Login
• Password Reset and Email Confirmation
• User Management (CRUD)
• Role Management (CRUD, assign/remove roles)
• JWT-Based Authentication
• Configurable Email Service
• External Authentication Providers (Google, Facebook, LinkedIn, etc.)
• Extendable Validators and Policies
• Ready-to-use Controllers and Endpoints
• Supports SQL Server, PostgreSQL (via EF Core)

Getting Started

Prerequisites

• .NET 8 SDK or later
• NuGet Package Manager

Installation

Add the package to your project:

dotnet add package AuthPlus.Identity

Configuration

Add the following settings to your appsettings.json:

{
  "JwtSettings": {
   "SecretKey": "your-32-character-super-secret-key-here", // Min 32 chars
    "Issuer": "your-app-name",
    "Audience": "your-app-clients",
    "ExpirationMinutes": 60
  },
  "EmailSettings": {
    "SmtpServer": "smtp.example.com",
    "SmtpPort": 587,
    "SmtpUser": "your-email@example.com",
    "SmtpPassword": "your-email-password",
    "BaseUrl": "https://your-app-url"
  },
  "ConnectionStrings": {
    "DefaultConnection": "Server=.;Database=AuthDb;Trusted_Connection=True;"
  }
}

Optional: Add external login providers by implementing IExternalAuthProvider (e.g., Google, Facebook, LinkedIn).

Setup in Program.cs

var builder = WebApplication.CreateBuilder(args);

// Add AuthPlus Identity (select your database provider)
builder.Services.AddAuthPlusIdentity(builder.Configuration, options =>
{
    options.UseSqlServer(builder.Configuration.GetConnectionString("DefaultConnection"));
    // options.UsePostgres(...);
    // options.UseMySql(...);
});

// Register external authentication providers (optional)
builder.Services.AddHttpClient<GoogleAuthProvider>();
builder.Services.AddHttpClient<MicrosoftAuthProvider>();
builder.Services.AddScoped<IExternalAuthProvider, GoogleAuthProvider>();
builder.Services.AddScoped<IExternalAuthProvider, MicrosoftAuthProvider>();

// Add controllers
builder.Services.AddControllers();

var app = builder.Build();
// IMPORTANT: Middleware must be in correct order
app.UseRouting(); // This must come first!
app.UseAuthentication();
app.UseAuthorization();

app.MapControllers();
app.Run();

AddAuthPlusIdentity automatically registers:

• Identity services
• JWT authentication
• Email service
• IUserService, IRoleService, IAuthService
• Policies (RequireAdminRole, RequireUserRole, RequireAdminOrUserRole)
• Validators for DTOs (LoginDto, RegisterDto, UserDto, ResetPasswordDto)

Controllers & Endpoints

AuthController

UserController

RoleController

Extending

You can extend and customize the library:

• Roles & Policies: Extend AuthorizationPolicies or add custom roles.
• Validators: Override or create custom DTO validators.
• ApplicationUser: Add new properties to your user class.
• Email Service: Implement IEmailService for custom email logic.
• External Providers: Implement IExternalAuthProvider for social logins.

Optional: Override Default Validators

public class CustomRegisterDtoValidator : RegisterDtoValidator
{
    public CustomRegisterDtoValidator()
    {
        RuleFor(x => x.Password)
            .Must(p => p.Contains("@"))
            .WithMessage("Password must contain '@'.");

        RuleFor(x => x.Password)
            .Matches(@"\d")
            .WithMessage("Password must contain at least one number.");
    }
}

// Register in Program.cs to replace default validator
builder.Services.AddTransient<IBaseValidator<RegisterDto>, CustomRegisterDtoValidator>();

Example: Register User in Controller

[HttpPost("register")]
public async Task<IActionResult> Register([FromBody] RegisterDto registerDto)
{
    var result = await _authService.RegisterAsync(registerDto);
    return !result.Succeeded ? BadRequest(result.Errors) : Ok(result);
}

License & Support

• MIT License
• For questions or support: muhdinmussema@gmail.com