EasyAuth.Framework.Core 2.4.11

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

EasyAuth uses Backend-for-Frontend (BFF) pattern with REST API endpoints. No additional frontend packages required.

// Check authentication status
const response = await fetch('/api/EAuth/user');
const result = await response.json();
if (result.success) {
 console.log('User authenticated:', result.data);
} else {
 console.log('User not authenticated');
}
// Get available providers
const providersResponse = await fetch('/api/EAuth/providers');
const providers = await providersResponse.json();
// Initiate login (redirects to provider)
window.location.href = `/api/EAuth/login?provider=google&returnUrl=${encodeURIComponent(window.location.href)}`;
// Logout
await fetch('/api/EAuth/logout', { method: 'POST' });

🔗 Supported Identity Providers

🏗️ 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

🧪 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

• 📖 Getting Started Guide
• ⚙️ Configuration Reference
• 🔑 Provider Setup Guide
• 📋 API Reference
• 🏢 Enterprise Deployment
• 🔧 Troubleshooting

🤝 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

• 📖 Documentation
• 💬 GitHub Discussions
• 🐛 Issue Tracker
• 📧 Email: support@easyauth.dev

⭐ If you find EasyAuth useful, please consider giving it a star on GitHub!