חלקים מדף זה עדיין באנגלית: הטקסט המקורי באנגלית שונה לאחר תרגומו.
הפניה / ראיות
Telegram · פורמט הראיות
תוכן קובץ ה-ZIP החתום, סוגי הרישומים, אישורי תהליך, פרופילי משתמשים, עותקים מחוץ לאתר ואימות במצב לא מקוון.
TgWitness שומר תצפיות טלגרם הנראות לחשבון ביומן חתום. הנמענים יכולים לאמת את הרשומות, הקבצים המצורפים והדוחות השמורים מול מפתח אספן מהימן, לבדוק את הזמן החיצוני מצד שלישי עבור הרשומה האחרונה, ולהשוות את היומן עם נקודת ביקורת ששמרו קודם לכן. דף זה מתאר את הפורמטים, הבדיקות והחומר שיש לשמור לצורך העברה.
הנמענים יכולים להתחיל עם VERIFY.cmd ב-Windows: התוכנה מבקשת את קובץ ה-ZIP המקורי ואת טביעת האצבע של המפתח שהושגה באופן עצמאי, מציגה תוצאה מפורטת, ושומרת תמליל אימות נפרד. ראו משגרי אימות ו סביבת ההרצה הניידת לקבלת מידע על הגדרה ומגבלות אמון.
בעמוד זה
- מה חתום
- השוואת ייצוא צ'אטים
- העברת החקירה
- קטע מהעברת האחריות
- דוחות קריאים
- קנוניזציה של אירועים
- סמנטיקה של שחקנים
- כיסוי: רציפות, פערים ומזהים שלא נצפו
- מפיק
- פרופילים של אנשים
- עד בלתי תלוי
- מניפסט ונקודות ביקורת
- היקף האימות
- קובצים מצורפים
- איסוף קבלות ותהליכים עמידים (0.2)
- הכנת RFC 3161 ואימות התגובה (0.2)
- רשומות אופציונליות במצב ראיות: drand ומכשירי Telegram
מה נחשב כחתום#
| חומר | הגנה | מה יש לשמור |
|---|---|---|
| כל תצפית ביומן, כולל אירועים מבצעיים | שרשרת SHA-256 וחתימת Ed25519 לכל אירוע | events.jsonl המקורי, טביעת האצבע של המפתח המהימן, ונקודת ביקורת שנשמרה |
| תוכן קובץ ה-ZIP של הראיות | manifest.sig חותם על המניפסט הקנוני, המפרט את חתימות ה-hash של קבצי התוכן |
קובץ ה-ZIP המלא, כולל קובץ המניפסט והחתימה שלו |
| קובצים מצורפים שנשמרו | SHA-256 ומספר הבתים באירוע media.saved חתום; חתימת קובץ במניפסט ZIP החתום |
הבייטים המקוריים בתוך קובץ ה-ZIP המאומת |
| נקודת ביקורת | חתימת Ed25519 על אורך היומן, חתימת הראש, המפתח הציבורי וזמן היצירה | עותק עצמאי שנשמר לפני שינוי שנוי במחלוקת |
| אישור ביצוע | תיעוד חתום של גרסת האספן, חשישי קבצי המקור והגדרות ההתחלה, כלול גם ב-process.started |
הקבלה, היומן הנלווה וראיות הסביבה עבור מצב האימות הנבחר |
דוחות קריאים: report.html וחלקיו, report.json, report.pdf, chat.pdf |
חותמת Ed25519 לכל קובץ על תוכנו; ה-PDF נושא גם חתימה סטנדרטית מסוג PDF (ראו דוחות קריאים ) | הקובץ כפי שהתקבל וטביעת האצבע של המפתח המהימן; קובץ ה-ZIP המתואר בו |
| CSV עצמאי | אין חתימה קריפטוגרפית עצמאית; חתימות ה-hash של האירועים בלבד אינן מספיקות | יש להשתמש בטקסט המדויק הנמצא בתוך קובץ ה-ZIP המאומת לצורך בדיקת תקינות |
| צילומי מסך, הדפסות או קבצי PDF שנוצרו על ידי דפדפן | אין חתימת TgWitness על התוצר הנגזר | יש לשמור את החבילה המקורית המאומתת ולתעד כיצד נוצר הנגזרת |
האספן מאמת את חתימות היומן לפני יצירת כל פורמט ייצוא. דוחות HTML ו-PDF קריאים נושאים חותמות משלהם; קובץ CSV עצמאי נבדק כחלק מ-ZIP חתום. יש לשמור את ה-ZIP כדי לשמור על בתים של הקובץ המצורף ועל המניפסט, וכן נקודת ביקורת נפרדת כדי להשוות את היומן לגבול מוקדם יותר.
פורמטים ונתיבי אימות#
מצב הרכישה ופורמט הפלט עונים על שאלות שונות. המצב מספק ראיות לאיסוף ולסביבה; כל פורמט משמר או מציג חלק מאותו רישום עם הבדיקות המפורטות להלן.
| פלט | אימות ושימוש |
|---|---|
| ראיות ZIP | אירועים קנוניים, מניפסט חתום, כיסוי, רשומות שמירה, קבצים מצורפים וקבלות חיצוניות זמינות; בדקו את הארכיון ואת מצב הרכישה הנבחר שלו. |
| מכל ASiC-E | קובץ ה-ZIP של הראיות כקונטיינר ETSI ASiC-E (EN 319 162-1) הכולל רשומת mimetype וקובץ META-INF/ASiCManifest.xml, החתום ב-CAdES באמצעות האישור של סביבת העבודה עצמה ברמה B-B, או B-T כאשר חותמת הזמן מופעלת. תוכנות אימות כגון EU DSS בודקות את הפורמט ואת תקינות הקובץ, ומאחר שהאישור הונפק באופן עצמאי, הן מדווחות על היעדר עוגן אמון. EU DSS 6.3 עם הגדרות ברירת המחדל דוחה מכולה המכילה יותר מ-1,000 קבצים ("Too many files detected"). verify.py בודק את המניפסט Ed25519 ואת כל הקבצים המפורטים בו, את ערכי SHA-256 ב-META-INF/ASiCManifest.xml ובקובץ ASiCManifestNNN.xml או ASiCEvidenceRecordManifest.xml שנוסף, ונכשל כאשר קיים ערך ב-META-INF/ שאינו מכוסה על ידי אף אחד מהם. הוא אינו בודק את חתימות ה-CAdES ומציין זאת במפורש. |
| דוחות ב-HTML וב-JSON | תצוגות אטומות בנפרד עם הפניות למקורות, המפורטות גם במניפסט ה-ZIP. הספירות המתועדות שלהן מסכמות את סוגי האירועים ביומן. |
| דוחות PDF | חותמת Ed25519 בתוספת חתימת PDF בסיסית מסוג PAdES על טווח הבתים: B-B, או B-T עם חותמת זמן לחתימה כאשר תכונת חותמת הזמן מופעלת. תוכנת האימות TgWitness משתמשת במפתח Ed25519 המהימן; תצוגת האמון בתעודה של הצופה מהווה בדיקה נפרדת. |
| CSV | תצוגת גיליון אלקטרוני המכוסה על ידי מניפסט ה-ZIP. בריחת נוסחאות מגנה על השימוש בגיליון האלקטרוני; הטקסט המקורי החתום נשאר ביומן. |
| JSONL | רשומות אירועים חתומות, כולל הפניות לקבצים מצורפים. קובץ ה-ZIP של הראיות מכיל בנוסף את בתים הקבצים המצורפים שנשמרו. |
| ייצוא צ'אט ותצוגות תואמות שולחן עבודה | רכישת היסטוריה ורשומות יומן מנהל זמינות, עם העיבוד המבוקש והארכיון החתום. הגרסאות השמורות של הניטור החי מהוות נתיב רכישה נפרד. |
| רשומות מדיה ורשומות המכילות רק חתימות hash | הביטים שנשמרו נבדקים מול ה-SHA-256 שלהם ומול הפניה להודעה. איסוף Hash-only שומר את מטא-הנתונים הזמינים של ה-hash להשוואה מאוחרת יותר עם ביטי הקובץ. |
| STIX/MISP ופרופילים אישיים | תצפיות שחולצו המקושרות למקור, מזהי חשבונות והתאמות אנליטיות. ניתן לבדוק חתימות פרופיל וחשישי רשומות מול הראיות המקוריות; מקור מטמון האווטאר מסומן בנפרד. |
| קטע מתוך מסמך המסירה | כללי גילוי חתומים, רשומות ללא שינוי ורשומות מסומנות ומצומצמות השומרות על חתימות/האשים המקוריים. יש להשתמש במקור שנשמר לצורך השוואה הדורשת שדות חסויים. |
| עדים וקבלות זמן | גבולות היומן הקודמים, הרציפות והטענות הזמן המאומתות הבודדות. הם מלווים את בדיקות הרכישה והארכיון. |
| משלוח מוגן בסיסמה | מגן על החבילה המצורפת במהלך ההעברה. .tgwpw משתמש בהצפנה מאומתת AES-GCM, כולל רשומה סופית מאומתת; היומן המצורף שומר על חתימותיו וקבלות הרכישה. |
הדפסה או צילום מסך הם הצגה של החומר החתום. מזהה הדוח , טביעת האצבע של המפתח והפניה ל-QR מסייעים באיתור הקובץ המקורי לצורך אימות. הצהרות שמירה מתעדות את הבוחן שסיפק את המידע ואת פרטי ההעברה; תוצאות המאמת וקבלות הרכישה נשמרות כראיות נפרדות.
חתימות חיצוניות#
חתימה יכולה גם לנבוע ממפתח ש-TgWitness לעולם אינו מחזיק, כגון
חתימה אלקטרונית מוסמכת של חוקר או חותמת של ארגון. בנוגע לייצוא, חתימה חיצונית
על קובץ ייצוא מוכן ללא סיסמה מספקת את הבתים שיש לחתום עליהם: רשימה חדשה
META-INF/ASiCManifestNNN.xml המפרטת כל קובץ עם ה-SHA-256 שלו עבור מכולה מסוג ASiC-E
, או את 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 עצמה; הן אינן מציגות את מה ש-Telegram הציג לאף אחד.
השוואת ייצוא צ'אטים#
יש לאמת ולהשוות שני קבצי 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; יש לבדוק את
הפרופיל הנדרש של כל ארכיון באמצעות תהליך האימות שלו.
כאשר שני הארכיונים מתעדים את אותם מזהי חשבון וצ'אט מספריים, הרשומות מוצמדות
לפי מזהה ההודעה. Unchanged פירושו שוויון בין רשומת ה-JSON השמורה במלואה:
הטקסט המלא, המחבר, התאריכים, יעד התשובה, מטא-נתונים מקוננים ושדות לא ידועים – כולם
כלולים. סדר המפתחות באובייקט JSON אינו משנה; שדות חסרים, ערכי null, סוגי ערכים
וסדר המערך כן משנים. תצוגה מקדימה של 300 תווים מיועדת לתצוגה בלבד. ערכים ששונו
מציינים את ה-changed_fields ברמה העליונה השונה, כולל שינויים שאינם נראים בתצוגה המקדימה.
מזהי הודעות כפולים נדחים במקום להחליף זה את זה במהלך ההתאמה.
ההבדל יכול להיות שם תצוגה ששונה, ספירת צפיות, הערת אוסף או מטא-נתונים אחרים של התצפית. עריכות ב-Telegram מופיעות כאירועי עריכה נפרדים, והאימות של כל ארכיון מראה אם אותו ארכיון שלם. רשומות שלא עברו ניתוח נשארות בהשוואה ומושוות על פי הייצוג השמור שלהן.
במקרה של זהויות חשבון/צ'אט שונות או חסרות, הכלי מוצא התאמות אפשריות
באמצעות השולח, הטקסט המלא, חתימת הקובץ, סוג המדיה וסובלנות זמן של חמש שניות,
ומדווח עליהן כ"מותאמות" (Matched) ולא כ"ללא שינוי" (Unchanged). רשומות שלא עברו ניתוח
נשארות ללא התאמה. ההבדלים ברשומות מזווגות מפורטים ב-changed,
כולל במצב תוכן. עם --json, matched סופר זוגות מועמדים ו-
unchanged סופר זוגות שרשומותיהם השמורות המלאות זהות. הפלט
הקיים changed_fields והמספר השלם unchanged נשארים תואמים
לתוצאות השוואה קודמות. פורמט הארכיון ואימות החתימה נותרו ללא שינוי.
העברת חקירה#
- רשמו את מספר התיק, המפעיל, מזהה החשבון המספרי של Telegram, המקורות שנבחרו, מדיניות האיסוף ותקופת האיסוף בהערות התיק שלכם. TgWitness משמרת תצפיות ותומכת בהערות ובאוספים המקושרים למקורות ב -Case Board. שמרו את רישומי ההעברה והשמירה יחד עם חומרי התיק שלכם. בדקו את הגדרת האיסוף המתוכננת באמצעות נוהל הקבלה בזמן אמת.
- יש לשמור את טביעת האצבע של המפתח הציבורי של סביבת העבודה באופן עצמאי לפני ההסתמכות על הייצואים שלה. יש להשאיר את מצב הראיות מופעל (הגדרת ברירת המחדל) כך שנקודות הבדיקה יקבלו קבלות לפי RFC 3161 ו-OpenTimestamps. יש לשמור נקודות בדיקה חתומות מחוץ לאספן במהלך האיסוף. יש לתעד הפרעות ואת מגבלות הנראות של החשבון.
- ייצא קובץ ZIP חתום ושמור את אישור ההפעלה החתום. השתמש בנקודת ביקורת ב- או לפני גבול היומן המיוצא. נקודת ביקורת מאוחרת יותר עלולה לדחות כראוי ייצוא מוקדם יותר בטענה שהוא קצר מדי. הייצואים כוללים את יומן סביבת העבודה המלא, ללא תלות במסנני הפאנלים; בדוק את החומר לפני שתשתף אותו.
-
יש לבקש מהנמען לאמת את קובץ ה-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).- תעדו את ה-SHA-256 של הארכיון, גבול הייצוא, תאריך ההעברה, השולח וה
נמען ברשומת השמירה שלכם. שמרו על החבילה המקורית שלמה ועבדו
מהעתקים. שתפו קבצי ראיות במקום את ספריית הנתונים הפרטיים של היישום,
הכוללת גם הפעלות חשבון וסודות חתימה.
להעברה, בחרו בקובץ ZIP מוגן בסיסמה ב-AES-256 או במכל החזק יותר
.tgwpw. קובץ ZIP משתמש בשיטת גזירת סיסמאות בעלות נמוכה של WinZip; השתמשו בסיסמה ארוכה ואקראית..tgwpwמשתמש ב-scrypt וב-AES-256-GCM ונפתח באמצעות הפקודהunseal-passwordשל תוכנת האימות העצמאית. הסיסמה אינה מאוחסנת ומגנה רק על הסודיות; הנמען מפענח את הארכיון ומאמת את הייצוא החתום שבתוכו, אשר נותר ללא שינוי. - כדי להטביע חותמת זמן על נקודת ביקורת מחוץ למצב ראיות, יש לפעול לפי הנוהל המפורט ב-RFC 3161 ולשמור את הבקשה, נקודת הביקורת, מידע על רשות האישור (CA) המהימנה ותגובת הרשות המאומתת. הכנת בקשה בלבד אינה מספיקה לקבלת חותמת זמן.
- תעדו את ה-SHA-256 של הארכיון, גבול הייצוא, תאריך ההעברה, השולח וה
נמען ברשומת השמירה שלכם. שמרו על החבילה המקורית שלמה ועבדו
מהעתקים. שתפו קבצי ראיות במקום את ספריית הנתונים הפרטיים של היישום,
הכוללת גם הפעלות חשבון וסודות חתימה.
להעברה, בחרו בקובץ ZIP מוגן בסיסמה ב-AES-256 או במכל החזק יותר
עבור .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 בודק תמצית בשתי דרכים. רשומה המוצגת כבלתי-משתנה מאומתת במלואה:
תוכנה נבדק מול ה-hash שלה, החתימה מסוג Ed25519 שלה והקישור שלה לקודמתה הכלולה. רשומה
מצומצמת שומרת על ה-hash והחתימה המקוריים, כך שהחתימה עדיין מאומתת, אך
לא ניתן לחשב מחדש את השדות שהוסתרו; הרשומה מציינת מה הוסתר והדוח
מסמן זאת. רשומות שירות ברמת החשבון (התחלות והפסקות, פערים בכיסוי, התראות על חיבור, רשת ואחסון,
שינויים בהיקף ובהגדרות) שומרות רק את השדות המפורטים עבור הסוג שלהן: רשימות הצ'אטים בהן נחתכות לצ'אטים הנבחרים
והסכומים הכוללים שלהן מחושבים מחדש, ופערים בבדיקה בזמן אמת בצ'אט שמחוץ לבחירה גורמים לאובדן אותו צ'אט,
מספרי ההודעות שלו וחשבון העד; בצ'אט שנבחר לבדיקה, חשבון העד מוחלף בשם בדוי, אלא אם כן
כולם מוצגים או שמדובר באחד מהאנשים שנבחרו. המניפסט מציין את אורך היומן ואת הכותרת עם חתימת האספן מעל אותה
כותרת, וסופר את הרשומות שהושמטו; הקובץ `coverage.json` מתאר את הצ'אטים שנבחרו. תמציות חדשות כוללות גם
את הקובץ `proofs.jsonl`: עבור כל רשומה כלולה ועבור כותרת היומן, נתיב מרקל מה-
ה-hash המקורי של הרשומה לשורש היומן המצוין במניפסט החתום. verify.py בודק כל
נתיב, כך שכל רשומה מוצגת כשייכת לאותו יומן באותו אורך וכותרת, ללא
היומן המלא; תמצית של 100 הודעות נבדקת תוך כ-שנייה, ללא תלות בגודל היומן.
--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): החותם חותם על ה- SHA-256 של ה-JSON הקנוני של ה-report, כך שניתן לקרוא את הנתונים במערכות ובסקריפטים של בתי משפט וניתן לבצע בחירה לצורך הגנה על נתונים מתוך הנתונים הללו, בעוד שהקובץ החתום נשאר שלם.report.pdf/chat.pdf: מסמך רשמי המיועד להדפסה ולתיעוד, החתום פעמיים על אותם בייטים, על הקובץ כולו למעט ערך החתימה (/ByteRange). חתימת ה-PDF הסטנדרטית היא PAdES baseline (ETSI EN 319 142-1,/SubFilter /ETSI.CAdES.detached: CMS עם SHA-256 ו- ECDSA P-256, signing-certificate-v2, ללא זמן חתימה ב-CMS; הזמן המוצהר הוא/M) ברמה B-B, או B-T עם חותמת זמן חתימה לפי RFC 3161 ב-CMS כאשר חותמת הזמן מופעלת ו רשות חותמת זמן עונה דרך המסלול עבור בקשות מחוץ ל-Telegram. הוא משתמש ב תעודת חתימת מסמכים שהונפקה עצמית, המאוחסנת בכספת סביבת העבודה; המספר הסידורי של הנושא שלה הוא טביעת האצבע של מפתח Ed25519. חותם ה-Ed25519 מועבר בתוך ה-CMS כ- תכונה לא חתומה2.25.240684792623320047764573196045913242332ומציין את ה-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
לא החזירה (נמחקה לפני הייצוא, או שאינה נראית לחשבון); בצ'אטים פרטיים וב
קבוצות בסיסיות המספרים משותפים לכל הצ'אטים של החשבון, והפערים אינם נספרים.
לאחר קריאת ההיסטוריה, הייצוא מבקש מ-Telegram שוב את כל המספרים החסרים, לפי מספר (channels.getMessages, עד 10,000 מספרי טלפון, כולל 1,000 המספרים שמתחת להודעה הראשונה, המפוזרים באופן שווה על פני כל הפערים כאשר ישנם יותר). התוצאה מופיעה message-ids.json ובדוח. תשובה ריקה מתעדת כי המספר אינו זמין לחשבון זה בזמן הבדיקה החוזרת; היא אינה מציינת את הסיבה. הודעה שהוחזרה בבדיקה החוזרת מתווספת לייצוא ומסומנת found_on_recheck.
כאשר סביבת העבודה המתבוננת הבחינה שהודעות בצ'אט נמחקו, נעלמו בבדיקה חוזרת או עברו עריכה, ייצוא הצ'אט מוסיף journal-changes.jsonl: את רשומות היומן הללו, כל גרסה שנשמרה ואת ההודעה, כל אחת עם ה-hash והחתימה Ed25519 שקיבלה ביומן. verify.py מחשב מחדש את ה-hash של כל רשומה, בודק את החתימה שלה מול מפתח הייצוא ומשווה את הספירה למניפסט החתום; ייצוא הראיות מכיל את שרשרת ה-hash המלאה. הדוח מפרט הודעות אלה תחת "מחיקות" ו"גרסאות קודמות".
כל דוח נפתח ב-בקיצור: פסקה אחת, ולאחר מכן מה החומר מראה ומה כולל התיעוד. חותמת האבטחה של הדף עצמו הופכת לכתומה כאשר הדפדפן אימת את חתימת החותמת, ולא את הדף: דפדפן אינו מעניק לדף את הבייטים שלו. הוא הופך לירוק רק כאשר הקורא גורר את הקובץ אל תיבת הבדיקה בתחתית הדף וכל בייט תואם, ורק אם הדף המוצג הוא אותו קובץ; אחרת הוא הופך לאדום.
כל דוח מציין את שם התוכנית במדויק: ה-git commit שבו האספן פועל מתוך צ'ק-אאוט או
שהמתקין מגדיר את TGWITNESS_COMMIT, ואת ה-SHA-256 של קבצי המקור שלו (source_tree_sha256,
ה-JSON הקנוני של הנתיב → SHA-256 של כל קובץ .py, .js, .css, .html ו-.svg בחבילה),
אשר צ'ק-אאוט של אותו commit משחזר, אלא אם כן הקבצים שונו. ה-Telegram
נקרא על שם הספרייה, שכבת ה-API ומרכז הנתונים שלו. כאשר מתחיל הניטור וכאשר ייצוא צ'אט
מתחיל ומסתיים, האספן שואל את Telegram לגבי הזמן שלו (updates.getState, שניות
שלמות) ורושם את הזמן של Telegram פחות השעון של האספן, עם אי-הוודאות הנובעת
מהמסלול הלוך ושוב; הדוחות מציגים מדידות אלה תחת "שרשרת האחריות". ייצוא צ'אט מתעד גם
מתי הוא קרא את ההיסטוריה, בנוסף לתאריכי ההודעות.
מציג דוחות במצב לא מקוון ומדריך לארכיון#
חלץ את קובץ ה-ZIP המלא לפני פתיחת chat.html או report.html. הצופה מספק חיפוש,
מסננים, משתתפים, אינדיקטורים, פרטי רשומות ובחירות JSON/CSV ללא צורך בשרת. שמור
את viewer/ ו-media/ לצד הדוח. הבחירות הן נגזרות: השתמש ב-verify.py SELECTION.json
--evidence ARCHIVE.zip כדי להשוות אותן לארכיון החתום.
המאמת בודק את מזהה הדוח, מפתח החתימה, גבולות הארכיון וכל פריט שנבחר; פריטים שעברו עריכה,
חסרים או כפולים ייפסלו. הערות הבחירה וזמן היצירה נותרים כמטא-נתונים לא חתומים.
פערים במספרי ההודעות מוצגים רק עבור פיד צ'אט שלם, לא מסונן ועולה בסדר עולה. הסתרת קטגוריה או כישלון בטעינת גוש נתונים אינם רשאים להפוך שורה שהושמטה לראיה להיעדרות הודעה. הדגשות החיפוש פועלות על טקסט רגיל לפני בריחה מ-HTML, תוך שמירה על סימון מילולי.
הדפדפן בודק חתימות מניפסט, מזהה הדוח והמפתח, וכן את כל חתימות ההאש של הקבצים המפורטים. הוא דוחה מבני ZIP מעורפלים או פגומים, שמות כפולים ונתיבים לא בטוחים, ומגביל את גודל הקבצים ל-256 MiB ואת סך התוכן המוצהר ל-4 GiB. השתמשו במאמת העצמאי עבור ארכיונים גדולים יותר. בדיקה זו של הדפדפן משלימה את בדיקות המאמת לגבי שרשראות היומנים וסמנטיקת הנתונים.
README.txt מכיל מדריך התחלה, רשימת קבצים מותאמת, הוראות אימות והערות על
פורמט הנתונים בשפת הדוח, ולאחר מכן מדריך מלא באנגלית. SHA256SUMS מכסה את
הקבצים המפורטים בתוכו, למעט הקובץ עצמו, manifest.json ו-manifest.sig; המניפסט החתום
מכסה גם את SHA256SUMS. יש לשמור על קובץ ה-ZIP המקורי ללא שינויים ולשמור קבצי עבודה מחוץ ל
תיקייה שחולצה. דוחות PDF כוללים סימניות לסעיפים וזיהוי תיק/דוח בעמודים הבאים.
הצ'אט בזמן הייצוא#
ייצוא צ'אט מתעד את מה ש-Telegram אמר על הצ'אט בתחילת הייצוא: התוויות של Telegram עצמו
(scam, fake, restricted עם הנימוקים, verified), שמות משתמש, תיאור, מספר
המשתתפים והמנהלים, הדיון המקושר, הגנת תוכן, האם משתתפים חדשים רואים הודעות קודמות
ומאיזו הודעה בחשבון זה ניתן לראות את ההיסטוריה (available_min_id), התאריך
של הודעה 1 כאשר מדובר בהקמת הצ'אט, ו-SHA-256 של תמונת הצ'אט (שנשמרה ב-media/).
היא מתעדת את מקומו של החשבון המייצא בצ'אט: תפקיד, תאריך הצטרפות, מי הזמין אותו, ובמקרה של
מנהל, את זכויותיו. בקשה ש-Telegram דחה מופיעה תחת שם אחר.
כאשר החשבון המייצא הוא מנהל, הייצוא קורא את יומן המנהל של הצ'אט (Telegram שומר אותו כ-
48 שעות) לקובץ admin-log.json: מחיקות ועריכות עם התוכן שסופק,
החשבון הפועל ותאריך פעולת המקור. רשומות אלה משלימות את
הגרסאות שנלכדו של היומן החי ואת רשומות קבלת המחיקות.
אינדיקטורים#
רשימת הדוחות והארכיון מכילים את indicators.csv
, indicators.stix.json
(STIX 2.1
)
ו-indicators.misp.json
(אירוע MISP
), אשר על פיהם יכול צוות הטיפול בתלונות לפעול בהודעות המוקלטות:
קישורים ודומיינים (גם כאלה המוסתרים מאחורי טקסט, בכפתורים ובתצוגה מקדימה של קישורים), כתובות מטבעות קריפטוגרפיים,
שמות משתמש וקישורי הזמנה ב-Telegram
, מספרי טלפון, כתובות דוא"ל ותמונות שמורות.
כתובות ביטקוין, לייטקוין, דוג'קוין ו-TRON מופיעות ברשימה רק כאשר בדיקת ה-base58 שלהן תקינה,
כתובות segwit כאשר בדיקת ה-bech32 או ה-bech32m שלהן תקינה, וכתובות TON כאשר בדיקת ה-CRC
שלהן תקינה; כתובות EVM ו-Solana מסומנות כלא נבדקות. התמונות נושאות את SHA-256
ואת
ה-hash התפיסתי (dHash, 64 סיביות) שנשאר כמעט ללא שינוי גם בעותקים שעברו דחיסה מחדש או שינוי גודל. הדוחות כותבים
אינדיקטורים כך שלא ייפתחו בטעות (hxxps[://]example[.]com
); הקבצים שומרים על
הערכים כפי שהיו. כל אינדיקטור מסומן כ"לא ידוע" וכ"לא לזיהוי אוטומטי" (STIX
,
indicator_types: unknown
, MISP
, to_ids: false
, הפצה לארגון עצמו): עצם
הופעתו ברשימה מעידה שהודעה כללה אותו, ולא שהוא זדוני. קישור שהטקסט שלו מציג
כתובת שונה מזו שנפתחת מסומן בדוח.
הדוחות מסוג PDF מסתיימים בהצהרה של הבוחן שיש לחתום עליה בכתב יד, ברשימת בדיקה עבור נוטריון או מומחה מטעם בית המשפט, ובקוד QR (המופיע גם בעמוד הראשון) הכולל את מזהה הדוח, טביעת האצבע של המפתח ו ה-SHA-256 של הנתונים המוסמכים, כך שהדפסה תוביל חזרה לארכיון.
קנוניזציה של אירועים#
קלט ה-hash מורכב בדיוק מהשדות הבאים:
seq, observed_at, source_at, kind, chat_id, message_id, actor_id, payload, previous_hash
יש לבצע סידוריזציה באמצעות JSON תואם Python ב-UTF-8, עם מפתחות אובייקטים ממוינים, ללא החלפת תווים ב-ASCII, ללא רווחים חסרי משמעות וללא NaN/אינסוף:
json.dumps(value, ensure_ascii=False, sort_keys=True,
separators=(",", ":"), allow_nan=False).encode("utf-8")
ה-SHA-256 של אותם בייטים הופך להאש של האירוע. החתימה היא Ed25519 על 32 בייטי ההאש הגולמיים, ולאחר מכן מקודדת ב-base64. ה-previous_hash הראשון הוא 64 אפסים. מספרי הרצף מתחילים ב-1 ועולים ב-1. כל האירועים, כולל אירועים תפעוליים, משתפים שרשרת אחת. אין דיכוי של מסירות כפולות: תצפיות חוזרות הן קבלות נפרדות, ולא טענה לפעולות נפרדות ב-Telegram.
תאריכי Telegram גולמיים הם מחרוזות ISO; שדות בינאריים הופכים לאובייקטים המכילים
bytes_base64. טקסט ההודעה, ישויות, תיאורי מדיה, מטא-נתונים של תשובות, תגובות,
ופעולות שירות נשמרים במטא-נתוני ההודעה הגולמיים כאשר הם מסופקים. הודעה חיה
שומרת גם את עדכון Telegram ששיגר אותה transport_update; כאשר
אותו עדכון נושא את אותה ההודעה כמו raw, שדה message הוא
{"same_as": "raw"} במקום עותק שני.
observed_at הוא הזמן ב-UTC שבו האספן כתב את הרשומה; source_at הוא התאריך
שנמסר על ידי אותו אירוע Telegram. רשומות שנכתבו במהלך טיפול בעדכון בזמן אמת מוסיפות
payload.received_at, את זמן ה-UTC שבו הגיע העדכון לאספן, ו
payload.processing_delay_ms. עריכות בזמן אמת שומרות על תאריך העריכה שסופק,
תמונות מצב של ההיסטוריה שומרות על תאריך ההודעה עם זמן התצפית הנוכחי, והודעת
מחיקה רגילה מתעדת את זמן הקבלה עם תאריך מקור ריק. רשומות ביומן הניהול
שומרות בנפרד על תאריך הפעולה שסופק. סדר הקבלה וסדר
האירועים המקוריים הם צירים זמן נפרדים, עם תצפיות שעון וקבלות חיצוניות
הזמינות להשוואה.
סמנטיקה של שחקנים#
ייחוס המקור נעשה לפי מקור האירוע. message.new.actor_id ו-
message.edited.payload.sender_id משמרים את שולח ההודעה. התראות רגילות מסוג
message.deleted נושאות מזהי הודעות ושדה השולח שלהן ריק;
רשומות יומן מנהל זמינות נושאות את הפעולה, השולח והתאריך שסופקו.
הודעות שירות החברות משמרות את השולח וסוג הפעולה, עדכוני משתתפים גולמיים
משמרים את actor_id שסופק, ותצלומי תגובה משמרים את
הספירות והזהויות הגלויות שסופקו. יש לקרוא רשומות אלה יחד עם הגרסאות
שנלכדו וקבלות האינטראקציה בלוח הבקרה.
הודעות מחיקה עבור צ'אטים פרטיים וקבוצות רגילות מכילות רק מזהי הודעות.
צ'אטים אלה חולקים רצף מזהים אחד לכל החשבון, ולכן מזהה מזהה הודעה בודדת של
חשבון זה. כאשר הודעה עם מזהה זה נשמרה קודם לכן ביומן זה,
המחיקה נרשמת באותו צ'אט כ-message.deleted עם payload.chat_resolution
המציין את שם השיטה. מזהים שמעולם לא נשמרו נשמרים כ-deletion.unscoped:
הודעת מחיקה בפועל שהצ'אט שלה לא הותאם. זה שונה
מ-message.missing_on_recheck, המתעד תוצאת שאילתה שאינה זמינה,
ומפער במזהי ההודעות שנשמרו. ערוצים וקבוצות-על מספרים הודעות לפי צ'אט,
ולעולם אינם מותאמים בדרך זו. כאשר ההודעה שנמחקה נשלחה על ידי החשבון הנצפה,
payload.deleted_message_was_outgoing הוא true; זהות המוחק עדיין לא צוינה.
הודעה ללא היקף שומרת על התווית שלה, מכיוון שהצ'אט התואם עשוי להיות מחוץ להיקף התצפית הנוכחי או שלא תהיה לו התאמה ייחודית. היעדרות בבדיקה חוזרת נשארת תצפית נפרדת מהודעת מחיקה בספירת הדוחות, במסננים וב תוויות. שחזור מאוחר יותר מוחק את מצב ההיעדרות הנוכחי תוך שמירה על הבדיקה הקודמת שלא צלחה בהיסטוריה החתומה; הודעות מחיקה נותרות סוג אירוע נפרד.
מזהים מרובים המתייחסים לאותו צ'אט מתוך התראה אחת מקובצים תחת
deletion.batch, ללא תלות במספרם, כאשר מזהי ההודעות מופיעים בדיוק כפי ש-Telegram
שלחה אותם וכמה מהן נשלחו על ידי חשבון זה. רשימת ההתראות של Telegram
מפרט את ההודעות; יומן הניהול של הצ'אט מציין את שם המנהל הפועל במקום שבו החשבון
יכול לקרוא זאת. הקישור (message.deletion_attributed) נוצר לפי מה שמגיע ראשון:
סקר שזיהה את הרישום ביומן המנהל לפני הודעת המחיקה, מותאם כאשר ההודעה
נרשמת.
היקף: רציפות, פערים ומזהים שלא נצפו#
כל קובץ ZIP חתום נושא את coverage.json, דוח ה-HTML נפתח עם אותו סיכום, ו-
verify.py מחשב אותו מחדש מ-events.jsonl במקום להסתמך על הקובץ:
- תצפית רציפה מ-X ל-Y. תקופה מתחילה ב-
observation.startedו מסתיימת בהשהיה, עצירה, אובדן חיבור ל-Telegram, יציאה מהמערכת, התחלת תהליך ללא עצירה מסודרת, או יותר משלוש דקות ללא כל רישום במהלך התצפית (פעימות נכתבות מדי דקה, ולכן שתיקה פירושה שהתהליך נעצר, קפא או שה מחשב נכנס למצב שינה). כאשר מרווח פעימות הלב משתנה ב"כלים נוספים" → "פרמטרים", כל פעימת לב מתעדת זאת, והשתיקה המותרת הופכת לשלושה מרווחים, לעולם לא פחות משלוש דקות. - רשימת הפערים מציינת את הזמן שחלף בין תקופות, יחד עם הסיבה לכך. פער שעדיין פתוח ברישום האחרון
מסומן כ-
not_resumed_by_last_record. - מזהי הודעות שלא נצפו. עבור ערוצים וקבוצות-על, המונים הודעות לפי צ'אט, המזהים החסרים בין המזהים שנצפו מפורטים כטווחים. הם מדווחים כ "לא נצפו" — נמחקו, מעולם לא נמסרו או נמצאים מחוץ להיסטוריה השמורה — לעולם לא כ "נמחקו". צ'אטים פרטיים וקבוצות רגילות חולקים רצף המשותף לכל החשבון, ולכן פערים בתוך צ'אט כזה אינם משמעותיים ואינם מפורטים שם.
- הודעות על פערים ברמת הצ'אט (לדוגמה, בקשת טלגרם לשחזור ההבדלים בערוץ אחד ) נספרות כהערות; הן אינן מפריעות לכיסוי הכולל.
- רשומות הפעלה. הפעלות שבהן מונה העדכונים של Telegram עלה אף על פי שאף עדכון
לא הגיע להפעלה זו (
updates_diverted), הפעלה זו יצאה מרשימת ההפעלות של Telegram בעוד שהחיבור שלה המשיך לפעול (session_revoked_externally), או שתשובת בדיקת העד הגיעה רק מההיסטוריה (probe_ack_missed_live) מפורטות בנפרד. המאמת מדווח גם על מקור מפתח ההפעלה של טלגרם, הפעלות אחרות שהיו מחוברות בעת תחילת התצפית, הפעלות שנוספו במהלך התצפית, הודעות אבטחה של טלגרם (777000), הפעלות אחרות שהסתיימו מסביבת העבודה, תקופות של הפעלה בלבד, ספירת בדיקות עדים ועדכוני שיחות טלפון. ראו חשבונות. כאשר האפשרות צ'אטים נבחרים בקפדנות מופעלת (scope.strictב-observation.started), רשימת ההפעלות (למעט כאשר זו ההפעלה היחידה, או כאשר מכשירים של Telegram מופעלת), הודעות אבטחה ו עדכוני שיחות טלפון אינם נאספים, ולכן היעדרם אינו מעיד על דבר, ומחיקה תואמת להפעלה רק אם התנהל סשן ב-10 הדקות שקדמו לה.
רצף העדכונים (pts)#
Telegram מסמן עדכונים הקשורים להודעות באמצעות pts: רצף אחד לחשבון
(צ'אטים פרטיים וקבוצות בסיסיות יחד) ורצף אחד לכל ערוץ או סופר-קבוצה. ה-
אספן מתעד כל רצף שקיבל ללא חוסרים כ coverage.sequence
רשומה: הראשון והאחרון pts, מספר העדכונים מכל סוג, והאם הם
נשלחו בזמן אמת או הוחזרו על ידי getDifference או getChannelDifference. הפסקה היא
coverage.gap רשומה, ו coverage.gap_closed מציין את pts שממנו הרצף
חוזר להיות שלם.
רצף רציף מראה כי כל עדכון ש-Telegram מספר ברצף זה, בין
הראשון לאחרון 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 מדידה של המספרים ש-Telegram הקצה ואשר
אספן זה מעולם לא ראה. Telegram ממספר הודעות פעם אחת לכל ערוץ או סופר-קבוצה, ופעם אחת לכל
חשבון בכל הצ'אטים הפרטיים, הבוטים והקבוצות הרגילות. מספר שבין שתי
הודעות שנצפו הוא או שנצפה או חסר; טווח רציף מהווה קביעה חיובית כי
כל הודעה שמספרה נכלל בו נצפתה. פער אינו מציין שחקן כלשהו או סיבה כלשהי.
| תחום | משמעות |
|---|---|
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נחשבים כנצפים ללא תוכן. ייצוא או העברה של צ'אטים נבחרים אינם יכולים למדוד זאת. אם איסוף הנתונים של החשבון כולו הופעל ונכבה, תופיע הערה המציינת כי המספרים ששימשו בינתיים מופיעים כפערים. - הודעות השירות הן רשומות ביומן עם מספרין משלהן, ולכן הן ממלאות את הפערים בעצמן; האומדן האופציונלי נועד רק להקשר.
verify.py מחשב מחדש gap_summary מ events.jsonl עם הפרמטרים שב-
coverage.json (הגדרות ברירת מחדל לארכיונים ישנים יותר) ו
מדפיס את השורה ברמת החשבון בסיכום הכיסוי שלו. ה- get_capture_status(MCP ושורת הפקודה) מחזיר את אותה המדידה עבור הצ'אטים שהגישה עשויה לקרוא;
הרצף ברמת החשבון כולו רק לגישה המכסה את כל סביבת העבודה.
תצפיות חוזרות על הודעה אחת של שירות נספרות פעם אחת, ואומדן שירות החשבון משתמש רק במספרים הנמצאים בטווח הנמדד. היקף יישום חייב לשמר במפורש את ההודעות של החשבון עצמו לפני שמדידה ברמת החשבון מופעלת; המדידה מתחילה מרשומות הנושאות מידע זה. הטווח הנמדד מכסה תצפית פעילה, והמשך התצפית נרשם. לשאילתת הארכיון החי יש תקציב זמן, הכולל את סריקת מסד הנתונים, והיא מסמנת מדידה שלא הושלמה כמדידה חלקית.
Telegram מתעד את רצפי מזהי ההודעות הנפרדים. מספרים אלה מתארים תצפיות; הודעות מחיקה, בדיקות חוזרות ורשומת יומן המנהל המסבירה מדוע מספר מסוים חסר במקום שבו Telegram מדווח עליו.
כאשר 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 והמאמת מציגים את רשומת
ה-producer החתומה הזו. חשישים של קבצי המקור מזהים את עץ המקור המתועד לצורך השוואה
עם צ'ק-אאוט מהימן. מקור הביצוע נבדק בנפרד באמצעות
אישור רכישה מ-GitHub או
מדידות Intel TDX, כאשר האפשרות מופעלת. ארכיונים שנוצרו לפני
ששדה היוצר היה קיים ממשיכים להיות נתמכים ומזוהים כרשומות ישנות.
כל רשומת observation.started מציינת גם את שם הלקוח Telegram שביצע את הניטור: ה-api_id שלו
(לעולם לא את ההאש), בין אם מדובר בזוג ציבורי מובנה או ביישום של המפעיל עצמו,
תיאור הלקוח שנשלח בבקשת החיבור של Telegram, וסוג מסלול החיבור
עם מצב ה-IP (ללא כתובת פרוקסי או סוד). הדוח ו-custody.json מפרטים כל
לקוח ומסלול נפרד עם מועד הרישום שלהם, וכן את הפעמים שבהן אף פרוקסי מהרשימה לא ענה
ו-Telegram זיהה את כתובת השרת. יומנים שנרשמו לפני כן מציינים זאת.
פרופילים אישיים#
קובץ פרופיל (tgwitness-dossier-v1, JSON) נבנה על פי בקשה מתוך רשומות שכבר נמצאות
ביומן עבור צ'אט אחד; לא נשאב דבר מ-Telegram ותוכן הפרופיל לעולם לא
נכתב ביומן (הפעלה וכיבוי של פרופילים נרשמים כ-dossier.changed).
עבור כל אדם שיש לו הודעה שמורה, הוא מפרט את ההיסטוריה של השם ושם המשתמש, דגלי טלגרם
(בוט, הונאה, מזויף, פרימיום, מאומת, מוגבל, נמחק) כפי שנראו בזמן השמירה,
תעודות זיהוי תמונה, SHA-256 והאש תפיסתי (pHash, תואם ל-imagehash.phash) של
האווטאר ממאגר האווטארים המקומי עם אווטארים דומים, פעילות (ההודעה הראשונה והאחרונה,
מספרים, שיתופים שעברו עריכה ונמחקו, הודעות לפי שעה UTC), מי עונה למי, צ'אטים אחרים
ביומן זה שבו האדם כתב, וארנקים שהוזכרו (BTC, EVM, TRON, TON, LTC,
DOGE, XMR, SOL; כתובות Base58Check מאומתות באמצעות בדיקת סיכום), מספרי טלפון, שמות משתמש ו
קישורים, כולל קישורים המוסתרים מאחורי טקסט.
כל עובדה מציינת את רשומות היומן (seq) שממנה היא נלקחה, ו-record_hashes מכיל את
ה-hash של כל רשומה שמצוטטת. ההצהרה חתומה במפתח סביבת העבודה:
python verify.py tgwitness-dossier-CHAT.json --fingerprint TRUSTED_SHA256 --evidence tgwitness-evidence.zip
בודק את החתימה, מאמת את ייצוא הראיות עצמו (חתימה, שרשרת האש וקבצים) ומבטיח שכל רשומה המוזכרת קיימת ללא שינוי בייצוא זה של אותו מרחב עבודה. האשים של האווטרים מסומנים כמקורם במטמון המקומי (לא מרשומות היומן). אזכורים הם התאמות לדפוס ורמזים לבדיקה. הפרופילים מופעלים לפי צ'אט, ניתנים לייצוא כקובץ ZIP מוצפן ב-AES-256 עם סיסמה, ו נמחקים כאשר הם כבויים או כאשר הצ'אט מוסר מהמקורות.
עד עצמאי#
יומן עד (tgwitness-witness-v1) והפרסומים בערוץ שלו נבדקים מול
ייצוא ראיות באמצעות verify.py --witness … --channel …; ראו עד עצמאי.
בעזרת כתובת ציבורית https://t.me/s/… או https://telegram.me/s/…, המאמת קורא
את תאריך כל פרסום מ-Telegram, והתאריך המוקדם ביותר של פרסום כזה בראש הייצוא
מהווה את הזמן החיצוני של הרשומה האחרונה. תאריכים מכל מקור אחר הם מטא-נתונים המסופקים.
מניפסט ונקודות בקרה#
manifest.json כולל את הפורמט, זמן הייצוא, המפתח הציבורי, טביעת האצבע, אורך היומן,
ה-hash של הראש, ההיקף, היוצר, המגבלות ו-SHA-256 של כל רכיב תוכן מלבד
manifest.json ו-manifest.sig עצמם.
manifest.sig הוא חתימת base64 Ed25519 על קובץ ה-JSON הקנוני של המניפסט.
המאמת דוחה רכיבים בלתי צפויים או חסרים, שמות כפולים, קבצים פגומים,
רצף/שרשרת שבורים, חתימות לא חוקיות ואי-התאמה עם נקודת ביקורת שסופקה.
הוא לעולם אינו מחלץ נתיבי ארכיון. הוא מגביל את הגודל הכולל המוצהר ללא דחיסה ל-4 GiB;
--max-gib N מאפשר ארכיונים גדולים יותר שנוצרו עם הגבלת כלים נוספים → פרמטרים מוגדלת.
ארכיון גדול נבדק על ידי מספר תהליכים בו-זמנית: הפריטים עוברים חישוב hash במקביל,
ולאחר 5,000 הרשומות הראשונות, ה-hash של התוכן והחתימה של כל רשומה נבדקים
על ידי תהליכי עבודה, בעוד שהתהליך הראשי עוקב אחר השרשרת, הכיסוי והקישורים
בסדר הנכון. --jobs N קובע את מספר התהליכים; ברירת המחדל auto משתמש בתהליך אחד לכל מעבד, עד
16 לכל היותר, ו- --jobs 1 שומר את הכל בתהליך אחד. התוצאה זהה בשני המקרים,
ושינוי נדחה עם אותה הודעה. חשישים במיקומים שצוינו על ידי
נקודות ביקורת שנשמרו ועוגני חותמת זמן נשמרים במהלך המעבר הבודד הזה, כך שכל עוגן
מושווה מבלי לקרוא את היומן שוב. במחשב בעל 32-threads, ארכיון בגודל 10.8 GB עם
400,000 רשומות ארך 58.9 שניות בתהליך אחד, 15.2 שניות עם 4 תהליכים ו-8.4 שניות עם 16; מעבר אחד על
הרשומות לפי הסדר קובע את המגבלה.
הפעל את האימות מהגרסה המותקנת של TgWitness או מגרסה שנבדקה. העותק הכלול בארכיון תומך בשימוש נייד; השווה עותק זה להתקנה המהימנה שלך לפני הפעלתו.
נקודת ביקורת חותמת על הצהרה המכילה את המפתח הציבורי, אורך היומן,
ה-hash של הכותרת וזמן היצירה. היא נושאת גם את סיבוב ה-drand העדכני ביותר שהמרחב העבודה
הוריד (drand_anchor
): האספן מבקש מממסר drand דרך
המסלול החיצוני של מרחב העבודה לפני כל נקודת ביקורת תקופתית, כך ש-Hide 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 וזמן חיצוני מצד
צד שלישי המכסה את הרשומה האחרונה.
יש לקרוא את signer_pinned, requirements_met ואת תוצאות האישור, ולא רק את
קוד היציאה. במקום זאת, ה-Sealed Acquisition משתמש ב-
מאמת האישורים ובמדיניות המאושרת שלו כדי לאמת את תקציר הרכישה.
היקף האימות#
האימות בודק את הארכיון ואת מצב האיסוף ששימש ליצירתו. יש לבחור את המצב שגבולות האמינות שלו תואמים למקרה, ולאחר מכן לשמור את נתוני האימות שלו.
| מצב איסוף | מה בודק המאמת | קלט אימות וגבולות אמון |
|---|---|---|
| סביבת עבודה מקומית | יש לתעד חתימות, שרשרת האש, קובץ המניפסט ותווי הבייט של הקבצים המצורפים | טביעת אצבע של האספן הנשמרת על ידי המקבל וזמן חיצוני מצד שלישי: קבלות מאומתות לפי RFC 3161 או OpenTimestamps, או פוסטים של עדים הנקראים מ-t.me. נקודות ביקורת ורישומי עדים שנשמרו משמשים כבדיקות תומכות |
| סביבת עבודה מקומית עם עד עצמאי | בדיקות הארכיון וכן התאמה לקידומת היומן הקודמת שנשמרה על ידי העד | טביעת אצבע ורשומות של ה-Witness; רשומת בקרת המפתח של המשמורן מראה מי מחזיק במפתח ה-Witness. עם --channel https://t.me/s/…, התאריכים ש-Telegram קבע לפוסטים מספקים זמן חיצוני |
| תיעוד פעולות GitHub | אישור GitHub של תקציר הארכיון, זרימת עבודה מאושרת והתחייבויות האספן, רץ מאוחסן, מקור חדש של הפעלה/מפתח ושלמות פנימית של הארכיון | מדיניות מאמת מהימן, מאגר המתקשרים וחבילת אישור GitHub; האיסוף מתבצע במסגרת זרימת העבודה המוצמדת |
| פריסה בענן | רשומות מחזור החיים והגישה של הספק, מצב חומת האש ו-Cloudflare, וכן רשומת ההפעלה החתומה של האספן | שאילתות לקריאה בלבד לספק ול-Cloudflare; זמינותן של בדיקות בודדות תלויה בספק |
| מכונת וירטואלית סודית של Intel TDX | ציטוט חתימה ומצב הפלטפורמה, קישור להצהרת האספן, חיבור ומדידות מערכת ההפעלה | שרשרת האמון של Intel ומדדי הפריסה הצפויים; יש לשמור את תוצאות כל בדיקת TDX נדרשת |
ברכישה אטומה, האספן המאושר מקבל נתונים דרך חיבור מאומת ל-Telegram בתוך הסביבה המאומתת. האישור קושר את הארכיון לאותה הפעלה, כך שהאימות מכסה הן את הרכישה והן את תקינות הקובץ בהמשך. זה מסתמך על הקוד המאושר ועל שרשרת האמון של הפלטפורמה המפורטת לעיל. אימות לכידת GitHub דורש הפעלה שנוצרה בתוך הריצה ודוחה לכידות של הפעלות מיובאות.
אישור ההפעלה מתעד את גרסת האספן, חתימות ה-hash של הקבצים והגדרות ההפעלה. מקור ב-GitHub ומדידות TDX מספקים את בדיקות הסביבה; רשומת האימות מזהה את התצורות שנבדקו.
מאיפה מגיעים ההודעות#
Telegram מעבירה הודעות לכל לקוח, כולל האפליקציות הרשמיות, במסגרת הפעלה של MTProto. מפתח ההרשאה של ההפעלה מותאם מול מפתח השרת הקבוע של Telegram, וכל עדכון מגיע מוצפן ועובר בדיקת תקינות תחת מפתח זה. האספן מקבל הודעות דרך ההפעלה המאומתת של החשבון, ומחתים כל תצפית ביומן עם הגעתה, יחד עם מזהי הצ'אט, ההודעה והשולח, וכן התאריך ש-Telegram קבעה לכל הודעה. ב-GitHub Actions ו-Intel TDX, האישור גם מקשר את ההפעלה של האספן המאושר לאותה הפעלה ולמפתח החתימה.
היומן מתעד את מקור מפתח ההרשאה. כניסה באמצעות טלפון או QR,
או כניסה עצמאית מקובץ הפעלה, כותבת account.authorized עם
key_origin: "created"; איסוף ממפתח .session מיובא, TData או JSON כותב
imported. מפתח מיובא קיים גם בכל מקום שממנו הגיע. פריסות מאומתות
מסרבות לקבל מפתחות מיובאים.
מקורו של רישום ב-Telegram מבוסס על החיבור המאומת של החשבון, על
רישומי החיבור והלכידה ביומן, על מסגרות MTProto שנלכדו והתאימו לרישומים
ביומן (tgwitness/forensics/), על תאריך ה-Telegram של כל
הודעה, ובמקרה של לכידה מאומתת – על סביבת הביצוע המאומתת. חתימות הארכיון
שומרות את הרישום לבדיקה מאוחרת יותר. נקודות ביקורת שנשמרו קובעות את גבולות היומן
המוקדמים, רשומות הכיסוי מציגות את תוצאות האיסוף, וחותמות זמן חיצוניות מאומתות
ממקמות את הבתים שנשמרו בזמן.
עבור סביבת עבודה מקומית, הנמען מספק קלט מאסף או עד מהימן. לצורך רכישה אטומה, המדיניות והאישור המהימנים קושרים את תקציר הארכיון לביצוע המאסף המאושר. אלה הם נתיבי אימות שונים; דווח על הבדיקות שהושלמו עבור הנתיב הנבחר.
קובצים מצורפים#
הקובצים ממוינים לפי SHA-256 בתיקיית media/. אירוע media.saved מקשר בין חתימת hash ואורך ב-byte לאירוע הודעה ספציפי. שמות הקבצים הגולמיים הם מטא-נתונים, לעולם לא נתיבים מקומיים. בייטים של מדיה מורידים באופן אסינכרוני, ולכן מחיקה מיידית עלולה למנוע את לכידתם. איסוף מושבת, קבצים גדולים מדי או בגודל לא ידוע, כשלים בהורדה, והורדות שנקטעו מוצגים בתוצאות. קריסת תהליך עלולה להשאיר קבצים חלקיים ללא הפניה; הם אינם נכללים בייצוא.
יצואן ה-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 כולל מזהה ריצה, שעונים מקומיים, גרסאות תלות, חשישים של קבצי מקור, חשבון/היקף ראשוניים, והגדרות לכידה. פעימות הלב כוללות את מזהה הריצה, זמן מונוטוני ומצב התור. ניתן להוריד את אישור ההרצה גם כמסמך חתום בנפרד. לצורך אימות סביבת הביצוע, יש לשלב אותו עם אישור GitHub או בדיקות TDX המתוארות ב-Verification scope.
נקודות ביקורת אוטומטיות נשמרות באופן מקומי בעת ההפעלה, כל חמש דקות במהלך התצפית (כלים נוספים → פרמטרים → נקודת ביקורת חתומה כל), ובסיום מסודר. אימות בעת ההפעלה וייצוא משווים את היומן לנקודת הביקורת המקומית האחרונה שנשמרה. כך ניתן לזהות החזרה לאחור של מסד הנתונים כאשר נקודת הביקורת נותרת קיימת. שמירה עצמאית שומרת על זמינות ההתייחסות מחוץ לסביבת העבודה; חותמת זמן חיצונית מאומתת מקבעת אותה בנוסף בזמן.
לאחר הפעלה מחדש, מיקום העדכון השמור של Telegram יוחזר (catch_up_from ב 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.
השחזור דורש ספרייה רגילה וריקה. קבצים שהורדו ואובייקטים מפוענחים נשמרים באחסון זמני פרטי עד לאימות היומן כולו וכל נקודת ביקורת שנשמרה. נתיבי אובייקטים לא בטוחים, טווחי קטעים לא עקביים ויומנים הקצרים מנקודת ביקורת נדחים; אימות כושל אינו מפרסם קבצים משוחזרים. בדיקות השמירה משוות את מצב נעילת האובייקט והתאריך שהוחזרו עם המועד האחרון שנשלח בעת ההעלאה (סובלנות עיגול של שנייה אחת). מועד אחרון שפג תוקפו, לא תקף או מקוצר אינו נחשב כמאומת. הסטטוס מדווח על האובייקט שנדגם ששמירתו נקראה בחזרה עבור מחזור ההעלאה הזה.
מדיה מקומית חסרה או פגומה מדווחת כשגיאה של המעבר, והסמן נשאר על המדיה שלפניה, כך שהקובץ ינסה שוב במעבר הבא; הקבצים, נקודות הבדיקה והייצוא שאחריה עדיין מועתקים. בדיקות השחזור משוות את כל ההפניות למדיה שנשמרה מול חשישים מפוענחים וגדלים שנרשמו. קטעי יומן חופפים זהים מהעלאות שנקטעו עוברים דה-דופליקציה; חפיפות סותרות נדחות. נקודות ביקורת שנוצרו במהלך העלאה נדחות עד שרישומי היומן שהן מכסות הועתקו, כך שמעבר שהושלם אינו מפרסם נקודת ביקורת לפני היומן שלה.
תמונות מצב של ייצוא הזרמה#
ייצוא הזרם משתמש בתמונת מצב קריאה יציבה של 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 שנכשלה פעמיים ברציפות ממתינה לפני הניסיון הבא: מרווח זמן אחד, לאחר מכן
שניים, ארבעה וכן הלאה עד שש שעות, או כל עוד מבקש ה-Retry-After, עד יום אחד. מעבר ש
מוצא רק רשויות ממתינות אינו כותב רשומה; אחרת, anchor.completed מפרט אותן תחת
deferred עם retry_at. עד שיענו שוב, הלוח מציג חותמות זמן כ-Degraded.
הפאנל מכין ארכיון בקשות המכיל בתים קנוניים של checkpoint.json, טביעת הודעה SHA-256 ו-nonce אקראי בקובץ timestamp.tsq, סכומי ביקורת והוראות. לא מתבצעת בקשת רשת; האסימון שהרשות מחזירה עבור בקשה זו הוא חותמת הזמן.
python -m tgwitness.anchor verify בודק את התשובה מול הבתים של נקודת הביקורת ומול הבקשה המקורית, ללא OpenSSL. יש לציין במפורש קובץ CA מהימן; אישורים כלולים אינם נחשבים מהימנים אוטומטית. בדיקת הבקשה אופציונלית ב-CLI, לכן שמרו את הבקשה והעבירו --request כדי לבדוק את ה-nonce. התוצאה מציינת אם היא נבדקה. את חתימת נקודת הביקורת של האוסף ואת היומן עדיין יש לאמת בנפרד מול טביעת האצבע המהימנה של האוסף.
האימות בודק את חתימת התגובה, את בתים של נקודת הבדיקה, וכאשר הם מסופקים,
את הבקשה המקורית תחת אמון ה-CA שצוין. עבור חותמות זמן שהושגו במצב ראיות, verify.py בודק גם את ה-OCSP המאוחסן או
את ראיות ה-CRL (ביטול תעודת חתימה).
ראו את ההליך ותוצאות האימות.
רשומות אופציונליות במצב ראיות: מכשירי drand ו-Telegram#
ישנם שני רשומים נוספים שיכולים לפעול באותם מחזורי רישום כמו חותמות הזמן. שניהם נכנסים לתוקף רק כל עוד
מצב הראיות מופעל. ראיות לתיק מפעילות את drand; אחרת, שניהם מתחילים לפעול. ניתן להחליף ביניהם
תחת 'כלים נוספים' → 'תוספות' → 'ראיות וגיבויים' → 'עדים נוספים' · אופציונלי,
או "drand": true ו "devices": true ב POST /api/evidence. תקלה באחד מהם אינה עוצרת את
השני או את חותמות הזמן; הלוח מציג את התוצאה האחרונה של כל אחד מהם מתחת לטופס.
drand
(beacon.drand
). בכל מעבר נכתבת הסבב החדש ביותר של drand quicknet, האקראיות הציבורית
של League of Entropy (סבב כל 3 שניות), ביומן: chain
,
round
, randomness
, signature
, round_time
וה-relay
שהשיב. סבב מאומת
ובלתי צפוי מספק נקודת ייחוס זמן תחתונה לחומר המקושר באמצעות hash הבא.
חותמת זמן מאומתת בנקודת ביקורת מאוחרת יותר מספקת נקודת ייחוס זמן עליונה. בדיקות אלה
מגדירות את גבולות החומר המקושר. האספן פונה תחילה ל-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 Gateway ( Gateway DNS ), כל
העתקה מעתיקה את מה ש-Gateway תיעד מאז ההעתקה הקודמת: רשומה אחת לכל חלון של שלוש
שעות לכל היותר עם from, until, location_id, address של השרת כאשר הוא מוגדר, ו-
queries כ-[at, name, type, rcode, decision, colo], גם כאשר לא היה כזה. הגדר זאת תחת
יומן Cloudflare Gateway : חשבון, מיקום, כתובת אופציונלית ואסימון לקריאה בלבד (קריאת
Analytics לקריאה; Zero Trust PII לקריאה כדי לשמור כתובת אחת של מיקום משותף). הלוח בודק
אותם בבקשה אחת לפני השמירה; האסימון נשאר מוצפן ולעולם אינו נכנס ליומן.
verify.py מפרט את החלונות, השמות שנחפשו ביותר וכל זמן שאין עותק שמכסה; רשומה
שמספרה אינו תואם את השאילתות שלה נכשלת. חלון המכיל יותר מעמוד אחד של
שאילתות בשנייה אחת שומר את העמוד הזה ומציין שהשאר חסר. העותק הוא
התשובה של Cloudflare דרך האספן, חתומה על ידי האספן; תוך 24 שעות כל מי שיש לו
אסימון לקריאה בלבד יכול להשוות אותה עם Cloudflare.