Authorizer.DotNet

Official .NET SDK for Authorizer.dev - A comprehensive authentication and authorization service for .NET applications.

🚀 Quick Start

dotnet add package Authorizer.DotNet // Configure in Program.cs builder.Services.AddAuthorizer(builder.Configuration, "Authorizer"); // Use in your code public class AuthController : ControllerBase { private readonly IAuthorizerClient _client; public AuthController(IAuthorizerClient client) => _client = client; [HttpPost("login")] public async Task<IActionResult> Login([FromBody] LoginRequest request) { var response = await _client.LoginAsync(request); return response.IsSuccess ? Ok(response.Data) : BadRequest(response.Errors); } } // appsettings.json { "Authorizer": { "AuthorizerUrl": "https://your-authorizer-instance.com", "ClientId": "your-client-id", "RedirectUrl": "https://your-app.com/auth/callback" } }

✨ Features

• 🔐 Complete authentication (login, signup, OAuth, JWT)
• 🛡️ Multi-factor authentication (OTP, TOTP)
• ✉️ Passwordless magic link authentication
• 👤 User & session management
• 🎯 Multi-framework support (ASP.NET Core, Blazor, Console)
• 🔄 .NET 6.0, 7.0, and 8.0 compatible
• ⚡ Production-ready with comprehensive testing

📖 Documentation

Complete Documentation →

All documentation has been consolidated into one comprehensive guide covering:

• Installation & Configuration
• All Authentication Methods
• Complete API Reference
• Sample Applications
• Advanced Topics (Cross-Domain, OAuth, MFA, etc.)
• Testing & Troubleshooting
• Migration Guides

📦 Sample Applications

Explore working examples in the samples/ directory:

• ASP.NET Core API - REST API with Swagger
• Blazor Server - Full web app with UI
• Console App - Interactive CLI
• JWT API - JWT Bearer authentication

Run any sample:

cd samples/Authorizer.Sample.BlazorServer dotnet run

🔧 Core Methods

// Authentication await client.LoginAsync(request); await client.SignupAsync(request); await client.MagicLinkLoginAsync(request); await client.AuthorizeAsync(request); // OAuth await client.LogoutAsync(token); // User Management await client.GetProfileAsync(token); await client.UpdateProfileAsync(request, token); await client.GetSessionAsync(); // Password Management await client.ForgotPasswordAsync(request); await client.ResetPasswordAsync(request); await client.ChangePasswordAsync(request); // MFA await client.VerifyOtpAsync(request); await client.ResendOtpAsync(request); // Utilities await client.GetMetaAsync(); // Feature detection await client.ValidateJwtAsync(token);

🆘 Common Issues

"HTTP 401 Unauthorized"

• Verify ClientId is correct in configuration

"HTTP 422 Cross-Domain Errors"

• Configure CookieDomain = ".example.com"
• See Cross-Domain Authentication

"Connection Timeout"

• Increase HttpTimeout in configuration
• Check network connectivity

📊 Testing

# Run all tests (137 total: 115 unit + 22 integration) dotnet test # Run unit tests only dotnet test tests/Authorizer.DotNet.UnitTests/ # Run integration tests (requires Authorizer instance) dotnet test tests/Authorizer.DotNet.IntegrationTests/

🤝 Contributing

Contributions are welcome! Please see DOCUMENTATION.md for guidelines.

📝 Changelog

See CHANGELOG.md for version history and breaking changes.

💬 Support

• 📖 Complete Documentation
• 📖 Authorizer.dev Docs
• 💬 Discord Community
• 🐛 Issue Tracker

📄 License

MIT License - see LICENSE file for details.

---

Made with ❤️ in London