TgWitness / 문서

테스트된 내용 →

참고 문헌 / 수집

Telegram · 비밀 채팅: 설정 및 기록

비밀 채팅 프로토콜 추가 구성 요소를 설치하고 계정별로 활성화한 뒤, TgWitness가 생성하거나 수락한 채팅을 기록하세요.

TgWitness / 문서

공개된 애플리케이션에는 시크릿 채팅 백엔드, 수집기 통합, API 경로 및 가짜 비밀 인터페이스. 프로토콜 라이브러리는 별도의 모듈입니다: open 가짜 비밀 그리고 누르세요 설치하고 켜기. 자동 수신 수락 기능은 사용자가 직접 켜기 전까지는 비활성화된 상태로 유지됩니다.

프로토콜 모듈#

모듈 kiaro-telethon-secret-chat 0.2.0
저자 키아로사마
라이선스 GPL-3.0-or-later; 해당 라이선스의 LICENSE 그리고 NOTICE 저장된 아카이브 내에 그대로 유지
출처 KiaroSama/Telethon-Secret-Chat 커밋 내역 d87bf037b90060383c7b704d8a06ebb98c621c6f
확인 SHA-256 c80feb9b5bc28201677c140d20930fbd730d7efdebb8ca789a19040c3f00ce5c 패키지 파일 목록과 각 파일의 SHA-256 값에 대해

설치 및 실행 기능은 주 관리자만 사용할 수 있습니다. TgWitness는 Telegram 외부 요청을 위한 작업 공간의 경로를 통해 GitHub에서 해당 커밋의 소스 아카이브를 다운로드하고, 패키지의 모든 파일을 TgWitness 릴리스에 고정된 값과 비교한 후, 아카이브를 modules/telethon-secret-chat-<commit>.zip 데이터 디렉터리에 저장한 후 메모리에서 코드를 불러옵니다. 재시작할 필요는 없습니다. 이 검사는 매번 시작 시마다 다시 실행되며, 차이가 있는 아카이브는 불러오지 않고 페이지에 해당 사실을 표시합니다. 패키지 파일이 변경되었거나 누락되었거나 추가된 경우 검사에 실패합니다.

이 모듈은 별도의 라이선스가 적용된 독립적인 작품입니다. TgWitness는 이 모듈을 기본으로 제공하지 않으며, 각 설치 시마다 작성자의 저장소에서 직접 다운로드합니다. 해당 페이지의 상세 정보에는 로드된 모듈, 작성자, 라이선스, 커밋 정보 및 SHA-256 값이 표시됩니다.

GitHub에 접근할 수 없는 호스트의 경우, 동일한 커밋을 Python 환경에 직접 설치할 수 있으며, 패널은 그 사본을 사용합니다:

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

TgWitness는 생성하거나 수락한 채팅의 엔드포인트가 됩니다. 이 도구는 메시지, 사용 가능한 첨부 파일, 타이머 변경 사항 및 삭제 알림을 서명된 저널에 기록합니다. 이전에 저장된 콘텐츠는 이후 삭제 알림이 발생하더라도 계속 사용할 수 있습니다.

패키지 이용 가능 여부#

8 년 11월 2026 일, 공개된 설치 프로그램 패키지는 소스 b35f8e18f3d1 , 릴리스 b35f8e18f3d1-1ff85ec98bb2 , 버전 0.9.1 프리뷰에서 검증되었습니다. 불변 휠과 그 종속성 잠금(dependency lock)은 SHA-256 및 RSA 릴리스 서명 검증을 통과했습니다. 패키지된 백엔드와 인터페이스는 해당 소스 리비전과 바이트 단위로 일치했습니다. 이 패키지에는 API 등록 및 수집기 후크도 포함되어 있습니다.

해당 패키지에는 프로토콜 라이브러리가 포함되어 있지 않았으며, 의존성 락에도 포함되어 있지 않습니다. secret-chats pyproject.toml의 extra 항목은 패널 버튼과 동일한 커밋을 고정합니다.

이 패키지 검사를 통해 어떤 파일과 종속성 선언이 포함되는지 확인합니다. 검증 기록은 개별 런타임 검사를 식별합니다. 지난 11월 6일 가이드에서는 개발용 스냅샷을 설명했으나, 더 이상 위의 패키지에 대해서는 설명하지 않습니다.

인터페이스를 사용하십시오#

‘Pseudo-secret’을 열고, 페이지에서 모듈을 제공하는 경우 이를 설치한 뒤, 해당 계정에 대해 활성화하고 연결하십시오. 자동 수락이 활성화되지 않은 경우, 수신 요청은 수락될 때까지 대기합니다. 시작, 수락, 전송 및 종료 시에는 계정의 상호작용 권한 및 읽기 전용 보호 기능이 적용됩니다.

조치 보존된 결과
사용자 이름 또는 사용자 ID로 채팅을 시작하세요 발신 요청; 피어는 자신의 기기에서 이를 수락합니다.
요청 수락 TgWitness가 수신 엔드포인트가 됩니다.
메시지 보내기 또는 받기 방향, 내용 및 지정된 타이머가 포함된 secret_chat.message.
파일 수신 SHA-256 및 secret_chat.file 영수증에 의해 저장된 복호화된 바이트; 증거 내보내기 파일에 포함됨.
타이머 또는 삭제 알림 수신 보관된 메시지와 파일과 별도로 기록된 작업 기록.
채팅 내용 검토 대화, 파일 수신 확인, 알림 및 키 시각화.

다른 기기에 있는 기존 비밀 채팅은 해당 기기 고유의 키를 유지합니다. 가져온 클라우드 세션은 이러한 키를 전송하지 않습니다. 비밀 채팅 키 자료와 카운터는 워크스페이스 볼트를 사용하며, 보존된 메시지와 복호화된 파일은 일반 워크스페이스 저장소 보호 기능을 사용합니다.

저장된 메시지 찾기#

열린 채팅 창에서 메시지 검색 기능을 사용하여 대소문자를 구분하지 않고 정확한 문구를 찾을 수 있습니다. 검색 필드에서 이전 및 다음 버튼을 누르거나 Enter 키와 Shift+Enter 키를 누르면 일치하는 메시지 사이를 이동할 수 있습니다. 카운터는 메시지 수를 표시하며, 각 메시지에서 일치하는 첫 번째 문구가 강조 표시됩니다. Esc 키를 누르면 검색 내용이 지워집니다.

검색 기능은 주변 대화 내용, 저장된 파일 및 삭제 알림을 계속 표시합니다. 이 기능은 패널에 이미 불러온 기록을 검색합니다. 이전 기록이 남아 있는 경우, 패널에 해당 내용이 표시됩니다. ‘이전 기록 불러오기’를 선택하면 기록 내역이 확장되고 검색 결과가 업데이트되며, 현재 메시지는 그대로 유지됩니다.

동일한 작업 공간 내에서 채팅을 전환하더라도 각 채팅의 검색 기록은 유지됩니다. 패널을 잠그거나 작업 공간을 변경하면 해당 검색 기록이 지워집니다. 검색어는 페이지 메모리에만 저장되며, 브라우저 저장소에 저장되거나 API 쿼리로 전송되지 않습니다. 검색 시 텔레그램 메시지나 입력/읽음 알림이 전송되지 않습니다. 채팅 열기 및 기타 작업에 대해서는 기존 공개 설정에 따라 처리됩니다.

생성 보고서는 선택한 채팅의 보고서 범위를 유지하며, 화면상의 검색 기능은 내보내는 레코드를 자동으로 제한하지 않습니다. 보고서를 다운로드하기 전에 선택 범위를 미리 확인하십시오.

지속성 및 상호작용 제어#

통합된 구현은 중복 감지를 위해 내구성 있는 저널 조회 기능을 사용하며, 다운로드 실패 후 첨부 파일 작업을 보류 상태로 유지하고, 종료 처리를 다른 원격 작업과 동일한 상호작용 가드를 통해 라우팅합니다. 이는 지난 11월 6일 개발 스냅샷 감사에서 보고된 세 가지 경로를 대체합니다.

저널 기록에 실패한 복호화된 메시지는 재시도를 위해 볼트에 보관됩니다. 첨부 파일 크기와 사용 가능한 디스크 공간 확인으로 인해 다운로드가 보류되지만, 해당 작업은 유지됩니다. 이 모듈은 계정의 기존 연결을 재사용합니다. 읽기 및 입력 알림은 ‘상대방이 보는 내용’에서 선택한 대로만 전송되며, 스크린샷 알림은 절대 전송되지 않습니다. secret_chats.py, API 경로 및 접근 정책을 참조하십시오.

과거 감사 기록은 원래의 스냅샷 조사 결과를 그대로 유지합니다. 현재 가용성 및 구현 내용은 위의 패키지 개정판과 현재 지원 기능을 참조하십시오.

인터페이스 시연#

웹사이트 시나리오는 가상의 요청, 메시지 및 파일을 사용하여 패널 워크플로를 시연합니다. 이는 인터페이스 예시이며, 프로토콜 및 수집 검사에 대한 결과는 검증 기록에 날짜별로 별도로 기재되어 있습니다.