TgWitness / Documentação

O que foi testado →

Algumas partes desta página ainda estão em inglês: o original em inglês sofreu alterações após ter sido traduzido.

Referência / Provas

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

TgWitness / Documentação

Evidências e verificação

O TgWitness preserva as observações do Telegram visíveis na conta em um diário assinado. Os destinatários podem verificar os registros salvos, anexos e relatórios em relação a uma chave de coletor confiável, conferir a hora externa fornecida por um terceiro para o último registro e comparar o diário com um ponto de verificação que tenham retido anteriormente. Esta página descreve os formatos, as verificações e o material a ser mantido para a transferência.

Os usuários podem começar com o VERIFY.cmd no Windows: ele solicita o arquivo ZIP original e a impressão digital da chave obtida de forma independente, exibe um resultado explicado e salva um relatório de verificação separado. Consulte os executáveis de verificação e o ambiente de execução portátil para obter informações sobre configuração e limites de confiança.

Nesta página

O que é assinado#

Material Proteção O que deve ser mantido
Todas as observações do registro, incluindo eventos operacionais Cadeia SHA-256 e uma assinatura Ed25519 por evento events.jsonl original, a impressão digital da chave confiável, e um ponto de verificação retido
Conteúdo do arquivo ZIP de evidências manifest.sig assina o manifesto canônico, que lista os hashes dos arquivos de conteúdo O arquivo ZIP completo, incluindo seu manifesto e sua assinatura
Anexos preservados SHA-256 e contagem de bytes em um evento media.saved assinado; hash do arquivo no manifesto ZIP assinado Os bytes originais contidos no arquivo ZIP verificado
Ponto de verificação Assinatura Ed25519 sobre o comprimento do registro, o hash do cabeçalho, a chave pública e a data de criação Uma cópia independente mantida antes de uma alteração contestada
Comprovante de execução Registro assinado da versão do coletor, hashes dos arquivos-fonte e configurações iniciais, também incluídos no process.started O recibo, o diário associado e as evidências do ambiente para o modo de verificação selecionado
Relatórios legíveis: report.html e suas partes, report.json, report.pdf, chat.pdf Um selo Ed25519 por arquivo sobre seu conteúdo; o PDF também contém uma assinatura padrão PDF (consulte Relatórios legíveis ) O arquivo tal como foi recebido e a impressão digital da chave confiável; o arquivo ZIP descrito nele
CSV independente Sem assinatura criptográfica independente; os hashes dos eventos, por si só, são insuficientes Utilize o arquivo exato contido no ZIP verificado para a verificação de integridade
Capturas de tela, impressões ou arquivos PDF gerados por um navegador Sem assinatura do TgWitness na versão derivada Mantenha o pacote original verificado e documente como a versão derivada foi criada

O coletor verifica as assinaturas do diário antes de gerar cada formato de exportação. Relatórios legíveis em HTML e PDF possuem seus próprios selos; o CSV independente é verificado como parte de um ZIP assinado. Mantenha o ZIP para preservar os bytes do anexo e o manifesto, e um ponto de verificação separado para comparar o diário com um limite anterior.

Formatos e caminhos de verificação#

O modo de aquisição e o formato de saída respondem a questões diferentes. O modo fornece evidências de coleta e do ambiente; cada formato preserva ou apresenta parte desse registro com as verificações abaixo.

Saída Verificação e uso
Evidências ZIP Eventos canônicos, manifesto assinado, cobertura, entradas de custódia, anexos e recibos externos disponíveis; verifique o arquivo e seu modo de aquisição selecionado.
Contêiner ASiC-E O arquivo ZIP de evidências como um contêiner ETSI ASiC-E (EN 319 162-1) com uma entrada de mimetype e o arquivo META-INF/ASiCManifest.xml, assinado por CAdES com o próprio certificado do espaço de trabalho no nível B-B, ou B-T quando o carimbo de data e hora estiver ativado. Validadores como o EU DSS verificam o formato e a integridade e, como o certificado é autoemitido, informam que não há âncora de confiança. O EU DSS 6.3, com configurações padrão, rejeita um contêiner com mais de 1.000 arquivos (“Detectados muitos arquivos”). O verify.py verifica o manifesto Ed25519 e todos os arquivos listados, os valores SHA-256 no META-INF/ASiCManifest.xml e em um ASiCManifestNNN.xml ou ASiCEvidenceRecordManifest.xml adicionado, e falha em uma entrada do META-INF/ que nenhum deles abrange. Ele não verifica as assinaturas CAdES e informa isso.
Relatórios em HTML e JSON Visualizações seladas individualmente com referências de fonte, também listadas no manifesto do ZIP. Suas contagens registradas resumem os tipos de eventos do diário.
Relatórios em PDF Selado com Ed25519, além de uma assinatura PAdES de referência em PDF sobre o intervalo de bytes: B-B ou B-T, com um carimbo de data e hora na assinatura, quando a função de carimbo de data e hora estiver ativada. O verificador TgWitness utiliza a chave Ed25519 confiável; a exibição da confiança no certificado pelo visualizador é uma verificação separada.
CSV Uma visualização em planilha abrangida pelo manifesto ZIP. O escape de fórmulas protege o uso da planilha; o texto original assinado permanece no diário.
JSONL Registros de eventos assinados, incluindo referências a anexos. O arquivo ZIP de evidências contém, além disso, os bytes dos anexos preservados.
Exportação de bate-papos e visualizações compatíveis com desktop Aquisição do histórico e registros disponíveis do log de administração, com a renderização solicitada e o arquivo assinado. As versões salvas do monitoramento em tempo real constituem um caminho de aquisição separado.
Registros de mídia e apenas hash Os bytes salvos são verificados em relação ao seu SHA-256 e à referência da mensagem. A aquisição apenas por hash preserva os metadados de hash disponíveis para comparação posterior com os bytes do arquivo.
STIX/MISP e perfis de pessoas Observações extraídas com link para a fonte, IDs de conta e correspondências analíticas. Assinaturas de perfil e hashes de registros podem ser verificados em relação às evidências originais; a proveniência do cache de avatares é identificada separadamente.
Trecho da transferência Regras de divulgação assinadas, registros inalterados e registros marcados como minimizados, mantendo os hashes/assinaturas originais. Use o original retido para uma comparação que exija campos ocultados.
Testemunhas e recibos de tempo Limites anteriores do diário, continuidade e as afirmações de tempo verificadas individualmente. Elas acompanham as verificações de aquisição e arquivamento.
Entrega protegida por senha Protege o pacote anexado durante a transferência. .tgwpw usa criptografia autenticada AES-GCM, incluindo um registro final autenticado; o diário anexado mantém suas assinaturas e recibos de aquisição.

Uma impressão ou captura de tela é uma apresentação do material assinado. Seu ID de relatório, impressão digital da chave e referência QR ajudam a localizar o arquivo original para verificação. As declarações de custódia registram as informações fornecidas sobre o examinador e a transferência; os resultados do verificador e os recibos de aquisição são mantidos como evidências separadas.

Assinaturas externas#

Uma assinatura também pode provir de uma chave que o TgWitness nunca possui, como a assinatura eletrônica qualificada de um investigador ou o selo de uma organização. Em Exportações, a assinatura externa em uma exportação preparada sem senha fornece os bytes a serem assinados: uma nova META-INF/ASiCManifestNNN.xml listagem de todos os arquivos com seu SHA-256 para um contêiner ASiC-E ou a manifest.json para um ZIP. O signatário retorna um CMS (CAdES) .p7s, separada ou com o conteúdo incorporado.

O TgWitness verifica se a assinatura abrange exatamente esses bytes e compara com o certificado do signatário (RSA PKCS#1 v1.5, RSASSA-PSS, ECDSA, Ed25519, Ed448). A cadeia é verificada apenas em relação aos certificados raiz fornecidos pelo operador; revogação, listas de confiança e status qualificado não são verificados. O painel exibe um status por assinatura: aguardando assinatura, anexada e não verificada, verificada, algoritmo não suportado, assinatura inválida, bytes assinados não correspondem ou certificado não vinculado a uma raiz fornecida. Alterar a exportação após os bytes terem sido distribuídos define todas as suas assinaturas como “bytes assinados não correspondem”.

O download com assinaturas adiciona as assinaturas e seus manifestos em META-INF em um contêiner ASiC-E. No caso de um ZIP, ele coloca o ZIP inalterado, os .p7s arquivos e SIGNATURES.txt em um ZIP externo. Assinaturas inválidas e assinaturas sobre outros bytes são ignoradas. Uma assinatura com um algoritmo que o TgWitness não consegue verificar é incluída; o painel mostra seu estado, assim como SIGNATURES.txt no caso de um ZIP.

Imagens de bate-papo assinadas#

Ao baixar o arquivo ZIP assinado na visualização da imagem, as páginas são salvas como PNG, pages.sig.json e README.txt. Cada página termina com os números de registro do diário exibidos, o bate-papo, o tempo de renderização, a impressão digital da chave da área de trabalho e o comando que a verifica. O painel envia apenas o SHA-256 e os números de registro de cada página; o servidor confirma que os registros pertencem ao bate-papo, assina a declaração (tgwitness-image-attestation-v1) com a chave do espaço de trabalho e registra a assinatura no diário como export.image_attested.

python verify.py page-01.png page-02.png pages.sig.json
python verify.py page-*.png pages.sig.json --fingerprint TRUSTED_SHA256 --evidence evidence.zip

O verificador verifica a assinatura, associa cada arquivo PNG a uma página assinada e informa a impressão digital da chave. --fingerprint Ele compara o signatário com uma impressão digital obtida do remetente de forma independente. --evidence Lê um arquivo ZIP de evidências assinadas do mesmo espaço de trabalho e exige que todos os registros das imagens estejam presentes com o mesmo hash. Um pixel alterado, uma declaração alterada ou outra chave faz com que a verificação seja reprovada. As imagens mostram registros salvos no próprio layout do TgWitness; elas não mostram o que o Telegram exibiu para ninguém.

Comparando exportações de bate-papos#

Verifique e compare dois arquivos ZIP de exportação de bate-papo assinados com impressões digitais dos signatários mantidas de forma independente:

python -m tgwitness.verify first.zip --compare second.zip \
  --fingerprint FIRST_TRUSTED_KEY_SHA256 --compare-fingerprint SECOND_TRUSTED_KEY_SHA256

As opções --require e --require-tier são rejeitadas quando usadas em conjunto com --compare; verifique o perfil exigido de cada arquivo por meio de sua própria verificação.

Quando ambos os arquivos registram os mesmos IDs numéricos de conta e de chat, os registros são emparelhados pelo ID da mensagem. Inalterado significa igualdade do registro JSON completo salvo: texto completo, autor, datas, destinatário da resposta, metadados aninhados e campos desconhecidos estão todos incluídos. A ordem das chaves do objeto JSON não importa; campos ausentes, valores nulos, tipos de valor e ordem da matriz, sim. A pré-visualização de 300 caracteres serve apenas para exibição. As entradas alteradas identificam o changed_fields de nível superior diferente, incluindo alterações invisíveis nessa pré-visualização. IDs de mensagem duplicados são rejeitados, em vez de se sobrescreverem mutuamente durante a correspondência.

Uma diferença pode ser um nome de exibição alterado, contagem de visualizações, anotação de coleção ou outros metadados de observação. As edições do Telegram aparecem como seus próprios eventos de edição, e a verificação de cada arquivo mostra se ele está intacto. Registros não analisados permanecem na comparação e são comparados por meio de sua representação salva.

Para identidades de conta/bate-papo diferentes ou ausentes, a ferramenta encontra correspondências candidatas usando remetente, texto completo, hash do arquivo, tipo de mídia e uma tolerância de tempo de cinco segundos, e as relata como Correspondentes em vez de Inalteradas. Registros não analisados permanecem sem correspondência. As diferenças nos registros emparelhados são listadas em changed, inclusive no modo de conteúdo. Com --json, matched conta os pares candidatos e unchanged conta os pares cujos registros completos salvos são iguais. A saída existente changed_fields e a saída inteira unchanged permanecem compatíveis com resultados de comparação anteriores. O formato de arquivo e a verificação de assinatura permanecem inalterados.

Transferência de investigação#

  1. Registre a referência do caso, o operador, o ID numérico da conta do Telegram, as fontes selecionadas, a política de coleta e o período de coleta nas notas do seu caso. O TgWitness preserva observações e oferece suporte a notas e coletas vinculadas a fontes no Case Board. Mantenha os registros de transferência e custódia junto com os materiais do seu caso. Verifique a configuração de coleta pretendida com o procedimento de aceitação em tempo real.
  2. Salve a impressão digital da chave pública do espaço de trabalho de forma independente antes de confiar nas suas exportações. Mantenha o modo de evidência ativado (configuração padrão) para que os pontos de verificação recebam recibos de acordo com a RFC 3161 e o OpenTimestamps. Salve os pontos de verificação assinados fora do coletor durante a coleta. Registre as interrupções e os limites de visibilidade da conta.
  3. Exporte um arquivo ZIP assinado e guarde o comprovante de execução assinado. Utilize um ponto de verificação no limite do registro exportado ou antes dele. Um ponto de verificação posterior pode rejeitar corretamente uma exportação anterior por ser muito curta. As exportações incluem o registro completo da área de trabalho, independentemente dos filtros do painel; revise o material antes de compartilhá-lo.
  4. Peça ao destinatário para verificar o ZIP com uma cópia confiável do verificador, a impressão digital fornecida de forma independente e o certificado raiz da autoridade de carimbo de data/hora obtido separadamente. A partir de um checkout confiável com seu ambiente Python ativo:

    python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --tsa-ca TSA-ROOT.pem --checkpoint retained-checkpoint.json --require evidence

    A impressão digital e um carimbo de data/hora verificado do último registro atendem aos requisitos mínimos para servir como evidência; caso contrário, --require evidence encerra a execução com o código 2. O ponto de verificação é uma verificação de apoio, pois é assinado com a chave do coletor. A saída bem-sucedida relata key_pinned: true e checkpoint_checked: true quando ambas as entradas são fornecidas e aceitas. Preserve o resultado da verificação.

    For a handover requiring the final exported record to be witnessed, use
    `--witness witness.zip --witness-fingerprint TRUSTED_WITNESS_SHA256 --require-witness`.
    This refuses an export with an unwitnessed tail. Add
    `--channel https://t.me/s/WITNESS_CHANNEL` to read the dates Telegram set on the
    witness posts as external time. See the
    [witness handover procedure](WITNESS.md#require-a-witnessed-export-boundary).
    
    1. Registre o SHA-256 do arquivo, o limite de exportação, a data de transferência, o remetente e o destinatário em seu registro de custódia. Mantenha o pacote original intacto e trabalhe com cópias. Compartilhe arquivos de evidência em vez do diretório de dados privados do aplicativo, que também contém sessões de conta e segredos de assinatura. Para transferência, escolha um ZIP AES-256 protegido por senha ou o contêiner mais seguro .tgwpw . O ZIP utiliza a derivação de senha de baixo custo do WinZip; use uma frase-senha longa e aleatória . O .tgwpw utiliza scrypt e AES-256-GCM e é aberto com o comando unseal-password do verificador independente. A senha não é armazenada e protege apenas a confidencialidade; o destinatário descriptografa o arquivo compactado e verifica a exportação assinada em seu interior, que permanece inalterada.
    2. Para aplicar um carimbo de data/hora a um ponto de verificação fora do modo de evidência, siga o procedimento da RFC 3161 e retenha a solicitação, o ponto de verificação, as informações da CA confiável e a resposta verificada da autoridade. A simples preparação de uma solicitação não garante a obtenção de um carimbo de data/hora.

Para .tgwpw, use um verificador obtido de forma independente e escolha um novo arquivo de saída com a extensão original: python verify.py unseal-password export.tgwpw --out evidence.zip. O comando solicita a senha; --password-stdin lê uma linha para automação. Ele nunca sobrescreve um arquivo existente e publica o texto simples somente após todos os registros terem sido autenticados. Em seguida, execute a verificação normal da assinatura no arquivo descriptografado. O contêiner usa scrypt (N=131072, r=8, p=1, salt de 16 bytes; cerca de 128 MiB de RAM) e AES-256-GCM com registros de 1 MiB e um registro final autenticado. Um registro de metadados criptografado armazena o nome do arquivo interno, para que os contêineres baixados possam ser renomeados.

A verificação bem-sucedida estabelece a integridade em relação à chave do coletor confiável e ao limite retido. Consulte o escopo da verificação para conhecer as suposições de confiança e os resultados da validação das verificações realizadas.

Trecho da transferência#

Um arquivo ZIP assinado contém todo o registro do espaço de trabalho. Quando um tribunal, um advogado ou uma unidade de combate a abusos precisa apenas de algumas conversas, de um período específico ou de determinadas pessoas, a opção “Exportações → Extrato de transferência” prepara uma cópia reduzida (tgwitness-handover-v1) de acordo com as regras de divulgação selecionadas. O operador indica a finalidade e escolhe as conversas, um período opcional (UTC), as pessoas às quais o extrato se refere, o que acontece com todos os demais (exibidos, substituídos por pseudônimos P01, P02… ou excluídos ), quais textos de mensagens permanecem, quais anexos e fotos de perfil são incluídos e se os números de telefone e endereços de e-mail nos textos são mascarados. A finalidade e essas regras constam no manifesto assinado e no relatório; o diário registra “handover.exported” com o acesso que o preparou e o SHA-256 do arquivo, não o conteúdo.

O verify.py verifica um extrato de duas maneiras. Um registro exibido como inalterado é verificado na íntegra: seu conteúdo é comparado com seu hash, sua assinatura Ed25519 e seu link para um predecessor incluído. Um registro minimizado mantém o hash e a assinatura originais; assim, a assinatura ainda é válida, mas os campos ocultados não podem ser recalculados a partir deles; o registro indica o que foi ocultado e o relatório o marca. Registros de serviço em toda a conta (inícios e encerramentos, lacunas de cobertura, avisos de conexão, rede e armazenamento, alterações de escopo e configurações) mantêm apenas os campos listados para seu tipo: as listas de bate-papo nelas são reduzidas aos e seus totais são recalculados; uma lacuna de sondagem ativa em um chat fora da seleção faz com que esse chat, seus números de mensagens e a conta testemunha sejam perdidos; em um chat de sondagem selecionado, a conta testemunha é substituída por seu pseudônimo, a menos que todos sejam exibidos ou que se trate de uma das pessoas selecionadas. O manifesto indica o comprimento e o cabeçalho do diário com a assinatura do coletor sobre esse cabeçalho e conta os registros excluídos; o arquivo `coverage.json` descreve os chats selecionados. Novos extratos também contêm o arquivo `proofs.jsonl`: para cada registro incluído e para o cabeçalho do diário, o caminho Merkle desde o hash original do registro até a raiz do diário indicada no manifesto assinado. O verify.py verifica cada caminho, de modo que cada registro seja comprovado como pertencente ao mesmo diário com aquele comprimento e cabeçalho, sem o diário completo; um extrato de 100 mensagens é verificado em cerca de um segundo, independentemente do tamanho do diário. --range=CHAT:FROM-TO confirma adicionalmente que as mensagens de FROM a TO de um chat estão no extrato e informa quantos registros foram verificados para elas. Nomes dentro de nomes de arquivos não são detectados. Revise os arquivos finais antes de compartilhá-los: texto livre, nomes de arquivos e anexos selecionados ainda podem identificar pessoas. Guarde o ZIP completo assinado: o extrato é uma divulgação, não um substituto.

Relatórios de fácil compreensão#

As evidências assinadas, a transferência e os arquivos ZIP de bate-papos contêm relatórios legíveis em HTML e JSON, além de PDF quando as fontes necessárias estiverem disponíveis, no idioma selecionado para o relatório. Cada relatório é selado com a chave Ed25519 do espaço de trabalho e pode ser verificado separadamente: ` python -m tgwitness.verify FILE --fingerprint KEY [--evidence ZIP]`.

  • report.html / chat.html: a instrução de selagem (tgwitness-report-seal-v1) fecha o arquivo e assina o SHA-256 de cada byte anterior a ela. Diários e bate-papos longos são divididos em partes de um tamanho configurável (Configurações do relatório, de 500 a 100.000 registros; 5.000 por padrão): records/records-0001.html ou messages/messages-0001.html, cada uma selada com seu número, intervalo e o total, e listada com seu SHA-256 no manifesto assinado. Séries de sinais de vida do coletor são exibidas como uma única linha, a menos que as configurações do relatório as listem uma a uma.
  • report.json (tgwitness-report-json-v1, chaves format, report, seal): o selo assina o SHA-256 do JSON canônico do report, para que os fatos possam ser lidos por sistemas de instâncias e scripts e uma seleção para proteção de dados possa ser feita a partir deles, enquanto o arquivo assinado permanece intacto.
  • report.pdf / chat.pdf: um documento formal para impressão e arquivamento, assinado duas vezes sobre os mesmos bytes, todo o arquivo, exceto o valor da assinatura (/ByteRange). A assinatura padrão em PDF é a PAdES baseline (ETSI EN 319 142-1, /SubFilter /ETSI.CAdES.detached: CMS com SHA-256 e ECDSA P-256, certificado de assinatura v2, sem hora de assinatura no CMS; a hora declarada é /M) no nível B-B, ou B-T com um carimbo de data e hora de assinatura RFC 3161 no CMS quando o carimbo de data e hora está ativado e uma autoridade de carimbo de data e hora responde pela rota para solicitações fora do Telegram. Ele utiliza um certificado de assinatura de documentos autoemitido, mantido no cofre da área de trabalho; seu número de série do sujeito é a impressão digital da chave Ed25519. O selo Ed25519 é transmitido dentro do CMS como o atributo não assinado 2.25.240684792623320047764573196045913242332 e identifica o SHA-256 do certificado com "content": "pdf-byte-range", de modo que a chave Ed25519 atesta a validade do certificado. O certificado não é qualificado: um leitor de PDF exibe a assinatura como válida e o signatário como desconhecido ou não confiável até que o certificado seja considerado confiável; compare a impressão digital da chave Ed25519 em vez disso. PDFs em chinês, japonês e coreano precisam de uma fonte no servidor (ou em TGWITNESS_FONT_DIR); sem ela, o ZIP contém apenas os relatórios em HTML e JSON .
  • report.en.html, report.en.pdf / chat.en.html, chat.en.pdf: o original em inglês do mesmo relatório quando o idioma do relatório não é o inglês, selado e assinado da mesma forma e indicado no manifesto assinado em report.original. O relatório no idioma escolhido começa com a recomendação de apresentar o original em inglês com uma tradução certificada ou juramentada; veja Traduzir relatórios para o tribunal.

Em um canal ou supergrupo, Telegram numera as mensagens 1, 2, 3… em ordem. Uma exportação de bate-papo lista o primeiro e o último número, quantas mensagens estão presentes e cada sequência de números ausentes em message-ids.json , o manifesto e o cabeçalho chat.json , além de marcar cada lacuna onde ela ocorre na transcrição. verify.py recomeça a contagem a partir de chat.json . Um número ausente é uma mensagem que Telegram não retornou (excluída antes da exportação ou não visível para a conta); em bate-papos privados e grupos básicos, os números são compartilhados por todos os bate-papos da conta e as lacunas não são contadas.

Após ler o histórico, a exportação solicita novamente ao Telegram todos os números ausentes, por número (channels.getMessages, até 10.000 números, incluindo os 1.000 abaixo da primeira mensagem, distribuídos uniformemente por todas as lacunas quando houver mais). O resultado consta message-ids.json e no relatório. Uma resposta vazia registra que o número não está disponível para esta conta no momento da nova verificação; ela não especifica a causa. Uma mensagem retornada na nova verificação é adicionada à exportação e marcada found_on_recheck.

Quando o espaço de trabalho de observação detectou que mensagens do chat foram excluídas, estavam ausentes na nova verificação ou foram editadas, a exportação do chat adiciona journal-changes.jsonl: esses registros do diário, todas as versões salvas e o aviso, cada um com o hash e a assinatura Ed25519 que recebeu no diário. verify.py Recalcula o hash de cada registro, verifica sua assinatura em relação à chave de exportação e compara a contagem com o manifesto assinado; a exportação de evidências contém a cadeia completa de hashes. O relatório lista essas mensagens nas seções “Exclusões” e “Versões anteriores”.

Cada relatório começa com Em resumo: um parágrafo, seguido do que o material mostra e do que o registro inclui. O selo da própria página fica âmbar quando o navegador verifica a assinatura do selo, e não a página: um navegador não fornece à página seus próprios bytes. Ele fica verde somente quando o leitor arrasta o arquivo para a verificação no final da página e todos os bytes correspondem, e somente se a página exibida for esse arquivo; caso contrário, ele fica vermelho.

Cada relatório identifica o programa com exatidão: o commit do Git quando o coletor é executado a partir de um checkout ou quando o instalador define TGWITNESS_COMMIT, e o SHA-256 de seus arquivos-fonte (source_tree_sha256, o JSON canônico do caminho → SHA-256 de cada arquivo .py, .js, .css, .html e .svg no pacote), que um checkout desse commit reproduz, a menos que os arquivos tenham sido alterados. O cliente Telegram é nomeado com base em sua biblioteca, camada de API e centro de dados. Quando a observação começa e quando uma exportação de chat inicia e termina, o coletor solicita ao Telegram sua hora (updates.getState, segundos inteiros ) e registra a hora do Telegram menos o relógio do coletor, com a incerteza decorrente da ida e volta; os relatórios mostram essas medições na seção “Cadeia de custódia”. Uma exportação de bate-papo também registra quando leu o histórico, além das datas das mensagens.

Visualizador de relatórios offline e guia de arquivamento#

Extraia o ZIP completo antes de abrir chat.html ou report.html. O visualizador oferece pesquisa, filtros, participantes, indicadores, detalhes do registro e seleções de JSON/CSV sem a necessidade de um servidor. Mantenha viewer/ e media/ ao lado do relatório. As seleções são derivadas: use verify.py SELECTION.json --evidence ARCHIVE.zip para compará-las com o arquivo assinado. O verificador verifica o ID do relatório, a chave de assinatura, o limite do arquivo e cada item selecionado; itens editados, ausentes e duplicados são rejeitados. As notas de seleção e a hora de criação permanecem como metadados não assinados.

Lacunas no número de mensagens são exibidas apenas para um feed de bate-papo completo, não filtrado e em ordem crescente. Ocultar uma categoria ou não conseguir carregar um bloco de dados não deve transformar uma linha omitida em evidência de uma mensagem ausente . Os destaques de pesquisa operam em texto simples antes do escape “HTML”, preservando a marcação literal.

O navegador verifica as assinaturas do manifesto, o ID e a chave do relatório, bem como todos os hashes de arquivos listados. Ele rejeita estruturas ZIP ambíguas ou malformadas, nomes duplicados e caminhos inseguros, e limita os arquivos a 256 MiB e o conteúdo total declarado a 4 GiB. Use o verificador independente para arquivos maiores. Essa verificação do navegador complementa as verificações do verificador quanto às cadeias de registros e à semântica dos dados.

O README.txt contém um guia de introdução, um inventário de arquivos alinhado, instruções de verificação e notas sobre o formato dos dados no idioma do relatório, seguidas por um guia completo em inglês. O SHA256SUMS abrange os arquivos listados nele, excluindo o próprio, o manifest.json e o manifest.sig; o manifesto assinado também abrange o SHA256SUMS. Mantenha o ZIP original inalterado e salve os arquivos de trabalho fora da pasta extraída. Os relatórios do PDF incluem marcadores de seção e identificação do caso/relatório nas páginas seguintes.

O chat no momento da exportação#

A exportação de um chat registra o que Telegram informou sobre o chat no momento em que a exportação foi iniciada: as próprias etiquetas de Telegram (scam, fake, restricted com seus motivos, verified), nomes de usuário, descrição, número de membros e administradores, a discussão vinculada, proteção de conteúdo, se novos membros veem mensagens anteriores e a partir de qual mensagem esta conta tem acesso ao histórico (available_min_id), a data da mensagem 1, quando se trata da criação do chat, e o SHA-256 da foto do chat (salva em media/). Registra a posição da conta exportadora no chat: função, data de adesão, quem a convidou e, no caso de um administrador, seus direitos. Uma solicitação que o Telegram recusa é indicada em seu lugar.

Quando a conta exportadora é um administrador, a exportação lê o log de administração do chat (o Telegram mantém por cerca de 48 horas) no arquivo admin-log.json: exclusões e edições com o conteúdo fornecido, a conta responsável e a data da ação de origem. Essas entradas complementam as versões capturadas do diário ativo e os registros de recebimento de exclusões.

Indicadores#

A lista de relatórios e o arquivo contêm, como indicators.csv , indicators.stix.json (STIX 2.1 ) e indicators.misp.json (evento MISP ), o que uma equipe de combate a abusos pode analisar nas mensagens registradas: links e domínios (mesmo aqueles ocultos atrás de texto, em botões e em visualizações de links), endereços de criptomoedas, nomes de usuário e links de convite Telegram , números de telefone, endereços de e-mail e imagens salvas. Endereços de Bitcoin, Litecoin, Dogecoin e TRON são listados apenas quando sua soma de verificação base58 é válida, endereços segwit quando sua soma de verificação bech32 ou bech32m é válida e endereços TON quando seu CRC é válido; endereços EVM e Solana são marcados como não verificados. As imagens contêm SHA-256 e um hash perceptual (dHash, 64 bits) que cópias recomprimidas ou redimensionadas mantêm praticamente inalterado. Os relatórios registram indicadores para que não sejam abertos acidentalmente (hxxps[://]example[.]com ); os arquivos mantêm os valores como estavam. Cada indicador é marcado como desconhecido e não apto para detecção automática (STIX , indicator_types: unknown , MISP , to_ids: false ; distribuição para a própria organização): o fato de estar listado significa que uma mensagem o continha, não que seja malicioso. Um link cujo texto exibe um endereço diferente daquele que ele abre é marcado no relatório.

Os relatórios PDF terminam com uma declaração do examinador a ser assinada à mão, uma lista de verificação para um notário ou perito judicial e um código QR (também na primeira página) com o ID do relatório, a impressão digital da chave e o SHA-256 dos dados oficiais, de modo que uma cópia impressa remeta de volta ao seu arquivo.

Canonização de eventos#

A entrada de hash consiste exatamente nos seguintes campos:

seq, observed_at, source_at, kind, chat_id, message_id, actor_id, payload, previous_hash

Serialize utilizando JSON compatível com Python em UTF-8, com chaves de objetos ordenadas, sem escape de ASCII, sem espaços em branco irrelevantes e sem NaN/infinito:

json.dumps(value, ensure_ascii=False, sort_keys=True,
           separators=(",", ":"), allow_nan=False).encode("utf-8")

O SHA-256 desses bytes torna-se o hash do evento. A assinatura é gerada pelo algoritmo Ed25519 sobre os 32 bytes brutos do hash e, em seguida, codificada em base64. O primeiro `previous_hash` é composto por 64 zeros. Os números de sequência começam em 1 e aumentam em 1. Todos os eventos, incluindo os operacionais, compartilham uma única cadeia. Não há supressão de entregas duplicadas: observações repetidas são recibos distintos, não uma alegação de ações distintas no Telegram.

As datas brutas do Telegram são strings ISO; os campos binários se tornam objetos contendo bytes_base64. O texto da mensagem, as entidades, os descritores de mídia, os metadados de resposta, as reações e as ações de serviço são mantidos nos metadados da mensagem bruta quando fornecidos. Uma mensagem ativa também mantém a atualização do Telegram que a entregou em transport_update; quando essa atualização contém a mesma mensagem que raw, seu message campo é {"same_as": "raw"} em vez de uma segunda cópia.

observed_at é a hora UTC em que o coletor gravou o registro; source_at é a data fornecida por esse evento do Telegram. Registros gravados durante o processamento de uma atualização em tempo real incluem payload.received_ata hora UTC em que a atualização chegou ao coletor, e payload.processing_delay_ms. As edições em tempo real mantêm a data de edição fornecida, os instantâneos do histórico mantêm a data da mensagem com uma hora de observação atual, e uma notificação de exclusão comum registra a hora de recepção com uma data de origem nula. As entradas do log de administração mantêm separadamente a data da ação fornecida. A ordem de recepção e a ordem dos eventos de origem são linhas do tempo distintas, com observações de relógio e recibos externos disponíveis para comparação.

Semântica dos atores#

A atribuição segue a fonte do evento. message.new.actor_id e message.edited.payload.sender_id mantêm o remetente da mensagem. Notificações comuns message.deleted contêm IDs de mensagem e têm um campo de ator nulo; entradas disponíveis no log de administração contêm a ação, o ator e a data fornecidos. Mensagens do serviço de associação mantêm o remetente e o tipo de ação; atualizações brutas de participantes mantêm o actor_id fornecido; e instantâneos de reação preservam suas contagens e identidades visíveis fornecidas. Leia esses registros juntamente com as versões capturadas e os recibos de interação do painel.

Notificações de exclusão para chats privados e grupos comuns contêm apenas IDs de mensagens. Esses chats compartilham uma sequência de IDs válida para toda a conta; portanto, um ID identifica uma única mensagem dessa conta. Quando uma mensagem com esse ID foi salva anteriormente neste diário, a exclusão é registrada nesse chat como `message.deleted`, com `payload.chat_resolution` nomeando o método. IDs que nunca foram salvos são mantidos como deletion.unscoped: uma notificação de exclusão efetiva cujo chat ainda não foi correlacionado. Isso é distinto de message.missing_on_recheck, que registra um resultado de consulta indisponível, e de uma lacuna nos IDs de mensagens salvas. Canais e supergrupos numeram as mensagens por bate-papo e nunca são correspondidos dessa forma. Quando a mensagem excluída foi enviada pela conta observada, payload.deleted_message_was_outgoing é verdadeiro; o autor da exclusão ainda não é fornecido.

Um aviso sem escopo mantém seu próprio rótulo porque o chat correspondente pode estar fora do escopo da observação atual ou não ter uma correspondência única. A ausência de nova verificação permanece como uma observação separada de uma notificação de exclusão nas contagens de relatórios, filtros e rótulos. Uma recuperação posterior elimina o estado atual de ausência, preservando a verificação malsucedida anterior no histórico assinado; os avisos de exclusão permanecem como um tipo de evento separado.

Vários IDs que correspondem ao mesmo chat a partir de uma única notificação são agrupados como deletion.batch, independentemente do número deles, com os IDs das mensagens exatamente como o Telegram os enviou e quantas delas essa conta havia enviado. A notificação do Telegram lista as mensagens; o registro de administração do chat identifica o administrador responsável, onde a conta pode acessá-lo. A ligação (message.deletion_attributed) é estabelecida conforme o que ocorrer primeiro: uma consulta que tenha visto a entrada no registro do administrador antes do aviso de exclusão é associada quando o aviso é registrado.

Cobertura: continuidade, lacunas e IDs não observados#

Cada arquivo ZIP assinado contém o coverage.json; o relatório em HTML abre com o mesmo resumo, e o verify.py o recalcula a partir do events.jsonl, em vez de confiar no arquivo:

  • Observado continuamente de X a Y. Um período começa com observation.started e termina com uma pausa, uma interrupção, uma perda de conexão com o Telegram, um logout, um início de processo sem uma parada ordenada ou mais de três minutos sem nenhum registro durante a observação (os heartbeats são gravados a cada minuto; portanto, o silêncio significa que o processo parou, travou ou que o computador entrou em modo de suspensão). Quando o intervalo do heartbeat é alterado em Mais ferramentas → Parâmetros, cada heartbeat registra essa alteração e o silêncio permitido passa a ser de três intervalos, nunca menos de três minutos.
  • As lacunas indicam o intervalo de tempo entre períodos, acompanhado do motivo. Uma lacuna ainda em aberto no último registro é marcada como not_resumed_by_last_record.
  • IDs de mensagens não observadas. Para canais e supergrupos, que numeram as mensagens por bate-papo, os IDs ausentes entre os observados são listados como intervalos. Eles são relatados como não observados — excluídos, nunca entregues ou fora do histórico salvo — nunca como excluídos. Bate-papos privados e grupos comuns compartilham uma sequência válida para toda a conta; portanto, lacunas dentro de um desses bate-papos não significam nada e não são listadas ali.
  • Notificações de lacunas no nível do chat (por exemplo, o Telegram solicitando a recuperação de diferenças em um canal) são contabilizadas como notas; elas não interrompem a cobertura global.
  • Registros de sessão. As instâncias em que o contador de atualizações do Telegram aumentou sem que nenhuma atualização tenha chegado a essa sessão (updates_diverted), em que essa sessão saiu da lista de sessões do Telegram enquanto sua conexão continuava ativa (session_revoked_externally) ou em que a resposta de uma sonda de testemunha chegou apenas do histórico (probe_ack_missed_live) são listadas separadamente. O verificador também informa a origem da chave de sessão do Telegram, outras sessões conectadas quando a observação começou, sessões adicionadas durante a observação, avisos de segurança do Telegram (777000), outras sessões encerradas a partir do espaço de trabalho, períodos de “somente sessão”, contagens de sondas de testemunha e atualizações de chamadas telefônicas. Consulte as contas. Enquanto a opção chats escolhidos estritamente estiver ativada (scope.strict em observation.started), a lista de sessões (exceto quando esta for a única sessão ou quando a opção dispositivos do Telegram estiver ativada), os avisos de segurança e as atualizações de chamadas telefônicas não são coletados; portanto, sua ausência não significa nada, e uma exclusão só é associada a uma sessão somente se uma tiver ocorrido nos 10 minutos anteriores a ela.

Sequência de atualização (pts)#

O Telegram apresenta atualizações relacionadas às mensagens com pts: uma sequência para a conta (conversas privadas e grupos básicos juntos) e uma para cada canal ou supergrupo. O coletor registra cada sequência recebida sem lacunas como um coverage.sequence registro: o primeiro e o último pts, o número de atualizações de cada tipo e se elas foram enviadas em tempo real ou retornadas pelo getDifference ou getChannelDifference. Uma interrupção é um coverage.gap registro, e coverage.gap_closed indica o pts a partir do qual a sequência fica completa novamente.

Uma sequência ininterrupta mostra que todas as atualizações do Telegram numeradas nessa sequência, entre a primeira e a última, pts chegou ao cliente do Telegram deste coletor. Isso não diz nada sobre conteúdos que o Telegram nunca enviou para essa conta, sobre o período anterior ao primeiro registrado pts, nem sobre sequências que o coletor não registrou. Um pts avanço que nenhum trecho registrado ou diferença abranja é mostrado como uma interrupção.

GET /api/continuity respostas para um intervalo (since, until, chat_id) se cada sequência é ininterrupta e lista as interrupções com seus motivos. verify.py imprime o mesmo a partir dos registros de um arquivo na seção “Continuidade da sequência”.

Números de mensagens ausentes (gap_summary)#

For a reader's guide to this section and to observation periods and gaps, see Coverage and missing material.

Pré-visualização. coverage.json → gap_summary Mede os números atribuídos pelo Telegram que este coletor nunca detectou. O Telegram numera as mensagens uma vez por canal ou supergrupo e uma vez por conta em chats privados, bots e grupos comuns. Um número entre duas mensagens observadas pode ser observado ou estar faltando; um intervalo contíguo é uma afirmação positiva de que todas as mensagens numeradas nesse intervalo foram observadas. Uma lacuna não indica nenhum agente nem motivo.

Campo Significado
status on ou off quando desativado em Mais ferramentas → Parâmetros → Análise de lacunas
parameters Os parâmetros que geraram o resultado, para que ele possa ser repetido
chats[] Uma entrada por canal ou supergrupo, cada uma numerada separadamente
account A sequência, em toda a conta, de conversas privadas, bots e grupos comuns
status (por sequência) applicable, ou not_applicable com reason
observed_from, observed_to, span Primeiro e último número observado e o tamanho do intervalo
observed, observed_without_content Números observados; aqueles conhecidos apenas por meio de um registro de exclusão ou de nova verificação
missing, density, gap_ranges, largest_gap Números nunca observados, sua proporção no intervalo, quantas execuções, a execução mais longa
clusters[] Lacunas listadas: low, high, missing, e os números observados adjacentes after / before com seus horários de observação
service_estimate Somente quando ativado: quantos números ausentes seriam mensagens de serviço, considerando sua proporção observada. Nunca subtraído de missing

A validade é derivada do diário, nunca é presumida:

  • Canais e supergrupos são medidos por conversa, inclusive na exportação de conversas selecionadas. Os registros selecionados pelo remetente constituem a medição not_applicable.
  • A sequência em toda a conta é medida apenas da primeira à última mensagem que chegou enquanto a coleta de toda a conta estava ativada e incluiu chats privados, bots, grupos comuns e as próprias mensagens da conta, sem excluir nenhum desses chats (scope.changed). Números indicados por deletion.unscoped contagem são considerados observados sem conteúdo. Uma exportação ou transferência de chats selecionados não pode medi-la. Se a coleta de toda a conta foi desativada e reativada, uma nota indica que os números usados nesse intervalo aparecem como lacunas.
  • As mensagens de serviço são registros do diário com números próprios, portanto, preenchem suas lacunas por conta própria; a estimativa opcional serve apenas como contexto.

verify.py recalcula gap_summary a partir events.jsonl com os parâmetros no coverage.json (valores padrão para arquivos mais antigos) e imprime a linha referente a toda a conta em seu resumo de cobertura. O get_capture_status(MCP e a linha de comando) retorna a mesma medição para os chats que um acesso pode ler; a sequência de toda a conta apenas para acessos que abranjam todo o espaço de trabalho.

Observações repetidas de uma mensagem de serviço contam uma única vez, e a estimativa do serviço de conta utiliza apenas números dentro do intervalo medido. Um escopo aplicado deve preservar explicitamente as próprias mensagens da conta antes que a medição em toda a conta seja habilitada; a medição começa a partir de registros que contêm essa informação. O intervalo medido abrange a observação em andamento, e sua retomada é registrada. A consulta ao arquivo em tempo real tem um orçamento de tempo, incluindo sua varredura no banco de dados, e marca uma medição inacabada como parcial.

O Telegram documenta as sequências separadas de IDs de mensagens. Esses números descrevem observações; avisos de exclusão, novas verificações e o registro do log de administração explicam por que um número está ausente onde o Telegram o relata.

Quando o Telegram deixa de aceitar a conta, o registro coverage.gap que encerra a observação contém o cause (account_banned, account_frozen, account_deleted, session_duplicated, session_revoked, session_expired, session_ended ou not_authorized) e o Telegram erro; o verify.py indica a causa do encerramento do período.

A cobertura combina períodos de observação registrados, interrupções e resultados de mensagens. Avalie-a juntamente com os chats selecionados, o período e a política de anexos; verifique novamente os resultados e as lacunas registradas para mostrar o grau de completude com que as atualizações da conta foram observadas.

Produtor#

O manifesto assinado dos arquivos ZIP de evidências, exportações de bate-papo, diários de testemunhas e a declaração dos arquivos de perfil de usuários contêm producer: software, versão, projeto (PhishDestroy), página inicial e repositório de código-fonte. O relatório em HTML e o verificador exibem esse registro assinado do produtor. Os hashes dos arquivos-fonte identificam a árvore de código-fonte registrada para comparação com um checkout confiável. A proveniência da execução é verificada separadamente por meio do atestado de aquisição do GitHub ou das medições do Intel TDX, quando habilitadas. Arquivos criados antes da existência do campo produtor continuam sendo suportados e são identificados como registros legados.

Cada registro observation.started também identifica o cliente Telegram que realizou a observação: seu api_id (nunca o hash), seja esse um par público integrado ou o próprio aplicativo da operadora, a descrição do cliente enviada na solicitação de conexão do Telegram e o tipo de rota de conexão com o modo IP (sem endereço de proxy ou senha). O relatório e o custody.json listam todos os clientes e rotas distintos com a data em que foram registrados, bem como as vezes em que nenhum proxy listado respondeu e o Telegram detectou o endereço do servidor. Os registros anteriores a este confirmam isso.

Perfis de pessoas#

Um arquivo de perfil (tgwitness-dossier-v1, JSON) é gerado mediante solicitação a partir de registros já presentes no diário para um chat; nada é obtido do Telegram e o conteúdo do perfil nunca é gravado no diário (a ativação e desativação de perfis são registradas como dossier.changed). Para cada pessoa com uma mensagem salva, ele lista o nome e o histórico de nomes de usuário, as marcações do Telegram (bot, golpe, falso, premium, verificado, restrito, excluído) conforme exibidas no momento do salvamento, as identificadores de foto, SHA-256 e hash perceptual (pHash, compatível com imagehash.phash) do avatar a partir do cache local de avatares com avatares semelhantes, atividade (primeira e última mensagem, contagens, compartilhamentos editados e excluídos, mensagens por hora UTC), quem responde a quem, outros chats neste diário em que a pessoa escreveu e carteiras mencionadas (BTC, EVM, TRON, TON, LTC, DOGE, XMR, SOL; endereços Base58Check são validados por checksum), números de telefone, nomes de usuário e links, incluindo links ocultos atrás de texto.

Cada fato indica os registros do diário (seq) dos quais se origina, e record_hashes contém o hash de cada registro referenciado. A declaração é assinada com a chave do espaço de trabalho:

python verify.py tgwitness-dossier-CHAT.json --fingerprint TRUSTED_SHA256 --evidence tgwitness-evidence.zip

Verifica a assinatura, verifica a própria exportação das evidências (assinatura, cadeia de hash e arquivos) e se todos os registros referenciados existem inalterados nessa exportação do mesmo espaço de trabalho. Os hashes de avatares são identificados como provenientes do cache local (não de registros do diário). As menções são correspondências de padrões e pistas a serem verificadas. Os perfis são ativados por chat, podem ser exportados como um ZIP com criptografia AES-256 e senha, e são excluídos quando desativados ou quando o chat é removido das fontes.

Testemunha independente#

Um diário de testemunha (tgwitness-witness-v1) e suas postagens no canal são verificados em relação a uma exportação de evidências com verify.py --witness … --channel …; consulte testemunha independente. Com um endereço público https://t.me/s/… ou https://telegram.me/s/…, o verificador lê a data de cada postagem no Telegram, e a data mais antiga de uma postagem no início da exportação é considerada a data externa do último registro. Datas provenientes de qualquer outra fonte são metadados fornecidos.

Manifesto e pontos de verificação#

O `manifest.json` inclui o formato, a hora de exportação, a chave pública, a impressão digital, o comprimento do diário, o hash do cabeçalho, o escopo, o produtor, as limitações e o SHA-256 de cada membro de conteúdo, exceto os próprios manifest.json e manifest.sig. O `manifest.sig` é a assinatura base64 Ed25519 sobre o JSON do manifesto canônico. O verificador rejeita membros inesperados ou ausentes, nomes duplicados, arquivos corrompidos, sequência ou cadeia interrompida, assinaturas inválidas e incompatibilidade com um ponto de verificação fornecido. Ele nunca extrai caminhos de arquivos compactados. Ele limita o tamanho total declarado sem compactação a 4 GiB; --max-gib N permite arquivos maiores criados com um limite aumentado em Mais ferramentas → Parâmetros.

Um grande arquivo é verificado por vários processos ao mesmo tempo: os membros são submetidos a hash em paralelo, e, após os primeiros 5.000 registros, o hash de conteúdo e a assinatura de cada registro são verificados por processos de trabalho, enquanto o processo principal acompanha a cadeia, a cobertura e as ligações em ordem. --jobs N define o número de processos; o padrão auto usa um por CPU, no máximo 16, e --jobs 1 mantém tudo em um único processo. O resultado é o mesmo em ambos os casos, e uma alteração é recusada com a mesma mensagem. Os hashes nas posições indicadas pelos pontos de verificação retidos e pelas âncoras de carimbo de data/hora são mantidos durante essa única passagem, de modo que cada âncora é comparada sem a necessidade de ler o diário novamente. Em um computador com 32 threads, um arquivo de 10,8 GB com 400.000 registros levou 58,9 s em um único processo, 15,2 s com 4 e 8,4 s com 16; uma passagem pelos registros em ordem define, então, o limite.

Execute a verificação a partir da versão TgWitness instalada ou de um checkout revisado. A cópia incluída no arquivo permite o uso portátil; compare essa cópia com sua instalação confiável antes de executá-la.

Um ponto de verificação assina uma declaração contendo a chave pública, o comprimento do diário, o hash do cabeçalho e a hora de criação. Ele também transporta a rodada drand mais recente que o espaço de trabalho obteve (drand_anchor ): o coletor solicita um retransmissor drand por meio da rota externa do espaço de trabalho antes de cada ponto de verificação periódico; assim, Hide IP, proxies e uma rota externa desativada se aplicam, fazendo com que o próprio ponto de verificação nunca se conecte externamente. O verificador pode conferir se um arquivo posterior contém o mesmo prefixo. Com --checkpoint e --check-drand , ele confirma essa rodada com os retransmissores drand e relata que o ponto de verificação foi assinado não antes da hora da rodada; a rodada não altera o nível de garantia. Mantenha o ponto de verificação fora do coletor, para que a verificação posterior compare o arquivo com uma referência mantida separadamente dele. A chave do coletor o assina, de modo que vincula os registros a ele somente se o destinatário o tiver obtido antes do arquivo, por meio de outro canal; por si só, ele não atende ao mínimo exigido para servir como evidência.

Lendo um resultado de verificação#

O verificador relata a integridade do arquivo, a vinculação do signatário e as verificações de garantia separadamente. Uma assinatura válida indica que os bytes não sofreram alterações desde que foram assinados. O operador fornece a impressão digital da chave ao destinatário por meio de um canal separado. Sem --fingerprint, um arquivo intacto é aprovado nas verificações de assinatura e formato com signer_pinned: false, e a linha final começa com EVIDENCE: minimum not met · missing: confirmed signer key.

Para uma política automatizada de arquivamento local que exija um signatário fixado e o mínimo de evidências:

python -m tgwitness.verify evidence.zip --strict --json --fingerprint TRUSTED_KEY_SHA256 --tsa-ca TSA-ROOT.pem --require evidence

Utilize uma impressão digital retida por meio do canal confiável do destinatário. Uma testemunha confiável também pode fixar o coletor por meio de um diário testemunhado consistente; forneça --witness, --witness-fingerprint e --require-witness. --strict encerra com status 2 para um signatário não fixado; um --require-tier ou --require evidence não atendido também encerra com status 2. --require evidence requer --fingerprint e tempo externo de um terceiro cobrindo o último registro. Leia signer_pinned, requirements_met e os resultados da garantia, não apenas o código de saída. A aquisição selada, por sua vez, usa seu verificador de atestado e a política aprovada para autenticar o resumo da aquisição.

Escopo da verificação#

A verificação analisa o arquivo e o modo de coleta utilizado para produzi-lo. Escolha o modo cujo limite de confiança corresponda ao caso e, em seguida, mantenha suas entradas de verificação.

Modo de coleta O que o verificador verifica Entradas de verificação e limite de confiança
Área de trabalho local Registrar assinaturas, cadeia de hash, manifesto e bytes de anexos A impressão digital do coletor é retida pelo destinatário, juntamente com a data e hora externas fornecidas por terceiros: recibos verificados de acordo com a RFC 3161 ou OpenTimestamps, ou postagens de testemunhas lidas em t.me. Os pontos de verificação e registros de testemunhas retidos servem como comprovantes de verificação
Espaço de trabalho local com uma testemunha independente As verificações do arquivo, além da conformidade com um prefixo de registro anterior mantido pela testemunha Impressão digital e registros da testemunha; o registro de controle de chaves do custodiante mostra quem detém a chave da testemunha. Com --channel https://t.me/s/…, as datas que o Telegram atribuiu às publicações fornecem um tempo externo
Captura do GitHub Actions Atestado no GitHub do resumo do arquivo, do fluxo de trabalho aprovado e dos commits do coletor, do executador hospedado, da origem recente da sessão/chave e da integridade interna do arquivo Política de verificador confiável, repositório de chamadores e pacote de atestados do GitHub; a coleta é executada sob o fluxo de trabalho fixado
Implantação na nuvem Registros do ciclo de vida e de acesso do provedor, estado do firewall e do Cloudflare, além do registro de execução assinado pelo coletor Consultas somente de leitura ao provedor e à Cloudflare; a disponibilidade de verificações individuais depende do provedor
VM confidencial Intel TDX Citar a assinatura e o status da plataforma, vinculando-os à declaração do coletor, à composição e às medições do sistema operacional Cadeia de confiança da Intel e métricas de implantação esperadas; mantenha os resultados de todas as verificações TDX exigidas

Na aquisição selada, o coletor aprovado recebe dados por meio de uma conexão autenticada do Telegram dentro do ambiente verificado. O atestado vincula o arquivo a essa execução, de modo que a verificação abrange tanto a aquisição quanto a integridade posterior do arquivo. Isso depende do código aprovado e da cadeia de confiança da plataforma listada acima. A verificação de captura do GitHub requer uma sessão criada dentro da execução e rejeita capturas de sessões importadas.

O recibo de execução registra a versão do coletor, os hashes dos arquivos e as configurações de inicialização. A proveniência do GitHub e as medições TDX fornecem as verificações de ambiente; o registro de validação identifica as configurações testadas.

De onde vêm as mensagens#

O Telegram entrega mensagens a todos os clientes, incluindo os aplicativos oficiais, por meio de uma sessão MTProto. A chave de autorização da sessão é negociada com base na chave fixa do servidor do Telegram, e cada atualização chega criptografada e com sua integridade verificada por meio dessa chave. O coletor recebe mensagens por meio da sessão autenticada da conta e registra cada observação no diário à medida que ela chega, com os identificadores do chat, da mensagem e do remetente, além da data definida pelo Telegram para cada mensagem. No GitHub , nas implantações do Actions e do Intel TDX, o atestado também vincula essa sessão e a chave de assinatura à execução aprovada do coletor.

O diário registra a origem da chave de autorização. O login por telefone ou QR, ou um login independente a partir de um arquivo de sessão, grava account.authorized com key_origin: "created"; a coleta em uma chave .session importada, TData ou JSON grava imported. Uma chave importada também existe independentemente de sua origem. Implantações atestadas recusam chaves importadas.

A origem de um registro no Telegram baseia-se na conexão autenticada da conta, nos registros de conexão e captura no diário, nos quadros MTProto capturados correspondentes às entradas do diário (tgwitness/forensics/), na data do Telegram de cada mensagem e, no caso de captura atestada, no ambiente de execução verificado. As assinaturas de arquivo preservam esse registro para verificação posterior. Os pontos de verificação retidos definem os limites anteriores do diário, os registros de cobertura mostram os resultados da coleta e os carimbos de data e hora externos verificados situam os bytes confirmados no tempo.

Para um espaço de trabalho local, o destinatário fornece entradas confiáveis do coletor ou da testemunha. Para aquisição selada, a política confiável e o atestado vinculam o resumo do arquivo à execução aprovada do coletor. Esses são caminhos de verificação diferentes; relate as verificações concluídas para o caminho selecionado.

Anexos#

Os arquivos são identificados por SHA-256 na pasta media/. Um evento media.saved vincula um hash e o comprimento em bytes a um evento de mensagem específico. Os nomes dos arquivos brutos são metadados, nunca caminhos locais. Os bytes de mídia são baixados de forma assíncrona; portanto, a exclusão imediata pode impedir a captura. A coleta desativada, arquivos com tamanho excessivo ou desconhecido, falhas no download e downloads interrompidos são exibidos como resultados. Uma falha no processo pode deixar arquivos parciais sem referência; eles não são incluídos nas exportações.

O exportador ZIP verifica os arquivos de mídia armazenados em relação aos seus nomes. As exportações em JSONL, CSV e HTML verificam as assinaturas dos eventos, mas não incluem os bytes de mídia. Os relatórios derivados são recursos de conveniência; o arquivo events.jsonl é a representação oficial dos eventos.

Uma exportação completa do chat salva os anexos, de acordo com as configurações de anexos do espaço de trabalho, na pasta media/, nomeados como SHA-256. Cada registro de mensagem em chat.json indica o nome do arquivo (file, file_sha256) ou o motivo de sua ausência (file_status), juntamente com o que o leitor viu ao redor do texto: links atrás do texto, origem do encaminhamento, botões de bot, assinatura, visualizações e o temporizador de exclusão automática. verify.py verifica se todos os arquivos nomeados estão no manifesto assinado sob aquele hash.

Recibos de coleta e processamento duradouros (0,2)#

Uma tarefa de mídia e seu evento de mensagem são confirmados em uma única transação. A tarefa armazena o descritor original da mensagem do Telegram; a observação assinada vincula seu SHA-256, conta e política de tamanho. A recuperação verifica essa vinculação antes do download. Ela nunca busca a mensagem atual e substitui silenciosamente por um anexo mais recente. Tarefas interrompidas são repetidas, enquanto a falha permanente permanece como um resultado explícito.

Cada espaço de trabalho possui seu próprio diário e identidade de assinatura. Um evento `process.started` inclui um ID de execução, relógios locais, versões de dependências, hashes de arquivos-fonte, conta/escopo inicial, e configurações de captura. Os heartbeats incluem o ID de execução, o tempo monotônico e o estado da fila. O comprovante de execução também pode ser baixado como um documento assinado separadamente. Para verificação do ambiente de execução, combine-o com o atestado do GitHub ou as verificações TDX descritas no escopo de verificação .

Pontos de verificação automáticos são retidos localmente na inicialização, a cada cinco minutos durante a observação (Mais ferramentas → Parâmetros → Ponto de verificação assinado a cada) e na parada ordenada. A verificação de inicialização e a exportação comparam o diário com o ponto de verificação local mais recente retido. Isso permite detectar um revertimento do banco de dados quando o ponto de verificação sobrevive. A retenção independente mantém essa referência disponível fora do espaço de trabalho; um carimbo de data e hora externo verificado, além disso, a fixa no tempo.

Após uma reinicialização, a posição salva da atualização do Telegram é retomada (catch_up_from em observation.started) e as atualizações perdidas são solicitadas. A posição salva abrange apenas as atualizações cujo processamento foi concluído; portanto, as atualizações que ainda estavam pendentes quando a conexão foi encerrada ou o processo foi interrompido são solicitadas novamente. Uma verificação periódica registra message.recovered a presença de mensagens perdidas e message.missing_on_recheck quando o Telegram não retorna mais uma mensagem salva; este último caso não constitui um aviso de exclusão e não indica quem a excluiu nem a data ou hora.

Cópia e restauração externas (S3)#

A cópia externa (Configurações → Notificações e cópia externa → Cópia externa, ou Mais ferramentas → Extras → Evidências e backups; desativada por padrão) envia segmentos do diário, arquivos preservados, pontos de verificação com seus carimbos de data/hora e exportações de bate-papos concluídas para um armazenamento compatível com S3, criptografados com AES-256-GCM antes do envio, usando uma chave mantida no cofre do espaço de trabalho; a retenção do Object Lock se aplica quando o bucket oferece suporte a ela. Sem a chave baixada, a cópia não pode ser lida. Restaure e verifique com python -m tgwitness.replica restore --key-file KEY.json --out DIR.

A restauração requer um diretório comum vazio. Os arquivos baixados e os objetos descriptografados permanecem em um armazenamento temporário privado até que todo o diário e todos os pontos de verificação retidos sejam validados. Caminhos de objetos inseguros, intervalos de segmentos inconsistentes e diários com duração inferior a um ponto de verificação são rejeitados; em caso de falha na verificação, nenhum arquivo restaurado é publicado. As verificações de retenção comparam o modo Object Lock e a data retornados com o prazo enviado no momento do upload (tolerância de arredondamento de um segundo). Um prazo expirado, inválido ou reduzido não é considerado como verificado. O status informa o objeto amostrado cuja retenção foi lida para aquela passagem de upload.

Mídias locais ausentes ou corrompidas são relatadas como erro da passagem e mantêm o cursor de mídia antes delas, de modo que o arquivo seja tentado novamente na próxima passagem; os arquivos, pontos de verificação e exportações posteriores a elas ainda são copiados. A restauração verifica todas as referências de mídia preservadas em relação aos hashes descriptografados e aos tamanhos registrados. Segmentos idênticos e sobrepostos do diário provenientes de uploads interrompidos são desduplicados; sobreposições conflitantes são rejeitadas. Os pontos de verificação criados durante um upload são adiados até que os registros do diário a que se referem tenham sido copiados, de modo que uma passagem concluída não publique um ponto de verificação antes de seu diário.

Exportação contínua de instantâneos#

As exportações em tempo real utilizam um instantâneo de leitura estável do SQLite. Sua parte inicial pode ser mais antiga do que o diário ativo atual quando o download for concluído. Um ponto de verificação criado após esse instantâneo pode indicar corretamente que o arquivo é menor; compare com um ponto de verificação no prefixo exportado ou anterior a ele, e não com um ponto de verificação posterior arbitrário.

Preparação da RFC 3161 e verificação de respostas (0.2)#

O modo de evidência envia apenas o SHA-256 de cada ponto de verificação assinado às autoridades listadas na RFC 3161 e aos calendários do OpenTimestamps, pela rota do espaço de trabalho e nunca pelo MTProxy. Os carimbos de data e hora estão ativados por padrão em todas as metas de configuração; a evidência para um caso também registra o drand. As respostas são mantidas em checkpoints/anchors/, exportadas como .tsr e .ots arquivos em anchors/, e verificadas pelo verify.py (--tsa-ca verifica a assinatura TSA; confirma as provas do OpenTimestamps com ots upgrade e ots verify).

Uma autoridade RFC 3161 que falha duas vezes seguidas aguarda antes da próxima tentativa: um intervalo, depois dois, quatro e assim por diante até seis horas, ou pelo tempo que seu Retry-After determinar, até um dia. Uma verificação que encontra apenas autoridades em espera não grava nenhum registro; caso contrário, anchor.completed as lista sob deferred com retry_at. Até que respondam novamente, o painel exibe os carimbos de data/hora como Degradado.

O painel prepara um arquivo de solicitação contendo bytes canônicos do checkpoint.json, uma impressão da mensagem SHA-256 e um nonce aleatório no timestamp.tsq, somas de verificação e instruções. Nenhuma solicitação de rede é feita; o token que a autoridade retorna para esta solicitação é o timestamp.

python -m tgwitness.anchor verify confere a resposta com os bytes do ponto de verificação e a solicitação original, sem OpenSSL. É preciso indicar explicitamente um arquivo de CA confiável; os certificados incluídos não são considerados confiáveis automaticamente. Na CLI a verificação da solicitação é opcional, então guarde a solicitação e passe --request para verificar o nonce. O resultado informa se ela foi verificada. A assinatura do ponto de verificação do coletor e o diário ainda precisam ser verificados separadamente com a impressão digital confiável do coletor.

A verificação checa a assinatura da resposta, os bytes do ponto de verificação e, quando fornecida, a solicitação original sob a confiança da CA especificada. Para carimbos de data e hora obtidos no modo de evidência, o verify.py também verifica as evidências OCSP ou CRL armazenadas (revogação do certificado de assinatura). Consulte o procedimento e os resultados da validação.

Registros opcionais no modo de evidência: dispositivos drand e Telegram#

Mais dois registros podem ser executados nas mesmas passagens que os carimbos de data e hora. Ambos entram em vigor apenas enquanto o modo de evidência estiver ativado. As evidências de um caso ativam o drand; caso contrário, ambos ficam desativados. Alterne entre eles em Mais ferramentas → Extras → Evidências e backups → Mais testemunhas · opcional, ou "drand": true e "devices": true em POST /api/evidence. Uma falha não interrompe o outro nem os carimbos de data/hora; o painel exibe o resultado mais recente de cada um abaixo do formulário.

drand (beacon.drand ). Cada passagem grava a rodada mais recente da drand quicknet, a aleatoriedade pública da League of Entropy (uma rodada a cada 3 segundos), no diário: chain , round , randomness , signature , round_time e o relay que respondeu. Uma rodada verificada e imprevisível fornece uma referência temporal inferior para o material subsequente vinculado por hash. Um carimbo de data/hora verificado em um ponto de verificação posterior fornece uma referência temporal superior. Essas verificações delimitam o material vinculado. O coletor consulta primeiro o drand.cloudflare.com e, em seguida, os retransmissores da Protocol Labs, por meio da rota do espaço de trabalho, com uma solicitação por passagem.

O verify.py verifica se cada valor aleatório corresponde ao SHA-256 de sua assinatura e se o tempo da rodada está correto, além de relatar as rodadas, o maior intervalo sem uma rodada e o atraso do relógio do coletor em relação ao drand. O --check-drand compara as rodadas com um relé da Cloudflare e um relé da Protocol Labs, todos eles ou uma amostra aleatória de 100 em um diário extenso; uma rodada que apresentar divergência falha na verificação.

Dispositivos , Telegram, (account.devices). Cada passagem lê as sessões da conta com account.getAuthorizations; a lista Telegram exibida em Configurações → Dispositivos é registrada: na íntegra quando houver alteração desde a passagem anterior, com os hashes de sessão added e removed, caso contrário, apenas sua contagem e SHA-256. Modelo do dispositivo, plataforma, aplicativo e versão, data de criação e última atividade, país e região são mantidos; endereços IP não são, pois as exportações de evidências saem de seu controle. A própria sessão do coletor permanece ativa o tempo todo, portanto, apenas a atividade de outras sessões conta como uma alteração. O verify.py relata a frequência com que a lista foi registrada e cada sessão nova e encerrada. Ele lê a lista apenas enquanto a observação está em andamento.

O que eles mostram: o drand ordena os registros em relação ao tempo público, e a lista de dispositivos é a declaração do Telegram por meio do coletor, assinada pelo coletor como qualquer outro registro.

Log do Cloudflare Gateway (cloudflare.gateway_dns). Para um servidor que realiza a resolução por meio do Cloudflare Gateway ( Gateway DNS ), cada passagem copia o que o Gateway registrou desde a cópia anterior: um registro por janela de no máximo três horas com from, until, o location_id, o address do servidor quando houver um definido e o queries como [at, name, type, rcode, decision, colo], mesmo quando não houver nenhum. Configure-o em (log do Cloudflare Gateway) : conta, localização, endereço opcional e um token somente leitura (Leitura de Análise de Conta Analytics Read; Zero Trust PII Read para manter um endereço de uma localização compartilhada). O painel verifica esses dados com uma solicitação antes de salvar; o token permanece criptografado e nunca entra no registro. O verify.py lista as janelas, os nomes mais pesquisados e qualquer momento não coberto por nenhuma cópia; um registro cuja contagem não corresponda às suas consultas é rejeitado. Uma janela que contenha mais de uma página de consultas em um único segundo mantém essa página e indica que o restante está faltando. A cópia é a resposta da Cloudflare por meio do coletor, assinada pelo coletor; em até 24 horas, qualquer pessoa com um token somente leitura pode compará-la com a Cloudflare.