EasyAuth.Framework 2.3.0

EasyAuth Framework

🔐 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

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