TgWitness / תיעוד

מה נבדק ←

תיעוד / 02

Telegram · תיעוד פעולות GitHub

בחרו Takeout, ייצוא דרך ה־API הרגיל או יומן שיחה על מכונת הרצה זמנית של GitHub.

הפניה מלאה

TgWitness / תיעוד · לכידה עצמאית

לכידה עצמאית

תצוגה מקדימה זמינה מה-main. פורק מפעיל זרימת עבודה מוצמדת וניתנת לשימוש חוזר מ- phishdestroy/TgWitness. זרימת העבודה מייצאת חשבון, צ'אטים נבחרים או יומן האירועים של צ'אט אחד באמצעות הפעלת טלגרם שנוצרה זה עתה, מאמתת את הראיות בקובץ ZIP או במניפסט רב-חלקים, ומעלה רק העברות מוצפנות על ידי הנמען. לוח הניהול הרגיל אינו חשוף.

בחר client=official_web להפעיל את ה-witness של ה-official-client עם בקרות וידאו מוגנות של Telegram Web. הדבר מצריך פרוקסי upstream משלך ומפקח על צ'אט אחד שמוצג. ברירת המחדל client=api שומר על מצבי הייצוא של החשבון המלא המתוארים להלן.

המאמת בודק את הארכיון מול האישור ב-GitHub, את תהליך העבודה המאושר ואת ה-commits של האספן, וכן את ה-hash של היומן והקבצים המצורפים החתומים. תהליך האיסוף משתמש בקוד מקובע מהמקור ובאחסון חדש. בודק יכול לבחון את הקוד ולאמת את הארכיון שנמסר מול הריצה המתועדת שלו.

בעמוד זה

זרימת המשתמשים#

העוזר מסביר את חמשת השלבים ומאפשר לך לנסות החלפת הודעה או קולטן על נתוני דוגמה. האפשרות התחל את הלכידה שלי פותחת את האשף.

  1. בחר ב-GitHub Actions capture (תצוגה מקדימה) בדף הבית של הפרויקט, במסך הכניסה לסביבת העבודה, או ב-Exports → Open capture helper. ניתן גם לפתוח את העוזר הרשמי או את הקובץ tgwitness/static/capture.html מתוך צ'ק-אאוט מהימן בדפדפן מודרני. העוזר אינו מבצע בקשות רשת לעיבוד מפתחות או קבצים. העוזר תומך בשפות הממשק של האתר; לוח האיסוף הזמני תומך באנגלית וברוסית ונפתח בשפת הדפדפן כאשר היא אחת מהן.
  2. הפק מפתח ושמור את הקובץ sealed-key.json. זהו המפתח הפרטי היחיד לפענוח. העתק את הערך הציבורי הנפרד של הנמען. אובדן המפתח הפרטי יגרום לאובדן הגישה הן לחיבור והן לארכיון. אשר ששמרת אותו כדי לעבור לשלב הבא. אם כבר יש לך קובץ משלוח, טען את המפתח השמור ובחר באפשרות כבר יש לי ארכיון.
  3. צרו פורק ל-TgWitness, הפכו את האפשרות "Actions" לזמינה בפורק, והפעילו את תכונת Sealed chat capture. הדביקו את הנמען הציבורי ובחרו 30, 60 או 120 דקות. לעולם אל תציינו מספר טלפון, קוד כניסה, סיסמת טלגרם, מפתח פרטי או הפעלה בתשומות של זרימת העבודה, בקומיטים, בבעיות או ביומנים.
  4. במהלך ההרצה, הורידו את הקובץ sealed-connection מ-Artifacts וחילצו אותו. טענו connection.tgwsealed בתוך ה-helper, באמצעות המפתח הפרטי שנשמר. הקישור שנוצר מכיל סוד גישה אקראי בקטע ה-URL שלו. שמור על פרטיות הקישור הזה. הפאנל מסיר את הקטע ושומר את הסוד באחסון ההפעלה של הכרטיסייה הזו; הוא אינו נרשם ביומני הגישה של HTTP.
  5. פתח את קישור החיבור. התחבר באמצעות קוד QR, או באמצעות מספר הטלפון שלך ו קוד הכניסה. הזן את סיסמת האימות הדו-שלבי אם Telegram מבקש זאת. מאגר האישורים המובנה של ה-API משמש כברירת מחדל, בדיוק כמו בסביבת העבודה הרגילה. אתה יכול להרחיב את הקטע האופציונלי של אישורים מותאמים אישית ולהזין את שניהם api_id וגם api_hash מ-my.telegram.org/apps. השאר את שני השדות ריקים כדי להשתמש במאגר המובנה; זוג חלקי או לא תקין יידחה. ייבוא הפעלות אינו מותר. בחר את מצב הייצוא ואת ההיקף. קישור החיבור מכיל סוד גישה: שמור אותו חסוי.
  6. בחר ב-Telegram Takeout, ב-Regular Telegram API או ביומן אירועי צ'אט. לייצוא חשבון, בחר את כל הצ'אטים הנגישים או טען ובחר צ'אט אחד או יותר, ואז הגדר תאריכים, סוגי צ'אט, קטגוריות חשבון וכללי קבצים מצורפים. בדוק את ההגדרות והגודל, ובמידת הצורך שמור את קובץ ה-JSON של ההגדרות עבור בוחן חיצוני, ולאחר מכן לחץ על 'התחל לכידה'. ההגדרות קבועות לאחר ההתחלה. המשך הפעולה פועל רק כל עוד הרץ הזה קיים; סיום מוקדם שומר את הנתונים שנאספו ומתעד פערים. פקיעת המועד האחרון לאחר ההתחלה מייצרת ארכיון חלקי במפורש; פקיעה לפני ההתחלה או ביטול אינם מייצרים ארכיון.
  7. המתן לקבלת הקובץ sealed-result, הורד אותו ופתח את הקובץ המכווץ, ולאחר מכן פענח delivery.tgwsealed בתוך התוכנה העוזרת. תקבלו delivery.zip, המכיל evidence.zip, attestation.jsonl, והוראות. פענוח בדפדפן מוגבל ל-256 MiB; עבור חבילות גדולות יותר יש להשתמש בפקודה המקומית להזרמה המופיעה להלן. תוצאות גדולות כוללות גם delivery-NNNNNN.tgwsealed חלקים; הקובץ הראשי delivery.tgwsealed מכיל evidence.parts.json ואת האישור. הורד כל חלק והרכיב אותם באופן מקומי כפי שתואר להלן.
  8. יש לסיים את ההפעלה הזמנית בתפריט 'הגדרות' → 'מכשירים' ב-Telegram אם הביטול לא אושר או אם תהליך הריצה הופסק. בסיום רגיל מתבקש המשתמש להתנתק, ו תהליך הריצה מתעד אם הביטול אושר.

המאגר חייב להכיל את הקוד המקור המוצמד שפורסם ואת ה-commits של "reusable-workflow". ענף מקומי לבדו אינו יכול להיות מופעל על ידי מאגר GitHub אחר.

תקציב זמן המפגש#

לפני האיסוף, חישוב זמן וגודל מעריך את ההיסטוריה והקבצים שנבחרו על סמך ספירת ההודעות ומדגם מוגבל. התצוגה כוללת את הזמן שכבר הוקדש להתחברות, את זמן האיסוף המשוער ואת הזמן הנדרש לאריזה. עבור קבצים, האומדן הראשוני מבוסס על קצב של 1 MiB/s ומרווח זמן כפול; ההתקדמות מחליפה הנחה זו בקצב הנמדד. שימוש הודעות בלבד או בחר פחות צ'אטים כאשר האומדן עולה על הזמן שנותר.

זמן ההמתנה המדווח של Telegram עבור "Takeout" מתווסף לתקציב. האספן מפסיק את האיסוף כאשר הזמן שנותר נדרש לאריזה, שומר את הנתונים שנאספו ומסמן תוצאה חלקית. לפיכך, הפעלה בת 120 דקות מנצלת את חלון האיסוף שנותר לה במקום להמתין למועד האחרון לפני הכנת הארכיון. התצוגה מזהה בחירות שלא ניתן היה לדגום את גודלן המלא.

בחר במצב זה או בסביבת עבודה קבועה#

מצב צילום טווח הניתן להגדרה ההבדל
Telegram Takeout, ברירת המחדל כל הצ'אטים הזמינים בענן או צ'אטים נבחרים, תאריכים, קטגוריות חשבונות, מדיניות מדיה ותצוגות JSON/HTML משתמש במנגנון הייצוא הרשמי של טלגרם; ייתכן שיידרש אישור או זמן המתנה. Takeout יכול לפרט את הערוצים/הקבוצות שנותרו, במקומות שבהם טלגרם מאפשרת זאת, ולבקש נתונים אישיים נוספים.
ממשק ה-API הרגיל של Telegram אותו היקף חשבון ואותן אפשרויות פלט, בכפוף לשיטות הזמינות באמצעות ה-API הרגיל אינו מבצע אתחול של Takeout; לא ניתן למנות את הערוצים/הסופר-קבוצות השמאליים או לאחזר נתונים אישיים הזמינים ב-Takeout בלבד. אנשי הקשר כוללים את משתמשי טלגרם ולא את רשימת אנשי הקשר המלאה השמורה בטלפון. מגבלות הקצב עדיין חלות.
יומן אירועי הצ'אט צ'אט נבחר אחד, מדיניות קבצים מצורפים ואווטרים אופציונליים מתעד את ההיסטוריה והשינויים שנצפו במהלך הריצה הזו. קטגוריות חשבונות, מסנני תאריכים ותצוגות התואמות למחשב שולחני אינן חלות כאן.

לכל שלושת המצבים יש אותה אימות GitHub ואותה העברה מוצפנת. Takeout בוחר את שיטת הרכישה, והוא לעולם לא מוחלף באופן סמוי על ידי גישה רגילה ל-API. TgWitness מייצר את תצוגות ה-JSON/HTML מהרשומות שנלכדו ושומר על שיטת הרכישה שנבחרה בייצוא. ראו את ה-API הרשמי של Takeout.

כברירת מחדל נעשה שימוש ב-Takeout, כולל כל סוגי הצ'אטים הנגישים – לרבות צ'אטים בארכיון, כל התאריכים, פרופיל החשבון ואנשי הקשר, קבצי JSON ו-HTML תואמים, וכן הורדות קבצים. תקציב המדיה הראשוני הוא 4 GiB, עם מגבלות קבצים גלויות לפי סוג; עבור קבצים גדולים יותר או כאשר תקציב ההורדות מוצה, נעשה שימוש בהאשים של השרת, ככל שהדבר אפשרי. יש לעיין במגבלות אלה לפני האיסוף. לא ניתן לשחזר קובץ באמצעות האשים. תמונות אופציונליות, סיפורים, מטא-נתונים של הפעלות ונתונים אישיים נוספים נותרים כאפשרויות נפרדות.

תהליך ה-Takeout עשוי לדרוש אישור במסגרת הפעלה קיימת ב-Telegram. Telegram קובעת את משך ההשהיה; התחברות חדשה או רץ חדש אינם עוקפים אותה. חלון הזמן המרבי ללכידה הוא 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

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

האפשרות ייצוא → פותח עוזר לכידת נתונים בסביבת העבודה פותחת את האשף המלא בתוך החלונית. הדף העצמאי משתמש באותו אשף, באותם פקדים ובאותם עיצובים. בשני המקרים, המפתחות והפענוח נשמרים בדפדפן שלך. תהליך העבודה של GitHub והחלונית הזמנית של Telegram נפתחים בלשוניות נפרדות; האשף ינחה אותך מתי לחזור. נעילת סביבת העבודה מוחקת את המפתח שבזיכרון האשף. קובץ המפתח השמור שלך נשאר במכשיר שלך.

מהו מידע ציבורי, ומה חייב להישאר פרטי#

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

פעולת ה-fork מעתיקה את קוד הפרויקט למאגר שלך. היא אינה מייצאת את חשבון הטלגרם שלך. נתוני הקלט של זרימת העבודה של הנמען הם מפתח הצפנה ציבורי. שמור sealed-key.json, פרטי הזדהות של Telegram, קודי כניסה, סיסמאות 2FA וכתובת ה-URL המופענחת של החיבור מחוץ לקומיטים, קלט זרימת העבודה ויומנים ציבוריים.

תהליך העבודה מפרסם ארטפקטים של חיבורים ותוצאות מוצפנים למשך יום אחד. יש להוריד את שניהם בזמן; חלים תנאי הזמינות של GitHub Actions, מגבלות החשבון והחיוב. פורק ציבורי אינו מהווה הבטחה למשאבי מחשוב חינמיים ללא הגבלה. לא מוזנים לתוך התוסף תשלום או אסימון גישה ל-GitHub.

מפתח הפענוח הפרטי נשאר בדפדפן/בקובץ שלך. תוכן ההפעלה ב-Telegram והתצפיות בטקסט גלוי נמצאים בהכרח בתוך המאגר הזמני. GitHub ומנהרת ה-HTTPS נותרים תשתית מהימנה. האישור עשוי לחשוף את סיכום הארכיון ואת זהות זרימת העבודה לציבור; תוכן הארכיון אינו נכלל באישור. חותמת הזמן של האישור אינה חותמת הזמן של ההודעה.

פתרון בעיות#

תסמין השלב הבא
כפתור "ללא זרימת עבודה" פתחו פורק משלכם, הפכו את 'פעולות' לזמין, וסנכרנו אותו עם המקור main. אל תערוך את ה-pins המאושרים ב-upstream כדי לעקוף תקלה.
לא sealed-connection חפץ בדוק אם המשימה החלה והשלימה את שלב ההפעלה/ההעלאה. תקלות בתור, ברץ, בהורדת התמונה, במנהרה או במדיניות המאגר עלולות למנוע את ההפעלה.
לא ניתן לפתוח את החיבור טען את המפתח שנשמר עבור הריצה הזו, פתח את קובץ ה-artifact שהורדת ובחר connection.tgwsealed. הרץ חייב להישאר פעיל.
ההיסטוריה הושעתה בדקו את מצב הפאנל והשתמשו באפשרות "המשך" כל עוד ההפעלה פעילה, או סיימו עם הנתונים שכבר נאספו. מגבלות טלגרם ותכנים שאינם נגישים עלולים להותיר פערים.
לא sealed-result ביטול או פקיעת תוקף לפני תחילת האיסוף אינם יוצרים ארכיון; התהליך מסתיים אז בהודעה אין ארכיון. שלב איסוף, אישור או אריזה שנכשל מונע גם הוא את המסירה; השלב שנכשל מציין את הסיבה שציין המפקח, ללא נתונים אישיים. ניתן לבדוק זאת ללא הזנת פרטי הזדהות.
הדפדפן אינו מצליח לפענח ארכיון גדול השתמש בממשק ה-CLI של הזרמה המופיע להלן עבור חבילות שגודלן עולה על 256 MiB. מפתח פרטי שגוי או שאבד לא יוכל לפענח את התוצאה.
תהליך האימות דוחה את החותם השתמש בהתקנה עדכנית ואמינה של TgWitness וב-caller המדויק OWNER/REPOSITORY. אל תקבלו מדיניות חלופית המצורפת לארכיון.
Telegram עדיין מציג את ההפעלה הזמנית סיים את התהליך תחת 'הגדרות' → 'מכשירים'. ייתכן שההתנתקות תיכשל, ויתכן שתהליך עבודה שהופסק בכוח לא יבצע ניקוי.

לפני שתסתמכו על תצוגה מקדימה זו, נסו לבצע שיחה קצרה שתוכלו לשלוט בה: צרו הודעה וקובץ מצורף, אספו אותם, פענחו את התוצאה, הפעילו את תוכנת האימות, בדקו את תוצאות הכיסוי/המדיה ואשרו את ביטול הפעלת טלגרם. הבדיקות האוטומטיות משתמשות בלקוח טלגרם סינתטי ובבדיקת תעודת 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. בדיקות בחירה צפויה והיקף מלא פועלות גם עם משלוח רב-חלקים.

Python 3.11 ומעלה, התלות של הפרויקט, ו-GitHub CLI בגרסה עדכנית התומכת --signer-digest ו --deny-self-hosted-runners . כמו כן, קיים מחולל מפתחות 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.

כיצד נשמר ה-fork מחוץ לתהליך הלכידה#

ה-caller מכיל הפניה ברמת המשימה לזרימת העבודה הניתנת לשימוש חוזר במעלה הזרם, ב-SHA של התחייבות מלאה. זרימת העבודה הזו מבצעת צ'ק-אאוט מפורש של המאגר במעלה הזרם ב-SHA קבוע של האספן. ברירת מחדל actions/checkout בתהליך עבודה הניתן לשימוש חוזר יבצע צ'ק-אאוט של המתקשר, והוא אינו בשימוש בכוונה.

תהליך העבודה אינו משחזר מטמוני המתקשר, אינו צורך ארטפקטים של המתקשר, אינו מבצע קבצי המתקשר, ואינו מקבל כתובות URL של מקור/תמונה, פקודות שורת פקודה, קבצי ZIP מוכנים, או חתימות hash לחתימה. הוא מקבל נמען ציבורי מוגדר ומשך הפעלה מוגבל. פעולות, תמונת הבסיס של Python ו-cloudflared מוצמדים באמצעות תקצירים בלתי ניתנים לשינוי; תלותי Python משתמשים בדרישות הקיימות הנעולות באמצעות חשיש. התמונה נבנית מהמקור המהימן ללא מטמון.

האספן פועל כמשתמש שאינו root עם תמונת מערכת לקריאה בלבד, יכולות לינוקס מוגבלות, הגבלות על משאבים, וללא שקע Docker או סביבת אסימון GitHub. ההתקנות היחידות שלו הן ספריות תצורה, סביבת עבודה ופלט חדשות. יישום ה-FastAPI המוגבל חושף כניסה, דיאלוגים, איסוף חשבונות או צ'אטים הניתנים להגדרה, סטטוס, המשך, סיום וביטול. אין מסלול הורדה בטקסט רגיל, מסלול ניהול כללי, מסלול ייבוא או נקודת קצה לחתימה.

המפקח עוצר את הקונטיינרים הפונים לרשת לפני שפעולת האישור קוראת את הגרסה הסופית המתוקנת evidence.zip או evidence.parts.json. למכולת האריזה אין חיבור לרשת. שמות שלבי ההעלאה הם רק connection.tgwsealed ו delivery*.tgwsealed; לא מועלים כמאפיינים לא ראיות בטקסט רגיל ולא פרטי הזדהות של Telegram. תהליך הניקוי מסיר את הספריות והמכולות הפרטיות, ו-GitHub משמיד את מכונת הווירטואלית המארחת לאחר סיום המשימה. משך שמירת המאפיינים הוא יום אחד; יש להורידם לפני תום התוקף.

בעל הפורק יכול להחליף את המתקשר או ליצור קובץ חתום אחר. המאמת הקפדני חייב לדחות את זרימת העבודה/תמצית החתימה השונה שהתקבלה. מבנה זה עדיין תלוי בהיעדר באגים הניתנים לניצול בקוד המאושר ובשלמות תשתית הריצה והחתימה של GitHub.

העברת שליטה קריפטוגרפית#

כל מפתח נמען הוא RSA-3072 (ניתן גם לייבא מפתחות RSA-4096), עם אקספוננט 65537. לכל מעטפה יש מפתח AES-256 אקראי חדש ו-nonce בן 96 סיביות. RSA-OAEP עם SHA-256/MGF1-SHA256 עוטף את מפתח ה-AES. AES-GCM עם תג של 128 סיביות מאמת את הקידומת והנתונים המלאים. המפתח הציבורי של הנמען הוא בפורמט DER SPKI ב-base64; קובץ המפתח הפרטי מכיל DER PKCS8 ב-base64.

בתים של המעטפת הם TGWSEAL1\n, אורך כותרת JSON מסוג uint32 בפורמט big-endian, הכותרת, הטקסט המוצפן ותג GCM בן 16 בתים. הכותרת מכילה בדיוק algorithm, key, ו nonce; האלגוריתם הוא RSA-OAEP-256+A256GCM. הקידומת המלאה דרך הכותרת היא נתונים מאומתים נוספים של GCM. גודל הכותרת מוגבל ל-8192 בתים. ה-CLI מעביר נתונים עד 8 GiB ומאמת לפני שהוא מתקין את הפלט המבוקש; הוא מסרב להחליף יעד קיים. זהו מעטפת ספציפית לפרויקט סביב פרימיטיבים קריפטוגרפיים סטנדרטיים: RSA-OAEP עם SHA-256 ו-AES-256-GCM, הזמינים ב-OpenSSL ובכל ספריית קריפטוגרפיה מרכזית.

בתים הראייתיים המקוריים מאומתים לפני הכנסת הראיות והאימות לתוך החבילה החיצונית המוצפנת. כך נמנעת תלות מעגלית בין ה-hash של הארכיון לבין תעודה הכלולה באותו ארכיון. במאגרים ציבוריים, מטא-נתוני האימות (מאגר, זרימת עבודה, commit, שם הארטפקט וה-digest) הם ציבוריים. אין להכניס שמות צ'אט למטא-נתונים ציבוריים.

היקף ואימות#

מצב זה משתמש ביומן החתום ובמנוע ייצוא החשבון. צ'אטים סודיים, היסטוריית צ'אטים שנמחקו לפני האיסוף ונתונים שאינם נגישים לחשבון אינם נכללים. צ'אטים בענן פרטי נכללים כאשר הם נבחרים. בורר הצ'אטים מוגבל ל-20,000 דיאלוגים; ייצוא החשבון מגלה את המלאי שלו בעצמו. נתונים חסרים, קבצים שנכשלו ומשימות שלא הושלמו נרשמים. מגבלות הקבצים המצורפים ומגבלות הדיסק/הזמן של התוכנית עדיין חלות. משלוח גדול משתמש בחלקים מוצפנים במקום מגבלת משלוח קבועה של 4 GiB. השלמה פירושה שהמשימות הנבחרות שהוקפאו הסתיימו, ולא שכל רשומת Telegram היסטורית קיימת בארכיון. יומן הצ'אט יכול גם לעקוב אחר עדכונים בזמן אמת; אף אחד מהמצבים אינו תמונת מצב אטומית. צילומי מסך והקלטות מסך שנוצרו אינם חלק ממצב זה.

הבדיקות כוללות כניסה סינתטית חדשה, בידוד היקף, מדיה, ביטול, השלמת מועד חלקית, יציאה כושלת, נתיבי API ושדות אסורים, דחיית סביבת עבודה טעונה מראש, דחייה עקב מפתח שגוי או חבלה, דגלי מאמת נדרשים, ותאימות הצפנה בין הדפדפן ל-Python. בדיקת הקבלה של הדפדפן משתמשת באישור מדומה המסומן בבירור; זו אינה בדיקת Sigstore אמיתית. יש לדווח בנפרד על בדיקות אמיתיות של Hosted-Runner, Docker, אישור GitHub וקבלת Telegram בזמן אמת, בהפרדה מבדיקות סינתטיות מקומיות.

תנאי השימוש ב-GitHub Actions מגבילים את השימוש ברצים המארחים (runners) למחזור החיים של פרויקט התוכנה. יצירת פורק אינה מבטלת מגבלות אלה; אין לשווק גרסת תצוגה מקדימה זו כשרות אירוח ייצור חינמי ללא הגבלות. גם שירותי Cloudflare Quick Tunnels מיועדים למטרות בדיקה ופיתוח. הפונקציות helper/workflows מתאימות להערכת תכונה זו; זכאות לשירות ייצור נותרת דרישת פריסה נפרדת. deployment requirement.

סדר שחרור הגרסאות על ידי האחראי#

  1. יש לבצע commit ולבדוק את האספן, המפקח, הגדרת המכל והבדיקות.
  2. הוסף את ה-commit של האספן ל- sealed-collector.yml, ולאחר מכן בצע commit/סקירה של זרימת העבודה הניתנת לשימוש חוזר. לעולם אל תפיק את ה-checkout באופן סמוי מה-SHA של הקורא.
  3. הצמד את ה-commit של זרימת העבודה הניתנת לשימוש חוזר ב- sealed-witness.yml והוסף את צמד ה-SHA של workflow/collector sealed_policy.json במהדורה מהימנה.
  4. פרסם את כל הקומיטים המוזכרים ואת הקובץ העזר, ולאחר מכן בדוק פורק עצמאי ואת תעודת ה-GitHub האמיתית. אל תמזג את הקומיטים המוזכרים על ידי ה-pins הללו, אלא אם כן ההפניות נוצרו מחדש ופורסמו שוב.

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