TgWitness / Documentação

O que foi testado →

Documentação / 14

Telegram · Mantenha a segurança

O que sai da sua máquina, o que cada segredo abre e o que as proteções cobrem versus o que fica com você.

127.0.0.1endereço do painel por padrão
256 bitstoken de painel aleatório
0CDNs, análises ou fontes remotas
Ed25519assinatura em cada registro

Onde tudo está disponível

O coletor, o painel e todos os registros ficam na sua máquina. Por padrão, só o Telegram é contatado; todo o resto é uma chave à parte.

06 / O QUE SAI DA MÁQUINASua instalação
SEU COMPUTADOR OU SERVIDOR
Painel127.0.0.1:8787 · token bearer
Coletorum cliente do Telegram por espaço de trabalho
DIRETÓRIO DE DADOS
RegistroSQLite · encadeamento de hash · assinado
Mídiaarquivos nomeados por SHA-256
CofreFernet · sessão, par de API, chave de assinatura, proxy
  • TelegramSempre · por meio de sua rota

    A conexão MTProto da conta: direta, SOCKS5, HTTP ou MTProxy. O modo “Ocultar IP” aguarda um proxy em funcionamento. O recurso de fallback direto requer um modo que o permita explicitamente.

  • Texto externoOpcional · desativado por padrão

    O diário, os arquivos e os pontos de verificação são criptografados com AES-GCM antes do envio para um armazenamento compatível com S3. A chave permanece em seu poder; os anexos são nomeados por hashes chaveados, e não pelo hash de seu conteúdo.

  • NotificaçõesOpcional · desativado por padrão

    Problemas e contagem de alterações com títulos de bate-papo. Trechos de mensagens são enviados somente se você ativar essa função.

  • Autoridade de carimbo de data e horaOpcional · desativado por padrão

    Apenas o SHA-256 de um ponto de verificação assinado e um nonce aleatório. Sem mensagens, sem nomes de chat.

  • TestemunhaOpcional · desativado por padrão

    Oferece pontos de verificação assinados e contadores de captura por meio de um token somente leitura. Não é capaz de ler conversas nem alterar configurações.

Padrão: apenas a conexão com o Telegram sai desta máquina.

Os destinos opcionais são configurados por espaço de trabalho.

O que cada segredo revela

SecretoOnde está armazenadoO que isso possibilitaCaso haja um vazamento
Token do painelpanel-token.txt no diretório de dados; o navegador guarda por abaTudo em todos os espaçosPare o TgWitness, apague panel-token.txt e inicie de novo: você recebe um novo
Sessão do TelegramCofre, criptografado (credentials.enc)A própria conta do TelegramEncerre a sessão no Telegram em Configurações → Dispositivos
Chave de assinaturaCofre, criptografado (signing.enc)Assinar registros com a sua impressão digitalPontos de verificação guardados em outro lugar, uma testemunha e carimbos de tempo ainda mostram o que existia antes
Chave do cofrevault.key ao lado dos dados ou uma chave mestra externaO cofreConsidere que a sessão e a chave de assinatura também vazaram
Token WitnessNo servidor do TgWitnessSó leitura: pontos de verificação e estadoApague na página da testemunha e crie um novo
Texto para uso externoVault; baixe-o uma vez para recuperaçãoA cópia externaQuem também tiver o bucket pode descriptografar: considere a cópia exposta

O que as proteções abrangem

Abrangido

  • Um registro alterado, removido ou reordenado: a cadeia de hashes ou uma assinatura quebra.
  • Um diário cortado ou reconstruído depois que você guardou um ponto de verificação em outro lugar: o ponto deixa de bater.
  • Adivinhar o token: 256 bits aleatórios, comparação em tempo constante; 15 falhas por minuto e o endereço é bloqueado.
  • Conteúdo hostil nos chats: texto continua texto, nunca HTML; anexos são baixados como arquivos; o painel não carrega nada de outros sites.
  • Um diretório de dados roubado com chave de cofre externa: sessões e chaves continuam criptografadas.

Fica a seu critério

  • O token principal pode tudo. Dê aos outros acesso limitado e guarde o principal para você.
  • Guarde a impressão digital e os pontos de verificação em outro lugar.
  • Criptografe o disco e restrinja as permissões.
  • HTTP puro fora do localhost vaza o token. Use HTTPS ou um túnel SSH.
  • Confira a cobertura em busca de lacunas e teste a entrega nas suas próprias contas e fontes.

Compartilhe o acesso a um caso com permissões, validade e limites de sessão.

Reforçar a segurança de uma instalação

  1. Use uma conta do Telegram dedicada, nunca a principal.
  2. Mantenha o painel em 127.0.0.1. Acesso remoto só por HTTPS (Caddy incluso) ou túnel SSH.
  3. Criptografe o disco com o diretório de dados.
  4. Restrinja o diretório de dados à conta de serviço (0700 no Unix, permissões de pasta no Windows).
  5. Guarde a chave do cofre em outro lugar em servidores: defina TGWITNESS_VAULT_KEY_FILE antes da primeira inicialização.
  6. Guarde a impressão digital e os pontos de verificação em outro sistema e rode uma testemunha em outro host.
  7. Nunca envie chaves data/, de sessão, panel-token.txt ou do cofre para o GitHub ou para um chat.
  8. Não registre cabeçalhos Authorization nem corpos de solicitação em um proxy reverso.
É possível alterar o token do painel sem perder dados?

Sim, ele só abre o painel. Pare o TgWitness, apague panel-token.txt e inicie de novo. Diário, sessões e chaves continuam. Se TGWITNESS_TOKEN estiver definido, esse valor vale no lugar do arquivo.

Relatar uma vulnerabilidade

Security → Report a vulnerability no GitHub. Versão, impacto e uma reprodução mínima com dados fictícios. Nunca envie credenciais, pastas de contas ou evidências reais. Se o relato privado estiver desativado, abra uma issue pedindo um canal privado, sem detalhes do exploit.