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ê.
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.
- 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.
O que cada segredo revela
| Secreto | Onde está armazenado | O que isso possibilita | Caso haja um vazamento |
|---|---|---|---|
| Token do painel | panel-token.txt no diretório de dados; o navegador guarda por aba | Tudo em todos os espaços | Pare o TgWitness, apague panel-token.txt e inicie de novo: você recebe um novo |
| Sessão do Telegram | Cofre, criptografado (credentials.enc) | A própria conta do Telegram | Encerre a sessão no Telegram em Configurações → Dispositivos |
| Chave de assinatura | Cofre, criptografado (signing.enc) | Assinar registros com a sua impressão digital | Pontos de verificação guardados em outro lugar, uma testemunha e carimbos de tempo ainda mostram o que existia antes |
| Chave do cofre | vault.key ao lado dos dados ou uma chave mestra externa | O cofre | Considere que a sessão e a chave de assinatura também vazaram |
| Token Witness | No servidor do TgWitness | Só leitura: pontos de verificação e estado | Apague na página da testemunha e crie um novo |
| Texto para uso externo | Vault; baixe-o uma vez para recuperação | A cópia externa | Quem 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
- Use uma conta do Telegram dedicada, nunca a principal.
- Mantenha o painel em 127.0.0.1. Acesso remoto só por HTTPS (Caddy incluso) ou túnel SSH.
- Criptografe o disco com o diretório de dados.
- Restrinja o diretório de dados à conta de serviço (0700 no Unix, permissões de pasta no Windows).
- Guarde a chave do cofre em outro lugar em servidores: defina
TGWITNESS_VAULT_KEY_FILEantes da primeira inicialização. - Guarde a impressão digital e os pontos de verificação em outro sistema e rode uma testemunha em outro host.
- Nunca envie chaves
data/, de sessão,panel-token.txtou do cofre para o GitHub ou para um chat. - Não registre cabeçalhos
Authorizationnem 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.