TgWitness / Documentación

Lo que se ha probado →

Documentación / 14

Telegram · Mantenga la seguridad

Qué sale de su máquina, qué abre cada secreto y qué cubren las protecciones frente a lo que le toca a usted.

127.0.0.1Dirección del panel por defecto
256 bitstoken de panel aleatorio
0CDN, herramientas de análisis o fuentes remotas
Ed25519Firma en cada registro

Donde se encuentra todo

El recolector, el panel y cada registro se quedan en su máquina. Por defecto solo se contacta con Telegram; todo lo demás es un interruptor aparte.

06 / LO QUE SALE DE LA MÁQUINASu instalación
SU ORDENADOR O SERVIDOR
Panel127.0.0.1:8787 · token de portador
RecopiladorUn cliente de Telegram por espacio de trabajo
DIRECTORIO DE DATOS
RegistroSQLite · encadenado por hash · firmado
Medios de comunicaciónarchivos nombrados según SHA-256
VaultFernet · sesión, par de API, clave de firma, proxy
  • TelegramSiempre · a través de su ruta

    Conexión MTProto de la cuenta: directa, SOCKS5, HTTP o MTProxy. El modo «Ocultar IP» espera a que haya un proxy operativo. La conexión directa de reserva requiere un modo que lo permita explícitamente.

  • Texto externoOpcional · desactivado por defecto

    El registro, los archivos y los puntos de control se cifran con AES-GCM antes de subirlos a un almacenamiento compatible con S3. La clave la conserva usted; los archivos adjuntos se nombran mediante hash con clave, no mediante el hash de su contenido.

  • NotificacionesOpcional · desactivado por defecto

    Problemas y recuento de cambios con los títulos de los chats. Los extractos de los mensajes solo se envían si usted activa esta opción.

  • Autoridad de sellado de tiempoOpcional · desactivado por defecto

    Únicamente el SHA-256 de un punto de control firmado y un nonce aleatorio. Sin mensajes ni nombres de chat.

  • TestigoOpcional · desactivado por defecto

    Obtiene puntos de control firmados y contadores de capturas mediante un token de solo lectura. No puede leer conversaciones ni modificar la configuración.

Por defecto: solo la conexión a Telegram sale de este equipo.

Los destinos opcionales se configuran por espacio de trabajo.

Lo que cada secreto desvela

SecretoDónde se almacenaQué posibilidades ofreceEn caso de filtración
Token de panelpanel-token.txt en el directorio de datos; el navegador lo guarda por pestañaTodo en todos los espaciosDetenga TgWitness, borre panel-token.txt y arranque de nuevo: obtiene uno nuevo
Sesión de TelegramAlmacén cifrado (credentials.enc)La propia cuenta de TelegramFinalice la sesión en Telegram en Ajustes → Dispositivos
Clave de firmaAlmacén cifrado (signing.enc)Firmar registros con su huellaLos puntos de control guardados en otro sitio, un testigo y las marcas de tiempo siguen mostrando lo que existía antes
Clave de la bóvedavault.key junto a los datos o una clave maestra externaLa bóvedaDé por filtradas también la sesión y la clave de firma
Token de WitnessEn el servidor de TgWitnessSolo lectura: puntos de control y estadoBórrelo en la página del testigo y cree uno nuevo
Texto clave para uso externoVault; descárguelo una sola vez para poder recuperarloLa copia externaQuien tenga además el bucket puede descifrarla: considere la copia expuesta

Qué cubren las medidas de protección

Cubierto

  • Un registro cambiado, eliminado o reordenado: se rompe la cadena de hashes o una firma.
  • Un diario recortado o reconstruido después de guardar un punto de control en otro sitio: el punto de control deja de coincidir.
  • Adivinar el token: 256 bits aleatorios, comparación en tiempo constante; 15 fallos por minuto y la dirección queda bloqueada.
  • Contenido hostil en chats: el texto sigue siendo texto, nunca HTML; los adjuntos se descargan como archivos; el panel no carga nada de otros sitios.
  • Un directorio de datos robado con clave de bóveda externa: sesiones y claves siguen cifradas.

A su criterio

  • El token principal lo puede todo. Dé a otros acceso limitado y guárdese el principal.
  • Guarde la huella y los puntos de control en otro sitio.
  • Cifre el disco y restrinja los permisos.
  • HTTP plano fuera de localhost filtra el token. Use HTTPS o un túnel SSH.
  • Compruebe la cobertura en busca de huecos y pruebe la entrega en sus propias cuentas y fuentes.

Comparta el acceso a un caso con permisos, caducidad y límites de sesión.

Reforzar una instalación

  1. Use una cuenta de Telegram dedicada, nunca la principal.
  2. Mantenga el panel en 127.0.0.1. Acceso remoto solo por HTTPS (Caddy incluido) o túnel SSH.
  3. Cifre el disco con el directorio de datos.
  4. Restrinja el directorio de datos a la cuenta de servicio (0700 en Unix, permisos de carpeta en Windows).
  5. Guarde la clave de la bóveda aparte en servidores: defina TGWITNESS_VAULT_KEY_FILE antes del primer arranque.
  6. Guarde la huella y los puntos de control en otro sistema y ejecute un testigo en otro host.
  7. Nunca suba claves data/, de sesión, panel-token.txt o de bóveda a GitHub ni a un chat.
  8. No registre los encabezados «Authorization» ni los cuerpos de las solicitudes en un proxy inverso.
¿Puedo cambiar el token del panel sin perder datos?

Sí, solo abre el panel. Detenga TgWitness, borre panel-token.txt y arranque de nuevo. Diario, sesiones y claves se mantienen. Si TGWITNESS_TOKEN está definido, ese valor manda sobre el archivo.

Informar de una vulnerabilidad

Security → Report a vulnerability en GitHub. Versión, impacto y una reproducción mínima con datos ficticios. Nunca envíe credenciales, carpetas de cuentas ni evidencia real. Si el informe privado está desactivado, abra un issue pidiendo un canal privado, sin detalles del exploit.