Rodrigo Freire Tech

Início > Projetos > SysCallCage

SysCallCage

Contenção Determinística no Kernel · BPF LSM Open Source

Jaula de segurança preventiva em Ring 0 para agentes autônomos de IA e processos locais. Intercepta chamadas de sistema no kernel Linux impedindo vazamento de credenciais (.env, chaves SSH) e conexões de rede não autorizadas com zero overhead.

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_LSM desabilitados 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 com CONFIG_BPF_LSM=y, CONFIG_SECURITY_BPF=y e CONFIG_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):

  1. 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.
  2. 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 -EACCES ou encerra o processo infrator com kill.
  3. 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.

Solicitar avaliação da operação da sua empresa →