Tisa.Authorization 2026.9.10.321

Tisa.Authorization

👁 NuGet Version

Библиотека авторизации для .NET приложений, разработанная компанией ТИСА. Предоставляет гибкую и расширяемую систему авторизации на основе разрешений (permissions) и ролей для ASP.NET Core приложений.

Возможности

• Поддержка .NET 8.0, .NET 9.0 и .NET 10.0
• Интеграция с ASP.NET Core Authorization
• Система разрешений (Permissions) на основе enum
• Система ролей (Roles) с поддержкой полномочий
• JWT токены и работа с claims
• Динамическое создание политик авторизации
• Атрибуты для декларативной авторизации
• Расширяемая система провайдеров (JWT, Claims, Roles)
• Интеграция с Tisa.Common

Установка

dotnet add package Tisa.Authorization

Начало работы

Регистрация сервисов

Для регистрации сервисов авторизации используйте метод расширения:

using Microsoft.Extensions.DependencyInjection;
using Tisa.Authorization;

public class Startup
{
 public void ConfigureServices(IServiceCollection services)
 {
 services.AddAuthorization();
 
 // Регистрация провайдера политик авторизации
 services.AddSingleton<IAuthorizationPolicyProvider, PermissionAuthorizationPolicyProvider>();
 
 // Регистрация обработчика разрешений
 services.AddSingleton<IAuthorizationHandler, PermissionAuthorizationHandler>();
 
 // Регистрация провайдеров (опционально)
 services.AddTransient<IClientClaimsProvider, ClaimsProvider>();
 services.AddTransient<IRoleProvider, RoleProvider>();
 }
}

Использование атрибутов авторизации

Атрибут HasPermission

Используйте атрибут HasPermissionAttribute для защиты действий контроллера:

using Microsoft.AspNetCore.Authorization;
using Microsoft.AspNetCore.Mvc;
using Tisa.Authorization.Attributes;
using Tisa.Authorization.Abstractions;

[ApiController]
[Route("api/[controller]")]
public class UsersController : ControllerBase
{
 [HttpGet]
 [HasPermission(Permission.UserRead)]
 public IActionResult GetUsers()
 {
 return Ok();
 }
}

Стандартный атрибут Authorize

Также можно использовать стандартный атрибут Authorize с именем разрешения:

[Authorize(Policy = "UserRead")]
public IActionResult GetUsers()
{
 return Ok();
}

Работа с разрешениями

Библиотека предоставляет enum Permission для определения разрешений:

using Tisa.Authorization.Abstractions;

// Доступные разрешения:
// - Permission.None - отсутствие полномочий
// - Permission.UserRead - чтение пользователя
// - Permission.AccessEverything - абсолютный доступ

Работа с ролями

Система ролей основана на классе Role:

using Tisa.Authorization.Abstractions;

// Стандартные роли:
// - Role.User - пользовательская роль (имеет Permission.UserRead)
// - Role.Administrator - административная роль (имеет Permission.AccessEverything)

// Получение роли по имени
var role = Role.FromName("User").Value;
var permissions = role.GetPermissions();

Работа с клиентами и Claims

Для работы с клиентами и генерации claims используйте IClientClaimsProvider:

using Tisa.Authorization.Abstractions;
using Tisa.Authorization.Models;
using System.Security.Claims;

public class MyService
{
 private readonly IClientClaimsProvider _claimsProvider;
 
 public MyService(IClientClaimsProvider claimsProvider)
 {
 _claimsProvider = claimsProvider;
 }
 
 public IEnumerable<Claim> GetClaims(Client client)
 {
 return _claimsProvider.GetClaimsForClient(client);
 }
}

Модель Client

Модель Client представляет клиента приложения:

using Tisa.Authorization.Models;

var client = new Client
{
 Token = "client-token",
 Name = "Client Name"
};

client.AddRole("User");
client.AddRole("Administrator");

Провайдер JWT токенов

Для работы с JWT токенами реализуйте интерфейс IJwtProvider:

using Tisa.Authorization.Abstractions;
using Tisa.Authorization.Models;

public class MyJwtProvider : IJwtProvider
{
 public AccessTokens GetAccessTokens(Client client)
 {
 // Реализация генерации токенов
 return new AccessTokens();
 }
}

Структура проекта

• Abstractions/ - Базовые интерфейсы и абстрактные классы (Permission, Role, IJwtProvider, IRoleProvider, IClientClaimsProvider)
• Attributes/ - Атрибуты для декларативной авторизации (HasPermissionAttribute)
• Filters/ - Фильтры для авторизации (зарезервировано)
• Handlers/ - Обработчики авторизации (PermissionAuthorizationHandler)
• Models/ - Модели данных (Client, AccessTokens, ClientTokenResponse)
• Providers/ - Провайдеры авторизации (PermissionAuthorizationPolicyProvider, ClaimsProvider, RoleProvider)
• Requirements/ - Требования авторизации (PermissionRequirement)

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

PermissionAuthorizationPolicyProvider

Провайдер политик авторизации, который динамически создает политики на основе имен разрешений. Если политика с указанным именем не найдена, создается новая политика с требованием PermissionRequirement.

PermissionAuthorizationHandler

Обработчик авторизации, который проверяет наличие необходимого разрешения у пользователя. Разрешения извлекаются из claims типа CustomClientClaimTypes.Permissions.

HasPermissionAttribute

Атрибут для декларативной авторизации действий контроллера на основе enum Permission.

Типы Claims

Библиотека использует следующие типы claims (определены в CustomClientClaimTypes):

• FullName - полное имя клиента
• IsSetupComplete - флаг завершения настройки
• Permissions - список разрешений клиента

Схемы аутентификации

Определены константы схем аутентификации в классе AuthScheme:

• ApiKey - передача токена в заголовке запроса
• Token - передача токена в параметре запроса

Требования

• .NET 8.0, .NET 9.0 или .NET 10.0
• Microsoft.AspNetCore.Authorization (версия зависит от целевой платформы)
• System.IdentityModel.Tokens.Jwt 8.16.0
• Tisa.Common

Лицензия

MIT License

Поддержка

По вопросам поддержки и сообщений об ошибках: support@tisn.ru