EasyAuth.Framework.Core 2.4.3

.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package EasyAuth.Framework.Core --version 2.4.3
                    


                    

                
NuGet\Install-Package EasyAuth.Framework.Core -Version 2.4.3
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="EasyAuth.Framework.Core" Version="2.4.3" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="EasyAuth.Framework.Core" Version="2.4.3" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="EasyAuth.Framework.Core" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add EasyAuth.Framework.Core --version 2.4.3
                    


                    

                
#r "nuget: EasyAuth.Framework.Core, 2.4.3"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package EasyAuth.Framework.Core@2.4.3
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=EasyAuth.Framework.Core&version=2.4.3
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=EasyAuth.Framework.Core&version=2.4.3
                    


                            Install as a Cake Tool

EasyAuth Framework

Build Status NuGet Version License: MIT Coverage

๐Ÿ” Enterprise-grade authentication framework with multi-provider support and zero-configuration setup

๐Ÿ“– Overview

EasyAuth is a production-ready, self-contained .NET 8+ authentication framework that provides seamless integration with multiple identity providers. Built following enterprise security best practices, it offers automatic database setup, comprehensive testing, and plug-and-play functionality for modern web applications.

โœจ Key Features

  • ๐Ÿ”€ Multi-Provider Support: Azure AD B2C, Google OAuth 2.0, Apple Sign-In, Meta/Facebook Login
  • ๐Ÿ“ฆ Self-Contained: Single NuGet package with automatic database setup and migrations
  • ๐Ÿ”’ Secure by Default: BFF pattern, HTTP-only cookies, CSRF protection, rate limiting
  • ๐ŸŽฏ Framework Agnostic: Works with ASP.NET Core, Vue.js, React, or vanilla JavaScript
  • ๐Ÿข Enterprise Ready: SQL Server backend, structured logging, health checks, telemetry
  • โšก Zero Configuration: Automatic setup with minimal configuration required
  • ๐Ÿงช Test-Driven: 90%+ code coverage with comprehensive test suite
  • ๐Ÿ”„ Production Hardened: Security scanning, performance testing, monitoring

๐Ÿš€ Quick Start

Backend Integration (ASP.NET Core)

dotnet add package EasyAuth.Framework

// Program.cs
builder.Services.AddEasyAuth(builder.Configuration, builder.Environment);

var app = builder.Build();

app.UseEasyAuth(builder.Configuration);
app.Run();

Configuration (appsettings.json)

{
  "EasyAuth": {
    "ConnectionString": "Server=.;Database=MyApp;Trusted_Connection=true;",
    "Providers": {
      "Google": {
        "Enabled": true,
        "ClientId": "your-google-client-id"
      }
    },
    "Framework": {
      "AutoDatabaseSetup": true,
      "EnableHealthChecks": true
    }
  }
}

Frontend Integration

npm install @easyauth/client

import { EasyAuthClient, useEasyAuth } from '@easyauth/client';

const authClient = new EasyAuthClient({
  baseUrl: 'https://your-api.com'
});

// Vue.js Composition API
const { user, login, logout, isAuthenticated } = useEasyAuth(authClient);

// React Hook
const { user, login, logout, isAuthenticated } = useEasyAuthReact(authClient);

๐Ÿ”— Supported Identity Providers

Provider Status Features
Google OAuth 2.0 โœ… Production Ready Profile, Email, OAuth 2.0
Azure AD B2C โœ… Production Ready Enterprise SSO, Custom Policies
Apple Sign-In โœ… Production Ready Privacy-focused, Mobile-first
Meta/Facebook โœ… Production Ready Social Login, Profile Data
Custom OAuth ๐Ÿ”„ Coming Soon Extensible Provider System

๐Ÿ—๏ธ Architecture

graph TB
    A[Frontend App] -->|HTTP/HTTPS| B[ASP.NET Core API]
    B -->|EasyAuth.Framework| C[Authentication Service]
    C -->|OAuth 2.0/OIDC| D[Identity Providers]
    C -->|Session Management| E[SQL Server Database]
    C -->|Secrets Management| F[Azure Key Vault]
    
    D --> D1[Google]
    D --> D2[Azure B2C]
    D --> D3[Apple]
    D --> D4[Facebook]

๐Ÿ“Š Development Status

Feature Status Coverage
Core Authentication โœ… Complete 95%
Google Provider โœ… Complete 92%
Database Layer โœ… Complete 98%
Security Hardening ๐Ÿ”„ In Progress 85%
Apple Provider ๐Ÿ”„ In Progress 75%
Facebook Provider ๐Ÿ”„ In Progress 70%
Azure B2C Provider ๐Ÿ”„ In Progress 60%
Performance Testing โณ Planned 0%
Documentation ๐Ÿ”„ In Progress 40%

๐Ÿงช Testing & Quality

  • Test Coverage: 90%+ across all components
  • Security Scanning: OWASP compliance, vulnerability scanning
  • Performance Testing: Load testing with NBomber
  • Code Quality: SonarCloud analysis, StyleCop enforcement
  • CI/CD: Automated testing, security checks, NuGet publishing

๐Ÿ“š Documentation

๐Ÿค Contributing

We welcome contributions! Please see our Contributing Guide for details.

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/amazing-feature
  3. Follow TDD: Write tests first, then implementation
  4. Ensure 90%+ code coverage
  5. Submit a pull request

๐Ÿ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

๐Ÿ†˜ Support

โญ If you find EasyAuth useful, please consider giving it a star on GitHub!

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on EasyAuth.Framework.Core:

Package Downloads
EasyAuth.Framework

Complete Universal Integration System for EasyAuth framework with StandardApiController, zero-config frontend support, and comprehensive extensions. Works with React, Vue, Angular, and any frontend framework. Includes all authentication providers and ASP.NET Core extensions.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
2.4.11 228 8/14/2025
2.4.10 218 8/14/2025
2.4.9 215 8/14/2025
2.4.8 213 8/14/2025
2.4.7 222 8/13/2025
2.4.6 213 8/13/2025
2.4.5 259 8/13/2025
2.4.3 246 8/13/2025
2.4.2 241 8/13/2025
2.4.0 244 8/13/2025
2.3.1 224 8/12/2025
2.3.0 220 8/12/2025
2.2.0 223 8/12/2025
2.1.0 238 8/12/2025
2.0.0 240 8/12/2025
1.0.0-alpha.1 175 8/12/2025

v2.4.3 Controller Consolidation & Swagger Enhancement: Resolved controller conflicts between StandardApiController and EAuthController. StandardApiController deprecated and moved to /api/legacy with IgnoreApi attribute. Enhanced EAuthController with comprehensive Swagger documentation and critical API path warnings. Fixed missing MapEasyAuth() method with proper controller mapping, endpoint logging, and Swagger visibility. Created extensive documentation for MapEasyAuth() integration, dependency version conflicts, and OAuth setup CLI with Azure B2C Graph API provisioning. All OAuth endpoints now properly visible in Swagger under /api/EAuth/ paths exclusively.