Raycynix.Extensions.Database.AspNetCore.Identity 2.1.0

Raycynix.Extensions.Database.AspNetCore.Identity

ASP.NET Core Identity integration for Raycynix.Extensions.Database.

This package adds Raycynix-compatible IdentityDbContext implementations and service registration extensions for applications that store ASP.NET Core Identity data through the Raycynix database infrastructure.

What It Provides

• Default RaycynixIdentityDatabaseContext based on ASP.NET Core Identity.
• Generic identity contexts for custom users, roles, keys, claims, logins, and tokens.
• AddRaycynixIdentityDatabase registration methods with strict identity-context constraints.
• Raycynix model assembly discovery and configurator execution.
• Provider validation, database initialization, migrations assembly selection, and model-cache integration inherited from Raycynix.Extensions.Database.

This package does not configure authentication, authorization, cookies, token handlers, or AddIdentity. It only registers the EF Core database context and Raycynix database infrastructure used by ASP.NET Core Identity.

Installation Shape

Use this package together with one Raycynix database provider package, for example:

using Raycynix.Extensions.Database.AspNetCore.Identity;
using Raycynix.Extensions.Database.PostgreSql;

builder.Services
    .AddRaycynixIdentityDatabase(builder.Configuration)
    .AddPostgreSql();

Default Identity Context

The default context uses ASP.NET Core Identity's standard IdentityDbContext shape.

builder.Services
    .AddRaycynixIdentityDatabase(builder.Configuration, options =>
    {
        options.UseMigrations = true;
        options.EnableSeed = false;
    })
    .AddSqlite();

Custom User Type

For a custom string-key user, use the generic Raycynix context:

using Microsoft.AspNetCore.Identity;
using Raycynix.Extensions.Database.AspNetCore.Identity;

public sealed class ApplicationUser : IdentityUser
{
    public DateTime CreatedAtUtc { get; set; }
}

builder.Services
    .AddRaycynixIdentityDatabase<RaycynixIdentityDatabaseContext<ApplicationUser>>(
        builder.Configuration)
    .AddPostgreSql();

Custom User, Role, And Key

For a custom key type, use the TUser, TRole, TKey context:

using Microsoft.AspNetCore.Identity;
using Raycynix.Extensions.Database.AspNetCore.Identity;

public sealed class ApplicationUser : IdentityUser<Guid>
{
}

public sealed class ApplicationRole : IdentityRole<Guid>
{
}

builder.Services
    .AddRaycynixIdentityDatabase<
        RaycynixIdentityDatabaseContext<ApplicationUser, ApplicationRole, Guid>>(
        builder.Configuration)
    .AddPostgreSql();

Fully Customized Identity Entities

The package also includes a fully generic context for custom claim, role mapping, login, role claim, and token entity types:

RaycynixIdentityDatabaseContext<
    TUser,
    TRole,
    TKey,
    TUserClaim,
    TUserRole,
    TUserLogin,
    TRoleClaim,
    TUserToken>

All Raycynix identity contexts implement IRaycynixIdentityDatabaseContext, which keeps AddRaycynixIdentityDatabase scoped to Identity contexts instead of arbitrary EF Core DbContext types.

Model And Migrations Assemblies

Use marker types when model configurators and migrations live in known assemblies:

builder.Services
    .AddRaycynixIdentityDatabase<
        RaycynixIdentityDatabaseContext<ApplicationUser, ApplicationRole, Guid>,
        ModelAssemblyMarker,
        MigrationsAssemblyMarker>(builder.Configuration)
    .AddMsSql();

Use explicit assemblies when markers are not convenient:

builder.Services
    .AddRaycynixIdentityDatabase<RaycynixIdentityDatabaseContext>(
        builder.Configuration,
        migrationsAssembly,
        modelAssembly)
    .AddSqlite();

Additional configurator assemblies can be registered through:

builder.Services.AddRaycynixDatabaseAssembly<MyModelMarker>();

Database Initialization

Database creation and migration behavior is controlled by DatabaseConfiguration, the same as in the core database package. In ASP.NET Core applications, use the startup helper from Raycynix.Extensions.Database.AspNetCore when you want initialization during application startup:

await app.InitializeRaycynixDatabaseAsync();