TgWitness / 문서

테스트된 내용 →

이 페이지의 일부 내용은 여전히 영어로 되어 있습니다. 번역 후 원본 영어 문구가 변경되었기 때문입니다.

참고 문헌 / 증거

Telegram · 증거 형식

서명된 ZIP 파일의 내용, 기록 유형, 처리 내역, 사용자 프로필, 외부 백업본 및 오프라인 검증.

TgWitness / 문서

증거 및 검증

TgWitness는 계정에서 확인할 수 있는 텔레그램 관측 결과를 서명된 저널에 보존합니다. 수신자는 저장된 기록, 첨부 파일 및 보고서를 신뢰할 수 있는 수집기 키를 기준으로 검증하고, 마지막 기록에 대한 제3자의 외부 시간을 확인하며, 저널을 이전에 보관해 둔 체크포인트와 비교할 수 있습니다. 이 페이지에서는 인계 시 필요한 형식, 검증 절차 및 보관해야 할 자료를 설명합니다.

사용자는 Windows에서 VERIFY.cmd를 실행하여 시작할 수 있습니다. 이 프로그램은 원본 ZIP 파일과 독립적으로 확보한 키 지문을 요청하고, 설명이 포함된 결과를 표시하며, 별도의 검증 기록을 저장합니다. 설정 및 신뢰 한도에 대해서는 검증 실행 프로그램과 휴대용 런타임을 참조하십시오.

이 페이지에서

서명된 증거란 무엇인가#

자료 보호 보존 대상
운영 이벤트를 포함한 모든 저널 기록 이벤트당 SHA-256 체인 및 Ed25519 서명 원본 events.jsonl(신뢰할 수 있는 키 지문) 및 보존된 체크포인트
증거 ZIP 파일 내용 manifest.sig는 콘텐츠 파일의 해시 값을 나열한 표준 매니페스트에 서명합니다. 매니페스트 및 서명이 포함된 전체 ZIP 파일
보존된 첨부 파일 서명된 media.saved 이벤트 내의 SHA-256 및 바이트 수; 서명된 ZIP 매니페스트 내의 파일 해시 검증된 ZIP 파일 내부의 원본 바이트
체크포인트 저널 길이, 헤더 해시, 공개 키 및 생성 시간에 대한 Ed25519 서명 논란이 되는 변경 사항이 적용되기 전에 보관된 독립적인 사본
실행 확인서 수집기 버전, 소스 파일 해시 및 시작 설정에 대한 서명된 기록은 process.started에도 포함되어 있습니다. 선택한 검증 모드에 대한 영수증, 관련 분개장 및 환경 증거
읽기 쉬운 보고서: report.html 및 그 구성 요소인 report.json, report.pdf, chat.pdf 파일당 내용에 대한 Ed25519 인장이 적용되며, PDF에는 표준 PDF 서명도 포함되어 있습니다( 참조, 가독성 있는 보고서 ). 수신된 파일 및 신뢰할 수 있는 키 지문; 해당 파일이 설명하는 ZIP 파일
독립형 CSV 독립적인 암호화 서명이 없으며, 이벤트 해시만으로는 불충분합니다. 무결성 검증을 위해 검증된 ZIP 파일 내의 정확한 내용을 사용하십시오.
브라우저에서 생성된 스크린샷, 출력물 또는 PDF 파생물에는 TgWitness 서명이 포함되어 있지 않습니다. 원본 검증된 패키지를 보관하고, 파생본이 어떻게 생성되었는지 문서화하십시오.

컬렉터는 모든 내보내기 형식을 생성하기 전에 저널 서명을 검증합니다. 읽기 쉬운 HTML 및 PDF 보고서에는 자체 인장이 포함되며, 독립형 CSV 파일은 서명된 ZIP 파일의 일부로 확인됩니다. 첨부 파일 바이트와 매니페스트를 보존하려면 ZIP 파일을 유지하고, 이전 경계와 저널을 대조하여 확인하기 위해 별도의 체크포인트를 유지하십시오.

형식 및 검증 경로#

수집 모드와 출력 형식은 서로 다른 질문에 답합니다. 모드는 수집 및 환경 증거를 제공하며, 각 형식은 아래의 검증 기준에 따라 해당 기록의 일부를 보존하거나 제시합니다.

출력 검증 및 사용
증거 ZIP 표준 이벤트, 서명된 매니페스트, 커버리지, 보관 기록, 첨부 파일 및 사용 가능한 외부 영수증; 아카이브와 선택된 수집 모드를 확인하십시오.
ASiC-E 컨테이너 mimetype 항목과 META-INF/ASiCManifest.xml을 포함하는 ETSI ASiC-E 컨테이너(EN 319 162-1) 형식의 증거 ZIP 파일로, 작업 공간의 자체 인증서를 사용하여 B-B 레벨로 CAdES 서명되었거나, 타임스탬프가 활성화된 경우 B-T 레벨로 서명되어야 합니다. EU DSS와 같은 검증 도구는 형식과 무결성을 확인하며, 인증서가 자체 발급된 것이므로 신뢰 앵커가 없다고 보고합니다. 기본 설정의 EU DSS 6.3은 1,000개 이상의 파일이 포함된 컨테이너를 거부합니다("Too many files detected"). verify.py는 Ed25519 매니페스트와 나열된 모든 파일, META-INF/ASiCManifest.xml 및 추가된 ASiCManifestNNN.xml 또는 ASiCEvidenceRecordManifest.xml 내의 SHA-256 값을 검사하며, 이들 중 어느 것도 포함하지 않는 META-INF/ 항목이 있을 경우 검사에 실패합니다. 이 도구는 CAdES 서명을 검사하지 않으며, 이를 명시적으로 알립니다.
HTML 및 JSON 보고서 출처 참조가 포함된 개별적으로 봉인된 뷰는 ZIP 매니페스트에도 나열되어 있습니다. 기록된 카운트는 저널 이벤트 유형을 요약합니다.
PDF 보고서 Ed25519 봉인 및 해당 바이트 범위(B-B, 또는 타임스탬프 기능이 활성화된 경우 B-T)에 대한 PAdES 기준선 PDF 서명. TgWitness 검증기는 신뢰할 수 있는 Ed25519 키를 사용하며, 뷰어의 인증서 신뢰도 표시는 별도의 확인 절차입니다.
CSV ZIP 매니페스트에 포함된 스프레드시트 보기입니다. 수식 이스케이핑을 통해 스프레드시트 사용이 보호되며, 원본 서명된 텍스트는 저널에 그대로 유지됩니다.
JSONL 첨부 파일 참조를 포함한 서명된 이벤트 기록입니다. 증거 ZIP 파일에는 보존된 첨부 파일 바이트도 추가로 포함되어 있습니다.
채팅 내보내기 및 데스크톱 호환 보기 이력 수집 및 이용 가능한 관리자 로그 기록, 요청된 렌더링 및 서명된 아카이브를 포함합니다. 실시간 모니터링의 저장된 버전은 별도의 수집 경로입니다.
미디어 및 해시 전용 기록 저장된 바이트는 SHA-256 및 메시지 참조와 대조하여 검증됩니다. 해시 전용 수집 방식은 나중에 파일 바이트와 비교할 수 있도록 사용 가능한 해시 메타데이터를 보존합니다.
STIX/MISP 및 인물 프로필 출처가 연결된 추출된 관측 결과, 계정 ID 및 분석적 일치 항목. 프로필 서명 및 레코드 해시는 원본 증거와 대조하여 확인할 수 있으며, 아바타 캐시의 출처 정보는 별도로 표시됩니다.
인계 요약 서명된 공개 규칙, 변경되지 않은 기록 및 원래 해시/서명을 유지하는 표시된 최소화 기록. 비공개 필드가 필요한 비교 시에는 보존된 원본을 사용하십시오.
위트니스 및 타임 리시트 이전 저널 경계, 연속성 및 개별 검증된 시간 클레임. 이들은 수집 및 아카이브 검사와 함께 수행됩니다.
비밀번호로 보호된 전달 전송 중 포함된 패키지를 보호합니다. .tgwpw는 인증된 최종 기록을 포함하여 AES-GCM 인증 암호화를 사용하며, 포함된 저널은 서명과 수집 영수증을 유지합니다.

출력물 또는 화면 캡처는 서명된 자료의 표시 형태입니다. 해당 보고서의 ID, 키 지문 및 QR 참조 정보는 검증을 위해 원본 파일을 찾는 데 도움이 됩니다. 보관 선언문은 지정된 검사관 및 전송 정보를 기록하며, 검증 결과와 취득 영수증은 별도의 증거로 보관됩니다.

외부 서명#

서명은 TgWitness가 절대 보유하지 않는 키에서 비롯될 수도 있는데, 예를 들어 조사관의 적격 전자 서명이나 기관의 인장이 이에 해당합니다. 내보내기 기능의 경우, 비밀번호가 없는 미리 준비된 내보내기 파일에 대한 외부 서명은 서명할 바이트를 전달합니다. 즉, META-INF/ASiCManifestNNN.xml ASiC-E 컨테이너의 경우 각 파일과 해당 SHA-256 해시값을 나열한 목록, 또는 ZIP의 경우 manifest.json ZIP의 경우 해당 내용입니다. 서명자는 CMS(CAdES) .p7s를 반환하며, 이는 분리된 형태이거나 콘텐츠가 내장된 형태일 수 있습니다.

TgWitness는 서명이 정확히 해당 바이트를 포함하는지 확인하고, 서명자의 인증서(RSA PKCS#1 v1.5, RSASSA-PSS, ECDSA, Ed25519, Ed448)를 통해 검증합니다. 체인 검증은 운영자가 제공한 루트 인증서에 대해서만 수행되며, 인증서 해지, 신뢰 목록 및 적격 상태는 확인되지 않습니다. 패널에는 서명당 하나의 상태가 표시됩니다: 서명 대기 중, 첨부되었으나 확인되지 않음, 검증됨, 알고리즘 미지원, 서명 무효, 서명된 바이트가 일치하지 않음, 또는 제공된 루트 인증서와 체인이 연결되지 않음. 바이트가 배포된 후 내보내기 설정을 변경하면 해당 서명들이 모두 "서명된 바이트가 일치하지 않음" 상태로 설정됩니다.

서명이 포함된 파일 다운로드 다음 위치에 서명과 해당 매니페스트를 추가합니다. META-INF ASiC-E 컨테이너에. ZIP의 경우, 변경되지 않은 ZIP 파일과 .p7s 파일 및 SIGNATURES.txt 외부 ZIP 파일로 압축됩니다. 유효하지 않은 서명이나 다른 바이트 위에 중첩된 서명은 제외됩니다. TgWitness 알고리즘이 확인할 수 없는 서명이 포함되어 있으며, 패널에는 해당 상태가 표시됩니다. 마찬가지로 SIGNATURES.txt ZIP 파일용.

서명이 들어간 채팅 이미지#

이미지 미리보기에서 서명된 ZIP 파일을 다운로드하면 PNG 형식의 페이지가 저장되며, pages.sig.json 그리고 README.txt. 각 페이지는 표시된 저널 기록 번호, 채팅 내용, 렌더링 시간, 작업 공간 키 지문 및 이를 확인하는 명령어로 끝납니다. 패널은 각 페이지의 SHA-256 및 기록 번호만 전송하며, 서버는 해당 기록이 해당 채팅에 속하는지 확인한 후, 진술서에 서명(tgwitness-image-attestation-v1)에 서명하고, 서명 과정을 저널에 기록합니다. export.image_attested.

python verify.py page-01.png page-02.png pages.sig.json
python verify.py page-*.png pages.sig.json --fingerprint TRUSTED_SHA256 --evidence evidence.zip

검증자는 서명을 확인하고, 모든 PNG 파일을 서명된 페이지와 대조한 후 키 지문을 보고합니다. --fingerprint 서명자를 발신자로부터 독립적으로 획득한 지문과 비교합니다. --evidence 동일한 작업 공간의 서명된 증거 ZIP 파일을 읽고, 이미지의 모든 기록이 동일한 해시와 함께 존재해야 함을 요구합니다. 픽셀이 변경되었거나, 진술이 변경되었거나, 다른 키가 사용된 경우 검사에 실패합니다. 이미지는 TgWitness 고유의 레이아웃으로 저장된 기록을 보여줄 뿐이며, 텔레그램이 누구에게나 표시했던 내용을 보여주는 것은 아닙니다.

채팅 내역 내보내기 비교#

독립적으로 보관된 서명자의 지문 정보를 사용하여 서명된 두 개의 채팅 내역 내보내기 ZIP 파일을 검증하고 비교하십시오:

python -m tgwitness.verify first.zip --compare second.zip \
  --fingerprint FIRST_TRUSTED_KEY_SHA256 --compare-fingerprint SECOND_TRUSTED_KEY_SHA256

--require 및 --require-tier는 --compare와 함께 사용할 수 없습니다. 각 아카이브의 필수 프로필을 해당 아카이브의 자체 검증 기능을 통해 확인하십시오.

두 아카이브 모두 동일한 숫자형 계정 ID와 채팅 ID를 기록하는 경우, 기록은 메시지 ID를 기준으로 쌍을 이룹니다. 변경 없음(Unchanged)은 저장된 전체 JSON 기록이 동일함을 의미합니다. 전체 텍스트, 작성자, 날짜, 답장 대상, 중첩된 메타데이터 및 알 수 없는 필드가 모두 포함됩니다. JSON 객체의 키 순서는 중요하지 않지만, 누락된 필드, null 값, 값의 유형 및 배열 순서는 중요합니다. 300자 미리보기는 표시용으로만 사용됩니다. 변경된 항목은 해당 미리보기에서는 보이지 않는 변경 사항을 포함하여, 상위 레벨 changed_fields로 명명됩니다. 일치 과정에서 중복된 메시지 ID는 서로 덮어쓰지 않고 거부됩니다.

차이점으로는 표시 이름, 조회수, 수집 주석 또는 기타 관측 메타데이터의 변경이 있을 수 있습니다. 텔레그램 편집 내역은 별도의 편집 이벤트로 표시되며, 각 아카이브의 검증 결과는 해당 아카이브가 손상되지 않았는지 여부를 보여줍니다. 구문 분석되지 않은 기록은 비교 대상에 그대로 남아 있으며, 저장된 표현 형식에 따라 비교됩니다.

계정/채팅 식별자가 다르거나 누락된 경우, 이 도구는 발신자, 전체 텍스트, 파일 해시, 미디어 유형 및 5초의 시간 허용 오차를 사용하여 후보 일치 항목을 찾아내고, 이를 변경 없음(Unchanged)이 아닌 일치(Matched)로 보고합니다. 구문 분석되지 않은 레코드는 일치하지 않은 상태로 남습니다. 쌍을 이룬 레코드 간의 차이점은 changed에 나열되며, 여기에는 콘텐츠 모드도 포함됩니다. --json 옵션을 사용하면 matched는 후보 쌍의 수를, unchanged는 저장된 전체 레코드가 동일한 쌍의 수를 집계합니다. 기존의 changed_fields 및 정수형 unchanged 출력은 이전 비교 결과와 호환성을 유지합니다. 아카이브 형식과 서명 검증은 변경되지 않았습니다.

조사 업무 인계#

  1. 사건 참조 번호, 담당자, 텔레그램 계정 ID, 선택된 출처, 수집 정책 및 수집 기간을 사건 메모에 기록하십시오. TgWitness는 관찰 내용을 보존하며, Case Board에서 출처와 연결된 메모 및 수집 자료를 지원합니다. 이관 및 보관 기록은 사건 자료와 함께 보관하십시오. 실시간 승인 절차를 통해 의도된 수집 설정을 확인하십시오.
  2. 워크스페이스의 공개 키 지문을 해당 워크스페이스의 내보내기 결과를 신뢰하기 전에 독립적으로 보관하십시오. 증거 모드를 켜두어(기본 설정) 체크포인트가 RFC 3161 및 OpenTimestamps 영수증을 수신하도록 하십시오. 수집 중에는 서명된 체크포인트를 수집기 외부에 저장하십시오. 중단 사항과 계정의 가시성 한계를 기록하십시오.
  3. 서명된 ZIP 파일을 내보내고 서명된 실행 영수증을 보관하십시오. 내보낸 저널 경계 지점 이전 또는 해당 지점에 체크포인트를 설정하십시오. 이후의 체크포인트는 이전 내보내기 파일이 너무 짧다는 이유로 이를 올바르게 거부할 수 있습니다. 내보내기 파일에는 패널 필터와 관계없이 전체 작업 공간 저널이 포함되므로, 공유하기 전에 내용을 검토하십시오.
  4. 수신자가 신뢰할 수 있는 검증기 사본, 독립적으로 제공된 지문, 그리고 별도로 획득한 타임스탬프 인증 기관의 루트 인증서를 사용하여 ZIP 파일을 검증하도록 하십시오. Python 환경이 활성화된 신뢰할 수 있는 체크아웃 환경에서:

    python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --tsa-ca TSA-ROOT.pem --checkpoint retained-checkpoint.json --require evidence

    지문과 마지막 기록의 검증된 타임스탬프는 증거의 최소 요건을 충족합니다. --require evidence는 그렇지 않은 경우 코드 2로 종료됩니다. 체크포인트는 수집기 키로 서명되었으므로 보조 검증 역할을 합니다. 두 입력값이 모두 제공되고 수락된 경우, 성공적인 출력 결과로 key_pinned: true 및 checkpoint_checked: true가 보고됩니다. 검증 결과를 보존하십시오.

    For a handover requiring the final exported record to be witnessed, use
    `--witness witness.zip --witness-fingerprint TRUSTED_WITNESS_SHA256 --require-witness`.
    This refuses an export with an unwitnessed tail. Add
    `--channel https://t.me/s/WITNESS_CHANNEL` to read the dates Telegram set on the
    witness posts as external time. See the
    [witness handover procedure](WITNESS.md#require-a-witnessed-export-boundary).
    
    1. 보관 기록에 아카이브의 SHA-256, 내보내기 경계, 전송 날짜, 발신자 및 수신자를 기록하십시오. 원본 패키지는 그대로 보존하고 복사본을 사용하여 작업하십시오. 계정 세션 및 서명 비밀키도 포함된 애플리케이션의 개인 데이터 디렉터리 대신 증거 파일을 공유하십시오. 전송 시에는 암호로 보호된 AES-256 ZIP 또는 더 강력한 .tgwpw 컨테이너를 선택하십시오. ZIP은 WinZip의 저비용 암호 유도 방식을 사용하므로, 길고 무작위적인 암호 문구를 사용하십시오. .tgwpw는 scrypt와 AES-256-GCM을 사용하며, 독립형 검증기의 unseal-password 명령으로 열 수 있습니다. 암호는 저장되지 않으며 기밀성만 보호합니다. 수신자는 아카이브를 복호화한 후, 변경되지 않은 내부 서명된 내보내기 파일을 검증합니다.
    2. 증거 모드 외에서 체크포인트에 타임스탬프를 부여하려면 RFC3161 절차를 따르고, 요청, 체크포인트, 신뢰할 수 있는 CA 정보 및 검증된 권한 응답을 보존하십시오. 요청을 준비하는 것만으로는 타임스탬프를 획득할 수 없습니다.

.tgwpw의 경우, 독립적으로 확보한 검증기를 사용하고 원래 확장자를 유지한 새 출력 파일을 선택하십시오: python verify.py unseal-password export.tgwpw --out evidence.zip. 명령어는 비밀번호 입력을 요청하며, --password-stdin는 자동화를 위해 한 줄을 읽어들입니다. 이 명령어는 기존 파일을 절대 덮어쓰지 않으며, 모든 기록이 인증된 후에만 평문을 공개합니다. 이후 암호 해독된 파일에 대해 일반적인 서명 검증을 실행하십시오. 이 컨테이너는 scrypt(N=131072, r=8, p=1, 16바이트 솔트; 약 128 MiB RAM) 및 AES-256-GCM을 사용하며, 1 MiB 크기의 레코드와 인증된 최종 레코드로 구성됩니다. 암호화된 메타데이터 레코드에는 내부 파일 이름이 저장되어 있으므로, 다운로드한 컨테이너의 이름을 변경할 수 있습니다.

검증이 성공적으로 완료되면 신뢰할 수 있는 수집기 키 및 유지된 경계와 관련하여 무결성이 확립됩니다. 수행된 검사에 대한 신뢰 가정 및 유효성 검사 결과는 검증 범위를 참조하십시오.

인계 요약#

서명된 ZIP 파일에는 전체 작업 공간 로그가 포함되어 있습니다. 법원, 변호사 또는 악용 신고 센터에서 일부 채팅, 특정 기간 또는 특정 인물에 대한 정보만 필요한 경우, ‘내보내기 → 인계 추출물’을 통해 선택된 공개 규칙에 따라 축소된 사본(tgwitness-handover-v1)을 생성할 수 있습니다. 운영자는 목적을 명시하고, 채팅 내용, 선택적 기간(UTC), 추출 대상인 사람, 나머지 사람들에 대한 처리 방식(표시, 가명 P01, P02… 또는 제외) 처리 방식, 어떤 메시지 본문을 남길지, 어떤 첨부 파일과 프로필 사진을 포함할지, 그리고 본문 내 전화번호와 이메일 주소를 가릴지 여부를 설정합니다. 목적과 이러한 규칙은 서명된 매니페스트와 보고서에 포함되며, 저널은 handover.exported를 생성한 액세스 정보와 파일의 SHA-256 해시값을 기록하며, 내용은 기록하지 않습니다.

verify.py는 추출물을 두 가지 방식으로 확인합니다. 변경되지 않은 것으로 표시된 레코드는 전체적으로 검증됩니다. 즉, 내용과 해시, Ed25519 서명, 그리고 포함된 이전 레코드와의 링크를 대조하여 검증합니다. 축소된 레코드는 원본 해시와 서명을 유지하므로 서명 검증은 여전히 가능하지만, 생략된 필드는 이를 바탕으로 재계산할 수 없습니다. 레코드에는 생략된 항목이 명시되어 있으며, 보고서에서 이를 표시합니다. 계정 전체 서비스 기록(시작 및 종료, 서비스 공백, 연결, 네트워크 및 저장소 알림, 범위 및 설정 변경)은 해당 유형에 대해 나열된 필드만 유지합니다. 이 기록에 포함된 채팅 목록은 선택된 채팅으로만 축소되고 총계는 재계산되며, 선택 범위 외 채팅에서 실시간 프로브 공백이 발생하면 해당 채팅, 메시지 수 및 증인 계정이 제외됩니다. 선택된 프로브 채팅에서는 모든 참여자가 표시되거나 선택된 사람 중 하나가 아닌 한, 증인 계정이 가명으로 대체됩니다. 매니페스트는 저널의 길이와 헤더를 명시하고, 해당 헤더 위에 수집자의 서명을 포함하며, 제외된 레코드 수를 집계합니다. `coverage.json`은 선택된 채팅을 설명합니다. 새로운 추출본에는 또한 `proofs.jsonl`이 포함됩니다. 포함된 모든 레코드와 저널 헤더에 대해, 해당 레코드의 원본 해시에서 서명된 매니페스트에 명시된 저널 루트까지의 머클 경로가 제공됩니다. verify.py는 각 경로를 확인하므로, 전체 저널이 없어도 모든 레코드가 해당 길이와 헤더를 가진 동일한 저널에 속함을 확인할 수 있습니다. 100개의 메시지로 구성된 추출본은 저널 크기와 상관없이 약 1초 만에 검증이 완료됩니다. --range=CHAT:FROM-TO는 추가로 해당 채팅의 FROM에서 TO까지의 메시지가 추출본에 포함되어 있는지 확인하고, 이를 위해 확인한 레코드 수를 보고합니다. 파일 이름 내의 이름은 감지되지 않습니다. 공유하기 전에 최종 파일을 검토하십시오: 자유 텍스트, 파일 이름 및 선택된 첨부 파일로 인해 여전히 개인을 식별할 수 있습니다. 서명된 전체 ZIP 파일을 보관하십시오: 추출본은 정보 공개용이지 대체물이 아닙니다.

읽기 쉬운 보고서#

서명된 증거 자료, 인계 자료 및 채팅 ZIP 파일에는 읽기 가능한 HTML 및 JSON 보고서가 포함되어 있으며, 필요한 글꼴이 구비된 경우 선택한 보고서 언어로 된 PDF도 함께 제공됩니다. 각 보고서는 작업 공간의 Ed25519 키로 봉인되어 있으며, python -m tgwitness.verify FILE --fingerprint KEY [--evidence ZIP] 명령을 통해 개별적으로 검증할 수 있습니다.

  • report.html / chat.html: 씰 문장(tgwitness-report-seal-v1)은 파일을 닫고 그 이전의 모든 바이트에 대한 SHA-256에 서명합니다. 긴 저널과 채팅은 구성 가능한 크기(보고서 설정, 500~100,000개 레코드; 기본값 5,000개)로 분할됩니다: records/records-0001.html 또는 messages/messages-0001.html는 각각 번호, 범위 및 총계와 함께 봉인되며, 서명된 매니페스트에 해당 SHA-256와 함께 나열됩니다. 수집기 하트비트 실행 내역은 보고서 설정에서 하나씩 나열하도록 지정하지 않는 한 한 줄로 표시됩니다.
  • report.json (tgwitness-report-json-v1, 키 format, report, seal): 이 인장은 report의 정규화된 JSON에 해당하는 SHA-256에 서명하므로, 사실 관계를 케이스 시스템 및 스크립트를 통해 읽을 수 있으며 서명된 파일의 무결성을 유지한 상태에서 데이터 보호를 위한 선별 작업이 가능합니다.
  • report.pdf / chat.pdf: 인쇄 및 보관용 공식 문서로, 동일한 바이트 위치에 두 번 서명되어 있으며, 서명 값을 제외한 전체 파일(/ByteRange)을 제외한 전체 파일. 표준 PDF 서명은 PAdES 베이스라인(ETSI EN 319 142-1, /SubFilter /ETSI.CAdES.detached: SHA-256 및 ECDSA P-256을 사용하는 CMS, 서명 인증서 v2, CMS 서명 시간 없음; 주장된 시간은 /M) 레벨 B-B, 또는 타임스탬프 기능이 켜져 있고 텔레그램 외부 요청에 대해 타임스탬프 기관이 경로를 통해 응답할 경우 CMS 내에 RFC 3161 서명 타임스탬프가 포함된 B-T입니다. 이는 작업 공간 볼트에 보관된 자체 발급 문서 서명 인증서를 사용하며, 해당 인증서의 주체 일련 번호는 Ed25519 키 지문입니다. Ed25519 인장은 CMS 내에서 서명되지 않은 속성 2.25.240684792623320047764573196045913242332 로 CMS 내에서 전송되며, 인증서의 SHA-256 해시값을 "content": "pdf-byte-range"로 명명되므로, Ed25519 키가 해당 인증서를 보증합니다. 이 인증서는 자격 인증을 받지 않았습니다. PDF 리더에서는 인증서가 신뢰될 때까지 서명을 유효한 것으로 표시하지만 서명자를 알 수 없거나 신뢰할 수 없는 것으로 표시합니다. 대신 Ed25519 지문과 비교해 보십시오. 중국어, 일본어 및 한국어 PDF의 경우 서버(또는 TGWITNESS_FONT_DIR)에 폰트가 있어야 합니다. 폰트가 없으면 ZIP 파일에는 HTML 및 JSON 보고서만 포함됩니다.
  • report.en.html, report.en.pdf / chat.en.html, chat.en.pdf: 보고서 언어가 영어가 아닐 때 같은 보고서의 영어 원본으로, 같은 방식으로 봉인·서명되며 서명된 매니페스트의 report.original 아래에 기재됩니다. 선택한 언어의 보고서는 영어 원본을 인증 또는 선서 번역과 함께 제출하라는 권고로 시작합니다. 법원 제출용 보고서 번역을 참조하십시오.

채널이나 슈퍼그룹에서 Telegram 는 메시지 1, 2, 3…을 순서대로 번호를 매깁니다. 채팅 내보내기 파일에는 첫 번째 및 마지막 번호, 존재하는 메시지 수, message-ids.json 에 있는 누락된 번호의 모든 연속 구간, 매니페스트 및 chat.json 헤더가 나열되며, 대본 내에서 각 공백이 발생하는 위치를 표시합니다. verify.py 는 chat.json 부터 번호를 다시 세어 나갑니다. 누락된 번호란 Telegram 가 반환하지 않은 메시지(내보내기 전에 삭제되었거나, 해당 계정에서 볼 수 없는 메시지)를 의미합니다. 비공개 채팅 및 기본 그룹의 경우 번호는 해당 계정의 모든 채팅에서 공유되며, 누락된 번호는 집계되지 않습니다.

이력을 읽은 후, 내보내기 과정에서는 텔레그램에 누락된 모든 번호를 번호별로 다시 요청합니다(channels.getMessages, 첫 번째 메시지 아래에 있는 1,000개를 포함하여 최대 10,000개까지, 그 수가 더 많을 경우 모든 공백에 고르게 분배됨). 결과는 message-ids.json 및 보고서에 포함됩니다. 빈 응답은 재확인 시점에 해당 번호가 이 계정에서 사용할 수 없음을 기록하며, 원인은 명시되지 않습니다. 재확인 시 반환된 메시지는 내보내기 파일에 추가되고 표시됩니다. found_on_recheck.

관찰 작업 공간에서 채팅 메시지가 삭제되거나, 재확인 시 누락되거나, 수정된 것을 감지하면 채팅 내보내기 기능은 journal-changes.jsonl: 해당 저널 기록, 저장된 모든 버전 및 알림을 추가하며, 각각에 저널에서 수신한 해시와 Ed25519 서명이 포함됩니다. verify.py 각 레코드의 해시를 재계산하고, 내보내기 키를 기준으로 서명을 확인하며, 개수를 서명된 매니페스트와 비교합니다. 증거 내보내기에는 완전한 해시 체인이 포함됩니다. 보고서에는 이러한 메시지가 삭제 내역 및 이전 버전 항목 아래에 나열됩니다.

모든 보고서는 요약으로 시작합니다. 한 단락 다음에 자료가 보여주는 내용과 기록에 포함된 내용이 이어집니다. 브라우저가 페이지 자체가 아닌 봉인의 서명을 확인하면 페이지 자체의 봉인 스탬프가 호박색으로 바뀝니다: 브라우저는 페이지에 자체 바이트를 부여하지 않습니다. 독자가 페이지 하단의 검증 창에 파일을 드래그하여 모든 바이트가 일치할 때, 그리고 표시된 페이지가 해당 파일일 경우에만 녹색으로 변하며, 그렇지 않으면 빨간색으로 변합니다.

각 보고서에는 프로그램의 정확한 명칭을 명시해야 합니다: 체크아웃에서 수집기가 실행될 때의 git 커밋 또는 설치 프로그램이 설정할 때의 TGWITNESS_COMMIT, 그리고 해당 소스 파일의 SHA-256 값(source_tree_sha256, 경로 → 각 파일의 SHA-256 값을 나타내는 표준 JSON 형식 .py, .js, .css, .html 및 .svg 파일의SHA-256 값)을 명시해야 하며, 파일이 변경되지 않은 한 해당 커밋을 체크아웃하면 이 결과가 재현됩니다. 텔레그램 클라이언트는 라이브러리, API 계층 및 데이터 센터와 함께 명명됩니다. 관측이 시작되고 채팅 내보내기가 시작 및 종료될 때, 수집기는 텔레그램에 시간을 요청합니다(updates.getState, 정수 초)을 요청하고, 텔레그램의 시간에서 수집기의 시계를 뺀 값을 기록하며, 여기에는 왕복 통신으로 인한 오차가 포함됩니다. 보고서에는 이러한 측정값이 ‘Chain of custody’ 항목 아래에 표시됩니다. 채팅 내보내기는 메시지의 날짜 외에도 이력을 읽은 시점을 기록합니다.

오프라인 보고서 뷰어 및 아카이브 가이드#

chat.html 또는 report.html를 열기 전에 ZIP 파일을 완전히 압축 해제하십시오. 뷰어는 서버 없이도 검색, 필터, 참가자, 지표, 기록 세부 정보 및 JSON/CSV 선택 기능을 제공합니다. viewer/와 media/는 보고서 옆에 보관하십시오. 선택 항목은 파생본이므로, verify.py SELECTION.json --evidence ARCHIVE.zip를 사용하여 서명된 아카이브와 비교하십시오. 검증기는 보고서 ID, 서명 키, 아카이브 경계 및 선택된 모든 항목을 확인하며, 수정된, 누락된 또는 중복된 항목은 검증에 실패합니다. 선택 사항에 대한 메모와 생성 시간은 서명되지 않은 메타데이터로 유지됩니다.

메시지 번호의 공백은 필터링되지 않은 완전한 오름차순 채팅 피드에서만 표시됩니다. 카테고리를 숨기거나 데이터 청크를 로드하지 못한 경우, 생략된 행이 메시지가 누락되었다는 증거로 간주되어서는 안 됩니다. 검색 하이라이트 기능은 HTML 이스케이프 처리 전의 일반 텍스트를 대상으로 하며, 리터럴 마크업을 그대로 유지합니다.

브라우저는 매니페스트 서명, 보고서 ID 및 키, 그리고 나열된 모든 파일 해시를 확인합니다. 또한 모호하거나 형식이 잘못된 ZIP 구조, 중복된 이름 및 안전하지 않은 경로를 거부하며, 파일 크기는 256 MiB, 선언된 총 콘텐츠 크기는 4 GiB로 제한합니다. 더 큰 아카이브의 경우 독립형 검증기를 사용하십시오. 이 브라우저 검사는 저널 체인 및 데이터 의미론에 대한 검증기의 검사를 보완합니다.

README.txt에는 시작 가이드, 정렬된 파일 목록, 검증 지침 및 데이터 형식 관련 참고 사항이 보고서 언어로 포함되어 있으며, 그 뒤를 이어 완전한 영어 가이드가 수록되어 있습니다. SHA256SUMS는 본 파일 자체, manifest.json 및 manifest.sig를 제외한, 그 안에 나열된 파일들을 다룹니다. 서명된 매니페스트는 SHA256SUMS도 포함합니다. 원본 ZIP 파일은 변경하지 말고, 작업 파일은 압축 해제된 폴더 외부에 저장하십시오. PDF 보고서에는 섹션 북마크와 후반 페이지에 사건/보고서 식별 정보가 포함되어 있습니다.

내보내기 시점의 채팅 내용#

채팅 내보내기 파일에는 내보내기가 시작될 당시 Telegram가 해당 채팅에 대해 기록한 내용이 포함됩니다: Telegram의 자체 라벨(scam, fake, restricted 및 그 사유, verified), 사용자 이름, 설명, 참가자 및 관리자 수, 연결된 토론, 콘텐츠 보호 설정, 신규 참가자가 이전 메시지를 볼 수 있는지 여부, 그리고 이 계정이 어느 메시지부터 기록을 볼 수 있는지(available_min_id), 채팅 생성일인 경우 첫 번째 메시지의 날짜, 그리고 채팅 사진의 SHA-256(media/에 저장됨). 이 데이터는 내보내는 계정의 채팅 내 위치를 기록합니다: 역할, 가입일, 초대자, 그리고 관리자의 경우 해당 권한. Telegram가 거부한 요청은 대신 이름이 지정됩니다.

내보내기 계정이 관리자인 경우, 내보내기 기능은 채팅의 관리자 로그(텔레그램은 약 48시간 동안 보관함)를 admin-log.json 파일로 읽어옵니다. 여기에는 삭제 및 수정 내역과 함께 제공된 콘텐츠, 실행 계정 및 소스 작업 날짜가 포함됩니다. 이러한 항목들은 실시간 저널의 캡처된 버전 및 삭제 수신 기록을 보완합니다.

지표#

보고서 목록과 아카이브에는 indicators.csv , indicators.stix.json (STIX 2.1 ) 및 indicators.misp.json (MISP 이벤트)로 기록되어 있으며, 이는 악용 신고 담당자가 기록된 메시지 내에서 조치를 취할 수 있는 항목입니다: 링크 및 도메인(텍스트 뒤에 숨겨져 있거나, 버튼 및 링크 미리보기 내의 것 포함), 암호화폐 주소, Telegram 사용자 이름 및 초대 링크, 전화번호, 이메일 주소, 저장된 이미지. 비트코인, 라이트코인, 도지코인 및 트론 주소는 base58 체크섬이 유효한 경우에만 나열되며, 세그윗 주소는 bech32 또는 bech32m 체크섬이 유효한 경우, TON 주소는 CRC가 유효한 경우에만 나열됩니다. EVM 및 솔라나 주소는 확인되지 않은 것으로 표시됩니다. 이미지에는 SHA-256 와 지각적 해시(dHash, 64비트)가 포함되어 있으며, 재압축되거나 크기가 조정된 사본에서도 이 값은 거의 변하지 않습니다. 보고서는 지표가 실수로 열리지 않도록 처리합니다(hxxps[://]example[.]com ); 파일은 원래의 값을 그대로 유지합니다. 모든 지표는 ‘알 수 없음’으로 표시되며 자동 탐지 대상에서 제외됩니다(STIX , indicator_types: unknown , MISP , to_ids: false , 자체 조직 내 배포): 목록에 등재되었다는 것은 해당 메시지에 해당 지표가 포함되어 있었음을 의미할 뿐, 악성이라는 뜻은 아닙니다. 텍스트에 표시된 주소와 실제로 열리는 주소가 다른 링크는 보고서에 표시됩니다.

PDF 보고서는 수기 서명이 필요한 조사관의 진술서, 공증인 또는 법원 전문가를 위한 체크리스트, 그리고 보고서 ID, 키 지문 및 공식 데이터의 SHA-256가 포함된 QR 코드(첫 페이지에도 기재됨)로 끝납니다. 이를 통해 출력본을 통해 해당 아카이브로 다시 연결될 수 있습니다.

이벤트 정규화#

해시 입력은 정확히 다음 필드로 구성됩니다:

seq, observed_at, source_at, kind, chat_id, message_id, actor_id, payload, previous_hash

UTF-8을 사용하는 Python 호환 JSON 형식으로 직렬화하며, 객체 키는 정렬되고, ASCII 에스케이핑이 없으며, 의미 없는 공백이 없고, NaN/무한대가 포함되지 않아야 합니다:

json.dumps(value, ensure_ascii=False, sort_keys=True,
           separators=(",", ":"), allow_nan=False).encode("utf-8")

해당 바이트의 SHA-256 값이 이벤트 해시가 됩니다. 서명은 32바이트의 원시 해시에 대해 Ed25519 알고리즘을 적용한 후 Base64로 인코딩됩니다. 첫 번째 previous_hash는 64개의 0으로 구성됩니다. 시퀀스 번호는 1부터 시작하여 1씩 증가합니다. 운영 이벤트를 포함한 모든 이벤트는 하나의 체인을 공유합니다. 중복 전달 억제 기능은 없습니다. 즉, 반복된 관측 결과는 서로 다른 수신 기록일 뿐, 서로 다른 텔레그램 동작을 의미하지는 않습니다.

Telegram의 원시 날짜는 ISO 문자열이며, 바이너리 필드는 bytes_base64를 포함하는 객체로 변환됩니다. 메시지 본문, 엔티티, 미디어 설명자, 답장 메타데이터, 반응, 및 서비스 액션은 제공된 경우 원시 메시지 메타데이터에 유지됩니다. 라이브 메시지는 또한 해당 메시지를 전달한 Telegram 업데이트를 transport_update; 해당 업데이트가 raw, 해당 message 필드는 {"same_as": "raw"} 가 됩니다.

observed_at 는 수집자가 레코드를 작성한 시점의 UTC 시간이며; source_at 는 해당 텔레그램 이벤트에서 제공된 날짜입니다. 실시간 업데이트를 처리하는 동안 기록된 레코드에는 payload.received_at, 업데이트가 수집기에 도달한 UTC 시간을 추가하며, payload.processing_delay_ms를 추가합니다. 실시간 편집은 제공된 편집 날짜를 유지하며, 기록 스냅샷은 메시지 날짜와 현재 관측 시간을 유지하고, 일반적인 삭제 알림은 소스 날짜를 null로 설정하고 수신 시간을 기록합니다. 관리자 로그 항목은 제공된 작업 날짜를 별도로 유지합니다. 수신 순서와 소스 이벤트 순서는 서로 다른 타임라인이며, 시계 관측값과 외부 수신 내역을 비교할 수 있습니다.

행위자 의미론#

출처 표기는 이벤트 소스를 따릅니다. message.new.actor_id와 message.edited.payload.sender_id는 메시지 발신자를 유지합니다. 일반적인 message.deleted 알림은 메시지 ID를 포함하며 액터 필드는 null입니다. 사용 가능한 관리자 로그 항목은 제공된 작업, 액터 및 날짜를 포함합니다. 멤버십 서비스 메시지는 발신자와 작업 유형을 유지하며, 원시 참가자 업데이트는 제공된 actor_id를 유지하고, 반응 스냅샷은 제공된 카운트와 표시된 신원을 보존합니다. 이러한 기록을 캡처된 버전 및 패널 상호작용 영수증과 함께 읽어보십시오.

비공개 채팅 및 일반 그룹에 대한 삭제 알림에는 메시지 ID만 포함됩니다. 이러한 채팅들은 계정 전체에 걸쳐 하나의 ID 시퀀스를 공유하므로, ID는 이 계정의 단일 메시지를 식별합니다. 해당 ID를 가진 메시지가 이전에 이 저널에 저장된 경우, 삭제 내역은 해당 채팅에 `message.deleted`로 기록되며, `payload.chat_resolution`이 메서드 이름을 지정합니다. 저장된 적이 없는 ID는 deletion.unscoped로 유지됩니다. 이는 채팅과의 연관성이 확인되지 않은 실제 삭제 알림입니다. 이는 사용 불가능한 쿼리 결과를 기록하는 message.missing_on_recheck과는 다르며, 저장된 메시지 ID의 공백과도 구별됩니다. 채널과 슈퍼그룹은 채팅별로 메시지 번호를 부여하며, 이러한 방식으로 매칭되지 않습니다. 삭제된 메시지가 관찰 대상 계정에서 전송된 경우, payload.deleted_message_was_outgoing이 true이며, 삭제자는 여전히 제공되지 않습니다.

범위가 지정되지 않은 알림은 해당 채팅이 현재 관찰 범위 외부에 있거나 일치하는 항목이 없을 수 있으므로 자체 레이블을 유지합니다. 부재 재확인 결과는 보고서 집계, 필터 및 레이블에서 삭제 알림과는 별개의 관찰 항목으로 남습니다. 이후 복구가 이루어지면 현재 누락 상태는 해제되지만, 서명된 기록 내의 이전 실패한 확인 내역은 보존되며, 삭제 알림은 별도의 이벤트 유형으로 유지됩니다.

하나의 알림에서 동일한 채팅으로 확인된 여러 ID는 개수와 관계없이 deletion.batch로 묶이며, 메시지 ID는 텔레그램이 전송한 그대로 유지되고 해당 계정이 보낸 메시지 수 또한 그대로 반영됩니다. 텔레그램의 알림에는 메시지 목록이 표시되며, 채팅의 관리자 로그에는 해당 계정이 확인할 수 있는 곳에 실제 관리자의 이름이 기재됩니다. 링크(message.deletion_attributed)는 다음 중 먼저 도착하는 쪽에 따라 생성됩니다: 삭제 알림이 기록될 때, 삭제 알림보다 먼저 관리자 로그 항목을 확인한 폴링이 일치하는 경우입니다.

다루는 내용: 연속성, 누락 및 감지되지 않은 ID#

모든 서명된 ZIP 파일에는 coverage.json가 포함되어 있으며, HTML 보고서는 동일한 요약으로 시작됩니다. 또한 verify.py는 파일을 그대로 신뢰하지 않고 events.jsonl를 기반으로 요약 내용을 재계산합니다:

  • X부터 Y까지 지속적으로 관측됩니다. 기간은 observation.started로 시작하여 일시 중지, 중지, 텔레그램 연결 끊김, 로그아웃, 정상적인 중지 절차 없이 시작된 프로세스, 또는 관측 중 기록이 전혀 없는 상태가 3분 이상 지속될 때 종료됩니다(하트비트는 1분마다 기록되므로, 기록이 없는 것은 프로세스가 중지되었거나, 멈췄거나, 컴퓨터가 절전 모드에 들어간 것을 의미합니다). ‘추가 도구 → 매개변수’에서 하트비트 간격이 변경되면, 각 하트비트가 이를 기록하며, 허용되는 무반응 시간은 3개의 간격이 되며, 3분 미만일 수는 없습니다.
  • ‘공백(Gaps)’ 항목에는 기간 간의 간격과 그 이유가 나열됩니다. 마지막 기록 시점에 여전히 해결되지 않은 공백은 not_resumed_by_last_record로 표시됩니다.
  • 관측되지 않은 메시지 ID. 채팅별로 메시지 번호를 부여하는 채널 및 슈퍼그룹의 경우, 관측된 메시지 사이에 누락된 ID는 범위 형태로 나열됩니다. 이러한 ID는 ‘관측되지 않음’ — 삭제됨, 전달되지 않음, 또는 저장된 기록 외부 — 으로 보고되며, 절대 ‘삭제됨’으로 보고되지 않습니다. 비공개 채팅과 일반 그룹은 계정 전체에 공통된 순서 번호를 사용하므로, 해당 채팅 내부의 공백은 아무런 의미가 없으며 해당 목록에 포함되지 않습니다.
  • 채팅 수준의 누락 알림(예: 텔레그램이 특정 채널에서 차이점 복구를 요청하는 경우)은 메모로 간주되며, 전체 기록 범위를 방해하지 않습니다.
  • Session records. Windows in which Telegram's update counter grew while no update reached this session (updates_diverted), this session left Telegram's session list while its connection kept working (session_revoked_externally), or a witness probe's answer arrived only from history (probe_ack_missed_live) are listed separately. The verifier also reports where the Telegram session key came from, other sessions signed in when observation started, sessions added during observation, Telegram security notices (777000), other sessions ended from the workspace, only-session periods, witness probe counts and phone call updates. See accounts. While strict chosen chats is on (scope.strict in observation.started), the session list (except while this is the only session, or when Telegram devices is on), security notices and phone call updates are not collected, so their absence says nothing, and a deletion is matched to a session check only if one ran in the 10 minutes before it.

업데이트 순서 (pts)#

텔레그램은 메시지와 관련된 업데이트를 pts: 계정당 하나의 시퀀스 (비공개 채팅과 기본 그룹을 통합)와 각 채널 또는 슈퍼그룹당 하나의 시퀀스로 구성됩니다. 수집기는 누락 없이 수신한 각 구간을 하나의 coverage.sequence 레코드로 저장합니다: 첫 번째와 마지막 pts, 각 유형별 업데이트 수, 그리고 해당 업데이트가 실시간으로 푸시되었는지 아니면 getDifference 또는 getChannelDifference에 의해 반환되었는지 여부. 중단은 하나의 coverage.gap 기록으로 간주되며, coverage.gap_closed 시퀀스가 pts 시점을 나타내며, 이 시점부터 시퀀스가 다시 완전해집니다.

끊김 없이 이어지는 기록을 보면, 텔레그램이 첫 번째와 마지막 업데이트 사이에 해당 순번으로 매긴 모든 업데이트가 pts 이 수집가의 텔레그램 클라이언트에 도달했음을 보여줍니다. 이는 텔레그램이 이 계정으로 전혀 전송하지 않은 내용이나, 기록된 첫 번째 pts, 또는 수집자가 기록하지 않은 연속 구간들에 대해서는 언급하지 않습니다. pts 기록된 연속 구간이나 차이가 포괄하지 못하는 진전은 단절로 표시됩니다.

GET /api/continuity 특정 구간(since, until, chat_id)에 대해 각 수열이 끊어지지 않았는지 여부를 판단하고, 끊어진 경우 그 이유를 함께 나열합니다. verify.py 수열의 연속성 항목에 있는 아카이브의 기록에서 동일한 내용을 출력합니다.

누락된 메시지 번호 (gap_summary)#

For a reader's guide to this section and to observation periods and gaps, see Coverage and missing material.

미리 보기. coverage.json → gap_summary 텔레그램이 할당했으나 이 수집기가 감지하지 못한 메시지 수를 측정합니다. 텔레그램은 채널이나 슈퍼그룹당 한 번, 그리고 개인 채팅, 봇 및 일반 그룹을 아우르는 계정당 한 번씩 메시지에 번호를 부여합니다. 두 개의 관측된 메시지 사이에 있는 번호는 관측되었거나 누락된 것입니다. 연속된 번호 범위는 그 범위 내의 모든 메시지가 관측되었다는 긍정적인 진술입니다. 간격이 있는 경우, 특정 행위자나 이유는 명시되지 않습니다.

분야 의미
status on 또는 ‘추가 도구 → 매개변수 → 갭 분석’에서 비활성화된 경우 off
parameters 결과를 도출한 매개변수. 이를 통해 결과를 재현할 수 있도록 합니다.
chats[] 채널 또는 슈퍼그룹당 하나의 항목으로 구성되며, 각 항목은 개별적으로 번호가 매겨집니다.
account 계정 전체에 걸친 비공개 채팅, 봇 및 일반 그룹의 순서
status (시퀀스별) applicable, 또는 not_applicable 와 함께 reason
observed_from, observed_to, span 최초 및 최종 관측 번호와 범위 크기
observed, observed_without_content 관측된 번호; 삭제 또는 재확인 기록을 통해서만 확인된 번호
missing, density, gap_ranges, largest_gap 관측된 적이 없는 숫자, 해당 범위에서 차지하는 비율, 실행 횟수, 가장 긴 실행 횟수
clusters[] 나열된 누락 사항: low, high, missing, 그리고 인접한 관측 번호들 after / before 및 관측 시간
service_estimate 활성화된 경우에만: 관측된 비율을 기준으로 누락된 번호 중 서비스 메시지일 것으로 추정되는 수. 다음에서 차감되지 않음: missing

유효성은 저널을 통해 도출되며, 결코 가정되어서는 안 됩니다:

  • 채널과 슈퍼그룹은 채팅 단위로 측정되며, 선택한 채팅을 내보낼 때도 마찬가지입니다. 발신자가 선택한 기록이 측정 기준이 됩니다. not_applicable.
  • 계정 전체 시퀀스는 ‘전체 계정 수집’ 기능이 활성화된 동안 수신된 첫 번째 메시지부터 마지막 메시지까지만 측정되며, 비공개 채팅, 봇, 일반 그룹 및 계정 자체 메시지를 모두 포함하며, 이러한 채팅 중 어떤 것도 제외되지 않습니다(scope.changed). * deletion.unscoped 'count'로 명명된 숫자는 내용 없이 관측된 것으로 간주됩니다. 선택한 채팅의 내보내기나 인계만으로는 이를 측정할 수 없습니다. 전체 계정 수집 기능이 꺼졌다가 다시 켜진 경우, 그 사이에 사용된 숫자는 공백으로 표시된다는 메모가 나타납니다.
  • 서비스 메시지는 고유 번호가 부여된 저널 기록이므로 간격을 자동으로 메웁니다. 선택 사항인 추정치는 단지 맥락을 제공하는 역할만 합니다.

verify.py 재계산 gap_summary from events.jsonl 서명된 coverage.json 멤버(구형 아카이브의 경우 기본값)의 매개변수를 사용하여재계산하고, 커버리지 요약에 계정 전체에 대한 행을 출력합니다. 아카이브의 get_capture_status(MCP 및 명령줄)은 특정 액세스가 읽을 수 있는 채팅에 대해 동일한 측정값을 반환하지만, 전체 작업 공간을 포괄하는 액세스에 대해서만 계정 전체 시퀀스를 반환합니다.

동일한 서비스 메시지에 대한 반복 관측은 한 번만 집계되며, 계정 서비스 추정치는 측정 범위 내의 숫자만 사용합니다. 적용된 범위는 계정 전체 측정이 활성화되기 전에 계정 자체의 메시지를 명시적으로 보존해야 하며, 측정은 해당 정보를 포함하는 기록부터 시작됩니다. 측정 범위는 실행 중인 관측을 포함하며, 관측 재개 시에는 이를 기록합니다. 실시간 아카이브 쿼리에는 데이터베이스 스캔을 포함한 시간 예산이 할당되며, 완료되지 않은 측정은 부분 측정으로 표시됩니다.

텔레그램은 별도의 메시지 ID 시퀀스를 문서화합니다. 이 번호들은 관측 결과, 삭제 알림, 재확인 및 관리자 로그 기록을 설명하며, 텔레그램이 보고한 위치에서 특정 번호가 누락된 이유를 나타냅니다.

Telegram가 계정 수신을 중단하면, 관찰을 종료하는 coverage.gap 레코드에는 cause(account_banned, account_frozen, account_deleted, session_duplicated, session_revoked, session_expired, session_ended 또는 not_authorized)와 Telegram 오류가 포함되며, verify.py는 해당 기간이 종료되는 원인을 명시합니다.

커버리지는 기록된 관측 기간, 중단 사항 및 메시지 결과를 종합한 것입니다. 선택한 채팅, 기간 및 첨부 파일 정책과 함께 이를 평가하고, 결과와 기록된 공백을 재확인하여 계정의 업데이트가 얼마나 완벽하게 관측되었는지 확인하십시오.

제작자#

증거 ZIP 파일, 채팅 내보내기, 증인 저널 및 사용자 프로필 파일의 진술서에 포함된 서명된 매니페스트에는 producer가 포함됩니다: 소프트웨어, 버전, 프로젝트(PhishDestroy), 홈페이지 및 소스 저장소. HTML 보고서와 검증기는 이 서명된 프로듀서 기록을 표시합니다. 소스 파일 해시는 신뢰할 수 있는 체크아웃과 비교하기 위해 기록된 소스 트리를 식별합니다. 실행 출처 정보는 GitHub 수집 증명서 또는 (활성화된 경우) Intel TDX 측정을 통해 별도로 확인됩니다. 프로듀서 필드가 생성되기 전에 만들어진 아카이브는 계속 지원되며 레거시 기록으로 식별됩니다.

각 observation.started 레코드에는 관찰한 Telegram 클라이언트의 이름도 명시되어 있습니다: 해당 클라이언트의 api_id (해시는 절대 포함되지 않음), 내장된 공개 키 쌍인지 운영자가 직접 개발한 애플리케이션인지 여부, Telegram의 연결 요청에 포함된 클라이언트 설명, 그리고 IP 모드를 포함한 연결 경로의 종류(프록시 주소나 비밀번호 없음). 이 보고서와 custody.json에는 기록된 시점과 함께 모든 고유한 클라이언트 및 경로가 나열되어 있으며, 목록에 없는 프록시가 응답하지 않은 시간과 Telegram가 서버 주소를 감지한 시간도 포함됩니다. 이보다 앞서 기록된 저널에도 그 내용이 명시되어 있습니다.

사용자 프로필#

프로필 파일(tgwitness-dossier-v1, JSON)은 요청 시 특정 채팅에 대한 저널에 이미 기록된 내용을 바탕으로 생성되며, 텔레그램에서 어떤 정보도 가져오지 않으며 프로필 내용은 절대 저널에 기록되지 않습니다(프로필 활성화 및 비활성화는 dossier.changed로 기록됨). 저장된 메시지가 있는 모든 사용자에 대해 이름과 사용자 이름 이력, 저장 시점에 표시된 텔레그램 플래그 (봇, 사기, 가짜, 프리미엄, 인증됨, 제한됨, 삭제됨), 프로필 사진 ID, 로컬 아바타 캐시에 저장된 아바타의 SHA-256 및 지각적 해시(pHash, imagehash.phash와 호환), 활동 내역(첫 번째 및 마지막 메시지, 수치, 수정 및 삭제된 공유 내역, UTC 시간대별 메시지), 누가 누구에게 답장했는지, 해당 인물이 글을 작성한 , 해당 인물이 글을 작성한 이 저널 내의 다른 채팅, 언급된 지갑(BTC, EVM, TRON, TON, LTC, DOGE, XMR, SOL; Base58Check 주소는 체크섬 검증을 거침), 전화번호, 사용자 이름 및 텍스트 뒤에 숨겨진 링크를 포함한 링크 등이 포함됩니다.

모든 사실 항목에는 해당 사실이 유래한 저널 기록(seq)이 명시되어 있으며, record_hashes에는 참조된 각 기록의 해시가 저장되어 있습니다. 이 진술은 워크스페이스 키로 서명됩니다:

python verify.py tgwitness-dossier-CHAT.json --fingerprint TRUSTED_SHA256 --evidence tgwitness-evidence.zip

서명을 확인하고, 증거 내보내기 파일 자체(서명, 해시 체인 및 파일)를 검증하며, 참조된 모든 기록이 동일한 작업 공간의 해당 내보내기 파일에 변경 없이 존재하는지 확인합니다. 아바타 해시는 로컬 캐시에서 유래한 것으로 표시됩니다 (저널 기록이 아님). 멘션은 패턴 일치 결과이며 확인해야 할 단서입니다. 프로필은 채팅별로 활성화되며, 암호로 보호된 AES-256 ZIP 파일로 내보낼 수 있고, 비활성화되거나 채팅이 소스에서 제거되면 삭제됩니다.

독립적인 증인#

위트니스 저널(tgwitness-witness-v1)과 그 채널 게시물은 verify.py --witness … --channel … 명령을 사용하여 증거 내보내기 파일과 대조하여 검증됩니다. 독립 위트니스를 참조하십시오. 공개 https://t.me/s/… 또는 https://telegram.me/s/… 주소를 통해 검증자는 텔레그램에서 각 게시물의 날짜를 읽어오며, 내보내기 파일의 맨 앞부분에 있는 게시물 중 가장 이른 날짜가 마지막 기록에 대한 외부 시간으로 간주됩니다. 다른 출처의 날짜는 제공된 메타데이터로 간주됩니다.

매니페스트 및 체크포인트#

manifest.json에는 형식, 내보내기 시간, 공개 키, 지문, 저널 길이, 헤더 해시, 범위, 생성자, 제한 사항, 그리고 manifest.json 및 manifest.sig 자체를 제외한 모든 콘텐츠 구성원의 SHA-256 해시가 포함됩니다. manifest.sig는 정규화된 매니페스트 JSON에 대한 base64 Ed25519 서명입니다. 검증기는 예상치 못한 구성 요소나 누락된 구성 요소, 중복된 이름, 손상된 파일, 손상된 시퀀스/체인, 유효하지 않은 서명, 제공된 체크포인트와의 불일치를 거부합니다. 검증기는 아카이브 경로를 절대 추출하지 않습니다. 선언된 총 비압축 크기를 4 GiB로 제한하며, --max-gib N 옵션을 사용하면 ‘더 많은 도구 → 매개변수’에서 제한을 높여 더 큰 아카이브를 만들 수 있습니다.

대용량 아카이브는 여러 프로세스에 의해 동시에 검사됩니다. 멤버들은 병렬로 해시 처리되며, 처음 5,000개의 레코드가 처리된 후에는 각 레코드의 콘텐츠 해시와 서명이 워커 프로세스에 의해 검사되는 동안, 메인 프로세스는 체인, 커버리지 및 바인딩을 순서대로 추적합니다. --jobs N 프로세스 수를 설정합니다. 기본값은 auto 는 CPU당 하나씩, 최대 16개를 사용하며, --jobs 1 모든 작업을 하나의 프로세스에서 처리합니다. 두 경우 모두 결과는 동일하며, 변경 요청 시 동일한 오류 메시지가 반환됩니다. 보존된 체크포인트와 타임스탬프 앵커가 지정한 위치의 해시는 해당 단일 통과 동안 유지되므로, 각 앵커는 저널을 다시 읽지 않고도 비교됩니다. 32스레드 컴퓨터에서 400,000개의 레코드가 포함된 10.8 GB 아카이브를 처리하는 데 단일 프로세스에서는 58.9초, 4개 프로세스에서는 15.2초, 16개 프로세스에서는 8.4초가 소요되었으며, 레코드를 순서대로 한 번 스캔한 후 처리 한도가 설정됩니다.

설치된 TgWitness 버전이나 검토를 거친 체크아웃에서 검증 작업을 실행하십시오. 아카이브에 포함된 사본은 이동식 사용을 지원합니다. 실행하기 전에 해당 사본을 신뢰할 수 있는 설치본과 대조하여 확인하십시오.

체크포인트는 공개 키, 저널 길이, 헤더 해시 및 생성 시간을 포함하는 진술에 서명합니다. 또한 워크스페이스가 가져온 최신 drand 라운드(drand_anchor )도 포함합니다: 수집기는 각 주기적 체크포인트 전에 워크스페이스의 외부 경로를 통해 drand 릴레이에 요청하므로, IP 숨기기, 프록시 및 비활성화된 외부 경로가 적용되며, 체크포인트 생성 자체는 외부로 연결되지 않습니다. 검증자는 후속 아카이브에 동일한 접두사가 포함되어 있는지 확인할 수 있습니다. --checkpoint 와 --check-drand 를 사용하면 drand 중계 서버를 통해 해당 라운드를 확인하고, 체크포인트가 해당 라운드의 시간보다 이른 시점에 서명되지 않았음을 보고합니다. 이 라운드는 보증 등급을 변경하지 않습니다. 체크포인트를 수집기 외부에 보관하므로, 이후 검증 시 아카이브를 수집기와 별도로 보관된 참조 자료와 비교합니다. 수집기 키로 서명되므로, 수신자가 아카이브보다 먼저 다른 채널을 통해 이를 입수한 경우에만 해당 기록이 수집기와 연결됩니다. 이 자체만으로는 증거의 최소 요건을 충족하지 못합니다.

검증 결과 읽기#

검증기는 아카이브 무결성, 서명자 고정 및 보증 검사를 각각 별도로 보고합니다. 유효한 서명은 해당 바이트가 서명된 이후로 변경되지 않았음을 나타냅니다. 운영자는 별도의 채널을 통해 수신자에게 키 지문을 전달합니다. --fingerprint, 손상되지 않은 아카이브는 서명 및 형식 검사를 통과하며 signer_pinned: false, 그리고 마지막 줄은 EVIDENCE: minimum not met · missing: confirmed signer key.

고정된 서명자와 증거에 필요한 최소한의 요건을 요구하는 자동화된 로컬 아카이브 정책의 경우:

python -m tgwitness.verify evidence.zip --strict --json --fingerprint TRUSTED_KEY_SHA256 --tsa-ca TSA-ROOT.pem --require evidence

수신자의 신뢰할 수 있는 채널을 통해 보존된 지문을 사용하십시오. 신뢰할 수 있는 증인은 일관된 증인 저널을 통해 수집기를 고정할 수도 있습니다. --witness, --witness-fingerprint 및 --require-witness를 지정하십시오. --strict는 고정되지 않은 서명자에 대해 상태 2로 종료되며, 충족되지 않은 --require-tier 또는 --require evidence도 상태 2로 종료됩니다. --require evidence는 --fingerprint와 마지막 기록을 포함하는 제3자의 외부 시간을 필요로 합니다. 단순히 종료 코드만 확인하지 말고 signer_pinned, requirements_met 및 보증 결과를 확인하십시오. 반면, Sealed acquisition은 자체 인증 검증기 및 승인된 정책을 사용하여 획득 다이제스트를 인증합니다.

검증 범위#

검증 과정에서는 아카이브와 이를 생성하는 데 사용된 수집 모드를 확인합니다. 해당 사례에 맞는 신뢰 경계를 가진 모드를 선택한 다음, 해당 모드의 검증 입력값을 유지하십시오.

수집 모드 검증자가 확인하는 사항 검증 입력값 및 신뢰 경계
로컬 작업 공간 서명, 해시 체인, 매니페스트 및 첨부 파일 바이트 기록 수신자가 보유한 수집기 지문 및 제3자로부터 제공된 외부 시간: 검증된 RFC 3161 또는 OpenTimestamps 영수증, 혹은 t.me에서 읽은 증인 게시물. 보존된 체크포인트 및 증인 기록은 검증의 근거가 됩니다.
독립적인 위트니스가 포함된 로컬 작업 공간 아카이브 검증 및 증인이 보관하고 있는 이전 저널 접두사와의 일치 여부 위트니스 지문과 기록. 보관자의 키 관리 기록은 위트니스 키를 누가 보유하는지 보여 줍니다. --channel https://t.me/s/…을 사용하면 텔레그램이 게시물에 부여한 날짜가 외부 시간을 제공합니다
GitHub Actions 캡처 아카이브 다이제스트, 승인된 워크플로우 및 수집기 커밋, 호스팅된 러너, 새로운 세션/키 출처 및 내부 아카이브 무결성에 대한 GitHub 인증 신뢰할 수 있는 검증자 정책, 호출자 저장소 및 GitHub 증명 번들; 수집 작업은 고정된 워크플로우에서 실행됩니다.
클라우드 배포 프로바이더의 라이프사이클 및 액세스 기록, 방화벽 및 Cloudflare 상태, 그리고 수집기의 서명된 실행 기록 프로바이더 및 Cloudflare에 대한 읽기 전용 쿼리; 개별 확인 기능의 이용 가능 여부는 프로바이더에 따라 다릅니다.
Intel TDX 기밀 VM 서명 및 플랫폼 상태를 인용하고, 수집기 진술, 구성 및 OS 측정값과 연계하십시오. 인텔 트러스트 체인 및 예상 배포 측정값; 모든 필수 TDX 검사 결과를 그대로 유지하십시오.

밀봉된 수집 방식에서, 승인된 수집자는 검증된 환경 내의 인증된 텔레그램 연결을 통해 데이터를 수신합니다. 증명(Attestation)은 아카이브를 해당 실행에 바인딩하므로, 검증은 수집 과정은 물론 이후의 파일 무결성까지 포함합니다. 이는 승인된 코드와 위에 나열된 플랫폼 신뢰 체인에 의존합니다. GitHub 캡처 검증은 실행 내부에서 생성된 세션을 요구하며, 가져온 세션(imported-session) 캡처는 거부합니다.

실행 영수증에는 수집기 버전, 파일 해시 및 시작 설정이 기록됩니다. GitHub 출처 정보와 TDX 측정값을 통해 환경 검증이 이루어지며, 유효성 검사 기록을 통해 테스트된 구성이 식별됩니다.

메시지의 출처#

텔레그램은 MTProto 세션 내에서 공식 앱을 포함한 모든 클라이언트에 메시지를 전달합니다. 세션의 인증 키는 텔레그램의 고정 서버 키를 기준으로 협상되며, 모든 업데이트는 해당 키를 통해 암호화되고 무결성 검증을 거친 후 도착합니다. 수집기는 계정의 인증된 세션을 통해 메시지를 수신하고, 메시지가 도착하는 즉시 채팅, 메시지 및 발신자 식별자와 텔레그램이 각 메시지에 설정한 날짜를 포함하여 저널에 각 관측값을 기록합니다. GitHub 액션 캡처 및 Intel TDX 배포 시, 인증 과정을 통해 해당 세션과 서명 키가 승인된 수집기 실행에 바인딩됩니다.

저널은 인증 키의 출처를 기록합니다. 휴대폰이나 QR 코드를 통한 로그인, 또는 세션 파일을 통한 독립적인 로그인 시, account.authorized에 key_origin: "created"가 기록됩니다; 가져온 .session, TData 또는 JSON 키를 사용하여 수집할 경우 imported가 기록됩니다. 가져온 키는 그 출처와 관계없이 어디에나 존재합니다. 검증된 배포 환경은 가져온 키를 거부합니다.

레코드의 텔레그램 출처는 계정의 인증된 연결, 저널 내의 연결 및 캡처 레코드, 저널 항목과 일치하는 캡처된 MTProto 프레임 (tgwitness/forensics/), 각 메시지의 텔레그램 날짜, 그리고 인증된 캡처의 경우 검증된 실행 환경에 근거합니다. 아카이브 서명은 나중에 확인할 수 있도록 해당 기록을 보존합니다. 보존된 체크포인트는 이전 저널의 경계를 확정하고, 커버리지 기록은 수집 결과를 보여주며, 검증된 외부 타임스탬프는 커밋된 바이트의 시간적 위치를 명확히 합니다.

로컬 작업 공간의 경우, 수신자가 신뢰할 수 있는 수집기 또는 증인 입력을 제공합니다. 봉인된 수집의 경우, 신뢰 정책 및 증명(attestation)을 통해 아카이브 다이제스트를 승인된 수집기 실행에 바인딩합니다. 이는 서로 다른 검증 경로이며, 선택된 경로에 대해 완료된 검사를 보고하십시오.

첨부 파일#

파일은 media/ 디렉터리 내에서 SHA-256 해시로 식별됩니다. media.saved 이벤트는 해시와 바이트 길이를 특정 메시지 이벤트에 연결합니다. 원본 파일명은 메타데이터이며, 절대 로컬 경로가 아닙니다. 미디어 바이트는 비동기 방식으로 다운로드되므로, 즉시 삭제할 경우 캡처가 이루어지지 않을 수 있습니다. 수집 비활성화, 크기 초과/알 수 없는 크기의 파일, 다운로드 실패, 및 중단된 다운로드는 결과로 표시됩니다. 프로세스 충돌 시 참조가 없는 부분 파일이 남을 수 있으며, 이러한 파일은 내보내기 대상에 포함되지 않습니다.

ZIP 내보내기 기능은 저장된 미디어 파일을 파일명과 대조하여 검증합니다. JSONL, CSV 및 HTML 내보내기 기능은 이벤트 서명을 검증하지만 미디어 바이트는 포함하지 않습니다. 파생 보고서는 편의상 제공되는 것이며, events.jsonl 파일이 공식적인 이벤트 표현입니다.

전체 채팅 내보내기를 수행하면 워크스페이스의 첨부 파일 설정에 따라 첨부 파일이 media/ 폴더 내에 SHA-256라는 이름으로 저장됩니다. chat.json의 각 메시지 기록은 파일 이름(file, file_sha256) 또는 파일이 없는 이유(file_status)를 명시하며, 독자가 본 텍스트 주변의 정보(텍스트 뒤의 링크, 전달 출처, 봇 버튼, 서명, 조회수 및 자동 삭제 타이머)도 함께 포함합니다. verify.py는 명명된 모든 파일이 해당 해시 아래의 서명된 매니페스트에 포함되어 있는지 확인합니다.

내구성 있는 수집 및 처리 영수증 (0.2)#

미디어 작업과 해당 메시지 이벤트 커밋이 하나의 트랜잭션으로 처리됩니다. 이 작업은 원본 TL 메시지 설명자를 저장하며, 서명된 관측 기록은 SHA-256, 계정, 및 크기 정책을 바인딩합니다. 복구 과정에서는 다운로드 전에 해당 바인딩을 검증합니다. 이 도구는 현재 메시지를 가져오지 않으며, 새로운 첨부 파일을 자동으로 대체합니다. 중단된 작업은 재시도되지만, 영구적인 실패는 명시적인 결과로 남습니다.

각 작업 공간에는 고유한 저널과 서명 주체가 있습니다. process.started 이벤트에는 실행 ID, 로컬 시계, 종속성 버전, 소스 파일 해시, 초기 계정/범위, 및 캡처 설정이 포함됩니다. 하트비트에는 실행 ID, 단조 증가 시간 및 큐 상태가 포함됩니다. 실행 영수증은 별도로 서명된 명세서로도 다운로드할 수 있습니다. 실행 환경의 검증을 위해서는 ‘검증 범위’에 설명된 GitHub 증명서 또는 TDX 검사와 함께 사용하십시오.

자동 체크포인트는 시작 시, 관찰 중 5분마다 (추가 도구 → 매개변수 → 서명된 체크포인트 간격), 그리고 정상 종료 시 로컬에 보관됩니다. 시작 검증 및 내보내기 과정에서는 저널을 가장 최근에 보관된 로컬 체크포인트와 비교합니다. 이를 통해 체크포인트가 보존된 경우 데이터베이스 롤백을 탐지할 수 있습니다. 독립적인 보존 기능을 통해 해당 참조를 작업 공간 외부에서도 이용할 수 있으며, 검증된 외부 타임스탬프를 통해 시간적 기준점을 추가로 확보합니다.

재시작 후 저장된 텔레그램 업데이트 위치가 재개됩니다(catch_up_from in observation.started)이며, 놓친 업데이트가 요청됩니다. 저장된 위치는 처리가 완료된 업데이트만 포함하므로, 연결이 끊기거나 프로세스가 중지되었을 때 아직 대기 중이던 업데이트는 다시 요청됩니다. 주기적인 재검사를 통해 message.recovered 누락된 메시지를 확인하고 message.missing_on_recheck Telegram이 더 이상 저장된 메시지를 반환하지 않을 때를 기록합니다. 후자는 삭제 알림이 아니며, 삭제자나 시간을 명시하지 않습니다.

오프사이트 백업 및 복원 (S3)#

오프사이트 복사본(설정 → 알림 및 오프사이트 복사본 → 오프사이트 복사본, 또는 추가 도구 → 기타 → 증거 및 백업; 기본적으로 비활성화됨)은 저널 세그먼트, 보존된 파일, 체크포인트 및 해당 타임스탬프, 완료된 채팅 내보내기 데이터를 S3 호환 스토리지에 업로드하며, 업로드 전에 워크스페이스 볼트에 보관된 키를 사용하여 AES-256-GCM으로 암호화됩니다. 버킷이 이를 지원하는 경우 Object Lock 보존 정책이 적용됩니다. 다운로드한 키가 없으면 이 복사본을 읽을 수 없습니다. python -m tgwitness.replica restore --key-file KEY.json --out DIR 명령어를 사용하여 복원 및 검증하십시오.

복원 작업에는 빈 일반 디렉터리가 필요합니다. 다운로드된 파일과 복호화된 객체는 전체 저널과 모든 보존된 체크포인트가 검증될 때까지 비공개 임시 저장소에 보관됩니다. 안전하지 않은 객체 경로, 일관되지 않은 세그먼트 범위, 체크포인트보다 짧은 저널은 거부되며, 검증에 실패한 경우 복원된 파일은 게시되지 않습니다. 보존 기간 확인은 반환된 오브젝트 잠금 모드와 날짜를 업로드 시 전송된 마감 기한과 비교합니다(1초의 반올림 허용 오차 적용). 만료되었거나, 유효하지 않거나, 단축된 마감 기한은 검증된 것으로 간주되지 않습니다. 상태는 해당 업로드 과정에서 보존 기간 정보가 읽혀진 표본 오브젝트를 보고합니다.

누락되거나 손상된 로컬 미디어는 해당 패스의 오류로 보고되며, 미디어 커서는 해당 위치 앞에 유지되므로 다음 패스에서 파일이 다시 시도됩니다. 그 이후의 파일, 체크포인트 및 내보낸 데이터는 여전히 복사됩니다. 복원 과정에서는 보존된 모든 미디어 참조를 복호화된 해시 및 기록된 크기와 대조하여 확인합니다. 중단된 업로드에서 발생한 동일한 중복 저널 세그먼트는 중복 제거되며, 충돌하는 중복 부분은 거부됩니다. 업로드 중에 생성된 체크포인트는 해당 체크포인트가 포함하는 저널 기록이 복사될 때까지 보류되므로, 완료된 패스는 해당 저널보다 앞서 체크포인트를 게시하지 않습니다.

스트리밍 내보내기 스냅샷#

스트리밍 내보내기는 안정적인 SQLite 읽기 스냅샷을 사용합니다. 다운로드가 완료될 때 이 스냅샷의 최상위 항목은 현재의 실시간 저널보다 오래된 것일 수 있습니다. 해당 스냅샷 이후에 생성된 체크포인트는 아카이브의 크기가 더 작다고 올바르게 보고할 수 있습니다. 임의의 이후 체크포인트가 아닌, 내보낸 접두사 시점 또는 그 이전의 체크포인트와 비교해야 합니다.

RFC 3161 준비 및 응답 검증 (0.2)#

증거 모드는 각 서명된 체크포인트의 SHA-256 해시값만을 나열된 RFC 3161 인증 기관 및 OpenTimestamps 캘린더로, MTProxy를 경유하지 않고 워크스페이스 경로를 통해 전송합니다. 타임스탬프는 모든 설정 목표에서 기본적으로 활성화되어 있으며, 사례에 대한 증거에는 drand도 기록됩니다. 응답은 checkpoints/anchors/에 저장되며, .tsr 및 .ots 파일로 내보내져 anchors/, 파일 아래에,및 verify.py (--tsa-ca TSA 서명을 확인하며, OpenTimestamps 증명은 다음 명령어로 확인합니다 ots upgrade 및 ots verify).

RFC 3161 권한이 연속으로 두 번 실패하면 다음 시도를 하기 전에 대기합니다: 1간격, 그다음 2, 4시간 등 최대 6시간까지, 또는 Retry-After에 지정된 시간(최대 1일) 동안 대기합니다. 대기 중인 권한만 발견된 패스는 기록을 작성하지 않습니다. 그렇지 않은 경우 anchor.completed는 deferred 아래에 retry_at와 함께 해당 권한들을 나열합니다. 해당 권한들이 다시 응답할 때까지 패널은 타임스탬프를 ‘Degraded’로 표시합니다.

패널은 표준화된 checkpoint.json 바이트, SHA-256 메시지 임프린트 및 timestamp.tsq 내의 무작위 논스, 체크섬 및 지침이 포함된 요청 아카이브를 준비합니다. 네트워크 요청은 수행되지 않으며, 권한 기관이 이 요청에 대해 반환하는 토큰은 타임스탬프입니다.

python -m tgwitness.anchor verify는 OpenSSL 없이 응답을 체크포인트 바이트 및 원래 요청과 대조합니다. 신뢰할 CA 파일은 명시적으로 지정해야 하며, 포함된 인증서는 자동으로 신뢰되지 않습니다. CLI에서 요청 확인은 선택 사항이므로 요청을 보관하고 nonce를 확인하려면 --request를 지정하세요. 확인 여부는 결과에 표시됩니다. 수집기의 체크포인트 서명과 저널은 여전히 신뢰하는 수집기 지문으로 따로 검증해야 합니다.

검증 과정에서는 응답 서명, 체크포인트 바이트 및 (제공된 경우) 지정된 CA 신뢰 체계 하의 원본 요청을 확인합니다. 증거 모드에서 얻은 타임스탬프의 경우, verify.py가 저장된 OCSP 또는 CRL 증거(서명 인증서 취소)도 확인합니다. 절차 및 검증 결과를 참조하십시오.

증거 모드에서 선택 가능한 기록 항목: drand 및 Telegram 장치#

타임스탬프와 동일한 패스에서 두 개의 레코드가 더 실행될 수 있습니다. 두 레코드 모두 증거 모드가 켜져 있을 때만 적용됩니다. 사건에 대한 증거가 있으면 drand가 켜지고, 그렇지 않으면 두 레코드 모두 시작됩니다. ‘추가 도구 → 부가 기능 → 증거 및 백업 → 추가 증인 · 선택 사항’에서 이들을 전환하거나, "drand": true 그리고 "devices": true 에서 POST /api/evidence에서 설정할 수 있습니다. 한 가지가 실패하더라도 다른 기능이나 타임스탬프 기능은 중단되지 않으며, 패널에는 양식 아래에 각 기능의 최신 결과가 표시됩니다.

drand (beacon.drand ). 각 패스(pass)는 drand quicknet의 최신 라운드, 즉 League of Entropy의 공개 난수(3초마다 한 라운드)를 저널에 기록합니다: chain , round , randomness , signature , round_time 및 응답한 relay . 검증된 예측 불가능한 라운드는 후속 해시 연결 자료에 대한 하한 시간 기준을 제공합니다. 후속 체크포인트의 검증된 타임스탬프는 상한 시간 기준을 제공합니다. 이러한 검사는 연결된 자료를 제한합니다. 수집기는 먼저 drand.cloudflare.com 에 요청한 다음, 워크스페이스 경로를 통해 Protocol Labs의 릴레이에 요청하며, 패스당 하나의 요청을 보냅니다.

verify.py 는 각 난수 값이 해당 서명의 SHA-256 와 일치하는지, 그리고 라운드 시간이 올바른지 확인하며, 라운드 수, 라운드가 없었던 가장 긴 구간, 그리고 수집기 시계가 drand보다 얼마나 뒤처져 있었는지를 보고합니다. --check-drand 는 라운드를 Cloudflare 중계 서버 및 Protocol Labs 중계 서버와 비교하며, 전체 라운드 또는 긴 저널 내 무작위 표본 100개를 대상으로 합니다. 차이가 있는 라운드는 검증에 실패합니다.

, Telegram, (account.devices) 기기. 각 실행 단계에서는 account.getAuthorizations를 통해 계정의 세션을 읽고, Telegram 목록은 [설정] → [기기]에 표시되며, 이를 기록합니다: 이전 처리 이후 변경된 경우 전체 내용을 added 및 removed 세션 해시와 함께 기록하고, 그렇지 않은 경우 개수와 SHA-256만 기록합니다. 기기 모델, 플랫폼, 앱 및 버전, 생성일 및 마지막 활동일, 국가 및 지역은 보관되지만, IP 주소는 보관되지 않습니다. 이는 증거 자료가 외부로 유출될 수 있기 때문입니다. 수집기 자체의 세션은 항상 활성화된 상태이므로, 다른 세션의 활동만 변경 사항으로 간주됩니다. verify.py는 목록이 기록된 횟수와 각 신규 및 종료된 세션을 보고합니다. 이 세션은 관찰이 진행되는 동안에만 목록을 읽습니다.

이들이 보여주는 내용: drand는 기록을 공개된 시간 순서대로 정렬하며, 장치 목록은 수집기를 통해 전달된 텔레그램의 성명서로, 다른 모든 기록과 마찬가지로 수집기에 의해 서명됩니다.

Cloudflare Gateway 로그 (cloudflare.gateway_dns). 다음 경로를 통해 해결되는 서버의 경우 Cloudflare 게이트웨이 ( 게이트웨이 DNS ), 각 전송 시 이전 복사 이후 게이트웨이에 기록된 내용을 복사합니다: 최대 3시간 단위의 창당 하나의 레코드로, from, until, location_id, 서버의 address(설정된 경우), 그리고 queries를 [at, name, type, rcode, decision, colo]로, 또한 기록이 없는 경우에도 동일하게 처리합니다. 아래에서 설정하세요. Cloudflare 게이트웨이 로그 : 계정, 위치, 선택적 주소 및 읽기 전용 토큰(계정 Analytics 읽기; 공유 위치의 주소 하나를 유지하기 위한 Zero Trust PII 읽기). 패널은 저장하기 전에 하나의 요청으로 이를 확인하며, 토큰은 암호화된 상태로 유지되어 로그에 기록되지 않습니다. verify.py에는 창, 가장 많이 조회된 이름 및 복사본이 포함되지 않은 시간이 나열되며, 쿼리 수와 일치하지 않는 레코드는 실패합니다. 단 1초 동안 한 페이지 이상의 쿼리를 포함하는 창은 해당 페이지를 유지하고 나머지는 누락되었다고 표시합니다. 이 사본은 컬렉터를 통해 제공된 Cloudflare의 응답으로, 컬렉터가 서명합니다. 24시간 이내에 읽기 전용 토큰을 보유한 사용자는 이를 Cloudflare와 비교할 수 있습니다.