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

Canonical page: https://phishdestroy.io/tgwitness/ko/docs/reference/secret-chats/

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

[Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/)

[Documentation index](https://phishdestroy.io/tgwitness/ko/llms.txt)

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

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [문서](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md)

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

## 프로토콜 모듈

|  |  |
| --- | --- |
| 모듈 | `kiaro-telethon-secret-chat` 0.2.0 |
| 저자 | 키아로사마 |
| 라이선스 | GPL-3.0-or-later; 해당 라이선스의 `LICENSE` 그리고 `NOTICE` 저장된 아카이브 내에 그대로 유지 |
| 출처 | [KiaroSama/Telethon-Secret-Chat](https://github.com/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`](https://github.com/phishdestroy/TgWitness/commit/b35f8e18f3d13c329af12e0036f50e0c8f340a2c) , 릴리스 `b35f8e18f3d1-1ff85ec98bb2` , 버전 0.9.1 프리뷰에서 검증되었습니다. [불변](https://get.destroy.tools/releases/b35f8e18f3d1-1ff85ec98bb2/tgwitness-0.9.1-py3-none-any.whl) 휠과 그 종속성 잠금(dependency lock)은 SHA-256 및 RSA 릴리스 서명 검증을 통과했습니다. 패키지된 백엔드와 인터페이스는 해당 소스 리비전과 바이트 단위로 일치했습니다. 이 패키지에는 API 등록 및 수집기 후크도 포함되어 있습니다.

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

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

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

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

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

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

## 저장된 메시지 찾기

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

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

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

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

## 지속성 및 상호작용 제어

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

저널 기록에 실패한 복호화된 메시지는 재시도를 위해 볼트에 보관됩니다. 첨부 파일 크기와 사용 가능한 디스크 공간 확인으로 인해 다운로드가 보류되지만, 해당 작업은 유지됩니다. 이 모듈은 계정의 기존 연결을 재사용합니다. 읽기 및 입력 알림은 [‘상대방이 보는](https://github.com/phishdestroy/TgWitness/blob/main/docs/INVESTIGATION-MODE.md#what-the-other-side-sees) 내용’에서 선택한 대로만 전송되며, 스크린샷 알림은 절대 전송되지 않습니다. [secret_chats.py](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/secret_chats.py), [API 경로](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/api/secret_chats.py) 및 [접근 정책을](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/access.py) 참조하십시오.

[과거 감사](https://github.com/phishdestroy/TgWitness/blob/main/website/validation/audit/REPORT.md) 기록은 원래의 스냅샷 조사 결과를 그대로 유지합니다. 현재 가용성 및 구현 내용은 위의 패키지 개정판과 [현재 지원](https://github.com/phishdestroy/TgWitness/blob/main/docs/STATUS.md) 기능을 참조하십시오.

## 인터페이스 시연

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