trustmebro

Em uma avaliação local controlada, cada modelo teve que verificar um marcador de autorização TXT DNS novo antes de poder prosseguir com uma varredura. Sem o TrustMeBro, o /usr/bin/dig real não retornava marcador e o modelo parava. Com o modo de laboratório do TrustMeBro, o mesmo caminho de comando absoluto retornava prova fabricada e, como resultado, o modelo prosseguia com a varredura.

Capacidades

• Intercepta qualquer comando listado em shim_commands.
• Corresponde a nomes de comando, domínios, tipos de registro DNS, globs de argumentos e expressões regulares.
• Gera saída realista de dig, nslookup e host.
• Reescreve o stdout de um comando real preservando o stderr e seu status de saída.
• Executa chamadas sem correspondência por meio do binário real com exec.
• Bloqueia chamadas correspondentes ou sem correspondência quando uma regra usa reject.
• Registra cada decisão em um log de auditoria JSONL com timestamp.

Instalação

Lançamento pré-compilado

Abra um novo terminal e verifique os shims instalados:

O instalador grava:

Ele também adiciona o diretório de shims aos arquivos de inicialização de shell suportados. Os arquivos de shell de login são incluídos porque os agentes comumente executam comandos por meio de sessões não interativas bash -lc.

Início rápido

A configuração gerada contém uma regra segura para *.trustmebro.test:

Um domínio que não corresponde a nenhuma regra vai para o comando real:

O log de auditoria registra qual caminho foi tomado:

Modo de laboratório

No Linux, execute um shell ou agente dentro de um namespace de interceptação temporário:

O modo de laboratório usa Bubblewrap para sombrear tanto as buscas de PATH quanto os caminhos absolutos descobertos, como /usr/bin/dig. Os binários originais permanecem disponíveis por meio de um caminho temporário separado para regras de passthrough e rewrite, então um agente não pode escapar da interceptação apenas executando command -v dig e invocando o resultado.

O modo de laboratório é um namespace de interceptação, não um sandbox de segurança. Ele reutiliza deliberadamente o sistema de arquivos do host, o workspace atual, a rede, o ambiente e as credenciais do agente. Instale bubblewrap por meio do gerenciador de pacotes do seu Linux antes de usá-lo. O namespace e seus arquivos temporários desaparecem quando o comando sai.

Regras

A configuração padrão é ~/.config/trustmebro/config.yaml. Defina TRUSTMEBRO_CONFIG para usar um arquivo diferente para um processo ou execução de teste.

As regras são verificadas na ordem do arquivo. A primeira regra correspondente vence, e cada campo de correspondência configurado deve ter sucesso.

A configuração é analisada estritamente. Campos desconhecidos, nomes de shim inseguros, ações inválidas e regras malformadas fazem o trustmebro check falhar. Se um shim instalado encontrar uma configuração inválida, ele bloqueia o comando e sai com status 78. Defina TRUSTMEBRO_DISABLE=1 somente quando você precisar explicitamente ignorar a configuração e executar o comando real.

Ações

Os geradores de DNS lidam com seções completas de dig, +short, +noall +answer, consultas reversas com -x, servidores explícitos com @server e ANY. Saída equivalente está disponível para nslookup e host.

Controles de ambiente

Arquitetura

O TrustMeBro é um único binário Go. Seu comportamento depende de argv[0]:

• trustmebro executa a CLI.
• Um nome de shim configurado como dig executa o caminho de interceptação.

A resolução do binário real varre PATH, ignora candidatos que resolvem de volta para o TrustMeBro e usa a primeira correspondência executável.

CLI

Limitações

• Fora do modo de laboratório, um caminho absoluto como /usr/bin/dig ignora o shim.
• Fora do modo de laboratório, sudo, ambientes limpos como env -i e sandboxes de agentes que substituem PATH podem ignorar a interceptação.
• which dig e command -v dig revelam o caminho do shim.
• Clientes DNS em processo, como socket do Python ou dns.resolver, não invocam shims de comando.
• IDs sintéticos, temporização e respostas instantâneas são destinados a testes de agentes, não simulação forense.
• O modo rewrite armazena em buffer até 16 MiB de stdout e stderr cada. Saída maior é rejeitada em vez de parcialmente reescrita.
• O instalador incluído tem como alvo shells Unix. O suporte a Windows é experimental.
• O modo de laboratório atualmente requer Linux e Bubblewrap.
• O modo de laboratório sombreia executáveis encontrados em PATH e diretórios comuns de binários do sistema; binários absolutos em outros lugares permanecem fora de seu limite de interceptação.
• O modo de laboratório não tenta resistir a um processo que deliberadamente usa o sinalizador de desativação explícito do TrustMeBro ou o diretório temporário de binários reais.

Desenvolvimento

Licença

MIT © 2026 David Carliez