# Telegram · 보안 및 데이터 처리

Canonical page: https://phishdestroy.io/tgwitness/ko/docs/reference/security/

위협 모델, 접근 모델, 저장된 기밀 정보, 네트워크 노출, 세션 가져오기 및 취약점 보고 방법.

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

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

위협 모델, 접근 모델, 저장된 기밀 정보, 네트워크 노출, 세션 가져오기 및 취약점 보고 방법.

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [문서](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [배포 및 복구](https://phishdestroy.io/tgwitness/ko/docs/reference/deployment/)

![배포 및 복구](https://phishdestroy.io/tgwitness/assets/chapter-operate.svg?v=7039a376d47f)

이 페이지에서는 로컬 또는 서버 작업 공간에서의 액세스, 저장 및 네트워크 보호에 대해 설명합니다. GitHub 러너 또는 Intel TDX 기밀 VM에서 수집하는 경우, 수집 환경에 대한 검사를 추가하는 [검증](https://phishdestroy.io/tgwitness/ko/docs/reference/evidence/#verification-scope)모드를 참조하십시오. 계정 연결, 알림, 타임스탬프, 오프사이트 사본 및 증인(witness)에는 각각 고유한 라우팅 설정이 있습니다.

| 분야 | 요약하자면 |
| --- | --- |
| 접근 | 관리자 키와 계정/채팅에 대한 범위 지정 액세스, 7가지 권한 및 취소 가능한 세션; 기본적으로 localhost 사용 |
| 저장된 비밀 | 세션, API 쌍, 서명 키 및 프록시 설정은 Fernet 알고리즘으로 암호화됩니다. |
| 메시지 및 미디어 | 워크스페이스 내의 파일은 호스트의 디스크 또는 볼륨 암호화 및 파일 권한으로 보호됩니다. |
| 무결성 | 모든 기록에 SHA-256 해시 체인과 Ed25519 서명이 적용됩니다. |
| 외부 시간 | RFC 3161 및 OpenTimestamps 영수증, 텔레그램이 날짜를 기록한 증인 게시물, GitHub 인증; 보존된 체크포인트, 증인 기록 및 Intel TDX 측정값이 검증 근거로 활용됩니다. 검증자는 어떤 증거 조건을 충족하는지 보고합니다. |

취약점 보고와 관련하여서는 [보안](https://github.com/phishdestroy/TgWitness/blob/main/.github/SECURITY.md)정책을 참조하십시오.

**이 페이지에서**

- [액세스 모델](https://phishdestroy.io/tgwitness/ko/docs/reference/security/#access-model)
- [패널 내용 및 내보내기](https://phishdestroy.io/tgwitness/ko/docs/reference/security/#panel-content-and-exports)
- [저장된 비밀](https://phishdestroy.io/tgwitness/ko/docs/reference/security/#secrets-at-rest)
- [프록시 및 네트워크 경로](https://phishdestroy.io/tgwitness/ko/docs/reference/security/#proxies-and-network-routes)
- [로그인 및 세션 가져오기](https://phishdestroy.io/tgwitness/ko/docs/reference/security/#sign-in-and-session-imports)
- [로그 및 전송](https://phishdestroy.io/tgwitness/ko/docs/reference/security/#logs-and-transport)
- [무결성 및 외부 시간](https://phishdestroy.io/tgwitness/ko/docs/reference/security/#integrity-and-external-time)
- [문제가 의심될 경우](https://phishdestroy.io/tgwitness/ko/docs/reference/security/#if-you-suspect-a-problem)

## 접근 모델

메인 패널 토큰은 전체 제어 권한을 부여합니다. 다른 사용자는 선택된 워크스페이스 및 채팅, 권한, 만료 기간, IP 제한, 로그인 횟수 제한 및 취소 가능한 세션과 같은 [범위 지정된 액세스](https://phishdestroy.io/tgwitness/ko/docs/reference/access/) 권한을 받을 수 있습니다. 채팅으로 제한된 액세스 권한을 가진 사용자는 권한이 설정되어 있더라도 전체 워크스페이스 작업을 수행할 수 없습니다. 각 워크스페이스는 하나의 프로세스 내에서 자체 저널, 볼트 및 서명 키를 갖습니다. 호스트 내 사용자 간의 분리는 운영 체제 계정을 통해 이루어집니다.

패널은 기본적으로 localhost에서 수신 대기합니다. 브라우저 로그인 시 액세스 토큰이 세션 자격 증명으로 교환되며, 브라우저는 이를 베어러 토큰으로 전송합니다. 이 토큰은 인증 쿠키가 아닌 sessionStorage에 저장됩니다. 잠금/로그아웃 시 브라우저 세션이 지워집니다. 브라우저를 닫거나 세션을 종료하더라도 데이터 수집은 중단되지 않습니다.

발행된 토큰과 세션 인증 정보는 암호화된 볼트에 해시 형태로 보관됩니다. 취소 시 관련 세션이 종료되며, 권한 변경 사항은 이후의 요청에 적용됩니다. 다운로드된 파일은 회수할 수 없습니다. 관리자는 자신의 브라우저 세션도 제한할 수 있지만, 메인 패널 토큰을 직접 사용하는 스크립트는 전체 액세스 권한을 유지하며 해당 브라우저 세션 제한을 우회합니다.

인증 실패 시 클라이언트 주소를 기준으로 속도 제한이 적용됩니다. IP 제한은 애플리케이션에서 인식하는 주소를 기준으로 하므로, 이를 신뢰하기 전에 리버스 프록시 동작을 확인하십시오. Witness 자격 증명은 별도의 읽기 전용 체크포인트/상태 확인 자격 증명으로 유지됩니다.

### 데모 이용

`/api/demo-access`는 명시적으로 시작된, 격리된 합성 데모를 위한 의도적으로 인증되지 않은 부트스트랩입니다. 이는 별도의 프로세스 수명 주기 내 기능을 발급하며, 절대 실제 패널 토큰이나 TGWITNESS_TOKEN 오버라이드를 발급하지 않습니다. 이 기능을 발급하고 사용하려면 루프백 피어와 호스트가 필요하며, 헤더 전달이나 크로스 오리진 요청은 허용되지 않습니다. 추가 워크스페이스나 인증된 세션이 있는 경우 이 경로는 비활성화됩니다. 활성 워크스페이스는 이 기능을 절대 발급하지 않습니다. 이 데모는 계정을 연결하거나 수집 설정을 변경할 수 없습니다.

## 패널 콘텐츠 및 내보내기

이 패널은 외부 폰트, 분석 도구, CDN 리소스 또는 임베드된 원격 미디어를 사용하지 않습니다. 텔레그램에서 가져온 텍스트는 HTML이 아닌 일반 텍스트로 삽입됩니다. 다운로드된 첨부 파일은 바이너리 첨부 파일로 제공됩니다. JSONL 내보내기에서는 원본 문자열이 그대로 유지되며, HTML 내보내기에서는 문자열이 이스케이프 처리되고, 수식이 될 수 있는 CSV 셀 앞에는 아포스트로피가 붙습니다.

내보낸 데이터에는 인증 및 서명 비밀 정보는 제외되지만, 수집된 원본 메타데이터, 식별자, 그리고 개인 정보나 민감한 내용이 의도적으로 포함됩니다. 원본 메타데이터에는 텔레그램 액세스 해시 및 파일 참조 정보가 포함될 수 있습니다.

## 저장된 비밀

텔레그램 API 인증 정보, 세션 및 서명 키는 Fernet으로 암호화됩니다. 로컬 메시지 및 미디어의 경우, 호스트의 디스크 또는 볼륨에서 암호화가 제공되며, 워크스페이스에는 일반 파일이 저장됩니다. 내보내기 시에는 암호로 보호된 AES-256 ZIP을 사용할 수 있으며, 오프사이트 사본에는 AES-256-GCM이 사용됩니다.

볼트 키는 기본적으로 보호된 데이터 디렉터리로 설정됩니다. 별도의 마스터 키 파일을 사용하여 별도로 저장하십시오. 유닉스 환경에서는 새로운 개인 키 파일에 모드 0600을, 새로운 데이터 디렉터리에 0700을 적용하십시오. 윈도우 환경에서는 서비스 계정 및 승인된 관리자를 대상으로 디렉터리 ACL을 설정하십시오. 기존 디렉터리 권한은 유지됩니다.

### 외부 마스터 키

새로운 데이터 디렉터리의 경우, TGWITNESS_VAULT_KEY_FILE을 통해 외부 무작위 마스터 키를 제공할 수 있습니다. HKDF-SHA256과 별도의 무작위 솔트를 사용하여 각 작업 공간마다 서로 다른 Fernet 키를 생성합니다. 복구를 위해 vault.external.json 파일을 반드시 보관해야 합니다. 마스터 키가 없거나 잘못된 경우 오류가 발생합니다. 기존 로컬 볼트는 자동으로 마이그레이션되지 않습니다. 패널에는 선택된 키 저장 모드가 표시됩니다. 두 모드 모두에서 디스크 암호화를 통해 로컬 메시지 및 미디어 파일이 보호됩니다. 설정에 대한 자세한 내용은 [연결 및 데이터 보호를](https://phishdestroy.io/tgwitness/ko/docs/reference/connection/) 참조하십시오.

## 프록시 및 네트워크 경로

프록시 구성 정보는 볼트에 암호화되어 저장됩니다. 비밀번호와 MTProxy 시크릿은 API를 통해 반환되거나 증거 기록에 기록되지 않습니다. 각 워크스페이스는 자신만의 텔레그램 경로와 [IP 모드를](https://phishdestroy.io/tgwitness/ko/docs/reference/connection/#ip-modes) 선택합니다.

**'주소 숨기기' 모드는** 텔레그램의 직접 폴백을 차단하며, 외부 HTTP 요청을 위해 프록시를 필요로 합니다. 명시적으로 선택한 폴백 모드는 지연 시간 후 텔레그램에 직접 접속할 수 있게 하며, 터널/VPN 모드는 직접 경로를 허용합니다. 터널 모드를 선택한다고 해서 VPN이 설치되거나 검증되는 것은 아닙니다. 이러한 설정은 모든 기기 트래픽, 브라우저, 패키지 관리자 또는 로컬 프록시 호스트의 DNS 확인을 제어하지 않습니다.

MTProxy는 텔레그램 트래픽만 처리합니다. 외부 요청은 별도의 SOCKS5/HTTP 프록시, 워크스페이스의 SOCKS5/HTTP 경로 또는 허용된 직접 경로를 사용할 수 있으며, 비활성화할 수도 있습니다. 독립적인 위트니스는 자체 전송 설정을 갖습니다. 일반적인 SOCKS5/HTTP CONNECT 인증은 해당 프록시 프로토콜 자체에 의해 암호화되지 않습니다. 가짜 TLS MTProxy 비밀 정보는 여전히 지원되지 않습니다.

## 로그인 및 세션 가져오기

변환된 .tgwitness-session 파일에는 볼트에 로드 및 저장될 때까지 평문 형태의 인증 비밀번호가 포함되어 있습니다. 오프라인 CLI는 검토를 거친 Telethon 스키마를 지원합니다. 패널 가져오기 기능은 Pyrogram SQLite, 최신 단일 계정 TData ZIP, 그리고 문서화된 JSON 입력도 추가로 지원합니다. 인증이 필요하며, 4개 파일 / 8 MiB로 제한되며, 아카이브 압축 해제나 원본 파일 저장 없이 메모리 내에서 업로드를 처리합니다. 정규화된 인증 정보는 요청한 인증된 브라우저에만 반환되며, 텔레그램 인증이 성공적으로 완료된 후 암호화된 볼트에 저장됩니다. 원본 파일과 변환된 파일을 보호하고, 여러 클라이언트가 동시에 인증 정보를 복제하는 것을 방지하십시오.

TData 처리는 컨테이너 체크섬, 로컬 복호화 해시 및 구조 길이를 검증합니다. 제공된 데스크톱 로컬 비밀번호는 일시적으로만 사용되며 저장되지 않습니다. 경계 지정 파서는 유효성을 검증하는 데스크톱 형식을 지원하며, 그 외 형식은 거부합니다. QR 이미지는 로컬에서 생성되며, 유효 기간이 짧은 텔레그램 로그인 토큰을 포함하고, 외부 렌더링 서비스로 전송되지 않습니다. 잠금, 작업 공간 전환, 새 로그인, 경로 변경 시 보류 중인 QR 시도가 취소됩니다. 탭을 새로 고치거나 닫을 경우, 시도가 만료될 때까지 보류 상태로 남을 수 있습니다. QR 로그인이 성공하더라도 계정 바인딩은 여전히 적용됩니다. 일반 API 본문은 여전히 16KiB로 제한되며, 인증된 가져오기 경로는 최대 12MiB의 인코딩된 JSON을 허용하되, 더 작은 디코딩된 파일 제한은 별도로 적용합니다.

로그인 코드 및 텔레그램 2단계 인증 비밀번호는 저장되지 않습니다. 전화번호/코드 해시 상태는 인증 과정에서 메모리에만 보관됩니다. 텔레그램 세션을 통해 계정 접근 권한이 부여되며, 데이터 디렉터리, 세션, 토큰, 볼트 키 또는 개인 서명 키를 GitHub에 절대 업로드하지 마십시오.

## 로그 및 전송

기본 API 유효성 검사 응답은 자격 증명 값이 노출되지 않도록 대체됩니다. 애플리케이션 액세스 로깅은 비활성화되어 있습니다. 리버스 프록시를 구성할 때 Authorization 헤더나 요청 본문을 로깅하지 않도록 하십시오. 패널은 localhost에서 수신 대기하며, 원격 액세스는 제공된 SSH 터널, Cloudflare Tunnel 또는 Caddy HTTPS를 통해 이루어지므로, 토큰과 로그인 비밀 정보는 SSH 또는 TLS 내부로 전송됩니다.

## 무결성 및 외부 시간

검증 과정에서는 기록 서명, 해시 체인, 첨부 파일 및 내보내기 매니페스트를 수집기 키와 대조하여 확인합니다. 유효한 서명은 해당 바이트가 서명된 이후로 변경되지 않았음을 나타냅니다. 각 작업 공간은 첫 실행 시 자체 서명 키를 생성하며, 패널과 모든 내보내기 파일에서 해당 지문을 표시합니다. 운영자는 별도의 채널을 통해 수신자에게 지문을 전달하고, `--fingerprint` 키를 고정합니다.

레코드가 변경, 삽입 또는 삭제되면 해시 체인이나 서명이 깨지게 되며, 검증자는 이를 보고합니다. 외부 타임스탬프와 위트니스는 또한 저널을 작업 공간 외부에 고정시킵니다. 저널 테이블에 설정된 SQLite 트리거는 애플리케이션이 실수로 레코드를 덮어쓰거나 삭제하는 것을 방지할 뿐입니다. `TGWITNESS_VAULT_KEY_FILE` 데이터 디렉터리의 복사본에서 볼트 키를 제외시킵니다.

RFC 3161 및 OpenTimestamps 영수증, 그리고 검증자가 텔레그램에서 날짜를 읽어오는 증인 게시물은, 이들이 포함하는 저널 접두사를 제3자가 설정한 시간에 연동시킵니다. 저널에 기록된 drand 라운드는 그 이후의 기록들이 해당 라운드가 게시된 시점보다 이른 시기에 생성되지 않았음을 보여줍니다. 검증된 GitHub 증명서 역시 서명의 검증된 시간을 포함하며, 이는 전체 아카이브를 외부 시간에 연동시킵니다. 체크포인트는 수집자 키로 서명되며, 수신자가 다른 채널을 통해 이를 획득한 시점부터 그 시점까지의 기록을 해당 키에 바인딩합니다. 위트니스는 두 번째 키가 저널 헤드를 보관했음을 나타내며, 관리자의 키 제어 기록은 누가 해당 키를 보유하고 있는지 보여줍니다. 이 두 가지 모두 보조적인 검증 수단이며, 최소한 제3자 시간 정보가 필요합니다. [GitHub Actions 캡처](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md) 또는 [Intel TDX 배포는](https://phishdestroy.io/tgwitness/ko/docs/reference/high-assurance/#confidential-vm-on-phala-cloud-intel-tdx) 수집 환경에 대한 워크플로 출처 정보나 하드웨어 측정값을 추가합니다.

모든 검증 답변에는 증거 조건과 각 조건이 어떻게 확인되었는지가 나열되며, 최소 조건에서의 역할에 따라 그룹화됩니다:

| 역할 | 조건 |
| --- | --- |
| 필수 사항 | 무결성; `--fingerprint`로 고정된 서명자 키; 마지막 기록을 포함하는 외부 시간(`--tsa-ca`로 확인된 RFC 3161 수신 확인, `--check-bitcoin`로 확인된 OpenTimestamps 수신 확인, `--channel`로 t.me에서 읽은 증인 게시물, 증인의 비트코인 씰 또는 확인된 GitHub 증명) |
| 최소 요구 사항의 일부는 아니나 지원되는 기능 | 자체 키를 가진 위트니스; 보존된 체크포인트; 인증된 수집 실행 |

**증거의 최소**요건은 마지막으로 내보낸 레코드를 포함하는 세 가지 필수 조건이 모두 충족되는 것이며, 검증 및 인증된 수집 실행에는 `attested` 프로필을 추가합니다. 마지막 줄에는 결과가 명시되며, 답변에는 누락된 조건을 충족할 수 있는 옵션들이 명시됩니다. `--fingerprint` 마지막 줄은 `EVIDENCE: minimum not met · missing: confirmed signer key`로 시작합니다. 검증된 타임스탬프가 이전 기록만 포함하는 경우, 답변에는 최소 조건이 성립하는 최종 기록까지의 기록이 명시됩니다. `--require evidence` 또는 `--require attested` 전체 내보내기에서 프로필에 도달하지 못한 경우 코드 2로 종료되며, 명령줄에서 요청되었으나 실행할 수 없는 검사는 동일한 코드로 수행되지 않았다고 보고됩니다. 모든 보고서에는 해당 사본의 상태와 이를 확인하는 명령어와 함께 동일한 조건이 포함됩니다. 보증 단계와 `--strict` 는 계속 사용할 수 있으며, [증거 형식](https://phishdestroy.io/tgwitness/ko/docs/reference/evidence/#verification-scope)에는 각 수집 모드에 대한 검사 항목이 나열되어 있습니다.

## 문제가 의심될 경우

원본 데이터 디렉터리는 그대로 유지하고, 분석용으로는 별도의 사본을 사용하십시오. [보안](https://github.com/phishdestroy/TgWitness/blob/main/.github/SECURITY.md)정책을 통해 영향을 받는 버전, 작업 및 재현 단계를 보고하되, 계정 데이터와 인증 정보는 비공개로 유지하십시오.
