Início > Projetos > SysCallCage
SysCallCage
Contenção Determinística no Kernel · BPF LSM Open Source
Tecnologias: Rust, Linux Kernel, BPF LSM, Kernel Customizado WSL2, Contenção de IA, Open Source
O Problema Operacional & Desafio
Permitir que agentes autônomos de inteligência artificial (como Claude Code, Cursor, Aider ou robôs de automação) executem comandos e scripts diretamente no computador é extremamente produtivo, mas cria um risco de segurança real: o modelo pode ler segredos em arquivos .env, chaves privadas SSH ou conectar-se a servidores externos não autorizados ao cumprir uma instrução literal demais.
As soluções tradicionais forçam o isolamento do agente dentro de contêineres ou máquinas virtuais pesadas. Embora funcione, essa abordagem é lenta, difícil de configurar e rompe a agilidade de trabalhar diretamente na árvore de arquivos do projeto real.
O SysCallCage inverte esse modelo: ele não isola o agente em uma jaula virtual pesada. O agente trabalha livremente nos seus arquivos locais, enquanto o kernel do Linux monitora e aplica regras inegociáveis no nível mais fundamental do sistema operacional, bloqueando qualquer desvio de forma síncrona antes que o comando proibido aconteça.
Arquitetura & Engenharia Técnica
1. Documentação Técnica & Produto Open Source
O SysCallCage é um software open source distribuído sob a licença Mozilla Public License 2.0 (MPL 2.0). Ele foi projetado para desenvolvedores e empresas que desejam autonomia para seus agentes de inteligência artificial com controle total sobre o que pode ser acessado.
2. Validação e Compilação de Kernel Customizado para WSL2
Um dos pontos mais marcantes da engenharia do SysCallCage foi viabilizar seu funcionamento determinístico dentro do Windows via WSL2:
- O Desafio do Kernel Padrão: Por padrão, a imagem de kernel do WSL2 distribuída pela Microsoft vem com os ganchos de segurança
BPF_LSMdesabilitados na compilação, impedindo a contenção preventiva síncrona. - Compilação do Kernel a partir da Fonte Oficial: Clonei a árvore oficial da Microsoft (
WSL2-Linux-Kernel), reconfigurou o arquivo de configuração comCONFIG_BPF_LSM=y,CONFIG_SECURITY_BPF=yeCONFIG_DEBUG_INFO_BTF=y, e compilei uma imagem de kernel Linux customizada e totalmente reprodutível. - Superação de Bug no Verifier do Kernel: Durante os testes de validação, foi identificado e solucionado um bug real no verifier do kernel Linux relacionado à inspeção de estruturas de ponteiros aninhados em programas BPF LSM, garantindo estabilidade e permitindo que o SysCallCage funcione com segurança comprovada no Windows.
3. Como Funciona a Contenção em Ring 0
Construído em Rust com programas compilados diretamente em BPF LSM (Linux Security Module):
- Política Declarativa em YAML: O usuário define em poucas linhas quais diretórios o agente tem permissão para ler ou escrever, quais arquivos são estritamente vetados (ex:
/.env,/.ssh/,/*.pem) e quais domínios externos podem ser contactados. - Interceptação Síncrona Preventiva: A cada chamada de sistema relevante (
openat,execve,connect), o programa BPF no kernel avalia a solicitação em nanossegundos. Se houver tentativa de acesso a um arquivo proibido, o kernel aborta a operação imediatamente com-EACCESou encerra o processo infrator comkill. - Zero Overhead de Processamento: Como a verificação reside dentro do próprio kernel via tabelas BPF em memória, não há trocas de contexto lentas com o espaço de usuário e nenhuma perda de desempenho na execução do código.
4. Modo Watch Supervisionado
Através do comando syscallcage watch --policy politica.yaml -- claude-code, o SysCallCage cria o processo do agente a partir do nascimento (fork + execve), eliminando a necessidade de descobrir o PID manualmente. Em conformidade com a flag de sistema PR_SET_PDEATHSIG, caso o supervisor seja encerrado, o agente protegido recebe SIGTERM imediatamente: o estado 'parado' é sempre preferível a 'rodando desprotegido'.
5. Geração de Políticas por Aprendizado de Sessão
Para projetos pré-existentes, o comando generate-policy permite rodar o agente em modo de observação e sintetizar automaticamente o arquivo YAML ideal com base nos arquivos que ele realmente precisou acessar, mantendo credenciais e chaves críticas fora da lista permitida por padrão.
Outros Projetos Desenvolvidos
-
Imunno System
Sistema imunológico autônomo para servidores Linux que opera no anel mais profundo do sistema operacional (Ring 0), interceptando invasões e ameaças em tempo real com matriz de decepção ativa Hades, protocolo Gossip em malha P2P e código genético evolutivo.
Ver documentação técnica → -
GreenToken
Medidor de eficiência energética e FinOps para clusters de IA. Calcula o custo real em Watts, Joules e dólares por token gerado através de instrumentação no silício (RAPL, NVML e eBPF). Pesquisa científica com dados brutos e artigo publicados no Zenodo.
Ver documentação técnica → -
Kernel WSL2 BPF Plus
Kernel Linux customizado para Windows (WSL2) compilado da árvore oficial da Microsoft com suporte completo a BPF LSM, CONFIG_SECURITY_BPF e interfaces BTF, viabilizando segurança determinística em Ring 0 e validação de ferramentas de IA no Windows.
Ver documentação técnica →
Sistemas e Engenharia para a sua Empresa
Desenvolvo sistemas sob medida com garantia de estabilidade, segurança e suporte técnico direto para empresas em Porto Velho, RO.