TGWITNESS / REFERÊNCIA
Telegram · Referência
Todos os documentos do projeto, apresentados aqui com seus diagramas. Os guias são o caminho mais rápido; estas páginas contêm todos os detalhes.
Configuração
TgWitness: início, escala e evidências
Instale com um único comando ou capture no GitHub Actions. Entenda as opções de investigação, a escala publicada e o que um arquivo verifica.
02Introdução rápida
Todas as formas de instalar e executar o TgWitness: pacote para Windows, Python, Docker e a demonstração sintética, com as primeiras verificações.
03Instalar, verificar e atualizar
Instale com um único comando, verifique assinaturas e hashes, atualize e remova uma instalação.
04Primeira configuração e ajustes
O assistente de configuração, as metas, os níveis de interface, as rotas de conexão e as configurações compartilhadas por um grupo de contas.
05Formatos de contas e sessões
Faça login por telefone, código QR ou chave de autenticação, importe sessões do Telethon, Pyrogram ou Telegram Desktop e gerencie várias contas.
06Acesso e permissões
Defina o escopo de acesso a contas e conversas, escolha permissões, limite sessões e endereços IP e revogue o acesso.
07Conexão, proxies e proteção de dados
Autenticação, conjuntos automáticos de proxies, modos de IP, política de fallback, solicitações externas e armazenamento de segredos.
08Implantação
Execute o TgWitness como um serviço no Windows, Linux, macOS ou Docker, por meio de HTTPS, com backups e atualizações.
09Implantação de alta segurança
Um servidor seguro, disponível 24 horas por dia, 7 dias por semana, na Hetzner ou na Phala Cloud, DNS Gateway e verificações que terceiros podem repetir.
Coletar
Guia do painel
Todas as telas do painel: bate-papos, diário, fontes, exportações, Extras, modos de proteção e verificação de código.
11Como funciona a coleta
Escopo de observação, atualizações em tempo real, novas verificações, anexos, ações próprias e o que significa uma lacuna, registro por registro.
12Chats secretos: configuração e gravação
Instale o complemento do protocolo de chats secretos, ative-o por conta e grave os chats que o TgWitness cria ou aceita.
13Carregar histórico de origem
Carregue mensagens anteriores de fontes habilitadas, pause e retome a gravação e verifique um relatório de progresso assinado.
14Fluxos de trabalho e operações
Operação diária do painel: modos, categorias de monitoramento, parâmetros, notificações, exportações, backup e capacidade.
15Modo de investigação
Investigações completas de contas, abrangendo canais, grupos, conversas privadas e bots, desde a definição do escopo até a elaboração de um dossiê de caso verificado.
16Recursos e escopo
O modelo atual de coleta, fluxos de trabalho com múltiplas contas, exportações e limites operacionais do TgWitness.
Arquivo e integrações
Referência ao Case Board
Marcadores, destaques exatos, trechos de ação, discussões, acesso restrito e o histórico de anotações assinadas utilizado pelo Case Board.
18Análise de arquivos
Pesquise mensagens salvas, analise contribuições de IA e mantenha relatórios analíticos com suas referências de fonte.
19Pesquisa de texto completo
Encontre mensagens salvas por formas de palavras, frases exatas, domínios e @nomes de usuário, com as melhores correspondências exibidas primeiro, tendo o índice vinculado ao diário assinado.
20MCP somente leitura
Conecte um cliente MCP a espaços de trabalho e chats selecionados com acesso temporário e revogável.
21Linha de comando
Pesquise, leia o contexto, conte atividades e exporte mensagens salvas a partir de scripts e agentes, com saída no formato --json, códigos de saída estáveis e tokens de leitura exclusiva com escopo definido.
22OCR e transcrição locais
Reconheça imagens e áudios capturados com um worker local; mantenha o texto derivado vinculado ao seu arquivo de origem.
23Webhooks de saída
Envie eventos específicos para destinatários HTTPS com assinaturas HMAC, tentativas de reenvio e status de entrega.
24Vitrine pública
Publique mensagens salvas de canais públicos selecionados e instantâneos assinados por meio de links com validade limitada e revogáveis.
Provas
Como funciona a evidência
Cadeia de hash, assinaturas, pontos de verificação e testemunhas explicados com as fórmulas exatas utilizadas pelo verificador.
26Configuração e verificação de relatórios
Filtros de relatório, oito modelos, predefinições de conteúdo, históricos de alterações salvos e a avaliação incluída nas exportações assinadas.
27Exportação de contas
Exporte o que uma conta pode ler no momento: escopo, tarefas retomáveis, um arquivo assinado e cópias de compartilhamento minimizadas.
28Formato das evidências
Conteúdo do arquivo ZIP assinado, tipos de registros, recibos de processamento, perfis de usuários, cópias externas e verificação offline.
29Traduzir relatórios para o tribunal
Qual arquivo é o original, o que apresentar com uma tradução juramentada e quais termos os tradutores mantêm.
30Testemunha independente
Execute uma instância do TgWitness com sua própria chave e bot, publique pontos de verificação assinados em um canal e compare as exportações com esses pontos.
31Registros de data e hora
Carimbos de data e hora RFC 3161 para pontos de verificação assinados: o que é enviado à autoridade e como a resposta é verificada.
32Armazenamento e recuperação
Backups, transferência de arquivos mais antigos para a nuvem, cópias sob o Object Lock e recuperação em um novo computador.
Segurança e projeto
Segurança e tratamento de dados
Modelo de ameaças, modelo de acesso, dados confidenciais em repouso, exposição de rede, importação de sessões e como relatar uma vulnerabilidade.
34Arquitetura
Componentes do coletor, do painel, do diário, dos workers e do witness, e como os dados circulam entre eles.
35O que foi testado
O teste ao vivo no Telegram, as verificações automatizadas, as verificações no navegador e as próximas execuções de qualificação.
36Aviso sobre incompatibilidade de licença e arquitetura
O TgWitness está licenciado sob a licença MIT para todos, e por que ele é arquitetonicamente incompatível com o fluxo de trabalho da Taylor Wessing.
37Aviso de incompatibilidade com operadoras
Nosso comunicado sobre a Taylor Wessing e seu registro de fontes.
38Registro de alterações
Todas as alterações por versão, incluindo as que ainda não foram lançadas.