PouryaKit.Security 0.1.0-preview.2

PouryaKit.Security

Permissions on commands and queries, and PBKDF2 password hashing. You put [RequiresPermission] on a command or query, and the pipeline's authorization step asks your application's IActorPermissions before validation and the handler run. An Actor without the permission gets an Error and nothing commits. The Kit issues no token and has no role system, policy framework or identity store.

Install

dotnet add package PouryaKit.Security --prerelease

When to use it

• A command or query may run only for Actors that hold a permission.
• You supply the permissions an Actor holds, from claims or your own store.
• You decide what a continuation or a system Actor may run.
• Your application stores its own passwords and needs to hash, verify and upgrade them.

It plugs into the pipeline of PouryaKit.Cqrs. PouryaKit.Security.JwtBearer turns bearer tokens into the Actor and, where the token carries one, the tenant.

Quick start

Declare the permission on the record, as the Proving Sample does:

[RequiresPermission(RemoveProductsCommand.Permission)]
internal sealed record RemoveProductsCommand(IReadOnlyList<string> Names)
    : Command<int>,
        IInvalidatesCache
{
    public const string Permission = "catalog.products.remove";

    public IReadOnlyCollection<string> InvalidatedCacheTags => [GetProductQuery.ProductsTag];
}

Register the check in the Composition Root and your source of permissions in the Host:

module.AddPouryaKitPermissions();
builder.Services.AddScoped<IActorPermissions, CallerPermissions>();

Say which permissions an Actor holds:

public sealed class CallerPermissions(IHttpContextAccessor http, IOptions<PouryaKitWebOptions> web)
    : IActorPermissions
{
    public const string ClaimType = "permission";

    public Task<bool> HasPermissionAsync(
        OperationContext context,
        string permission,
        CancellationToken cancellationToken
    )
    {
        ArgumentNullException.ThrowIfNull(context);
        var caller = http.HttpContext?.User;
        return Task.FromResult(
            caller?.Identity?.IsAuthenticated == true
                && context.Actor.Kind == ActorKind.Person
                && caller.FindFirstValue(web.Value.ActorClaim) == context.Actor.Id
                && caller.HasClaim(ClaimType, permission)
        );
    }
}

What you get

• One declared rule, checked in one place in the pipeline, before validation and the handler.
• A denial that is an Error, with nothing committed.
• A trusted continuation that is not asked again, such as a delivery the Kit restored.
• Password hashes that say how they were made, so a hasher can upgrade them.

Learn more

• Security
• Secure an Operation
• Continuations
• Password hashing