TgWitness / תיעוד

מה נבדק ←

הפניה / ראיות

Telegram · חותמות זמן

חותמות זמן לפי RFC 3161 עבור נקודות ביקורת חתומות: מה נשלח לרשות וכיצד מאמתים את התגובה.

TgWitness / תיעוד · ראיות ואימות

ראיות ואימות

TgWitness מכין בקשות לפי RFC 3161 ומאמת תגובות של רשות חותמת זמן (TSA). תהליך ידני זה אינו בוחר TSA ואינו שולח נתונים; מצב הראיות מבצע את שני הדברים על פי לוח זמנים (פורמט ראיות). בקשה שהוכנה אינה מהווה עדיין הוכחת חותמת זמן.

מה שהראיה מחייבת#

תרשים זרימהתצפיות על חשבונות → שרשרת SHA-256 וחתימות Ed25519; שרשרת SHA-256 וחתימות Ed25519 → נקודת ביקורת חתומה; נקודת ביקורת חתומה → השיג (hash) ברמת בייט מדויק ו-nonce אקראי; השיג (hash) ברמת בייט מדויק ו-nonce אקראי → בקשה לפי RFC 3161; בקשה לפי RFC 3161 → TSA עצמאית; TSA עצמאית → תגובת TSA חתומה; נקודת ביקורת חתומה → אימות נתונים, מספר אקראי (nonce) ואמון מפורש ברשות האישור (CA); תגובת TSA חתומה → אימות נתונים, מספר אקראי (nonce) ואמון מפורש ברשות האישור (CA)תצפיות על חשבונותשרשרת SHA-256 וחתימותEd25519נקודת ביקורת חתומההשיג (hash) ברמת בייטמדויק ו-nonce אקראיבקשה לפי RFC 3161TSA עצמאיתתגובת TSA חתומהאימות נתונים, מספראקראי (nonce) ואמוןמפורש ברשות האישור(CA)
תרשים כטקסט
  1. תצפיות על חשבונות → שרשרת SHA-256 וחתימות Ed25519
  2. שרשרת SHA-256 וחתימות Ed25519 → נקודת ביקורת חתומה
  3. נקודת ביקורת חתומה → השיג (hash) ברמת בייט מדויק ו-nonce אקראי
  4. השיג (hash) ברמת בייט מדויק ו-nonce אקראי → בקשה לפי RFC 3161
  5. בקשה לפי RFC 3161 → TSA עצמאית
  6. TSA עצמאית → תגובת TSA חתומה
  7. נקודת ביקורת חתומה → אימות נתונים, מספר אקראי (nonce) ואמון מפורש ברשות האישור (CA)
  8. תגובת TSA חתומה → אימות נתונים, מספר אקראי (nonce) ואמון מפורש ברשות האישור (CA)

חתימת האספן קושרת את הרשומות למפתח שלו. תגובה מהימנה של TSA יכולה לקבוע כי נקודת ביקורת מסוימת הייתה קיימת בזמן שצוין על ידי ה-TSA. נקודת הביקורת יכולה אז לקשר את קידומת היומן. מגבלת הזמן העליונה הזו חלה על אותה קידומת שהוקצתה; פעולות Telegram בודדות שומרות על זמני האירועים המתועדים שלהן.

נוהל#

מאמת היומן מדווח על צעדים לאחור וערכי observed_at שאינם ניתנים לניתוח ב-chronology, כאשר הם קיימים, וכולל אזהרה בפלט הפקודה שלו. הוא שומר על חותמות הזמן החתומות ועדיין בודק את החתימות שלהן. צעד לאחור יכול לנבוע מתיקון שעון, ולכן יש לבדוק אותו מול רשומות השעון של המארח. הזמן העצמאי נגזר מחותמות זמן חיצוניות מאומתות, מהודעות עדים הנקראות מדף ה-t.me הציבורי שלהן ומסבבי drand; --strict קובע את קיבוע החותמים ואת הפורמטים הנתמכים.

ערכי drand שהוקלטו עוברים בדיקות עקביות פנימית מבנית ובדיקות עקביות חשיפתית במצב לא מקוון. הפקודה --check-drand משווה סיבובים מוקלטים נבחרים לתגובות ממסרי HTTPS; התוצאה מציינת כמה סיבובים הושוו ואילו ממסרים השיבו, וה סיבובים שהושוו מספקים את הגבול התחתון המאושר של הזמן.

  1. יש לשמור את טביעת האצבע של מפתח האספן באמצעות ערוץ מהימן נפרד; היא מזהה את האספן באופן בלתי תלוי בקובץ ה-ZIP הנבדק.
  2. תחת 'ייצוא' → 'הכנת בקשת חותמת זמן', הורידו את קובץ ה-ZIP של הבקשה של סביבת העבודה הנבחרת. חלצו את הקבצים checkpoint.json, timestamp.tsq, SHA256SUMS ו- README.txt. אין לשנות את בתים של נקודת הבדיקה.
  3. בחרו TSA המתאים לחקירה. שלחו את timestamp.tsq באמצעות השיטה המתועדת, עם application/timestamp-query עבור שירות HTTP. שמרו את התשובה הבינארית המקורית כ-timestamp.tsr, את נקודת הקצה, זמן האחזור ותוצאת הבקשה. הבקשה מכילה hash ו-nonce במקום הודעות; מטא-נתוני הרשת עדיין חושפים את הבקשה.
  4. יש להשיג את תעודת השורש המהימנה באופן עצמאי מהתשובה, בנוסף לכל תעודות הביניים הנדרשות. תעודה המופיעה בתשובה אינה הופכת למהימנה רק בגלל שהיא כלולה בה.
  5. מתוך התקנה מהימנה של TgWitness, אמת:
python -m tgwitness.anchor verify --checkpoint checkpoint.json --request timestamp.tsq --response timestamp.tsr --ca trusted-tsa-root.pem

הוסיפו --intermediates tsa-intermediates.pem במידת הצורך. אין צורך ב-OpenSSL: החתימה, ההפניה לאישור החתימה והשרשרת נבדקות ב-Python בספרייה cryptography, אותו קוד שבו משתמש verify.py --tsa-ca. openssl ts -verify נשאר בדיקה שנייה ועצמאית למומחה שרוצה בה.

  1. ייצא קובץ ZIP של היומן החתום לאחר נקודת הבדיקה, כך שיכלול את הקידומת הזו. אמת באמצעות טביעת האצבע הידועה באופן עצמאי:
python tgwitness/verify.py evidence.zip --fingerprint TRUSTED_SHA256 --checkpoint checkpoint.json

זה מראה שהייצוא מכיל את הקידומת עם חותמת הזמן. verify.py קורא קבלות עם חותמת זמן רק מה-ZIP, שם מצב הראיות מאחסן אותן; התשובה הידנית נבדקת בשלב 5 ומכסה את הרשומות עד לנקודת ביקורת זו.

  1. יש לשמור את קובץ ה-ZIP, נקודת הבדיקה, הבקשה, התשובה, שרשרת האישורים, תוצאות האימות ותיעוד העברת הנתונים מחוץ לאספן. יש לחזור על תהליך האימות עם קבלת הנתונים.

כדי להכין בקשה מנקודת ביקורת שנשמרה:

python -m tgwitness.anchor prepare checkpoint.json --out timestamp-request.zip

תהליך ההכנה מבצע קנוניזציה של JSON וכולל את נקודת הבדיקה התואמת בארכיון. יש להשתמש בבתים של נקודת הבדיקה מאותו ארכיון לאימות TSA, גם אם בקובץ הקלט היו רווחים שונים.

גבולות האימות#

בדוק התנהגות נוכחית
נתונים ערך ה-SHA-256 של בתים המדויקים בנקודת הבדיקה חייב להתאים לתגובה
בקשה באמצעות ה---request, השאילתה המקורית וה-nonce מאומתים
חתימת TSA החתימה, אישור החתימה והשרשרת שלו עד ה-CA שצוין במפורש נבדקים לפי זמן החותמת
חתימת האספן מאומת בנפרד על ידי בודק היומן באמצעות מפתח מוצמד
ביטול מצב הראיות מאחסן ראיות OCSP/CRL ש-verify.py בודק
הגשה מתוזמנת מצב ראיות, מופעל על ידי כל יעד הגדרה

--request אופציונלי מבחינה טכנית, אך בלעדיו אי אפשר לאמת את ה-nonce המקורי. בהליך המלא הזה request_checked בתוצאה חייב להיות true. כל אישור בשרשרת חייב להיות תקף בזמן החותמת, ואישור החתימה חייב להיות מיועד לחותמות זמן בלבד.

תגובת ה-TSA מקשרת את בתים של נקודת הבדיקה שהוגשו לזמן שצוין. יש לבדוק תוצאה זו מול רשומות הרכישה ואימות הסביבה עבור המצב הנבחר. מצב הראיות כולל ה-TSA המוסמך של ממשלת בלגיה (http://tsa.belgium.be/connect; תשובות RFC 3161 חתומות, ולכן HTTP רגיל אינו מחליש אותן). כאשר שורש הספק מועבר ל---tsa-ca, verify.py מדווח על חותמת זמן eIDAS מוסמכת ויחידת חתימת הזמן שלה; תקנה (האיחוד האירופי) מס' 910/2014, סעיף 41(2), מניחה את דיוק הזמן ואת תקינות הנתונים המקושרים.

ביטול תעודת חתימה#

מיד לאחר כל תשובה, מצב הראיות משיג ראיות לביטול עבור תעודת החתימה של TSA: תגובת OCSP מכתובת ה-AIA OCSP של התעודה, או לחלופין ה-CRL מנקודת ההפצה שלה (4 MiB לכל היותר). היא מאוחסנת לצד התשובה כ- checkpoint-N.<service>.ocsp או .crl ומיוצאת יחד איתה. אי-הצלחה בהשגה לעולם אינה מעכבת את חותמת הזמן; הרשומה anchor.completed מציינת אותה כ-unavailable עם הסיבה.

verify.py בודק את חתימת התגובה של OCSP (על ידי המנפיק, או על ידי תעודת מגיב שהמנפיק העניק למטרת חתימת OCSP), את מזהה התעודה ואת הסטטוס, וכן שה תשובה הונפקה ב-genTime או לאחר מכן, או שהייתה עדיין בתוקף באותו זמן (nextUpdate). עבור CRL הוא בודק את חתימת המנפיק, את אותו חלון זמן ואת העובדה שהמספר הסידורי אינו מופיע ברשימה. לאחר מכן הוא מדווח signing certificate not revoked as of <time> (OCSP|CRL), על הבדיקה שנכשלה, או revocation not checked (no OCSP/CRL in the archive). תעודת חתימה שבוטלה ב-genTime או לפניו נכשלת באימות; ביטול מאוחר יותר מוצג כאזהרה.

תיעוד ראיות וחידוש (RFC 4998)#

חותמת זמן לפי RFC 3161 תקפה רק כל עוד אלגוריתם ההאש שלה, מפתח החתימה של ה-TSA והאישור שלה תקפים, אך התיק עשוי להימשך מעבר לכך. מצב הראיות שומר גם על רשומת ראיות לפי RFC 4998 (ERS) עבור כל נקודת ביקורת שנשמרה, ומחדש אותה.

בכל מחזור אימות, נקודות ביקורת שאין להן רשומה נכנסות לעץ האש, וה-TSA שהוגדרו מתבקשים לפי הסדר לספק חותמת זמן אחת על השורש שלו. כל נקודת ביקורת מקבלת checkpoints/anchors/checkpoint-N.ers: EvidenceRecord שבו ArchiveTimeStampSequence מכיל אחת ArchiveTimeStampChain עם ArchiveTimeStamp המכיל את עץ ההאש המצומצם עבור אותה נקודת ביקורת ואת אסימון ה-TSA. רשומה יכולה לכלול האשים של נקודות ביקורת סמוכות; תוכנות אימות כגון EU DSS מזהירות מפני כך. ייצוא ASiC-E מכיל גם META-INF/evidencerecord.ers עם META-INF/ASiCEvidenceRecordManifest.xml, את רשומת הראיות עבור אובייקטי הנתונים של המכל (ETSI EN 319 162-1). ייצוא ZIP נושא את רשומות נקודות הבדיקה תחת anchors/.

החידוש מתבצע בהתאם לסעיף 5 של RFC 4998, ורק מוסיף את הפרטים הבאים:

חידוש כאשר מה מוטבע
חידוש חותמת הזמן תוקף תעודת החתימה של האסימון החדש יפוג תוך N חודשים (ברירת מחדל: 6), חתימת ההאש שלו מסומנת כחלשה, או על פי בקשה ה-hash של האסימון הקודם, באותו אלגוריתם; החותמת מתווספת לשרשרת האחרונה
חידוש עץ ההאש אלגוריתם ההאש של השרשרת מסומן כחלש, או לפי בקשה H(H(checkpoint) + H(previous ArchiveTimeStampSequence)) באמצעות אלגוריתם חזק יותר (SHA-512 כברירת מחדל); מתווספת שרשרת חדשה

כל חידוש נשמר בקובץ חדש, checkpoint-N.renewal-K.ers; הקבצים והשרשראות הקודמים נשארים זהים בייט אחר בייט. ההוכחה מתייחסת לחותמת הזמן הראשונה רק אם כל החוליות נבדקות בסדר הנכון, ולכן יש לחדש כל עוד האסימון החדש ביותר עדיין תקף: לפני שתוקף תעודת החתימה שלו יפוג, מידע הביטול שלו ייעלם או שאלגוריתם ההאש או החתימה שלו יישבר. חידוש מאוחר יותר מוסיף חותמת אך אינו מאריך את ההוכחה הקודמת.

לולאת הרקע במצב "ראיות" בודקת את המדיניות מדי יום ועל פי בקשה (evidence_record.demand_renewal). כל ניסיון נרשם ביומן כ- evidence_record.created או evidence_record.renewed עם השירות, הזמן, אלגוריתם ההאש, שורש העץ, טווח נקודת הבדיקה, ok והשגיאות; רשומות בלתי קריאות מועברות ל evidence_record.check_failed. במקרה של כישלון ב-TSA מתבצעת ניסיון חוזר עם זמן המתנה לחתימת נקודת הבדיקה, הנספר בנפרד, בזמן שמנסים את ה-TSA הבא ברשימה. המדיניות (months_before_expiry, weak_algorithms, algorithm, stronger_algorithm) היא הגדרת הפרופיל evidence_record_policy; ללוח הבקרה אין עדיין שליטה עליה.

האספן בודק כל רשומה חדשה מול נקודת הבדיקה שלה וחתימת ה-TSA לפני שהוא כותב אותה. verify.py בודק כל רשומה בייצוא: עצי hash, אסימונים, סדר השרשראות והחידושים, ומדווח על הזמן המוקדם ביותר שהוכח ועל מצב החותמת החדשה ביותר. ה-DSS של האיחוד האירופי קורא את אותן רשומות עם נקודת הבדיקה כנתונים מנותקים.

תקנה (האיחוד האירופי) 2024/1183 (eIDAS 2.0) הוסיפה ארכיונים אלקטרוניים מוסמכים ורישומים אלקטרוניים מוסמכים לתקנה (האיחוד האירופי) מס' 910/2014. TgWitness כותבת רשומות בפורמטים סטנדרטיים, אך אינה שירות אמון; לארכיון ולרישום שלה אין מעמד מוסמך. ספק מוסמך יצטרך, בין היתר:

  • ארכוב (סעיפים 45i ו-45j): ספק שירותי אמון מוסמך השומר את הנתונים למשך תקופת השמירה החוקית או החוזית, באופן עמיד וקריא מעבר לתקופת התוקף הטכנולוגית ומוגן מפני אובדן ושינוי, עם דוח תקינות אוטומטי עבור צדדים מסתמכים מורשים, מתחילת השמירה ועד לשליפת הנתונים. סעיף 45i(2) קובע חזקת תקינות ומקור עבור שירות כזה.
  • ספרי חשבונות (סעיפים 45k ו-45l): ספר חשבונות שנוצר ומנוהל על ידי ספק שירותי נאמנות מוסמך אחד או יותר, אשר קובע את מקור הרשומות, מסדר אותן באופן ייחודי ו כרונולוגי, ומאפשר זיהוי מיידי של שינויים שבוצעו מאוחר יותר. יומן ה-TgWitness הוא שרשרת חשישים (hash-chained) וחתום במפתח של האספן עצמו, אשר כשלעצמו אינו מהווה ספר חשבונות מוסמך.
  • שניהם: מעמד מוסמך שהוענק על ידי גוף פיקוח ורישום ברשימת הארגונים המהימנים (סעיפים 21 ו- 22), החובות המפורטות בסעיף 24, הערכת תאימות לפחות אחת ל-24 חודשים (סעיף 20) והתקנים המתייחסים של תקנות היישום לפי סעיפים 45j(2) ו-45l(2).

חותמות זמן מאושרות מ-TSA מאושר (סעיפים 41 ו-42) שומרות על חזקתן הנפרדת לכל אסימון; חידושן אינו יוצר חזקה כזו עבור התיעוד בכללותו.

רישום העברה#

תעדו את מזהה התיק, השולח והנמען, זמן ההעברה ב-UTC ומקורו, המטרה, שמות הקבצים/ערכי SHA-256, טביעת האצבע של האספן, טווח הרצף, פערים ידועים, גרסת המאמת ותוצאת האימות. חתמו על תיעוד זה ושמרו אותו באופן עצמאי בהתאם לתהליך הארגוני שלכם. מערכת תיעוד שמירה רב-משתמשת אינה מיושמת ב-TgWitness.

בדיקת שירות בזמן אמת, 9 בנובמבר 2026#

בקשה אחת לפי RFC 3161 נשלחה לכל אחד מהשירותים המוגדרים כברירת מחדל. שניהם אישרו אותה.

שירות תשובה יחידת חתימה תוצאת המאמת
http://tsa.belgium.be/connect אושר, מדיניות 2.16.56.13.6.3.1.1000 יחידת חותמת זמן 202301 חותמת זמן מוסמכת לפי eIDAS
https://freetsa.org/tsr אושר FreeTSA חותמת זמן RFC 3161

תעודת החתימה הבלגית נושאת את הצהרת התאימות qcStatements ו תואמת את היחידה שנרשמה במאמת. בדיקות מקומיות משתמשות גם ב-CA/TSA סינתטי כדי לבדוק דחייה של נתונים ששונו, nonce ששונה ו-CA שגוי.

ב-10 בנובמבר 2026, מגיב ה-OCSP הבלגי, תעודת מגיב מוסמכת, השיב "טוב" עבור יחידת חותמת הזמן 202301. כתובת ה-OCSP של FreeTSA (יציאה 2560) לא השיבה תוך 40 שניות ממארח הבדיקה; במקום זאת נעשה שימוש ב-CRL שלה (PEM, 1 KB).