TgWitness / Documentación

Lo que se ha probado →

Referencia / Recopilar

Telegram · Chats secretos: configuración y grabación

Instale el complemento del protocolo de chats secretos, actívelo por cuenta y grabe los chats que TgWitness crea o acepta.

TgWitness / Documentación

La aplicación publicada incluye el backend de «Charla secreta», la integración del colector, las rutas de la API y la interfaz de Pseudo-secret. La biblioteca de protocolos es un módulo independiente: abre Pseudo-secret, pulsa Instalar y actívalo. La aceptación automática de mensajes entrantes permanecerá desactivada hasta que la actives.

Módulo de protocolo#

Módulo kiaro-telethon-secret-chat 0.2.0
Autor KiaroSama
Licencia GPL-3.0 o posterior; su LICENSE y NOTICE permanecer dentro del archivo guardado
Fuente KiaroSama/Telethon-Secret-Chat en el commit d87bf037b90060383c7b704d8a06ebb98c621c6f
Comprobar SHA-256 c80feb9b5bc28201677c140d20930fbd730d7efdebb8ca789a19040c3f00ce5c sobre la lista de archivos de paquetes y sus propios valores SHA-256

La opción Instalar y activar está disponible para el administrador principal. TgWitness descarga el archivo fuente de esa confirmación desde GitHub a través de la ruta del espacio de trabajo para las solicitudes externas a Telegram, compara cada archivo del paquete con el valor establecido en la versión de TgWitness, guarda el archivo como modules/telethon-secret-chat-<commit>.zip en el directorio de datos y carga el código desde la memoria. No es necesario reiniciar. La comprobación se ejecuta de nuevo cada vez que se inicia el programa; si un archivo difiere, no se carga y la página lo indica. Un archivo del paquete modificado, que falte o que se haya añadido hace que la comprobación falle.

El módulo es una obra independiente con su propia licencia. TgWitness no lo incluye: cada instalación lo descarga del repositorio de su autor. En la página de detalles se muestra el módulo cargado, su autor, la licencia, el commit y el SHA-256.

Un administrador que no tenga acceso a GitHub puede instalar la misma confirmación en el entorno de Python ; a continuación, el panel utiliza esa copia:

python -m pip install ".[secret-chats]"

TgWitness se convierte en un punto final para los chats que crea o acepta. Registra mensajes, archivos adjuntos disponibles, cambios en el temporizador y avisos de eliminación en el registro firmado. El contenido guardado previamente sigue estando disponible tras un aviso de eliminación posterior.

Disponibilidad del paquete#

El 8 de noviembre de 2026 , se comprobó el paquete de instalación publicado en el código fuente b35f8e18f3d1 , la versión b35f8e18f3d1-1ff85ec98bb2 , versión 0.9.1 preview. El archivo wheel inmutable y su bloqueo de dependencias superaron la verificación de la firma de lanzamiento mediante SHA-256 y RSA. El backend y la interfaz empaquetados coincidían byte a byte con esa revisión del código fuente. El paquete también contiene el registro de la API y los hooks del recopilador.

Ese paquete no contenía la biblioteca de protocolos y no figura en el lock de dependencias. El secret-chats «extra» en pyproject.toml fija el mismo commit que el botón del panel.

Esta inspección del paquete determina qué archivos y declaraciones de dependencias se incluyen. El registro de validación identifica las comprobaciones de tiempo de ejecución independientes. La guía anterior del 6 de noviembre describía una instantánea de desarrollo; ya no describe el paquete mencionado anteriormente.

Utiliza la interfaz#

Abre Pseudo-secret, instala el módulo si la página lo ofrece, actívalo para la cuenta y conéctalo. Las solicitudes entrantes quedan en espera hasta que se acepten, a menos que se haya habilitado la aceptación automática. El inicio, la aceptación, el envío y el cierre utilizan los permisos de interacción de la cuenta y la protección de solo lectura.

Acción Resultado conservado
Iniciar un chat por nombre de usuario o ID de usuario Solicitud saliente; el par la acepta en su dispositivo.
Aceptar una solicitud TgWitness se convierte en el punto final receptor.
Enviar o recibir un mensaje secret_chat.message, con su dirección, contenido y temporizador asociado.
Recibir un archivo Bytes descifrados almacenados mediante SHA-256 y un recibo secret_chat.file; incluidos en la exportación de pruebas.
Recibir un aviso de temporizador o de eliminación Un registro de acciones independiente junto con los mensajes y archivos conservados.
Revisar el chat Conversaciones, acuses de recibo de archivos, notificaciones y visualización de claves.

Los chats secretos existentes en otro dispositivo conservan sus claves específicas de ese dispositivo. Una sesión en la nube importada no transfiere esas claves. El material de claves de los chats secretos y los contadores utilizan la bóveda del espacio de trabajo; los mensajes conservados y los archivos descifrados utilizan las protecciones normales de almacenamiento del espacio de trabajo.

Buscar mensajes guardados#

Utiliza la función Buscar mensajes dentro de un chat abierto para encontrar una frase exacta, sin tener en cuenta las mayúsculas y minúsculas. Las teclas Anterior y Siguiente, o «Intro» y «Mayús+Intro» en el campo de búsqueda, permiten desplazarse entre los mensajes que coinciden. El contador cuenta los mensajes; la primera frase coincidente de cada mensaje aparece resaltada. La tecla «Esc» borra la búsqueda.

La función de búsqueda mantiene visibles la conversación circundante, los archivos guardados y los avisos de eliminación. Busca entre los registros ya cargados en el panel. Cuando quedan registros anteriores, el panel lo indica; la opción Cargar registros más antiguos amplía el historial y actualiza los resultados de la búsqueda, al tiempo que mantiene el mensaje actual en su sitio.

Cada chat conserva su búsqueda aunque cambies de espacio de trabajo dentro del mismo. Al bloquear el panel o cambiar de espacio de trabajo, esas búsquedas se borran. Los términos de búsqueda permanecen en la memoria de la página y no se almacenan en el almacenamiento del navegador ni se envían como consultas a la API. La búsqueda no envía mensajes de Telegram ni notificaciones de escritura o lectura. La configuración de visibilidad existente sigue regulando la apertura de un chat y otras acciones.

El informe de compilación mantiene el ámbito del informe del chat seleccionado; una búsqueda en la vista previa no restringe de forma implícita los registros exportados. Previsualiza la selección del informe antes de descargarlo.

Controles de persistencia e interacción#

La implementación integrada utiliza la búsqueda en el diario duradero para la detección de duplicados, mantiene pendientes las tareas de adjuntar archivos tras una descarga fallida y canaliza el cierre a través del mismo control de interacción que otras acciones remotas. Estas sustituyen a las tres rutas señaladas en la auditoría histórica de la instantánea de desarrollo del 6 de noviembre.

Los mensajes descifrados cuya escritura en el registro falla se guardan en la bóveda para volver a intentarlo. Las comprobaciones del tamaño de los archivos adjuntos y del espacio libre en disco aplazan las descargas, aunque mantienen las tareas en curso. El módulo reutiliza la conexión existente de la cuenta. Las notificaciones de lectura y de escritura se envían únicamente según lo seleccionado en Lo que ve la otra parte; las notificaciones de capturas de pantalla nunca se envían. Véase secret_chats.py, las rutas de la API y la política de acceso.

La auditoría histórica conserva sus conclusiones originales de la instantánea. La disponibilidad y la implementación actuales deben consultarse en la revisión del paquete anterior y en las capacidades actuales.

Demostración de la interfaz#

El escenario del sitio web utiliza solicitudes, mensajes y archivos ficticios para demostrar el flujo de trabajo del panel. Se trata de un ejemplo de interfaz; las comprobaciones de protocolo y adquisición tienen sus propios resultados fechados en el registro de validación.