Documentação / 12

Configure um bot do Witness

Permita que um processo separado verifique o registro e publique pontos de verificação assinados em seu canal.

Dois servidores, duas chaves de assinatura

HOST A / COLLECTORConta + registro

Chave de assinatura do Coletor de sessões do Telegram

Endpoint de ponto de verificação somente leitura

← solicitar resposta assinada →

HOST B / WITNESSVerificar + reter

Impressão digital fixada do coletor; Chave de assinatura separada da testemunha

Registro próprio + token do bot

Witness → API do bot do Telegram →Seu canal · publicações assinadas com TGW1

O “witness” realiza as verificações por conta própria. O acesso do coletor é somente para leitura. A publicação pelo bot utiliza a conexão e o token do “witness”; nenhuma sessão de conta é concedida ao “witness”.

03 / DECISÕES DE CHECKPOINTRespostas ilustrativas

ÚLTIMA ACEITAÇÃO120 registroshead 9c7d…

PRÓXIMA RESPOSTA128 registroshead a4f2…

Aceito: a contagem aumenta, a assinatura é verificada e a chave corresponde. A testemunha mantém esse novo limite.

Todos os exemplos de respostas pressupõem uma assinatura válida e a chave fixada. Os hashes aqui apresentados são ilustrações abreviadas. Uma contagem maior, por si só, não pode provar que todo o prefixo antigo permanece inalterado; compare uma exportação com pontos de verificação retidos.

Prepare um bot e um canal

Crie um bot com o BotFather e permita que ele publique em um canal sob seu controle. Escolha um computador ou servidor para o TgWitness. Um host e um operador independentes proporcionam maior independência do que um segundo processo no servidor do coletor.

Três etapas em “Extras”

Acesso somente para leitura. Abra “Extras” → Um bot no seu canal, crie um token de testemunha e salve o arquivo de acesso. Ele permite a leitura de pontos de verificação e do estado de integridade, mas não de conversas nem dos controles do coletor.
Canal e intervalo. Insira o canal e um endereço de coletor acessível a partir do TgWitness. Salve o arquivo de configurações.
Inicialização. Coloque witness.json, witness-token.txt e um bot-token.txt criados no servidor do TgWitness juntos. Execute os comandos abaixo no ambiente do projeto instalado.

python -m tgwitness.witness run --config witness.json --check-config
python -m tgwitness.witness run --config witness.json

O download dos arquivos não inicia o witness. Verifique se a primeira postagem assinada aparece no canal e, em seguida, guarde separadamente a impressão digital da chave pública do witness.

Escolha a frequência de publicação

A publicação de cada verificação cria um registro externo regular. Em intervalos de cinco minutos, isso equivale a cerca de 288 postagens por espaço de trabalho por dia. As configurações avançadas também oferecem a publicação de alterações ou problemas, um proxy e um endereço personalizado da API do bot.

O que o bot, na verdade, atesta?

A testemunha solicita ao coletor um ponto de verificação assinado, verifica-o em relação à chave esperada e mantém um registro assinado separado. Ela registra respostas ausentes e respostas rejeitadas, bem como verificações bem-sucedidas. A publicação ainda depende da testemunha estar em execução e ter acesso à API de bots do Telegram.

Ele verifica o estado do registro relatado pelo coletor. Não monitora de forma independente todas as mensagens do Telegram. Para isso, adicione o teste de entrega controlada.

Verifique as evidências posteriormente

Mantenha o diário de evidências, as publicações do canal e as impressões digitais salvas de forma independente. O procedimento completo de verificação compara esses dados com a exportação assinada pelo coletor.