#access-control #blockchain #wasm #rate-limiting #user-token #cache #rust

spawn-access-control

A Rust library for access control management with WebAssembly support, including role-based access control (RBAC), permissions, and audit logging

9 releases

0.1.10 Sep 11, 2024
0.1.9 Sep 8, 2024

#6 in #user-token

Download history 128/week @ 2024-08-31 489/week @ 2024-09-07 45/week @ 2024-09-14 2/week @ 2024-09-21 170/week @ 2024-09-28 1/week @ 2024-10-05 4/week @ 2024-10-12

175 downloads per month

MIT license

20KB
389 lines

Spawn Access Control Library

A comprehensive and extensible Access Control Management System written in Rust, supporting WebAssembly for cross-platform compatibility. This library provides advanced features such as role-based access control (RBAC), resource-based permissions, audit logging, session management, rate limiting, and more.

Features

  • Role-Based Access Control (RBAC): Assign roles to users and create role hierarchies.
  • Permission Management: Grant users permissions on specific resources with condition-based access control.
  • Resource-Based Access Control: Manage resources and define which roles have access.
  • Audit Logging: Track every access attempt with detailed logs including timestamps and IP addresses.
  • Session Management: Handle user sessions with expiration and multi-session support.
  • Rate Limiting: Prevent abuse by limiting the number of requests a user can make within a time window.
  • Multi-Factor Authentication (MFA): Add an additional layer of security by verifying users through a token system.
  • Caching: Improve performance by caching user access permissions.
  • WebAssembly Support: Compile to WebAssembly for cross-platform compatibility.

Getting Started

To use this library in your Rust project, add the following to your Cargo.toml:

[dependencies]
spawn-access-control = "0.1.10"

Example Usage

  1. Create a Role-Based Access Control System:
use spawn_access_control::{Role, AccessManager, Resource};

fn main() {
    let mut access_manager = AccessManager::new();
    
    // Define roles
    let admin_role = Role::new("admin", None);
    let user_role = Role::new("user", None);

    // Define a resource
    let resource = Resource::new("file.txt", vec!["admin".to_string()]);

    // Add a user and assign a role
    access_manager.add_user("alice", admin_role.clone());

    // Check if the user has access to the resource
    if access_manager.check_access("alice", &resource) {
        println!("Access granted!");
    } else {
        println!("Access denied!");
    }
}
  1. Use Permission-Based Access Control:
use spawn_access_control::{Permission, AccessManager, Resource};

fn main() {
    let read_permission = Permission { name: "read".to_string(), resource: "file.txt".to_string(), condition: None };
    let write_permission = Permission { name: "write".to_string(), resource: "file.txt".to_string(), condition: None };

    // Use AccessManager to assign roles with permissions
    // Example: Define specific permissions for users based on actions
}
  1. Rate Limiting:
use spawn_access_control::RateLimiter;

fn main() {
    let mut rate_limiter = RateLimiter::new(5, 60); // 5 requests per minute

    for _ in 0..5 {
        if rate_limiter.is_within_limit() {
            println!("Request allowed");
        } else {
            println!("Rate limit exceeded");
        }
    }
}

WebAssembly Support

To compile this library to WebAssembly, use the following command:

wasm-pack build

Dependencies

~0.4–10MB
~108K SLoC