문서 / 02
Telegram · GitHub Actions 캡처
임시 GitHub 실행기에서 Takeout, 일반 API 내보내기 또는 채팅 기록을 선택하세요.
전체 참고 문헌
main에서 미리 보기가 가능합니다. 포크를 실행하면
phishdestroy/TgWitness에서 고정된 재사용 가능한 워크플로를 실행합니다. 이 워크플로는 새로 생성된 텔레그램 세션을 사용하여 계정, 선택된 채팅 또는 하나의
채팅 이벤트 저널을 내보내고, 증거
ZIP 또는 멀티파트 매니페스트를 인증하며,
수신자 암호화 핸드오프만 업로드합니다. 일반 관리 패널은 노출되지 않습니다.
다음 중 하나를 선택하세요 client=official_web Telegram Web 컨트롤과 동영상이 보호된 상태에서 공식 클라이언트 위트니스를 실행하도록 선택하십시오. 이를 위해서는 자체 업스트림 프록시가 필요하며, 렌더링된 채팅 하나를 모니터링합니다. 기본 설정은 client=api 아래에 설명된 전체 계정 내보내기 모드를 유지합니다.
검증자는 아카이브를 GitHub 인증 정보, 승인된 워크플로우 및 수집기 커밋, 그리고 서명된 저널 및 첨부 파일 해시와 대조하여 확인합니다. 수집 과정에서는 고정된 업스트림 코드와 새로운 저장소를 사용합니다. 검토자는 해당 코드를 검토하고, 전달된 아카이브를 기록된 실행 내역과 대조하여 검증할 수 있습니다.
이 페이지에서
사용자 흐름#
도움말에서는 5단계에 대해 설명하고, 샘플 데이터를 사용하여 메시지 또는 수집기 대체 기능을 직접 시도해 볼 수 있게 해줍니다. ‘캡처 시작’을 클릭하면 마법사가 열립니다.
- 프로젝트 홈페이지,
워크스페이스 로그인 화면 또는 ‘내보내기 → 캡처 헬퍼 열기’에서 GitHub Actions 캡처(미리보기)를 선택하세요. 또한
최신 브라우저에서 공식 헬퍼
또는 신뢰할 수 있는 체크아웃의
tgwitness/static/capture.html을 열 수도 있습니다. 이 헬퍼는 키나 파일 처리를 위해 네트워크 요청을 보내지 않습니다. 이 헬퍼는 사이트의 인터페이스 언어를 지원하며, 임시 수집 패널은 영어와 러시아어를 지원하며, 브라우저 언어가 이 중 하나일 경우 해당 언어로 열립니다. - 키를 생성하고 sealed-key.json 파일을 저장하세요. 이것이 유일한 개인 복호화 키입니다. 별도의 공개 수신자 값을 복사해 두세요. 개인 키를 분실하면 연결과 아카이브 모두에 접근할 수 없게 됩니다. 다음 단계로 진행하려면 파일을 저장했는지 확인하세요. 이미 전송 파일이 있는 경우, 저장된 키를 불러온 다음 ‘이미 아카이브가 있습니다’를 선택하세요.
- TgWitness를 포크하고, 포크된 프로젝트에서 ‘Actions’ 기능을 활성화한 다음, ‘Sealed chat capture’를 실행하세요. 공개 수신자를 붙여넣고 30분, 60분 또는 120분 중 하나를 선택하세요. 절대로 전화번호, 로그인 코드, 텔레그램 비밀번호, 개인 키 또는 세션을 워크플로우 입력값, 커밋, 이슈 또는 로그에 포함하지 마세요.
- 실행 중에 Artifacts에서 sealed-connection을 다운로드하여 압축을 풀어주세요.
저장된 개인 키를 사용하여
connection.tgwsealed저장된 개인 키를 사용하여 헬퍼에서 로드하십시오. 생성된 링크의 URL 프래그먼트에는 무작위 액세스 시크릿이 포함되어 있습니다. 이 링크는 비공개로 유지하십시오. 패널은 프래그먼트를 제거하고 시크릿을 이 탭의 세션 저장소에 보관하며, HTTP 액세스 로그에는 기록되지 않습니다. - 연결 링크를 엽니다. QR 코드나 전화번호와
로그인 코드를 사용하여 로그인합니다. 텔레그램에서 요청할 경우 2단계 인증 비밀번호를 입력하세요.
일반 작업 공간과 마찬가지로 기본적으로 내장된 API 자격 증명 풀이 사용됩니다.
선택 사항인 사용자 지정 자격 증명 섹션을 확장하여 다음 두 가지를 모두 입력할 수 있습니다
api_idmy.telegram.org/apps에서 가져온api_hashmy.telegram.org/apps에서 가져온 값을 모두 입력할 수 있습니다. 내장 풀을 사용하려면 두 필드를 모두 비워 두십시오. 불완전하거나 형식이 잘못된 쌍은 거부됩니다. 세션 가져오기는 허용되지 않습니다. 내보내기 모드와 범위를 선택하십시오. 연결 링크에는 액세스 시크릿이 포함되어 있으므로, 이를 비공개로 유지하십시오. - Telegram Takeout, 일반 Telegram API 또는 채팅 이벤트 로그 중 하나를 선택하세요. 계정 내보내기의 경우, 접근 가능한 모든 채팅을 선택하거나 하나 이상의 채팅을 불러와 선택한 다음, 날짜, 채팅 유형, 계정 카테고리 및 첨부 파일 규칙을 설정하세요. 설정과 크기를 확인하고, 필요에 따라 독립적인 검토자를 위해 설정 JSON을 저장한 다음, ‘캡처 시작’을 누르십시오. 시작 후에는 설정을 변경할 수 없습니다. ‘재개’ 기능은 이 러너가 존재하는 동안에만 작동하며, 조기 종료 시 수집된 데이터는 보존되고 누락된 부분이 기록됩니다. 시작 후 마감 기한이 만료되면 명시적으로 부분 아카이브가 생성되며, 시작 전 마감 기한 만료 또는 취소 시 아카이브는 생성되지 않습니다.
- 봉인된 결과를 기다린 후, 파일을 다운로드하고 압축을 풀고,
delivery.tgwsealed헬퍼에서 해독하십시오. 다음과 같은 파일을 받게 됩니다delivery.zip, 여기에는evidence.zip,attestation.jsonl, 및 지침이 포함되어 있습니다. 브라우저를 통한 복호화는 256 MiB로 제한됩니다. 이보다 큰 패키지의 경우 아래의 로컬 스트리밍 명령을 사용하십시오. 대용량 결과물에는delivery-NNNNNN.tgwsealed부분으로 구성되며, 메인delivery.tgwsealed파일에는evidence.parts.json및 인증 정보를 포함합니다. 모든 파트를 다운로드하고 아래 설명된 대로 로컬에서 조립하십시오. - 권한 철회가 확인되지 않았거나 실행 프로세스가 강제 종료된 경우, 텔레그램 설정 → 기기에서 임시 세션을 종료하십시오. 정상적으로 완료되면 로그아웃을 요청하며, 실행 기록에는 권한 철회가 확인되었는지 여부가 기록됩니다.
저장소에는 게시된 고정된 소스 및 재사용 가능한 워크플로우 커밋이 포함되어 있어야 합니다. 로컬 브랜치만으로는 다른 GitHub 저장소에서 호출할 수 없습니다.
세션 시간 배정#
수집 전에, 메시지 수와 제한된 표본을 바탕으로 선택한 기록 및 파일의 예상 소요 시간과 용량을 계산합니다. 화면에는 로그인에 이미 소요된 시간, 예상 수집 시간, 그리고 파일 압축을 위한 여유 시간이 표시됩니다. 파일의 경우, 초기 추정치는 1 MiB/s의 전송 속도와 2배의 시간 여유를 적용하지만, 진행 상황에 따라 해당 가정치가 측정된 전송 속도로 대체됩니다. 예상 소요 시간이 남은 시간을 초과할 경우, ‘메시지만’을 선택하거나 채팅 수를 줄이십시오.
텔레그램에서 보고된 ‘테이크아웃’ 대기 시간이 예산에 추가됩니다. 수집기는 남은 시간이 패키징에 필요한 경우 수집을 중단하고, 수집된 데이터를 유지한 채 부분 결과로 표시합니다. 따라서 120분 세션은 아카이브를 준비하기 전에 마감 시간을 기다리기보다는 남은 수집 시간을 활용합니다. 화면에는 전체 크기를 샘플링할 수 없었던 선택 항목이 표시됩니다.
이 모드 또는 영구 작업 공간을 선택하세요#
| 촬영 모드 | 설정 가능한 범위 | 차이 |
|---|---|---|
| Telegram Takeout, 기본값 | 사용 가능한 모든 클라우드 채팅 또는 선택한 채팅, 날짜, 계정 카테고리, 미디어 정책 및 JSON/HTML 보기 | 텔레그램의 공식 내보내기 기능을 사용합니다. 승인이 필요하거나 대기 시간이 발생할 수 있습니다. Takeout은 텔레그램에서 허용하는 경우 남아 있는 채널/그룹을 열거하고 추가 개인 데이터를 요청할 수 있습니다. |
| 일반 텔레그램 API | 일반 API를 통해 사용할 수 있는 메서드에 따라 동일한 계정 범위 및 출력 옵션을 적용합니다. | Takeout이 초기화되지 않아, 왼쪽 채널/슈퍼그룹을 열거하거나 Takeout 전용 개인 데이터를 가져올 수 없습니다. 연락처는 저장된 전체 전화번호부 목록이 아닌 텔레그램 사용자를 대상으로 합니다. 사용량 제한은 여전히 적용됩니다. |
| 채팅 이벤트 일지 | 선택된 채팅 하나, 첨부 파일 정책 및 선택적 아바타 | 이번 실행 중에 관찰된 내역과 변경 사항을 기록합니다. 계정 범주, 날짜 필터 및 데스크톱 호환 보기는 적용되지 않습니다. |
세 가지 모드 모두 동일한 GitHub 인증 및 암호화 전송 기능을 제공합니다. Takeout은 수집 방법을 선택하며, 일반 API 액세스로 무단으로 대체되는 일은 절대 없습니다. TgWitness는 캡처된 레코드에서 JSON/HTML 뷰를 생성하고, 수출 시 선택한 수집 방법을 유지합니다. 공식 Takeout API를 참조하십시오.
기본 설정으로는 ‘Takeout’이 사용되며, 보관된 채팅을 포함한 모든 접근 가능한 채팅 유형, 모든 날짜, 계정 프로필 및 연락처, 호환 가능한 JSON 및 HTML, 그리고 파일 다운로드가 포함됩니다. 초기 미디어 할당량은 4 GiB이며, 유형별 파일 용량 제한이 표시됩니다. 이보다 큰 파일이나 다운로드 할당량이 소진된 경우에는 가능한 경우 서버 해시가 사용됩니다. 데이터를 수집하기 전에 이러한 제한 사항을 확인하시기 바랍니다. 해시만으로는 파일을 복원할 수 없습니다. 선택 사항인 사진, 스토리, 세션 메타데이터 및 추가 개인 데이터는 별도로 선택할 수 있습니다.
테이크아웃을 수행하려면 기존 텔레그램 세션에서 승인이 필요할 수 있습니다. 텔레그램이 지연 시간을 설정하며, 새로운 로그인이나 실행 프로그램으로도 이를 우회할 수 없습니다. 최대 캡처 기간은 로그인 및 승인 시간을 포함해 120분으로 제한되므로, 대규모 계정이나 승인 대기 시간이 길 경우 작업이 완료되지 않을 수 있습니다. 영구적인 로컬 내보내기 파일을 사용하면 동일한 세션을 재개할 수 있지만, GitHub 인증 정보는 상속되지 않습니다.
설정에 동의하고 확인하기#
~ 이후 설정 및 크기 확인, 사용 검증을 위해 설정 저장. 동의합니다
그 결과 sealed-export-settings.json 수집 전에 검토자와 협의해야 합니다.
변경 사항이 발생하면 저장된 평가 결과가 무효화됩니다. 수집자는 유효한
설정과 해당 SHA-256에 서명하며, 계정 내보내기 영수증은 동일한 옵션을 구속합니다.
검증자는 실제 모드, 선택 사항 및 완전성을 보고하며,
저널과 중첩된 계정 내보내기 간에 불일치가 있을 경우 이를 거부합니다.
python -m tgwitness.sealed_verify evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness --expected-selection sealed-export-settings.json --require-complete
--expected-selection 다른 전송 방식, 채팅 범위, 필터 또는
첨부 파일 정책을 거부합니다. --require-complete 계정 내보내기 및 ‘완료’로 기록된 채팅
일지만 허용합니다. 이러한 플래그가 없더라도 검증 과정에서는 출처와
무결성을 확인하는 동시에 기록된 설정 및 누락 사항을 보고합니다. 실행 전에 예상되는
선택 사항에 합의하고 이를 아카이브와 별도로 보관하십시오. 범위와 수집 간격은 실행 중에 캡처된 자료를
식별하는 기준이 되며, 이전 버전을 비교할 때는 보존된 이전 관측값을 사용하십시오.
| 필요 사항 | 모드 |
|---|---|
| 제한된 세션 동안 접근 가능한 계정 데이터 또는 선택한 채팅 내역을 내보내고, 검토자에게 외부 기관의 검증을 받은 아카이브를 제공하십시오. | GitHub Actions 캡처 (미리 보기) |
| 여러 채팅방을 지속적으로 모니터링하고, 계정을 관리하며, 점점 늘어나는 아카이브를 검색하고 읽어보세요. | 로컬 또는 Docker 작업 공간 |
이 작업은 새로운 로그인 정보로 별도의 캡처를 시작합니다. 기존 로컬 저널을 업로드하거나, 현재 열려 있는 작업 공간을 내보내거나, 텔레그램 세션을 재사용하지는 않습니다. 완료되지 않은 클라우드 캡처는 실행기가 종료된 후에는 재개할 수 없으며, 새로운 워크플로가 시작되면 새로운 캡처가 시작됩니다.
작업 공간의 ‘내보내기 → 캡처 도우미 열기’를 선택하면 패널 내에서 전체 마법사가 열립니다. 독립형 페이지도 동일한 마법사, 제어 요소 및 테마를 사용합니다. 두 경우 모두 키와 복호화 처리는 브라우저 내에서 이루어집니다. GitHub 워크플로 시작 및 임시 Telegram 패널은 별도의 탭에서 열리며, 마법사에서 언제 돌아와야 하는지 안내해 줍니다. 작업 공간을 잠그면 마법사의 메모리 내 키가 지워집니다. 저장된 키 파일은 기기에 그대로 남아 있습니다.
‘공개’란 무엇이며, ‘비공개’로 남아야 할 것은 무엇인가#
컬렉션은 GitHub에서 호스팅하는 표준 러너에서 실행됩니다. 승인된 수집기인 GitHub와 의존성, 헬퍼 페이지, 브라우저, HTTPS 터널은 이 설정에서 신뢰할 수 있는 구성 요소입니다. 임시 호스트는 텔레그램 세션과 일반 텍스트 메시지를 처리하며, 전달되는 아티팩트는 수신자를 위해 암호화됩니다.
포킹을 통해 프로젝트 코드를 자신의 저장소로 복사합니다. 이 작업은 아니다 Telegram 계정을
내보내세요. 수신자 워크플로우 입력값은 공개 암호화 키입니다.
유지 sealed-key.json, 텔레그램 인증 정보, 로그인 코드, 2단계 인증(2FA) 비밀번호 및
커밋, 워크플로 입력값, 공개 로그에서 추출된 복호화된 연결 URL.
이 워크플로는 하루 동안 암호화된 연결/결과 아티팩트를 게시합니다. 두 가지 모두 제때 다운로드하시기 바랍니다. GitHub Actions의 가용성, 계정 제한 및 청구 정책이 적용됩니다. 공개 포크를 생성한다고 해서 무제한 무료 컴퓨팅이 보장되는 것은 아닙니다. 헬퍼에는 결제 정보나 GitHub 액세스 토큰이 입력되지 않습니다.
개인 복호화 키는 사용자의 브라우저나 파일에 남아 있습니다. 텔레그램 세션 자료 및 평문 관측값은 반드시 임시 저장소에 존재합니다. GitHub와 HTTPS 터널은 여전히 신뢰할 수 있는 인프라로 유지됩니다. 인증 과정을 통해 아카이브 다이제스트와 워크플로 식별 정보가 공개될 수 있으나, 아카이브 내용은 인증 대상에 포함되지 않습니다. 인증 타임스탬프는 메시지 타임스탬프와 다릅니다.
문제 해결#
| 증상 | 다음 단계 |
|---|---|
| '워크플로우 실행 안 함' 버튼 | 자신만의 포크를 열고, ‘액션(Actions)’을 활성화한 다음, 이를 업스트림과 동기화하세요 main. 승인된 업스트림 핀을 수정하여 실패를 우회하지 마십시오. |
아니요 sealed-connection 유물 |
작업이 시작되었는지, 그리고 시작/업로드 단계가 완료되었는지 확인하십시오. 큐, 러너, 이미지 다운로드, 터널 또는 리포지토리 정책 오류로 인해 시작이 실패할 수 있습니다. |
| 연결을 열 수 없습니다 | 이번 실행에 대해 저장된 키를 불러오고, 다운로드한 아티팩트의 압축을 해제한 다음 connection.tgwsealed를 선택하십시오. 러너는 여전히 활성 상태여야 합니다. |
| 역사가 일시 정지되었습니다 | 패널의 상태를 확인하고, 세션이 활성화된 동안 ‘재개’ 기능을 사용하거나, 이미 수집된 데이터로 세션을 마무리하세요. 텔레그램의 제한 사항이나 접근할 수 없는 콘텐츠로 인해 데이터에 누락이 발생할 수 있습니다. |
아니요 sealed-result |
수집 시작 전에 취소되거나 만료되면 아카이브가 생성되지 않으며, 해당 실행은 ‘아카이브 없음’이라는 알림과 함께 종료됩니다. 수집, 인증 또는 패키징 단계에서 오류가 발생하면 전달도 차단되며, 오류가 발생한 단계에는 개인 정보가 제외된 상태로 관리자의 사유가 명시됩니다. 자격 증명을 등록하지 않고도 이를 확인할 수 있습니다. |
| 브라우저에서 대용량 압축 파일을 해독할 수 없습니다 | 256 MiB보다 큰 패키지의 경우 아래의 스트리밍 CLI를 사용하십시오. 개인 키가 잘못되었거나 분실된 경우 결과 파일을 복호화할 수 없습니다. |
| 인증 과정에서 서명자가 거부됨 | 신뢰할 수 있는 최신 버전의 TgWitness 설치본과 정확한 호출자를 사용하십시오 OWNER/REPOSITORY. 아카이브와 함께 제공되는 대체 정책은 절대 수락하지 마십시오. |
| 텔레그램에는 여전히 임시 세션이 표시되어 있습니다 | ‘설정’ → ‘기기’에서 종료하세요. 로그아웃에 실패할 수 있으며, 강제 종료된 워크플로는 정리 작업을 수행하지 못할 수도 있습니다. |
이 미리보기를 신뢰하기 전에, 직접 제어할 수 있는 소규모 채팅에서 테스트해 보십시오. 메시지와 첨부 파일을 생성하고, 이를 수집한 뒤, 결과를 복호화하고, 검증기를 실행하여 커버리지/미디어 결과를 확인한 후 텔레그램 세션 해지가 제대로 이루어졌는지 확인하십시오. 자동화된 검증은 합성 텔레그램 클라이언트와 별도의 실제 GitHub 인증서 테스트를 사용하며, 현재 버전에서는 실제 계정을 사용한 실행 기록이 없습니다.
로컬 암호 해독 및 검증#
알 수 없는 증거 아카이브에서 제공된 실행 파일이 아닌, 독립적으로 신뢰할 수 있는 설치 출처의 도구를 사용하십시오:
python -m tgwitness.sealed_crypto decrypt delivery.tgwsealed --key sealed-key.json --out delivery.zip
# Unzip delivery.zip using your archive manager, then:
python -m tgwitness.sealed_verify evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness
여러 부분으로 구성된 파일을 전달할 경우, 먼저 메인 패키지의 암호화를 해제한 후 추출된 매니페스트 파일을 각 암호화된 부분 옆에 두고, 다음 명령을 실행하십시오:
python -m tgwitness.sealed_parts evidence.parts.json --key sealed-key.json --out evidence.zip
python -m tgwitness.sealed_verify evidence.parts.json --assembled evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness
매니페스트는 인증된 대상이며, 모든 부분과 압축된 ZIP 파일을 하나로 묶어줍니다.
다음 명령을 사용하여 --max-gib 를 사용하여 대용량 아카이브에 적합한 압축 해제 검증 상한값을 설정하십시오.
기본값은 4 GiB입니다. 예상 선택(expected-selection) 및 전체 범위(complete-scope) 검사도
다중 파트 전송에서 작동합니다.
Python 3.11 이상, 프로젝트의 종속성, 그리고
--signer-digest 및 --deny-self-hosted-runners 를 지원하는 최신 GitHub CLI가 필요합니다. CLI 키 생성기
도 사용할 수 있습니다: python -m tgwitness.sealed_crypto keygen sealed-key.json.
검증기는 tgwitness/sealed_policy.json 신뢰할 수 있는 설치본에서 가져옵니다.
이 검증기는 호출자 저장소, 업스트림 서명자 워크플로우, 승인된 서명자의
커밋, 호스팅된 러너 요구 사항, 완전한 ZIP 다이제스트, 내부 저널 및
첨부 파일 무결성, 최신 계정-키 출처, 예상된 수집기 커밋을 확인합니다.
모든 데이터가 저장되었다고 암시하는 대신, 이력 및 미디어 결과를 표시합니다.
승인된 릴리스 목록이 비어 있으면 실패로 처리됩니다. 정책 업데이트는 명시적인
신뢰 결정입니다. 아카이브가 자체적으로 제안한 정책을 절대 자동으로 수락해서는 안 됩니다.
오프라인에서 사용하려면, 신뢰할 수 있는 환경에서 미리 신뢰할 수 있는 루트를 확보하십시오:
gh attestation trusted-root > trusted_root.jsonl
python -m tgwitness.sealed_verify evidence.zip --bundle attestation.jsonl --repo OWNER/TgWitness --trusted-root trusted_root.jsonl
인증의 타임스탬프는 아카이브의 약속과 관련이 있습니다. 이는 메시지의 타임스탬프나 수집기의 실제 시간을 인증하는 것은 아닙니다. GitHub의 검증 옵션을 참조하십시오.
포크가 캡처 프로세스 외부에 유지되는 방식#
호출자에는 전체 커밋 SHA를 통해 업스트림 재사용 가능한 워크플로우에 대한
작업 수준 참조가 포함되어 있습니다. 해당 워크플로우는 고정된 수집기 SHA에서
업스트림 저장소를 명시적으로 체크아웃합니다. 재사용 가능한 워크플로우 내의 actions/checkout 는 호출자를 체크아웃하게 되므로 의도적으로 사용되지 않습니다.
이 워크플로는 호출자 캐시를 복원하지 않으며, 호출자 아티팩트를 소비하거나, 호출자 파일을 실행하거나, 소스/이미지 URL, 셸 명령어, 미리 준비된 ZIP 파일, 또는 서명할 해시를 허용하지 않습니다. 이 워크플로는 제한된 공개 수신자와 세션 기간만 허용합니다. 액션, Python 기본 이미지 및 cloudflared는 불변 다이제스트로 고정되며, Python 종속성은 기존의 해시 잠금 처리된 요구 사항을 사용합니다. 이미지는 캐시 없이 신뢰할 수 있는 소스에서 빌드됩니다.
컬렉터는 읽기 전용 이미지를 사용하여 비루트 사용자로 실행되며, 리눅스 기능이 제거되고 리소스 제한이 적용되며, Docker 소켓이나 GitHub 토큰 환경이 없습니다. 마운트되는 디렉터리는 새로운 구성, 작업 공간 및 출력 디렉터리뿐입니다. 제한된 FastAPI 애플리케이션은 로그인, 대화창, 사용자 정의 가능한 계정 또는 채팅 수집, 상태, 재개, 완료 및 취소 기능을 제공합니다. 일반 텍스트 다운로드 경로, 일반 관리 경로, 가져오기 경로 또는 서명 엔드포인트는 없습니다.
관리자는 ‘attest’ 작업이
최종 수정된 내용을 읽기 전에 네트워크에 노출된 컨테이너를 중지합니다 evidence.zip 또는 evidence.parts.json를 읽기 전에 네트워크에 연결된 컨테이너를 중지합니다. 패키징 컨테이너에는 네트워크가 없습니다.
업로드 단계의 이름은 connection.tgwsealed 와 delivery*.tgwsealed만 지정합니다;
평문 증거 자료나 텔레그램 자격 증명은 아티팩트로 업로드되지 않습니다.
정리 단계에서는 비공개 디렉터리와 컨테이너가 제거되며, GitHub는 작업 완료 후
호스팅된 러너 VM을 폐기합니다. 아티팩트 보존 기간은 1일이며, 만료 전에 다운로드해야 합니다.
포크 소유자는 호출자를 대체하거나 다른 서명된 파일을 생성할 수 있습니다. 엄격한 검증기는 그 결과로 생성된 다른 서명자의 워크플로/다이제스트를 거부해야 합니다. 이러한 구조는 여전히 승인된 코드에 악용 가능한 버그가 없어야 한다는 점과 GitHub의 러너 및 서명 인프라의 무결성에 의존합니다.
암호학적 핸드오프#
각 수신자 키는 RSA-3072(RSA-4096 가져오기도 허용됨)이며, 지수는 65537입니다. 각 봉투에는 새로 생성된 무작위 AES-256 키와 96비트 논스가 포함됩니다. SHA-256/MGF1-SHA256을 사용하는 RSA-OAEP가 AES 키를 감쌉니다. 128비트 태그를 사용하는 AES-GCM은 전체 접두사와 페이로드를 인증합니다. 공개 수신자 키는 base64로 인코딩된 DER SPKI 형식이며, 개인 키 파일에는 base64로 인코딩된 DER PKCS8이 포함되어 있습니다.
엔벨로프 바이트는 TGWSEAL1\n, 빅엔디안 uint32 형식의 JSON 헤더 길이,
헤더, 암호문, 그리고 16바이트 길이의 GCM 태그로 구성됩니다. 헤더의 길이는 정확히 algorithm,
key, 그리고 nonce; 알고리즘은 RSA-OAEP-256+A256GCM입니다. 헤더까지의 전체 접두사
는 GCM 추가 인증 데이터입니다. 헤더 크기는
8192바이트로 제한됩니다. CLI는 최대 8 GiB의 페이로드를 스트리밍하며, 요청된 출력을
설치하기 전에 인증을 수행합니다. 또한 기존 대상에 대한 덮어쓰기는 허용하지 않습니다.
이는 표준 암호화 기본 요소(RSA-OAEP와 SHA-256, AES-256-GCM)를 감싸는 프로젝트 전용 엔벨로프로, OpenSSL 및 모든 주요
암호화 라이브러리에서 사용할 수 있습니다.
원본 증거 바이트는 증거와 인증 정보를 암호화된 외부 패키지에 넣기 전에 인증됩니다. 이를 통해 아카이브의 해시와 동일한 아카이브 내에 포함된 인증서 간의 순환 의존성을 방지할 수 있습니다. 공개 저장소의 경우, 인증 메타데이터(저장소, 워크플로, 커밋, 아티팩트 이름 및 다이제스트)는 공개됩니다. 공개 메타데이터에는 절대로 채팅 이름을 포함하지 마십시오.
범위 및 검증#
이 모드는 서명된 저널 및 계정 내보내기 엔진을 사용합니다. 비밀 채팅, 수집 이전의 삭제된 기록, 그리고 계정에서 접근할 수 없는 데이터는 제외됩니다. 비공개 클라우드 채팅은 선택 시 대상에 포함됩니다. 채팅 선택기는 대화 수 20,000개로 제한되며, 계정 내보내기는 자체 인벤토리를 파악합니다. 누락된 데이터, 실패한 파일 및 완료되지 않은 작업은 기록됩니다. 첨부 파일 제한 및 실행기 디스크/시간 제한은 여전히 적용됩니다. 대용량 전송의 경우, 고정된 4 GiB 전송 제한 대신 암호화된 부분을 사용합니다. 완료란 선택된 작업이 동결된 상태로 끝났음을 의미하며, 모든 과거 텔레그램 기록이 아카이브에 존재함을 의미하지는 않습니다. 채팅 저널은 실시간 업데이트도 관찰할 수 있으며, 두 모드 모두 원자적 스냅샷은 아닙니다. 생성된 스크린샷 및 화면 녹화 내용은 이 모드의 일부가 아닙니다.
테스트 항목에는 합성 신규 로그인, 범위 격리, 미디어, 취소, 부분 마감 시간 완료, 로그아웃 실패, 허용되지 않는 API 경로 및 필드, 사전 로드된 작업 공간 거부, 잘못된 키 및 변조 거부, 필수 검증자 플래그, 브라우저/Python 암호화 상호 운용성 등이 포함됩니다. 브라우저 승인 테스트는 명확하게 표시된 모의 증명서를 사용하며, 실제 Sigstore 테스트는 아닙니다. 실제 호스팅된 러너, Docker, GitHub 증명 및 실시간 Telegram 수락 테스트는 로컬 합성 검사 결과와 별도로 보고되어야 합니다.
GitHub Actions 약관에 따라 호스팅된 러너의 사용은 소프트웨어 프로젝트의 라이프사이클로 제한됩니다. 포크를 생성하더라도 이러한 제한이 해제되지는 않으며, 이 프리뷰 버전을 제한 없는 무료 프로덕션 호스팅으로 홍보해서는 안 됩니다. Cloudflare Quick Tunnels 역시 테스트 및 개발 용도로만 제공됩니다. helper/workflows는 이 기능을 평가하는 데 적합하지만, 프로덕션 서비스 이용 자격은 별도의 배포 요건으로 유지됩니다.
유지 관리자의 릴리스 순서#
- 컬렉터, 슈퍼바이저, 컨테이너 정의 및 테스트 코드를 커밋하고 검토하십시오.
- 해당 컬렉터 커밋을
sealed-collector.yml에 핀한 다음, 재사용 가능한 워크플로를 커밋하거나 검토하세요. 호출자의 SHA에서 체크아웃을 자동으로 파생시키지 마십시오. - 재사용 가능한 워크플로 커밋을
sealed-witness.yml고정하고, 해당 워크플로우/컬렉터 SHA 쌍을sealed_policy.json신뢰할 수 있는 릴리스에 추가하십시오. - 참조된 모든 커밋과 헬퍼를 게시한 다음, 독립적인 포크와 실제 GitHub 인증서를 테스트하십시오. 참조가 재생성되어 다시 게시되지 않는 한, 이 핀들이 참조하는 커밋을 스쿼시하여 제거하지 마십시오.
호출자 리포지토리와 업스트림 서명자 간의 차이점에 대해서는 재사용 가능한 워크플로우 및 확인서를 참조하십시오.