문서 / 14
Telegram · 보안을 유지하세요
무엇이 컴퓨터 밖으로 나가는지, 각 비밀 값이 무엇을 여는지, 보호 장치가 다루는 것과 귀하가 책임질 것.
모든 정보가 모여 있는 곳
수집기, 패널, 모든 기록은 귀하의 컴퓨터에 남습니다. 기본적으로 텔레그램에만 연결하며, 나머지는 모두 별도의 스위치입니다.
- 텔레그램항상 · 귀하의 경로를 통해
계정의 MTProto 연결 방식: 직접 연결, SOCKS5, HTTP 또는 MTProxy. IP 숨기기 모드는 작동하는 프록시를 기다립니다. 직접 연결로 자동 전환하려면 이를 명시적으로 허용하는 모드가 필요합니다.
- 외부 사이트용 문구선택 사항 · 기본값은 비활성화됨
저널, 파일 및 체크포인트는 S3 호환 스토리지에 업로드되기 전에 AES-GCM으로 암호화됩니다. 암호화 키는 사용자가 직접 관리하며, 첨부 파일의 이름은 내용 해시가 아닌 키가 적용된 해시로 지정됩니다.
- 알림선택 사항 · 기본값은 비활성화됨
채팅 제목과 함께 문제점 및 변경 내역을 제공합니다. 메시지 발췌문은 사용자가 해당 기능을 활성화한 경우에만 전송됩니다.
- 타임스탬프 신뢰성선택 사항 · 기본값은 비활성화됨
서명된 체크포인트의 SHA-256 해시값과 무작위 논스(nonce)만 포함됩니다. 메시지나 채팅 이름은 포함되지 않습니다.
- 위트니스선택 사항 · 기본값은 비활성화됨
읽기 전용 토큰을 사용하여 서명된 체크포인트와 캡처 카운터를 가져옵니다. 대화 내용을 읽거나 설정을 변경할 수는 없습니다.
기본 설정: 텔레그램 연결만 이 기기를 통해 이루어집니다.
각 비밀이 열어주는 것
| 비밀 | 보관 위치 | 이 도구가 제공하는 이점 | 유출될 경우 |
|---|---|---|---|
| 패널 토큰 | 데이터 디렉터리의 panel-token.txt, 브라우저는 탭마다 보관합니다 | 모든 작업 공간의 모든 것 | TgWitness를 멈추고, panel-token.txt를 지우고, 다시 시작: 새 토큰이 생깁니다 |
| 텔레그램 세션 | Vault, 암호화됨 (credentials.enc) | 텔레그램 계정 자체 | 텔레그램에서 [설정] → [기기]로 이동하여 세션을 종료하세요. |
| 서명 키 | Vault, 암호화됨 (signing.enc) | 귀하의 지문으로 기록에 서명하기 | 다른 곳에 보관한 체크포인트, 증인, 타임스탬프가 이전에 있던 것을 여전히 보여 줍니다 |
| 볼트 키 | 데이터 옆의 vault.key 또는 외부 마스터 키 | 볼트 | 세션과 서명 키도 유출되었다고 가정하십시오 |
| Witness 토큰 | witness 호스트에서 | 읽기 전용: 체크포인트와 상태 | 증인 페이지에서 삭제하고 새로 만듭니다 |
| 외부 사이트용 카피 키 | Vault; 복구를 위해 한 번만 다운로드하세요 | 오프사이트 사본 | 버킷까지 가진 사람은 복호화할 수 있습니다: 사본이 노출된 것으로 취급하십시오 |
보호 대상 범위
포함
- 기록 변경, 삭제, 순서 바꾸기: 해시 체인이나 서명이 깨집니다.
- 다른 곳에 체크포인트를 저장한 뒤 저널을 잘라 내거나 다시 만든 경우: 체크포인트가 더 이상 일치하지 않습니다.
- 토큰 추측: 256비트 난수, 상수 시간 비교, 1분에 15번 실패하면 주소가 차단됩니다.
- 악의적인 채팅 내용: 텍스트는 항상 텍스트로 남고 HTML이 되지 않으며, 첨부 파일은 파일로 다운로드되고, 패널은 다른 사이트에서 아무것도 불러오지 않습니다.
- 외부 볼트 키를 쓰는 상태에서 데이터 디렉터리를 도난당한 경우: 세션과 키는 암호화된 채로 남습니다.
, 여러분께 맡깁니다
- 메인 토큰은 무엇이든 할 수 있습니다. 다른 사람에게는 범위가 제한된 액세스를 주고, 메인 토큰은 혼자 가지십시오.
- 지문과 체크포인트는 다른 곳에 보관하십시오.
- 디스크를 암호화하고 권한을 좁히십시오.
- localhost 밖에서 일반 HTTP를 쓰면 토큰이 샙니다. HTTPS나 SSH 터널을 사용하십시오.
- 범위에 공백이 있는지 확인하고 귀하의 계정과 소스에서 전달을 테스트하십시오.
권한, 만료, 세션 제한을 두고 사건 액세스를 공유합니다.
설치 환경 강화
- 전용 텔레그램 계정을 사용하십시오. 주 계정은 절대 쓰지 마십시오.
- 패널은 127.0.0.1에 유지하십시오. 원격 액세스는 HTTPS(내장 Caddy)나 SSH 터널로만.
- 디스크를 암호화하십시오. 데이터 디렉터리가 있는 디스크입니다.
- 데이터 디렉터리를 제한하십시오. 서비스 계정만 접근하도록(Unix에서는 0700, Windows에서는 폴더 권한).
- 서버에서는 볼트 키를 다른 곳에 두십시오: 처음 시작하기 전에
TGWITNESS_VAULT_KEY_FILE을 설정합니다. - 지문과 체크포인트를 저장하십시오. 다른 시스템에 두고, 증인은 다른 호스트에서 실행합니다.
data/, 세션,panel-token.txt또는 볼트 키를 GitHub이나 채팅방에 절대 업로드하지 마십시오.- 리버스 프록시에서는
Authorization헤더나 요청 본문을 기록하지 마십시오.
데이터를 잃지 않고 패널 토큰을 변경할 수 있나요?
예, 토큰은 패널만 엽니다. TgWitness를 멈추고, panel-token.txt를 지우고, 다시 시작하십시오. 저널, 세션, 키는 남습니다. TGWITNESS_TOKEN이 설정되어 있으면 파일보다 그 값이 우선합니다.
취약점 신고
GitHub의 Security → Report a vulnerability. 버전, 영향, 가짜 데이터로 만든 최소 재현을 포함하십시오. 자격 증명, 계정 폴더, 실제 증거는 절대 보내지 마십시오. 비공개 신고가 꺼져 있으면 익스플로잇 세부 정보 없이 비공개 채널을 요청하는 이슈를 여십시오.