How unchartedsecurity/laf works
Main Components
a. Kernel Space Components:
• eBPF Programs (from src/bpf directory)
• Linux Kernel Hooks
• Packet Filter Infrastructure
b. User Space Components:
• Python-based Control Program (src/main.py)
• Configuration Management
• Rule Engine
• User Interface Layer
┌─────────────────────────────────────────┐
• User Space │
• ┌──────────┐ ┌──────────────┐ │
• Python │ │ Configuration│ │
• Control │◄─────► │ Management │ │
• Program │ └──────────────┘ │
• ┬─────┘ │
• ┼────────────────────────────────┘
• ▼
┌─────────────────────────────────────────┐
• Kernel Space │
• ┌──────────┐ ┌──────────────┐ │
• eBPF │◄─────► │ Kernel │ │
• Programs │ │ Hooks │ │
• ┘ └──────────────┘ │
• ┘
Key Elements to Highlight
a. Communication Flows:
• Bidirectional communication between user space and kernel space
• Packet inspection points
• Configuration data flow
• Rule application paths
b. Security Boundaries:
• User space/kernel space boundary
• Privileged operations
• Security policy enforcement points
Technical Details
• eBPF program loading paths
• Hook points in the kernel
• Configuration file locations
• Policy enforcement mechanisms
• Logging and monitoring paths
Implementation Notes
• Maintain consistent spacing and alignment
• Use standard networking and security symbols where applicable
• Brief annotations for complex interactions
Security boundaries and enforcement points
Remember to:
• Security-critical paths
• Both normal operation and error handling paths
• Monitoring and logging components
• How the firewall integrates with the Linux kernel
• The flow of packet filtering decisions
• Configuration and policy management
• Security boundaries and trust zones