DioRed.Aith.AspNetCore 1.0.0-preview.9

DioRed.Aith.AspNetCore

DioRed.Aith.AspNetCore provides seamless integration between ASP.NET Core applications and Aith, an OAuth 2.0 authorization server and OpenID Connect provider from DioRED.

It offers:

• Browser login (Authorization Code + PKCE) with cookie-based app sessions
• Automatic UserInfo → Claims mapping
• High-level and advanced configuration models
• Built-in interactive login/logout endpoint helpers
• Support for multiple authentication schemes
• Full extensibility for custom OAuth options

🚀 Installation

dotnet add package DioRed.Aith.AspNetCore

✨ Quick Start

Register Aith authentication in Program.cs:

builder.Services.AddAithAuthentication(o =>
{
    o.ClientId     = "my-app";
    o.ClientSecret = "secret";
});

Add interactive login/logout endpoints:

app.MapAithInteractiveEndpoints();

Protect your pages:

app.MapGet("/profile", (ClaimsPrincipal user) =>
{
    return $"Hello, {user.Identity?.Name}";
}).RequireAuthorization();

🔧 Advanced Configuration

If you need full control over cookie scheme names, the authentication pipeline, or the underlying OAuth handler:

builder.Services.AddAithAuthenticationCore(o =>
{
    o.CookieScheme = "MyCookies";
    o.AithScheme   = "MyAith";

    o.ConfigureAith = aith =>
    {
        aith.ClientId     = "my-app";
        aith.ClientSecret = "secret";
    };

    o.ConfigureAithOAuth = oauth =>
    {
        oauth.SignInScheme = "MyCookies";
        oauth.Scope.Add("custom-scope");
    };

    // Optional:
    // o.ConfigureCookie = cookie => { ... };
});

📡 UserInfo → Claims Mapping

Aith automatically fetches the UserInfo document and maps its fields to claims:

• "name" → ClaimTypes.Name
• "sub" → ClaimTypes.NameIdentifier
• "email" → ClaimTypes.Email
• "preferred_username" → "preferred_username"
• All other JSON fields → claims with the same JSON property names

This ensures HttpContext.User.Identity.Name works as expected.

🧩 Interactive Login/Logout Endpoints

Add standardized interactive endpoints:

app.MapAithInteractiveEndpoints();

Customize paths/schemes if needed:

app.MapAithInteractiveEndpoints(
    loginPath: "/auth/login",
    logoutPath: "/auth/logout",
    cookieScheme: "MyCookies",
    challengeScheme: "MyAith"
);

📚 Summary

DioRed.Aith.AspNetCore gives you a clean, production-ready, extensible way to plug Aith authentication into any ASP.NET Core application, from minimal APIs to MVC to Razor Pages.

If you need programmatic Aith access using client_credentials, see the companion package:

👉 DioRed.Aith.Client (NuGet)