Rastreio
Todos os pedidos que uma máquina faz (uma máquina é um espaço de trabalho, no editor de definições) — o tráfego do agente para fornecedores de modelos, descarregamentos de pacotes, chamadas à sua infraestrutura — passam pelo proxy do Bromure no Mac. O painel Rastreio define quanto desse tráfego é registado para esta máquina, de nada até aos corpos completos dos pedidos e das respostas. Tudo o que é registado fica no seu Mac, cifrado, e pode ser percorrido no Inspetor de rastreio ou com bromure-cli trace.
O nível de rastreio diz respeito apenas ao tráfego registado. A Linha do tempo de segurança — o que os motores de segurança bloquearam, permitiram, substituíram ou assinalaram — é sempre registada, qualquer que seja o valor aqui. Ver Visão geral e linha do tempo de segurança.
Traço da sessão
| Nível | O que é registado |
|---|---|
| Desativado | Nada. |
| Só atividade | Um registo de metadados por pedido: hora, anfitrião, método, caminho, estado, tamanhos, latência, o relatório de substituição de tokens e os avisos de fuga de credenciais. Sem corpos. |
| Detalhes dos pedidos de IA | Tudo o que há em Só atividade, mais os corpos completos dos pedidos e das respostas para anfitriões de fornecedores de modelos conhecidos (Anthropic, OpenAI, Google, Cohere, Mistral, Perplexity, x.ai, Groq, Replicate, HuggingFace). |
| Tudo | Corpos para todos os anfitriões. É o que enche o disco mais depressa. |
As máquinas novas registam em Detalhes dos pedidos de IA (vindo do modelo Predefinições), para que as conversas do agente possam ser auditadas desde o início. O nível muda numa máquina em execução assim que grava.
Dica: Só atividade dá-lhe o rasto de auditoria — que anfitriões foram contactados, se houve credenciais substituídas ou fugidas — sem guardar prompts e respostas no disco.
Como os rastreios são guardados
Os metadados vão para ~/Library/Application Support/BromureAC/traces/AAAA-MM-DD/<sessionID>.jsonl, uma linha JSON por pedido. Os corpos ficam ao lado, numa pasta por sessão, cifrados com a mesma chave guardada no Porta-chaves que protege os segredos das máquinas.
Antes de se escrever qualquer coisa, os cabeçalhos sensíveis (Authorization, Proxy-Authorization, Cookie, Set-Cookie, x-amz-security-token, api-key, e qualquer cabeçalho que acabe em -api-key) são substituídos por <redacted>, e as substituições e as suspeitas de fuga são registadas apenas como pré-visualizações dos primeiros e últimos caracteres — segredos reais nunca entram num rastreio.
Os corpos estão limitados a 100 MB por sessão (os mais antigos saem primeiro; os metadados ficam) e a pasta de rastreios a 5 GB (os dias mais antigos saem primeiro).
Aviso: em Detalhes dos pedidos de IA e em Tudo, o texto completo das trocas de IA está no disco — cifrado, mas presente.
Modo privado
O interruptor Modo privado aparece apenas em Macs inscritos numa organização bromure.io. Quando está ligado, as sessões desta máquina deixam de enviar os metadados de sessão (ferramentas, ficheiros, comandos, consumo de tokens) à sua organização — «nem o indicador da barra de título nem a lista de sessões do administrador verão nada deste espaço de trabalho». O rastreio local não é afetado. Num Mac que não está inscrito o interruptor está oculto, já que nada é enviado. Predefinição: desligado. Ver Empresa — Inscrição e frota.
Substituição de tokens de subscrição
Quando corre um agente com sessão iniciada através de uma subscrição, o proxy pode manter os verdadeiros tokens de início de sessão do Claude ou do Codex no Mac e dar substitutos à VM — a mesma substituição usada para as chaves de API. Depois de lhe ter perguntado uma vez para esta máquina, o painel mostra uma linha por fornecedor:
- Substituição do token de subscrição do Claude
- Substituição do token de subscrição do Codex
Cada uma diz Ativa («O proxy está a manter os verdadeiros tokens OAuth neste Mac e a servir falsos dentro da VM.») ou Recusada, com Esquecer substituição (perguntar outra vez na próxima sessão) ou Reativar a pergunta para a reiniciar; o proxy volta então a perguntar. As linhas ficam ocultas até o proxy ter perguntado.
Ver o que foi registado
- Inspetor de rastreio — Janela › Inspetor de rastreio… (⇧⌘I), ou Inspecionar rastreio no menu de máquinas. Uma lista viva e filtrável das trocas registadas, com insígnias de substituição e de fuga; as trocas de IA capturadas aparecem como uma conversa.
- Linha de comandos — com a aplicação a correr,
bromure-cli trace ls,trace summary,trace hostnames,trace leaksetrace clear.
Ambos são tratados em Rastreio e Auditoria.
Histórico de segurança (só nas Preferências)
Em Preferências › Rastreamento (as Preferências deste Mac, não as definições de uma máquina nem as de um Mac remoto), Security history define como a janela Segurança guarda e mostra os seus eventos:
- Keep events for — 7 days, 30 days, 90 days (predefinição), 180 days, 1 year ou Forever. «Events older than this are deleted from this Mac.» Uma alteração aplica-se de imediato.
- Security window opens on — Last hour, Últimas 24 horas (predefinição), Last 7 days, Last 30 days ou All history. A Visão geral conta esse período, e a Linha do tempo abre nele.
Referência de definições
| Definição | Tipo | Predefinição |
|---|---|---|
| Traço da sessão | Desativado / Só atividade / Detalhes dos pedidos de IA / Tudo | Detalhes dos pedidos de IA para máquinas novas |
| Modo privado | Interruptor (só em Macs inscritos) | Desligado |
| Substituição do token de subscrição do Claude | Estado e reinício (depois da primeira pergunta) | Oculta |
| Substituição do token de subscrição do Codex | Estado e reinício (depois da primeira pergunta) | Oculta |
| Keep events for (Preferências) | 7 days … Forever | 90 dias |
| Security window opens on (Preferências) | Last hour … All history | Últimas 24 horas |
Capítulos relacionados
- Rastreio e Auditoria — o Inspetor de rastreio, os níveis e a CLI de rastreio.
- Visão geral e linha do tempo de segurança — o registo sempre ativo das decisões de segurança.
- Referência de Definições — todos os painéis num relance.