TgWitness / Documentação

O que foi testado →

Referência / Segurança e projeto

Telegram · Segurança e tratamento de dados

Modelo de ameaças, modelo de acesso, dados confidenciais em repouso, exposição de rede, importação de sessões e como relatar uma vulnerabilidade.

TgWitness / Documentação · Implantação e recuperação

Implantação e recuperação

Esta página descreve o acesso, o armazenamento e a proteção de rede em um espaço de trabalho local ou no servidor. Para coleta em um GitHub Runner ou em uma VM confidencial do Intel TDX, consulte os modos de verificação, que adicionam verificações do ambiente de coleta. Conexões de conta, notificações, carimbos de data/hora, cópias externas e testemunhas possuem suas próprias configurações de roteamento.

Área Em resumo
Acesso Chave de administrador, além de acesso restrito a contas/chats, sete permissões e sessões revogáveis; localhost por padrão
Segredos em repouso As configurações de sessão, par de API, chave de assinatura e proxy são criptografadas com Fernet
Mensagens e arquivos de mídia Arquivos no espaço de trabalho, protegidos por criptografia de disco ou volume e permissões de arquivo do host
Integridade Cadeia de hash SHA-256 e uma assinatura Ed25519 em cada registro
Tempo externo Os recibos da RFC 3161 e do OpenTimestamps, as publicações de testemunhas datadas pelo Telegram e o atestado do GitHub; pontos de verificação retidos, registros de testemunhas e medições do Intel TDX constituem verificações de apoio. O verificador informa quais condições de evidência são atendidas

Para relatórios de vulnerabilidades, consulte a política de segurança.

Nesta página

Modelo de acesso#

O token do painel principal concede controle total. Outras pessoas podem receber seu próprio acesso restrito: espaços de trabalho e chats selecionados, permissões, validade, restrições de IP, limites de login e sessões revogáveis. Um acesso restrito a um chat não pode realizar operações em todo o espaço de trabalho, mesmo que sua permissão esteja marcada. Cada espaço de trabalho possui seu próprio diário, cofre e chave de assinatura dentro de um único processo; a separação entre usuários no host é feita por meio de contas do sistema operacional.

O painel escuta no localhost por padrão. O login no navegador troca um token de acesso por uma credencial de sessão; o navegador o envia como um token de portador. Ele é mantido no sessionStorage, em vez de em um cookie de autenticação. Bloquear/sair limpa a sessão do navegador. Fechar o navegador ou encerrar uma sessão não interrompe a coleta.

Os tokens emitidos e as credenciais de sessão são mantidos como hashes no cofre criptografado. A revogação encerra as sessões associadas; alterações de permissão afetam as solicitações subsequentes. Arquivos baixados não podem ser recuperados. O administrador também pode limitar suas próprias sessões de navegador, mas scripts que utilizam diretamente o token do painel principal mantêm acesso total e contornam esses limites de sessão do navegador.

A autenticação malsucedida é limitada por taxa por endereço do cliente. As restrições de IP utilizam o endereço percebido pelo aplicativo; verifique o comportamento do proxy reverso antes de confiar nele. As credenciais do Witness permanecem separadas como credenciais de verificação de integridade/ponto de verificação, apenas para leitura.

Acesso à demonstração#

/api/demo-access é um bootstrap deliberadamente não autenticado para uma demonstração sintética isolada e iniciada explicitamente. Ele emite uma capacidade válida apenas durante a vida útil do processo, nunca o token real do painel nem uma substituição do TGWITNESS_TOKEN. A emissão e o uso exigem um par de loopback e um Host, sem cabeçalhos encaminhados e sem solicitações entre origens. Espaços de trabalho adicionais ou uma sessão autorizada desativam esse caminho. Espaços de trabalho ativos nunca emitem essa capacidade. A demonstração não pode conectar contas nem alterar configurações de coleta.

Conteúdo dos painéis e exportações#

O painel não utiliza fontes externas, ferramentas de análise, recursos de CDN nem mídia remota incorporada. O texto proveniente do Telegram é inserido como texto, não como HTML. Os anexos baixados são fornecidos como anexos binários. As exportações em JSONL preservam as cadeias de caracteres originais; o HTML as escapa; as células CSV que poderiam se tornar fórmulas recebem um apóstrofo como prefixo.

As exportações excluem segredos de autenticação e assinatura, mas contêm deliberadamente metadados de origem coletados, identificadores e, possivelmente, conteúdo pessoal ou confidencial. Hashes de acesso ao Telegram e referências a arquivos podem estar presentes nos metadados de origem brutos.

Segredos em repouso#

As credenciais da API do Telegram, a sessão e a chave de assinatura são criptografadas com Fernet. Para mensagens e mídias locais, a criptografia é fornecida pelo disco ou volume do host; o espaço de trabalho armazena arquivos comuns. As exportações podem usar um ZIP AES-256 protegido por senha, e as cópias externas usam AES-256-GCM.

A chave do cofre é, por padrão, o diretório de dados protegidos. Use um arquivo externo de chave-mestra abaixo para armazená-la separadamente. No Unix, novos arquivos de chave privada usam o modo 0600 e novos diretórios de dados usam 0700; no Windows, defina a ACL do diretório para a conta de serviço e os administradores autorizados. As permissões existentes do diretório são mantidas.

Chave mestra externa#

Para um novo diretório de dados, TGWITNESS_VAULT_KEY_FILE pode fornecer uma chave mestra aleatória externa. O HKDF-SHA256 e um salt aleatório separado geram uma chave Fernet diferente para cada espaço de trabalho. O arquivo vault.external.json deve ser mantido para recuperação. Chaves-mestras ausentes ou incorretas resultam em falha. Cofres locais existentes não são migrados silenciosamente. O painel exibe o modo de armazenamento de chaves selecionado. A criptografia de disco protege as mensagens e os arquivos de mídia locais em ambos os modos; consulte “ conexão” e “proteção de dados” para detalhes de configuração.

Proxies e rotas de rede#

A configuração do proxy é criptografada no cofre. Senhas e segredos do MTProxy não são retornados pela API nem registrados nos registros de evidências. Cada espaço de trabalho escolhe sua rota do Telegram e um modo de IP.

A opção “Ocultar o endereço” desativa o fallback direto do Telegram e exige um proxy para solicitações HTTP externas. O modo de fallback explicitamente selecionado permite o acesso direto ao Telegram após um atraso; o modo túnel/VPN permite rotas diretas. A escolha do modo túnel não instala nem verifica uma VPN. Essas configurações não controlam todo o tráfego da máquina, navegadores, gerenciadores de pacotes ou a resolução de DNS do proxy local.

O MTProxy transporta apenas o tráfego do Telegram. Solicitações externas podem utilizar um proxy SOCKS5/HTTP separado, a rota SOCKS5/HTTP do espaço de trabalho ou uma rota direta permitida; elas também podem ser desativadas. A testemunha independente possui suas próprias configurações de transporte. A autenticação CONNECT padrão do SOCKS5/HTTP não é criptografada por esses próprios protocolos de proxy. Segredos TLS falsos do MTProxy continuam sem suporte.

Início de sessão e importação de sessões#

Os arquivos .tgwitness-session convertidos contêm um segredo de autorização em texto simples até que sejam carregados e armazenados no cofre. A CLI offline aceita esquemas Telethon revisados. A importação pelo painel aceita, além disso, Pyrogram SQLite, o moderno TData ZIP de conta única e entradas JSON documentadas. Ela é autenticada, limitada a quatro arquivos / 8 MiB, e processa os envios na memória sem extração do arquivo compactado nem salvamento dos arquivos originais. As credenciais normalizadas são retornadas apenas ao navegador autenticado solicitante; elas são salvas no cofre criptografado após a autorização bem-sucedida do Telegram. Proteja os arquivos originais e os convertidos e evite que clientes simultâneos clonem uma autorização.

O processamento de TData verifica somas de verificação de contêineres, hashes de descriptografia local e comprimentos de estrutura. Uma senha local fornecida para o Desktop é usada temporariamente e não é armazenada. O analisador limitado suporta os formatos do Desktop que valida e rejeita os demais. Imagens QR são geradas localmente, contêm tokens de login do Telegram de curta duração e nunca são enviadas a um serviço de renderização externo. Bloqueio, troca de área de trabalho, novo login e alterações de rota cancelam tentativas de QR pendentes. Recarregar/fechar uma aba pode deixar uma tentativa pendente até o vencimento. Um login por QR bem-sucedido ainda exige a vinculação da conta. Os corpos de API comuns permanecem limitados a 16 KiB; a rota de importação autenticada aceita até 12 MiB de JSON codificado, aplicando separadamente o limite menor para o arquivo decodificado.

Códigos de login e senhas de verificação em duas etapas do Telegram não são armazenados. O estado do número de telefone/hash do código é mantido na memória durante a autorização. As sessões do Telegram concedem acesso à conta; nunca faça upload de um diretório de dados, sessão, token, chave do cofre ou chave de assinatura privada para o GitHub.

Registros e transporte#

A resposta padrão de validação da API é substituída para que não repita valores de credenciais. O registro de acesso do aplicativo está desativado. Não configure um proxy reverso para registrar cabeçalhos de autorização ou corpos de solicitação. O painel escuta no localhost; o acesso remoto ocorre por meio do túnel SSH fornecido, do Cloudflare Tunnel ou do Caddy HTTPS, de modo que tokens e segredos de login trafegam dentro do SSH ou TLS.

Integridade e tempo externo#

A verificação compara as assinaturas dos registros, a cadeia de hash, os anexos e o manifesto de exportação com a chave do coletor. Uma assinatura válida indica que os bytes não foram alterados desde que foram assinados. Cada espaço de trabalho cria sua chave de assinatura na primeira inicialização e exibe sua impressão digital no painel e em todas as exportações. O operador fornece a impressão digital ao destinatário por meio de um canal separado e --fingerprint fixa a chave.

Um registro alterado, inserido ou removido rompe a cadeia de hash ou uma assinatura, e o verificador sinaliza isso. Carimbos de data e hora externos e uma testemunha também fixam o diário fora do espaço de trabalho. Os gatilhos do SQLite na tabela do diário servem apenas para impedir que o aplicativo sobrescreva ou exclua um registro por engano. TGWITNESS_VAULT_KEY_FILE mantém a chave do cofre fora de uma cópia do diretório de dados.

Os recibos da RFC 3161 e do OpenTimestamps, bem como as postagens de testemunhas cujas datas o verificador obtém do Telegram, vinculam o prefixo do diário que abrangem a um horário definido por um terceiro. Uma rodada drand registrada no diário demonstra que os registros posteriores a ela foram criados não antes da publicação dessa rodada. Um atestado verificado do GitHub também contém o horário verificado de sua assinatura, o que vincula todo o arquivo a um horário externo. Um ponto de verificação é assinado com a chave do coletor e vincula os registros até ele a partir do momento em que o destinatário o obteve, por meio de outro canal. Uma testemunha mostra que uma segunda chave reteve o cabeçalho do diário; o registro de controle de chaves do custodiante mostra quem detém essa chave. Ambos são verificações de apoio; o mínimo exigido é a hora de um terceiro. A captura do GitHub Actions ou uma implantação do Intel TDX adicionam a proveniência do fluxo de trabalho ou medições de hardware do ambiente de coleta.

Cada resposta de verificação lista as condições de evidência com a forma como cada uma foi verificada, agrupadas por sua função no mínimo:

Função Condição
Obrigatório Integridade; chave do signatário fixada com --fingerprint; tempo externo abrangendo o último registro (recibo RFC 3161 verificado com --tsa-ca, recibo OpenTimestamps confirmado com --check-bitcoin, postagem da testemunha lida em t.me com --channel, selo Bitcoin da testemunha ou atestado do GitHub verificado)
Compatível, mas não faz parte do mínimo Testemunha com chave própria; ponto de verificação retido; execução de coleta atestada

O mínimo exigido como evidência é que todas as três condições necessárias sejam atendidas no último registro exportado; uma execução de coleta verificada e atestada adiciona o attested perfil. A linha final indica o resultado, e a resposta especifica as opções que atenderiam às condições ausentes. Sem --fingerprint a linha final começa com EVIDENCE: minimum not met · missing: confirmed signer key. Quando os carimbos de data/hora verificados abrangem apenas registros anteriores, a resposta indica o registro até o qual o mínimo se mantém válido. --require evidence ou --require attested encerra com o código 2 quando o perfil não é alcançado para toda a exportação, e uma verificação solicitada na linha de comando que não pode ser executada é relatada como não realizada com o mesmo código. Cada relatório apresenta as mesmas condições com seu estado naquela cópia e o comando que as verifica . Os níveis de garantia e --strict permanecem disponíveis; o formato de evidência lista as verificações para cada modo de coleta.

Caso suspeite de algum problema#

Preserve o diretório de dados original e utilize uma cópia separada para análise. Relate a versão afetada, a operação e as etapas reproduzíveis por meio da política de segurança, mantendo os dados da conta e as credenciais em sigilo.