Reo.Core.IdentityModel 10.0.200

Reo.Core.IdentityModel

Описание пакета

Пакет Reo.Core.IdentityModel предоставляет инструменты для работы с пользовательскими данными в приложениях, требующих аутентификации и авторизации. Он позволяет эффективно управлять информацией о пользователях, включая кэширование данных, проверку ролей и разрешений, а также интеграцию с системами управления доступом.

Основные функции:

• Хранение и извлечение информации о пользователях (имя, роль, разрешения).
• Кэширование данных пользователя для повышения производительности.
• Поддержка проверки ролей и разрешений.
• Интеграция с DI-контейнерами (например, в ASP.NET Core).

Основные компоненты

Классы и интерфейсы

• UserInfo Основной класс для хранения и управления данными пользователя (имя, роль, разрешения, связанные регионы и т.д.). Предоставляет методы для проверки ролей, разрешений и извлечения информации.

• UserInfoCacheDto DTO-класс для хранения данных пользователя в кэше. Расширяет UserInfo и добавляет поддержку кэширования через атрибуты [CacheKeyPrefix].

• UserInfoContainer Реализация интерфейса IUserInfoService, предоставляющая доступ к данным пользователя. Используется как контейнер для инкапсуляции логики работы с пользовательскими данными.

• IUserInfoService Интерфейс для абстракции сервиса работы с пользовательскими данными. Определяет методы, такие как GetUserInfo(), IsInRole(), HasPermission() и др.

• UserInfoCacheDto DTO-класс для хранения данных пользователя в кэше. Расширяет UserInfo и добавляет поддержку кэширования через атрибуты [CacheKeyPrefix].

Требования

• .NET версии: .NET 6.0 и выше.
• Зависимости:
  • IdentityModel (для работы с утверждениями).
  • Reo.Core.DistributedCache.Abstractions (для кэширования данных).

Установка

Установите пакет через NuGet Package Manager:

Install-Package Reo.Core.IdentityModel

Или через .NET CLI:

dotnet add package Reo.Core.IdentityModel

Настройка

Регистрация в DI-контейнере (ASP.NET Core)

Добавьте сервис в Startup.cs или Program.cs:

services.AddScoped<IUserInfoService, UserInfoContainer>();

Конфигурационные параметры

• Кэширование: Используйте атрибут [CacheKeyPrefix("identity", "userinfo")] в классе UserInfoCacheDto для настройки префикса ключа кэша.

Использование

Пример 1: Получение информации о пользователе

public class UserService
{
 private readonly IUserInfoService _userInfoService;

 public UserService(IUserInfoService userInfoService)
 {
 _userInfoService = userInfoService;
 }

 public void CheckUserPermissions()
 {
 var userInfo = _userInfoService.GetUserInfo();
 if (userInfo.HasPermission("edit_content"))
 {
 Console.WriteLine("Пользователь имеет разрешение на редактирование контента.");
 }
 }
}

Пример 2: Проверка роли пользователя

public class RoleChecker
{
 private readonly IUserInfoService _userInfoService;

 public RoleChecker(IUserInfoService userInfoService)
 {
 _userInfoService = userInfoService;
 }

 public void CheckUserRole()
 {
 var userInfo = _userInfoService.GetUserInfo();
 if (userInfo.IsInRole("admin"))
 {
 Console.WriteLine("Пользователь является администратором.");
 }
 }
}

Пример 3: Кэширование данных пользователя

// В классе UserInfoCacheDto используется атрибут [CacheKeyPrefix] для кэширования.
[CacheKeyPrefix("identity", "userinfo")]
public class UserInfoCacheDto : UserInfo, IEntityId<Guid>
{
 // Реализация класса
}

Лицензия

Данный пакет распространяется под лицензией MIT.