TgWitness / Documentação

O que foi testado →

Referência / Coletar

Telegram · Modo 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.

TgWitness / Documentação

Investigação

Acompanhe um caso em canais, grupos, conversas privadas e bots, desde a aquisição inicial até uma linha do tempo referenciada e uma transferência verificável. A versão interativa do site está disponível em /docs/cases/; instruções para visualização prévia.

Nesta página

Caso prático: uma mudança de destino ao longo de quatro conversas#

Um anúncio indica um bot. Um grupo de operações discute um novo destino de pagamento, e o teclado do bot o exibe. O anúncio é editado, uma mensagem privada de acompanhamento repete o destino, e uma mensagem de grupo desaparece.

As perguntas são: o que foi observado antes e depois da alteração, quais contas do Telegram publicaram cada item, onde o destino apareceu, quais bytes do anexo foram preservados e quais intervalos permanecem desconhecidos?

Todos os nomes, IDs, horários e referências do registro neste exemplo são fictícios. O fluxo de trabalho utiliza recursos atuais; o mapa do caso é uma ilustração, não um gráfico automático gerado pelo aplicativo.

Diagrama de fluxoCanais → Diário do espaço de trabalho; Grupos → Diário do espaço de trabalho; Conversas privadas → Diário do espaço de trabalho; Bots → Diário do espaço de trabalho; Diário do espaço de trabalho → Pesquisar todas as fontes; Diário do espaço de trabalho → Perfis de pessoas com referências aos registros; Diário do espaço de trabalho → Versões salvas e recibos de anexos; Pesquisar todas as fontes → Linha do tempo do analista e registro de fontes; Perfis de pessoas com referências aos registros → Linha do tempo do analista e registro de fontes; Versões salvas e recibos de anexos → Linha do tempo do analista e registro de fontes; Diário do espaço de trabalho → Arquivo ZIP de evidências assinadas; Linha do tempo do analista e registro de fontes → Transferência de casos com artefatos verificados separadamente; Arquivo ZIP de evidências assinadas → Transferência de casos com artefatos verificados separadamenteCanaisGruposConversas privadasBotsDiário do espaço detrabalhoPesquisar todas as fontesPerfis de pessoas comreferências aos registrosVersões salvas e recibosde anexosArquivo ZIP de evidênciasassinadasLinha do tempo do analistae registro de fontesTransferência de casos comartefatos verificadosseparadamente
Diagrama em formato de texto
  1. Canais → Diário do espaço de trabalho
  2. Grupos → Diário do espaço de trabalho
  3. Conversas privadas → Diário do espaço de trabalho
  4. Bots → Diário do espaço de trabalho
  5. Diário do espaço de trabalho → Pesquisar todas as fontes
  6. Diário do espaço de trabalho → Perfis de pessoas com referências aos registros
  7. Diário do espaço de trabalho → Versões salvas e recibos de anexos
  8. Pesquisar todas as fontes → Linha do tempo do analista e registro de fontes
  9. Perfis de pessoas com referências aos registros → Linha do tempo do analista e registro de fontes
  10. Versões salvas e recibos de anexos → Linha do tempo do analista e registro de fontes
  11. Diário do espaço de trabalho → Arquivo ZIP de evidências assinadas
  12. Linha do tempo do analista e registro de fontes → Transferência de casos com artefatos verificados separadamente
  13. Arquivo ZIP de evidências assinadas → Transferência de casos com artefatos verificados separadamente

1. Defina o caso e reúna todo o relato#

  1. Conecte a conta de coleta em seu próprio espaço de trabalho. No Case Board ou em seu registro de casos, registre a referência do caso, o ID da conta, o espaço de trabalho e o início da observação. Mantenha a impressão digital da chave de assinatura confiável de forma independente.
  2. Para uma conta de coleta dedicada, abra Mais ferramentas → Fontes → Escopo → Modo de investigação. A predefinição seleciona Conta inteira, canais/grupos/conversas privadas/bots, ações próprias, perfis de fonte e as últimas 200 mensagens visíveis para fontes recém-descobertas. Revise-a, pressione Salvar escopo e conclua a confirmação do escopo. Contas principais usam conversas selecionadas ou uma pasta; a coleta de toda a conta está disponível para contas marcadas para investigação.
  3. Carregue as conversas e compare as fontes com a lista de diálogos da conta. Verifique as exclusões. Mais ferramentas → Parâmetros → O número padrão de conversas lidas da lista da conta é 1,000 e permite até 20,000. Fontes além do limite da lista são adicionadas quando se tornam ativas. Registre o que foi efetivamente enumerado.
  4. Em Mais ferramentas → Fontes → Gravação, selecione Todas as atividades visíveis e salve as configurações de monitoramento. Verifique os tipos/limites de anexos e o espaço livre em disco.
  5. Inicie a observação. Valide uma nova mensagem controlada, uma edição e uma exclusão e, em seguida, registre as referências do teste e quaisquer falhas.

O escopo de conta inteira registra atividades visíveis à conta dentro das configurações salvas, nos chats dos quais a conta participou. Os Chats Secretos são registrados pelo módulo de Chat Secreto, e as conversas existentes são preenchidas retroativamente por meio do Histórico. Consulte o escopo de coleta.

2. Inventariar todas as fontes e obter o contexto histórico#

Mantenha um registro de fontes com uma linha por conversa:

Campo Registrar
Identidade Espaço de trabalho, ID da conta, ID numérico do chat, título e tipo
Visibilidade Afiliação/função, acesso confirmado ou não confirmado, exclusões
Captura em tempo real Data de início, tipos de eventos selecionados e alterações posteriores na política
Histórico do registro Instantâneo solicitado/concluído, limite, tempo e referências de registro
Histórico completo Nome do arquivo de exportação assinado por conversa, limites e conclusão/falha
Anexos Recibos de mídia concluídos, hashes, tamanhos e resultados ignorados/com falha
Cobertura Interrupções de serviço, captação incompleta, FloodWait, mensagens indisponíveis e outras lacunas

Utilize o método de aquisição adequado para cada fonte:

  • Carregar o histórico completo em Mais ferramentas → Fontes → Bate-papos no escopo carrega as mensagens anteriores disponíveis das fontes habilitadas no diário da área de trabalho. Suporta pausar/retomar e um relatório de progresso assinado. Consulte aquisição de histórico.
  • O instantâneo do histórico salva as mensagens visíveis recentes no diário de observações. Seu limite máximo padrão é 500; em Mais ferramentas → Parâmetros → Maior instantâneo do histórico, é possível aumentar esse valor para 10,000. Trata-se de observações do histórico atual, não de edições reconstruídas.
  • Exportações → Capturar ou exportar um chat → Exportar chat completo, ou Chats → Exportar chat, busca o histórico atualmente visível de um chat em um pacote separado e assinado chat.json / chat.html. Repita para as fontes do caso e mantenha cada resultado.
  • Quando um novo chat ou bot aparece, é possível salvar seu perfil e até 1.000 mensagens recentes; o modo de investigação seleciona 200. Os chats existentes não recebem essa captura retroativamente quando o modo é ativado.
  • O download de anexos visíveis preserva os bytes de acordo com a política configurada. É necessário um recibo media.saved preenchido com SHA-256 e contagem de bytes. Uma tarefa na fila, uma miniatura ou um nome de arquivo não constituem o anexo preservado.

A exportação completa de um chat não preenche o registro nem os perfis das pessoas com todas as suas mensagens. Use “Carregar histórico completo” ou “instantâneos limitados do registro” para o histórico que você precisa analisar dentro do TgWitness. Verifique a lista de fontes ativadas antes de iniciar uma execução do histórico. Nenhuma das duas opções recupera material que o Telegram não retorna mais.

3. Preservar a evolução do caso e as interações deliberadas#

Marque os chats de casos ativos como fontes prioritárias. Revise os intervalos de verificação, a atualização contínua e os resultados de mídia. Mantenha o coletor em funcionamento enquanto utiliza a conta. Utilize Chats → Perfil → Salvar perfil agora para reter metadados da fonte, tais como descrições e comandos de bot. Isso é distinto dos perfis de pessoas derivados de mensagens salvas.

Quando o caso envolver acompanhar uma fonte ou interagir com um bot:

  1. Abrir link do Telegram → Salvar pré-visualização registra o link fornecido e a pré-visualização exibida antes de uma ação.
  2. A função “Join / open and observe” executa o “join/open” e envia o parâmetro de inicialização de um bot, quando fornecido. Uma solicitação de adesão aguardando aprovação é registrada como pendente.
  3. Respostas de texto emitidas pelo painel e cliques em botões suportados mantêm interaction.requested e interaction.result. Os recibos de retorno de chamada podem manter o texto do pop-up exibido, o estado do alerta e a URL.

Essas são ações reais da conta. Os cliques de retorno em outro aplicativo do Telegram não são visíveis ao coletor, embora as mensagens ou edições resultantes possam ser. O minicliente não executa fluxos de trabalho relacionados a aplicativos web, pagamentos, telefone ou localização. Para obter informações sobre o comportamento exato, consulte as interações do painel.

4. Relacione observações entre conversas#

No “Journal”, selecione “Todas as fontes” e pesquise o conteúdo registrado. Abra os registros correspondentes e anote o espaço de trabalho, o chat, o ID da mensagem, a sequência e o hash do registro.

Em um chat relevante, abra Pessoas → Ativar perfis e examine uma pessoa:

  • Nomes/nomes de usuário observados ao longo do tempo e o ID numérico do Telegram.
  • Relações de resposta com referências aos registros de origem.
  • Também em… outros chats neste diário do espaço de trabalho onde esse ID escreveu.
  • Atividades, edições/exclusões e carteiras, telefones, nomes de usuário e links mencionados.
  • Metadados de avatares salvos e avatares semelhantes armazenados em cache, com suas origens distintas.

Abra os registros citados antes de usar um perfil derivado em uma conclusão. Os perfis abrangem pessoas com mensagens salvas, não todos os membros do grupo. Mais ferramentas → Parâmetros → Registros citados por fato limitam a lista de referências, não a contagem de atividades subjacentes. Menções e semelhança de avatares são pistas; a propriedade e a identidade baseiam-se em IDs numéricos e remetentes atribuídos.

O dossiê assinado separa as dicas do codificador dos arquivos encaminhados e reutilizados em clients.forwarded e clients.reused. Esses arquivos não contribuem para clients.observed nem para a lista media_timing.pre_existing. Um arquivo reutilizado significa que o mesmo ID de documento do Telegram foi observado em uma mensagem diferente anteriormente neste diário, dentro dos chats permitidos do leitor. Seu primeiro registro observado é citado; outra observação ou edição da mesma mensagem não é considerada reutilização.

A seção paid_reactions do dossiê mantém a tabela de classificação mais recente disponível de “Estrelas” para cada mensagem listada, com registros de origem e marcações de anonimato. Essas são contagens instantâneas, não somas de pagamentos adicionais nem uma lista completa das pessoas que reagiram. Um instantâneo sem tabela de classificação não fornece nenhuma lista substituta. A seção indica as mensagens omitidas quando seu limite de exibição é atingido.

As listas de observação e as exportações de indicadores verificam rótulos de botões, URLs, texto de cópia, consultas embutidas e bytes de retorno de chamada que são decodificados como UTF-8 válido. Codificações de retorno de chamada inválidas ou com tamanho excessivo são ignoradas pela extração de texto; os bytes originais permanecem no registro salvo. As listas de observação existentes precisam ser verificadas novamente para analisar registros mais antigos com esses campos adicionais. A verificação não aciona o botão.

No exemplo prático:

Link Registros Observação fundamentada
A mesma conta de remetente Grupo n.º 146 e acompanhamento privado n.º 205 Ambos fornecem o ID do remetente do Telegram 71001
Mesmo destinatário #146, teclado do bot #173, edição de canal #188, mensagem privada #205 Todos contêm pay.example.invalid/new; um destino repetido vincula o material
O mesmo arquivo salvo Recibos de mídia concluídos n.º 151 e n.º 209 Os valores SHA-256 completos coincidem para os bytes preservados
Atribuição do canal #101 e #188 Não atribua uma publicação do canal ao usuário 71001 sem que o remetente esteja identificado

Comparar os hashes dos anexos e suas referências de mensagem associadas, e manter as linhas do tempo das contas agrupadas pelos IDs do Telegram fornecidos nesses registros.

Mantenha as anotações de trabalho da equipe no Case Board: marque os registros nos quais você se baseia, como #146, #188 e #205, destaque a sequência de caracteres de destino exata e salve um trecho de cada ação registrada entre dois registros ou em um intervalo de tempo. As notas e os status mantêm a revisão da equipe em seu próprio histórico assinado, separadamente identificável das observações de origem.

5. Criar a linha do tempo entre conversas#

Utilize as versões salvas nos Chats e seus links de registro no Diário #… No Diário, combine todas as fontes com as edições, exclusões e cobertura. Mantenha tanto o source_at, quando fornecido, quanto o observed_at.

Tempo de observação ilustrativo Referência Observação
09:00 Canal #101 Destino original capturado
09:12 Grupo n.º 146; mídia n.º 151 Novo destino publicado; download do arquivo concluído
09:16 Bot nº 173 O teclado aponta para o novo destino
09:20 Canal #188 Anúncio editado; ambas as versões salvas permanecem
09:24 Privado #205; mídia #209 O mesmo ID de remetente repete o destino; os mesmos bytes do arquivo são preservados
09:28 Grupo nº 231 Notificação de exclusão recebida; autor da exclusão e horário exato da exclusão desconhecidos

Outros registros ocorrem entre essas referências de exemplo. Os números de sequência ordenam as observações; instantâneos do histórico podem conter datas de origem mais antigas e chegar posteriormente aos eventos em tempo real. Distinga entre instantâneos, mensagens recuperadas, notificações de exclusão e resultados de “ausência na verificação posterior”. Marque lacunas de cobertura como intervalos desconhecidos. A aquisição posterior do histórico não estabelece retroativamente uma observação ininterrupta.

6. Adicionar perspectivas de contas sem perder sua origem#

Utilize um espaço de trabalho separado para cada conta distinta e repita seu inventário. Mantenha o ID da conta, a função, a impressão digital da chave de assinatura e as referências de origem em cada comparação. Os números das mensagens não são identificadores globais entre bate-papos/contas.

O Case Board mantém notas e coleções vinculadas às fontes dentro de cada espaço de trabalho. A tela de grupo analisa o status das contas em conjunto e pode agrupar exportações de espaços de trabalho separados. Correlacione essas fontes em suas notas de caso ou ferramentas de análise; cada diário mantém sua própria origem e chave de assinatura. Não é gerada uma busca global nem uma linha do tempo combinada entre espaços de trabalho . A exportação para várias contas de um canal/supergrupo obtém o histórico desse chat usando as contas elegíveis.

Para trabalhos mais extensos, mantenha os limites com uma testemunha independente. Utilize verificações de entrega controladas para validar o caminho de captura e a visibilidade de cada conta.

Recorrência de mídia e fontes de encaminhamento#

Os relatórios de evidências comparam separadamente os IDs dos documentos do Telegram e os hashes SHA-256 dos registros de arquivos salvos. Eles mostram mensagens e conversas distintas, bem como a primeira e a última ocorrência retida, com uma linha do tempo de observações expansível em HTML. Instantâneos ou edições repetidas da mesma mensagem não aumentam a contagem de ocorrências para a mesma chave. Um arquivo diferente em uma mensagem editada mantém sua própria ocorrência.

“Observado pela primeira vez” segue a sequência da revista científica na seleção do relatório. Isso não significa que se trate da publicação mais antiga no Telegram. Os IDs dos documentos identificam os documentos do Telegram; o SHA-256 compara os bytes salvos. dHashes de 64 bits correspondentes de diferentes imagens salvas são exibidos como pistas visuais; essa comparação utiliza hashes iguais, e não uma busca pelo vizinho mais próximo. Os bytes da imagem devem corresponder ao SHA-256 salvo antes da análise do dHash; arquivos com mais de 64 MiB e imagens com mais de 40 milhões de pixels são ignorados.

Os resumos de origem contam as mensagens de destino distintas. Os IDs de pares nos cabeçalhos, nomes ocultos, assinaturas dos autores das postagens e o contexto das “Mensagens Salvas” permanecem separados. O JSON do perfil pessoal inclui as fontes de cada remetente; as postagens do canal também aparecem no resumo no nível do chat. Uma fonte nomeada sem um ID de par é um agrupamento de texto, não uma pessoa identificada. Os cabeçalhos de chats importados permanecem marcados como importados.

Os arquivos ZIP de evidências não compactadas incluem media-repeats.json, forward-sources.json e observed-sources.gexf, protegidos pelo manifesto do arquivo. O grafo GEXF 1.3 possui arestas tipadas forwarded_from e recommended. As setas se estendem do chat observado até o par referenciado. Os pesos das recomendações contam as observações de recomendação retidas; os pesos de encaminhamento contam mensagens distintas. Nomes ocultos e cabeçalhos importados não criam arestas de identidade. Nenhuma operação no grafo resolve perfis ou chama o Telegram. Os metadados das arestas incluem sequências de origem e hashes.

Os resumos seguem a seleção do relatório; o arquivo ZIP de evidências ainda contém o diário completo assinado. Uma seleção que contém apenas eventos de mensagem compara IDs de documentos; comparações de bytes salvos e imagens exigem eventos de arquivos salvos no fluxo selecionado. A seleção atual de mensagens na nuvem exclui o arquivo `media.saved`. Os limites são explícitos: 200.000 ocorrências de chave/mensagem retidas por análise, 100.000 chaves de mídia, 20 grupos de relatórios, 100 referências cronológicas por grupo e 1.000 arestas de gráfico exportadas. Quando um limite de comparação é atingido, os resultados mostram as ocorrências omitidas e as contagens passam a ser limites inferiores. Os limites de exibição da cronologia e do gráfico são relatados separadamente. Os arquivos ZIP compactados omitem esses resumos derivados. Os registros de origem assinados permanecem inalterados.

7. Reunir e verificar a transferência do caso#

Mantenha esses elementos reunidos em um diretório de casos organizado por um analista:

Material Objetivo
Notas de caso e registro de fontes Questões, política de coleta, acesso/função, conclusões, explicações alternativas e lacunas
Linha do tempo Referências tanto às datas quanto ao espaço de trabalho/bate-papo/mensagem/sequência para cada entrada
Case Board exportação e trechos, se utilizados Marcadores vinculados à fonte, citações, notas da equipe, coleções, histórico de revisões e registros selecionados verificados em relação ao arquivo ZIP de provas
Arquivo ZIP de evidências assinadas por espaço de trabalho Registro completo, manifesto e mídia preservada incluída; os filtros do painel não restringem a exportação do registro
Arquivos de perfis de pessoas assinados separadamente Referências derivadas verificadas em relação às evidências correspondentes do espaço de trabalho
Exportações completas e assinadas de conversas Aquisição do histórico visível atual, separada do registro de observação
Impressões digitais confiáveis, certificados raiz da TSA e pontos de verificação anteriores Identidade da chave, hora externa do último registro e limites do diário retidos
Artefatos do Witness, se configurados Registro separado, postagens assinadas e impressão digital da testemunha
Resultados da verificação e hashes dos arquivos entregues O que foi verificado, quais bytes foram transferidos e para quem

A partir de uma instalação confiável, com nomes de arquivos e a impressão digital real de cada espaço de trabalho:

python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --tsa-ca TSA-ROOT.pem --checkpoint retained-checkpoint.json --require evidence
python -m tgwitness.verify profiles-operations.json --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --evidence evidence.zip
python -m tgwitness.verify history-channel.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256
python -m tgwitness.verify board-slice.json --evidence evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256

--require evidence encerra com o código 2, a menos que a impressão digital corresponda e a data/hora externa de um terceiro abranja o último registro; o ponto de verificação é uma verificação de apoio.

Mantenha os resultados reais da verificação e os artefatos originais. Exporte as notas da área de trabalho do Case Board juntamente com o material de fonte citado. Reúna as descobertas entre áreas de trabalho no diretório de nível superior do caso; cada artefato do TgWitness possui sua própria assinatura e procedimento de verificação.

Adapte a investigação#

Caso Rastrear Entregar
Contestação de pedidos/pagamentos por meio de bot Anúncio de entrada → visualização do link salvo → parâmetro de inicialização do bot → versões para mensagens e teclado → recibos de retorno de chamada do painel → acompanhamento de conversas privadas/em grupo Linha do tempo observada de oferta/resposta e fontes verificadas; a confirmação de pagamento provém do registro de pagamento
Mensagens removidas após um incidente Todos os chats afetados → originais/edições salvas → resultados de exclusão ou ausência na verificação posterior → mídia preservada → cobertura e outras perspectivas da conta Versões preservadas e intervalos desconhecidos explicitados; nenhum agente de exclusão inventado
Um participante altera seus nomes nos diferentes chats ID numérico do remetente → histórico de nomes/nomes de usuário → respostas → outros chats observados → destinos/arquivos citados Uma linha do tempo da atividade de uma conta do Telegram com links para os registros de origem

Referência da coleção · Verificação de perfis de pessoas · Transferência de evidências · Validação concluída