ASP.NET Core Identity에서 역할 기반 인증을 위한 ApplicationRole 클래스 추가 가이드
역할 기반 인증
ASP.NET Core MVC, Razor Pages, Blazor Server 프로젝트의 기본 템플릿에서는 ApplicationRole 클래스가 포함되어 있지 않습니다. 그러나 역할 기반 인증(Role-Based Authorization) 기능을 구현하려면 기본 IdentityRole 클래스를 상속받은 사용자 정의 역할 클래스가 필요합니다. 이 문서에서는 ApplicationRole을 정의하고 Identity 시스템에 통합하는 과정을 단계별로 설명합니다.
1. ApplicationRole 클래스 생성
IdentityRole을 상속하여 사용자 지정 역할 속성을 추가할 수 있습니다. 예를 들어 역할에 대한 설명을 추가하려면 다음과 같이 정의합니다:
// File: Data/ApplicationRole.cs
using Microsoft.AspNetCore.Identity;
namespace Azunt.Web.Data;
/// <summary>
/// ASP.NET Core Identity 역할 클래스 (사용자 정의 확장)
/// 역할 기반 인증 시, 역할 설명 등 추가 정보 제공
/// </summary>
public class ApplicationRole : IdentityRole
{
public string Description { get; set; } = "";
}
2. ApplicationDbContext에 사용자 정의 역할 클래스 등록
IdentityDbContext에 제네릭 인자로 ApplicationUser, ApplicationRole, 키 타입(string)을 지정합니다:
// File: Data/ApplicationDbContext.cs
using Microsoft.AspNetCore.Identity.EntityFrameworkCore;
using Microsoft.EntityFrameworkCore;
namespace Azunt.Web.Data;
public class ApplicationDbContext : IdentityDbContext<ApplicationUser, ApplicationRole, string>
{
public ApplicationDbContext(DbContextOptions<ApplicationDbContext> options)
: base(options)
{
}
}
🔍
ApplicationUser는 사용자 정의 IdentityUser 클래스입니다.ApplicationRole과 마찬가지로 확장을 위해 사용됩니다.
3. Program.cs 또는 Startup.cs에서 Identity 설정 확장
AddIdentity 호출 시 사용자 클래스와 역할 클래스를 모두 명시해야 합니다:
builder.Services
.AddDefaultIdentity<ApplicationUser>(
options => options.SignIn.RequireConfirmedAccount = true)
.AddEntityFrameworkStores<ApplicationDbContext>();
위 모양으로 되어 있는 코드를 다음과 같은 스타일로 변경합니다.
AddIdentity<ApplicationUser, ApplicationRole>
// File: Program.cs
services.AddIdentity<ApplicationUser, ApplicationRole>(options =>
{
options.SignIn.RequireConfirmedAccount = false;
options.SignIn.RequireConfirmedEmail = false;
})
.AddEntityFrameworkStores<ApplicationDbContext>()
.AddDefaultTokenProviders();
4. 마이그레이션 및 데이터베이스 반영
새로운 ApplicationRole 클래스는 데이터베이스 테이블 구조에 영향을 줍니다. 따라서 마이그레이션 및 데이터베이스 업데이트를 수행해야 합니다:
dotnet ef migrations add AddApplicationRole
dotnet ef database update
5. 역할 생성 및 할당 예시
시드 데이터 또는 관리자 페이지에서 역할을 생성하고 사용자에게 할당할 수 있습니다:
var roleManager = serviceProvider.GetRequiredService<RoleManager<ApplicationRole>>();
if (!await roleManager.RoleExistsAsync("Administrators"))
{
await roleManager.CreateAsync(new ApplicationRole
{
Name = "Administrators",
Description = "관리자 역할"
});
}
var userManager = serviceProvider.GetRequiredService<UserManager<ApplicationUser>>();
var user = await userManager.FindByEmailAsync("admin@example.com");
await userManager.AddToRoleAsync(user, "Administrators");
결론
ApplicationRole 클래스는 역할에 대해 보다 유연하고 풍부한 정보를 제공할 수 있도록 돕습니다. ASP.NET Core Identity의 기본 템플릿에는 포함되어 있지 않지만, 역할 기반 인증 및 관리자 기능 개발을 위해서는 필수적으로 정의하고 설정해야 할 요소입니다. 본 문서를 기반으로 프로젝트에 맞는 사용자 정의 역할 기능을 확장해보시기 바랍니다.