Referencia / Seguridad y proyecto
Telegram · Seguridad y tratamiento de datos
Modelo de amenazas, modelo de acceso, información confidencial en reposo, exposición de la red, importación de sesiones y cómo notificar una vulnerabilidad.
TgWitness / Documentación · Implementación y recuperación
Esta página describe el acceso, el almacenamiento y la protección de la red en un espacio de trabajo local o en un servidor. Para la recopilación en un GitHub Runner o en una máquina virtual confidencial de Intel TDX, consulta los modos de verificación, que añaden comprobaciones del entorno de recopilación. Las conexiones de cuentas, las notificaciones, las marcas de tiempo, las copias externas y los testigos tienen su propia configuración de enrutamiento.
| Área | En resumen |
|---|---|
| Acceso | Clave de administrador más acceso limitado a cuentas y chats, siete permisos y sesiones revocables; localhost por defecto. |
| Secretos en reposo | La sesión, el par de API, la clave de firma y la configuración del proxy se cifran con Fernet |
| Mensajes y archivos multimedia | Archivos del espacio de trabajo, protegidos mediante cifrado de disco o de volumen y permisos de archivo del host |
| Integridad | Cadena de hash SHA-256 y una firma Ed25519 en cada registro |
| Hora externa | Los recibos RFC 3161 y OpenTimestamps, las publicaciones de testigos fechadas por Telegram y la certificación de GitHub; los puntos de control conservados, los registros de testigos y las mediciones de Intel TDX constituyen comprobaciones de respaldo. El verificador informa de qué condiciones de evidencia se cumplen. |
Para informar sobre vulnerabilidades, consulte la política de seguridad.
En esta página
Modelo de acceso#
El token del panel principal otorga control total. Otras personas pueden recibir su propio acceso limitado: espacios de trabajo y chats seleccionados, permisos, caducidad, restricciones de IP, límites de inicio de sesión y sesiones revocables. Un acceso limitado a un chat no puede realizar operaciones en todo el espacio de trabajo, incluso si su permiso está marcado. Cada espacio de trabajo tiene su propio diario, almacén y clave de firma dentro de un único proceso; la separación entre los usuarios del host se basa en las cuentas del sistema operativo.
El panel escucha en localhost de forma predeterminada. Al iniciar sesión desde el navegador, se intercambia un token de acceso por una credencial de sesión; el navegador lo envía como un token de portador. Se almacena en sessionStorage en lugar de en una cookie de autenticación. Al bloquear la sesión o cerrarla, se borra la sesión del navegador. Cerrar el navegador o finalizar una sesión no detiene la recopilación.
Los tokens emitidos y las credenciales de sesión se almacenan como hash en la bóveda cifrada. La revocación pone fin a las sesiones asociadas; los cambios en los permisos afectan a las solicitudes posteriores. Los archivos descargados no pueden recuperarse. El administrador también puede limitar sus propias sesiones de navegador, pero los scripts que utilizan directamente el token del panel principal conservan acceso completo y eluden dichos límites de sesión del navegador.
Los intentos fallidos de autenticación están limitados por la dirección del cliente. Las restricciones de IP utilizan la dirección que ve la aplicación; compruebe el comportamiento del proxy inverso antes de basarse en él. Las credenciales de Witness siguen siendo credenciales independientes de solo lectura para el control de estado y el punto de control.
Acceso a la demostración#
/api/demo-access es un bootstrap deliberadamente no autenticado para una
demostración sintética aislada e iniciada explícitamente. Emite una capacidad independiente válida durante la vida útil del proceso,
nunca el token real del panel ni una sustitución de TGWITNESS_TOKEN. Su emisión y uso requieren un
par de bucle de retorno y un host, sin encabezados reenviados ni solicitudes de origen cruzado. Los
espacios de trabajo adicionales o una sesión autorizada desactivan esta vía. Los espacios de trabajo activos nunca emiten
dicha capacidad. La demostración no puede vincular cuentas ni modificar la configuración de recopilación.
Contenido de los paneles y exportaciones#
El panel no utiliza fuentes externas, herramientas de análisis, recursos CDN ni medios remotos incrustados. El texto procedente de Telegram se inserta como texto, no como HTML. Los archivos adjuntos descargados se sirven como archivos adjuntos binarios. Las exportaciones en formato JSONL conservan las cadenas originales; el HTML las escapa; a las celdas CSV que podrían convertirse en fórmulas se les antepone un apóstrofo.
Las exportaciones excluyen los secretos de autenticación y firma, pero contienen deliberadamente metadatos de origen recopilados, identificadores y, posiblemente, contenido personal o sensible. En los metadatos de origen sin procesar pueden aparecer hash de acceso a Telegram y referencias a archivos.
Secretos en reposo#
Las credenciales de la API de Telegram, la sesión y la clave de firma se cifran con Fernet. En el caso de los mensajes y archivos multimedia locales, el cifrado lo proporciona el disco o volumen del host; el espacio de trabajo almacena archivos normales. Las exportaciones pueden utilizar un ZIP AES-256 protegido con contraseña, y las copias externas utilizan AES-256-GCM.
La clave de la bóveda se establece por defecto en el directorio de datos protegidos. Utiliza un archivo externo de clave maestra como se indica a continuación para almacenarla por separado. En Unix, los nuevos archivos de clave privada utilizan el modo 0600 y los nuevos directorios de datos utilizan el modo 0700; en Windows, configura la lista de control de acceso (ACL) del directorio para la cuenta de servicio y los administradores autorizados. Se conservan los permisos existentes del directorio.
Clave maestra externa#
Para un nuevo directorio de datos, TGWITNESS_VAULT_KEY_FILE puede proporcionar una clave maestra aleatoria externa. HKDF-SHA256 y una sal aleatoria independiente derivan una clave Fernet diferente para cada espacio de trabajo. Se debe conservar el archivo vault.external.json para la recuperación. Si faltan o las claves maestras son incorrectas, el sistema no se inicia. Las bóvedas locales existentes no se migran de forma silenciosa. El panel muestra el modo de almacenamiento de claves seleccionado. El cifrado de disco protege los archivos de mensajes y multimedia locales en cualquiera de los dos modos; consulte « conexión» y «protección de datos » para obtener detalles sobre la configuración.
Proxies y rutas de red#
La configuración del proxy se cifra en el almacén de datos. Las contraseñas y los secretos de MTProxy no se devuelven a través de la API ni se registran en los registros de pruebas. Cada espacio de trabajo elige su ruta de Telegram y un modo de IP.
La opción «Ocultar la dirección» desactiva el acceso directo a Telegram y requiere un proxy para las solicitudes HTTP externas. El modo de acceso alternativo seleccionado explícitamente permite el acceso directo a Telegram tras un retraso; el modo túnel/VPN permite rutas directas. Al elegir el modo túnel no se instala ni se verifica ninguna VPN. Esta configuración no controla todo el tráfico del equipo, ni los navegadores, ni los gestores de paquetes, ni la resolución de DNS del proxy local.
MTProxy solo transmite tráfico de Telegram. Las solicitudes externas pueden utilizar un proxy SOCKS5/HTTP independiente, la ruta SOCKS5/HTTP del espacio de trabajo o una ruta directa autorizada; también pueden desactivarse. El testigo independiente cuenta con su propia configuración de transporte. La autenticación CONNECT habitual de SOCKS5/HTTP no está cifrada por dichos protocolos de proxy en sí mismos. Los secretos TLS falsos de MTProxy siguen sin ser compatibles.
Inicio de sesión e importación de sesiones#
Los archivos .tgwitness-session convertidos contienen un secreto de autorización en texto plano hasta que se cargan y se almacenan en la bóveda. La interfaz de línea de comandos (CLI) sin conexión acepta esquemas de Telethon revisados. Además, la importación a través del panel admite Pyrogram SQLite, el moderno formato ZIP de TData para una sola cuenta, y entradas JSON documentadas. Está autenticada, limitada a cuatro archivos / 8 MiB, y procesa las subidas en memoria sin necesidad de extraer el archivo ni guardar los archivos originales. Las credenciales normalizadas solo se devuelven al navegador autenticado que las solicita; se guardan en el almacén cifrado tras una autorización satisfactoria en Telegram. Proteja los archivos originales y los convertidos, y evite que clientes simultáneos clonen una autorización.
El procesamiento de TData verifica las sumas de comprobación de los contenedores, los hash de descifrado local y las longitudes de las estructuras. La contraseña local de Desktop facilitada se utiliza de forma transitoria y no se almacena. El analizador sintáctico limitado admite los formatos de Desktop que valida y rechaza los demás. Las imágenes QR se generan localmente, contienen tokens de inicio de sesión de Telegram de corta duración y nunca se envían a un servicio de renderización externo. El bloqueo, el cambio de espacio de trabajo, un nuevo inicio de sesión y los cambios de ruta cancelan los intentos de QR pendientes. Al recargar o cerrar una pestaña, puede quedar un intento pendiente hasta su caducidad. Un inicio de sesión con código QR correcto sigue exigiendo la vinculación de la cuenta. Los cuerpos de API ordinarios siguen limitados a 16 KiB; la ruta de importación autenticada acepta hasta 12 MiB de JSON codificado, aplicando por separado el límite más pequeño para el archivo decodificado.
Los códigos de inicio de sesión y las contraseñas de verificación en dos pasos de Telegram no se almacenan de forma permanente. El estado del número de teléfono o del hash del código se mantiene en memoria durante la autorización. Las sesiones de Telegram otorgan acceso a la cuenta; nunca suba un directorio de datos, una sesión, un token, una clave de almacén o una clave de firma privada a GitHub.
Registros y transporte#
La respuesta predeterminada de validación de la API se sustituye para que no repita los valores de las credenciales. El registro de acceso de la aplicación está desactivado. No configures un proxy inverso para registrar encabezados de autorización ni cuerpos de solicitud. El panel escucha en localhost; el acceso remoto se realiza a través del túnel SSH proporcionado, Cloudflare Tunnel o Caddy HTTPS, por lo que los tokens y las claves de inicio de sesión se transmiten dentro de SSH o TLS.
Integridad y tiempo externo#
Los controles de verificación comparan las firmas de los registros, la cadena de hash, los archivos adjuntos y el manifiesto de exportación
con la clave del recopilador. Una firma válida indica que los bytes no han sufrido cambios desde
que se firmaron. Cada espacio de trabajo crea su clave de firma al iniciarse por primera vez y muestra su
huella digital en el panel y en cada exportación. El operador facilita la huella digital al
destinatario a través de un canal independiente, y --fingerprint fija la clave.
Un registro modificado, insertado o eliminado rompe la cadena hash o una firma, y el
verificador lo notifica. Las marcas de tiempo externas y un testigo también fijan el diario fuera del
espacio de trabajo. Los disparadores de SQLite en la tabla del diario solo impiden que la aplicación
sobrescriba o elimine un registro por error. TGWITNESS_VAULT_KEY_FILE mantiene la clave de la bóveda
fuera de la copia del directorio de datos.
Los recibos RFC 3161 y OpenTimestamps, así como las publicaciones de testigos cuyas fechas lee el verificador desde Telegram, vinculan el prefijo del diario que abarcan a una hora establecida por un tercero. Una ronda «drand» inscrita en el diario demuestra que los registros posteriores a ella se crearon no antes de la publicación de dicha ronda. Una certificación de GitHub verificada también incluye la hora verificada de su firma, lo que vincula todo el archivo a una hora externa. Un punto de control se firma con la clave del recopilador y vincula los registros anteriores a él desde el momento en que el destinatario lo obtuvo, a través de otro canal. Un testigo demuestra que una segunda clave conservó el encabezado del diario; el registro de control de claves del custodio muestra quién posee esa clave. Ambos son comprobaciones de respaldo; el mínimo es la hora de un tercero. La captura de GitHub Actions o una implementación de Intel TDX añaden la procedencia del flujo de trabajo o mediciones de hardware del entorno de recopilación.
Cada respuesta de verificación enumera las condiciones de las pruebas junto con la forma en que se comprobó cada una de ellas, agrupadas según su función en el mínimo:
| Función | Condición |
|---|---|
| Requisitos | Integridad; clave del firmante fijada con --fingerprint; hora externa que abarca el último registro (recibo RFC 3161 comprobado con --tsa-ca, recibo de OpenTimestamps confirmado con --check-bitcoin, publicación del testigo leída desde t.me con --channel, sello de Bitcoin del testigo o certificación de GitHub comprobada) |
| Compatible, pero no forma parte de los requisitos mínimos | Testigo con su propia clave; punto de control conservado; ejecución de recopilación certificada |
El requisito mínimo para que se considere prueba válida es que las tres condiciones exigidas se cumplan en el último registro
exportado; una ejecución de recopilación verificada y certificada añade el attested perfil.
La última línea indica el resultado, y la respuesta enumera las opciones que cumplirían las
condiciones que faltan. Sin --fingerprint la línea final comienza con
EVIDENCE: minimum not met · missing: confirmed signer key.
Cuando las marcas de tiempo verificadas solo abarcan registros anteriores, la respuesta indica el registro hasta
el cual se cumple el mínimo. --require evidence O --require attested termina con el código 2 cuando
no se alcanza el perfil para toda la exportación, y una comprobación solicitada en la línea de
comandos que no se puede ejecutar se indica como no realizada con el mismo código. Cada informe
incluye las mismas condiciones con su estado en esa copia y el comando que las comprueba
. Los niveles de garantía y --strict siguen estando disponibles; el
formato de evidencia enumera las comprobaciones para cada modo de recopilación.
Si sospecha que hay algún problema#
Conservar el directorio de datos original y utilizar una copia independiente para el análisis. Informar de la versión afectada, la operación y los pasos reproducibles a través de la política de seguridad, manteniendo la privacidad de los datos de la cuenta y las credenciales.