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.
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 está assinado
- Comparando exportações de bate-papos
- Transferência da investigação
- Trecho de transferência
- Relatórios legíveis
- Canonização de eventos
- Semântica do ator
- Cobertura: continuidade, lacunas e IDs não observados
- Produtor
- Perfis de pessoas
- Testemunha independente
- Manifesto e pontos de verificação
- Escopo da verificação
- Anexos
- Recibos de coleta e processamento duráveis (0.2)
- Preparação da RFC 3161 e verificação da resposta (0.2)
- Registros opcionais no modo de evidência: drand e dispositivos do Telegram
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#
- 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.
- 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.
- 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.
-
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 evidenceA 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 evidenceencerra 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 relatakey_pinned: trueecheckpoint_checked: truequando 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).- 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.tgwpwutiliza scrypt e AES-256-GCM e é aberto com o comandounseal-passworddo 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. - 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.
- 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
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.htmloumessages/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, chavesformat,report,seal): o selo assina o SHA-256 do JSON canônico doreport, 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 assinado2.25.240684792623320047764573196045913242332e 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 emTGWITNESS_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 emreport.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.startede 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.strictemobservation.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 pordeletion.unscopedcontagem 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.