Sparkdo.Authorization 1.0.1

Sparkdo.Authorization

Sparkdo 授权库，提供基于策略和权限的授权功能实现。

功能特性

• 基于策略的授权：支持 ASP.NET Core 授权策略
• 权限系统：灵活的权限定义和检查机制
• 方法级授权：通过拦截器实现方法级别的授权控制
• 多租户支持：支持多租户场景下的授权控制
• 权限提供者：支持用户、角色、客户端等多种权限提供者
• 本地化支持：支持授权错误消息的本地化
• 与 Sparkdo 框架无缝集成

安装

<PackageReference Include="Sparkdo.Authorization" Version="x.x.x" />

核心组件

授权拦截器

• AuthorizationInterceptor: 授权拦截器，用于拦截方法调用并执行授权检查
• AuthorizationInterceptorRegistrar: 授权拦截器注册器

授权服务

• ISparkdoAuthorizationService: Sparkdo 授权服务接口
• DefaultSparkdoAuthorizationService: 默认 Sparkdo 授权服务实现
• IMethodInvocationAuthorizationService: 方法调用授权服务接口
• DefaultMethodInvocationAuthorizationService: 默认方法调用授权服务实现

权限管理

• IPermissionChecker: 权限检查器接口
• DefaultPermissionChecker: 默认权限检查器实现
• IPermissionDefinitionManager: 权限定义管理器接口
• DefaultPermissionDefinitionManager: 默认权限定义管理器实现
• IPermissionValueProviderManager: 权限值提供者管理器接口
• DefaultPermissionValueProviderManager: 默认权限值提供者管理器实现

权限提供者

• UserPermissionValueProvider: 用户权限值提供者
• RolePermissionValueProvider: 角色权限值提供者
• ClientPermissionValueProvider: 客户端权限值提供者

权限定义存储

• IStaticPermissionDefinitionStore: 静态权限定义存储接口
• DefaultStaticPermissionDefinitionStore: 默认静态权限定义存储实现
• IDynamicPermissionDefinitionStore: 动态权限定义存储接口
• NullDynamicPermissionDefinitionStore: 空动态权限定义存储实现

策略提供者

• ISparkdoAuthorizationPolicyProvider: Sparkdo 授权策略提供者接口
• DefaultSparkdoAuthorizationPolicyProvider: 默认 Sparkdo 授权策略提供者实现

状态检查器

• RequirePermissionsSimpleStateChecker: 需要权限的简单状态检查器
• RequirePermissionsSimpleBatchStateChecker: 需要权限的批量简单状态检查器
• RequireAuthenticatedSimpleStateChecker: 需要认证的简单状态检查器

使用示例

基本授权使用

[Authorize("MyPermission")]
public class MyService
{
    public void MyMethod()
    {
        // 此方法需要 "MyPermission" 权限才能访问
    }
}

[Authorize("MyPermission1,MyPermission2")]
public class AnotherService
{
    public void MyMethod()
    {
        // 此方法需要 "MyPermission1" 和 "MyPermission2" 权限才能访问
    }
}

权限检查

public class MyService
{
    private readonly IPermissionChecker _permissionChecker;
    
    public MyService(IPermissionChecker permissionChecker)
    {
        _permissionChecker = permissionChecker;
    }
    
    public async Task MyMethod()
    {
        if (await _permissionChecker.IsGrantedAsync("MyPermission"))
        {
            // 用户具有 "MyPermission" 权限
        }
    }
}

自定义权限定义

public class MyPermissionDefinitionProvider : PermissionDefinitionProvider
{
    public override void Define(IPermissionDefinitionContext context)
    {
        var myGroup = context.AddGroup("MyGroup", "我的权限组");
        
        myGroup.AddPermission("MyPermission", "我的权限");
    }
}

扩展性

该库提供了完整的授权功能实现，可以通过以下方式扩展：

1. 实现自定义的权限提供者
2. 实现自定义的权限定义存储
3. 实现自定义的授权策略提供者
4. 实现自定义的状态检查器
5. 通过继承和重写默认实现来定制授权行为

所有公共接口和类都添加了详细的 XML 文档注释，便于开发者理解和使用。