Skip to content

BlackRoad-Security/blackroad-access-control

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

ulackroad access control

Part of BlackRoad OS — Sovereign Computing for Everyone

BlackRoad OS BlackRoad Security License

ulackroad access control is part of the BlackRoad OS ecosystem — a sovereign, distributed operating system built on edge computing, local AI, and mesh networking by BlackRoad OS, Inc.

About BlackRoad OS

BlackRoad OS is a sovereign computing platform that runs AI locally on your own hardware. No cloud dependencies. No API keys. No surveillance. Built by BlackRoad OS, Inc., a Delaware C-Corp founded in 2025.

Key Features

  • Local AI — Run LLMs on Raspberry Pi, Hailo-8, and commodity hardware
  • Mesh Networking — WireGuard VPN, NATS pub/sub, peer-to-peer communication
  • Edge Computing — 52 TOPS of AI acceleration across a Pi fleet
  • Self-Hosted Everything — Git, DNS, storage, CI/CD, chat — all sovereign
  • Zero Cloud Dependencies — Your data stays on your hardware

The BlackRoad Ecosystem

Organization Focus
BlackRoad OS Core platform and applications
BlackRoad OS, Inc. Corporate and enterprise
BlackRoad AI Artificial intelligence and ML
BlackRoad Hardware Edge hardware and IoT
BlackRoad Security Cybersecurity and auditing
BlackRoad Quantum Quantum computing research
BlackRoad Agents Autonomous AI agents
BlackRoad Network Mesh and distributed networking
BlackRoad Education Learning and tutoring platforms
BlackRoad Labs Research and experiments
BlackRoad Cloud Self-hosted cloud infrastructure
BlackRoad Forge Developer tools and utilities

Links


BlackRoad Security - ublackroad access control

Part of the BlackRoad OS ecosystem — BlackRoad-Security


blackroad-access-control

Production RBAC (Role-Based Access Control) engine with SQLite persistence and full audit logging.

Features

  • 🔐 RBAC Engine – Roles, permissions, wildcard * resources/actions
  • 📦 Role Inheritance – Hierarchical roles with permission resolution
  • 🕐 Expiring Assignments – Time-limited role grants
  • 📝 Audit Log – Every access decision logged with subject/resource/action/result
  • 💾 SQLite Persistence – Zero-dependency storage

Built-in Roles

Role Permissions
admin *:* (all resources, all actions)
viewer *:read
editor *:read, *:write

Usage

# Check permission
python src/access_control.py check alice documents read

# Assign role
python src/access_control.py assign-role alice editor

# Create custom role
python src/access_control.py add-role deployer --description "Deploy access"

# Add permission to role
python src/access_control.py add-permission deployer deployment execute

# Effective permissions
python src/access_control.py effective alice

# Audit log
python src/access_control.py audit --subject alice

Schema

  • roles – role definitions with optional parent
  • permissions – resource:action grants per role
  • assignments – subject → role mappings (with expiry)
  • audit_log – timestamped access decisions

Tests

pytest tests/ -v --cov=src

License

Proprietary – BlackRoad OS, Inc. All rights reserved.

About

blackroad access control — Part of the BlackRoad OS ecosystem. Sovereign computing, edge AI, mesh networking. blackroad.io

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors