TgWitness / תיעוד

מה נבדק ←

הפניה / אבטחה ופרויקט

Telegram · אבטחה וטיפול בנתונים

מודל איומים, מודל גישה, מידע סודי במאגר, חשיפה ברשת, ייבוא הפעלות וכיצד לדווח על פגיעות אבטחה.

TgWitness / תיעוד · פריסה ושחזור

פריסה ושחזור

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

תחום בקיצור
גישה מפתח מנהל בתוספת גישה מוגבלת לחשבונות/צ'אטים, שבע רמות הרשאה ומפגשים הניתנים לביטול; localhost כברירת מחדל
סודות במנוחה ההגדרות של ההפעלה, זוג ה-API, מפתח החתימה והגדרות ה-proxy מוצפנות באמצעות Fernet
הודעות ומדיה קובצים בסביבת העבודה, המוגנים באמצעות הצפנת דיסק או אמצעי אחסון והרשאות קבצים של המארח
יושרה שרשרת חשיש SHA-256 וחתימת Ed25519 על כל רשומה
זמן חיצוני קבלות RFC 3161 ו-OpenTimestamps, פרסומי עדים המתוארכים על ידי טלגרם ואישור GitHub; נקודות ביקורת שנשמרו, רשומות עדים ומדידות Intel TDX מהווים בדיקות תומכות. המאמת מדווח אילו תנאי ראיות הם עומדים בהם

לדיווחים על פגיעויות, ראו את מדיניות האבטחה.

בעמוד זה

מודל גישה#

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

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

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

אימות כושל מוגבל לפי קצב לפי כתובת הלקוח. הגבלות ה-IP משתמשות בכתובת שנראית על ידי היישום; יש לבדוק את התנהגות ה-reverse-proxy לפני שמסתמכים עליה. אמצעי הזיהוי של Witness נשארים נפרדים, כנקודת ביקורת לקריאה בלבד או כאמצעי זיהוי לבדיקת תקינות.

גישה לדמו#

/api/demo-access הוא בוטסטראפ שלא אומת בכוונה, המיועד להדגמה סינתטית מבודדת שהופעלה במפורש. הוא מנפיק יכולת נפרדת לתקופת חיי התהליך, לעולם לא את אסימון הפאנל האמיתי או עקיפת TGWITNESS_TOKEN. ההנפקה והשימוש דורשים עמית לולאה אחורית (loopback) ומארח, ללא כותרות מועברות וללא בקשות בין-מקורות. סביבות עבודה נוספות או הפעלה מורשית מבטלות נתיב זה. סביבות עבודה פעילות לעולם אינן מנפיקות את היכולת. ההדגמה אינה יכולה לחבר חשבונות או לשנות הגדרות איסוף.

תוכן הלוח וייצוא נתונים#

הפאנל אינו משתמש בגופנים חיצוניים, בניתוח נתונים, במשאבי CDN או במדיה מרוחקת משובצת. טקסט שמקורו ב-Telegram מוחדר כטקסט, ולא כ-HTML. קבצים מצורפים שהורדו מוצגים כקבצים בינאריים. ייצוא בפורמט JSONL משמר את המחרוזות המקוריות; HTML מבצע החלפה של תווים; לתאי CSV שעלולים להפוך לנוסחאות מתווסף קידומת של גרש.

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

סודות במנוחה#

אמצעי הזיהוי של ממשק ה-API של Telegram, מפתח ההפעלה ומפתח החתימה מוצפנים באמצעות Fernet. עבור הודעות ומדיה מקומיות, ההצפנה מתבצעת על ידי הדיסק או אמצעי האחסון של המארח; סביבת העבודה מאחסנת קבצים רגילים. ייצוא יכול להשתמש בקובץ ZIP מסוג AES-256 המוגן בסיסמה, ועותקים מחוץ לאתר משתמשים ב-AES-256-GCM.

מפתח הכספת מוגדר כברירת מחדל לספריית הנתונים המוגנת. השתמש בקובץ מפתח ראשי חיצוני להלן כדי לאחסן אותו בנפרד. במערכת Unix, קבצי מפתח פרטי חדשים משתמשים במצב 0600 וספריות נתונים חדשות משתמשות במצב 0700; ב-Windows, הגדר את רשימת הגישה (ACL) של הספרייה עבור חשבון השירות ו המנהלים המורשים. הרשאות הספרייה הקיימות נשמרות.

מפתח ראשי חיצוני#

עבור ספריית נתונים חדשה, TGWITNESS_VAULT_KEY_FILE יכול לספק מפתח ראשי אקראי חיצוני. HKDF-SHA256 ומלח אקראי נפרד מפיקים מפתח Fernet שונה עבור כל סביבת עבודה. יש לשמור את הקובץ vault.external.json לצורך שחזור. מפתחות ראשיים חסרים או שגויים יגרמו לכישלון. כספות מקומיות קיימות אינן מועברות באופן אוטומטי. הלוח מציג את מצב אחסון המפתחות הנבחר. הצפנת דיסק מגנה על קובצי ההודעות והמדיה המקומיים בשני המצבים; ראו חיבור והגנת נתונים לפרטי ההגדרה.

פרוקסי ונתיבי רשת#

תצורת ה-Proxy מוצפנת בכספת. סיסמאות וסודות MTProxy אינם מוחזרים על ידי ה-API ואינם נכתבים ברשומות הראיות. כל סביבת עבודה בוחרת את נתיב ה-Telegram שלה ואת מצב ה-IP.

הסתרת הכתובת מונעת שימוש ישיר ב-Telegram כגיבוי ודורשת פרוקסי עבור בקשות HTTP חיצוניות. מצב הגיבוי שנבחר במפורש מאפשר גישה ישירה ל-Telegram לאחר עיכוב; מצב מנהרה/VPN מאפשר נתיבים ישירים. בחירת מצב המנהרה אינה מתקינה או מאמתת VPN. הגדרות אלה אינן שולטות בכל התעבורה של המחשב, בדפדפנים, במנהלי החבילות או בפתרון ה-DNS של מארח הפרוקסי המקומי.

MTProxy מעביר רק תעבורת טלגרם. בקשות חיצוניות יכולות להשתמש ב- פרוקסי SOCKS5/HTTP נפרד, בנתיב SOCKS5/HTTP של סביבת העבודה, או בנתיב ישיר מותר; ניתן גם להשבית אותן. ל-Witness העצמאי יש הגדרות העברה משלו. אימות SOCKS5/HTTP CONNECT רגיל אינו מוצפן על ידי פרוטוקולי הפרוקסי עצמם. סודות TLS מזויפים של MTProxy אינם נתמכים.

כניסה וייבוא נתוני הפעלה#

קבצי .tgwitness-session שהומרו מכילים סוד אימות בטקסט רגיל עד לטעונם ואחסונם בכספת. ממשק ה-CLI המקוון מקבל סכמות Telethon שנבדקו. ייבוא הפאנל מקבל בנוסף Pyrogram SQLite, ZIP של TData מודרני לחשבון יחיד, וקבצי JSON מתועדים. הוא מאומת, מוגבל לארבעה קבצים / 8 MiB, ומעבד העלאות בזיכרון ללא חילוץ ארכיונים או שמירת קבצים מקוריים. אישורי הכניסה המנורמלים מוחזרים רק לדפדפן המאושר המבקש; הם נשמרים בכספת המוצפנת לאחר אימות מוצלח ב-Telegram. יש להגן על הקבצים המקוריים והקבצים שהומרו, ולמנוע מלקוחות מקבילים לשכפל אישור.

עיבוד TData מאמת סכומי ביקורת של מכולות, חשישים של פענוח מקומי ואורכי מבנה. קוד גישה מקומי של Desktop שסופק משמש באופן זמני ואינו נשמר. המנתח המוגבל תומך בפורמטים של Desktop שהוא מאמת ודוחה אחרים. תמונות QR נוצרות באופן מקומי, מכילות אסימוני כניסה לטלגרם קצרי מועד, ו לעולם אינן נשלחות לשירות עיבוד חיצוני. נעילה, מעבר בין סביבות עבודה, כניסה חדשה, ושינויי מסלול מבטלים ניסיונות QR הממתינים לאישור. טעינה מחדש/סגירת כרטיסייה עשויה להשאיר ניסיון תלוי עד לפקיעת תוקפו. כניסה מוצלחת באמצעות QR עדיין מחייבת קישור חשבון. גופי API רגילים נשארים מוגבלים ל-16 KiB; מסלול הייבוא המאומת מקבל עד 12 MiB של JSON מקודד, תוך אכיפה נפרדת של המגבלה הקטנה יותר על קובץ מפוענח.

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

יומנים והעברה#

תגובת אימות ה-API המוגדרת כברירת מחדל מוחלפת כך שלא תחזור על ערכי האישורים. רישום הגישה ליישום מושבת. אין להגדיר פרוקסי הפוך כדי לרשום כותרות אישור או גופי בקשות. הפאנל מאזין ב-localhost; הגישה מרחוק עוברת דרך מנהרת ה-SSH המסופקת, Cloudflare Tunnel או Caddy HTTPS, כך שאסימונים וסודות כניסה מועברים בתוך SSH או TLS.

שלמות וזמן חיצוני#

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

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

RFC 3161 וקבלות OpenTimestamps, וכן פרסומי עדים שתאריכיהם נקראים על ידי המאמת מתוך Telegram, קושרים את קידומת היומן שהם מכסים לזמן שנקבע על ידי צד שלישי. סיבוב drand שנרשם ביומן מראה שהרשומות שאחריו נוצרו לא מוקדם יותר ממועד פרסום אותו סיבוב. אישור GitHub מאומת נושא גם הוא את הזמן המאומת של חתימתו, אשר קושר את הארכיון כולו לזמן חיצוני. נקודת ביקורת נחתמת באמצעות מפתח האספן וקושרת את הרשומות עד אליה מהרגע שהנמען קיבל אותה, דרך ערוץ אחר. עד מראה שמפתח שני שמר על ראש היומן; רשומת בקרת המפתחות של האפוטרופוס מראה מי מחזיק במפתח זה. שתיהן מהוות בדיקות תומכות; המינימום הנדרש הוא זמן של צד שלישי. תיעוד GitHub Actions או פריסת Intel TDX מוסיפים מקור זרימת העבודה או מדידות חומרה של סביבת האיסוף.

כל תשובה לאימות מפרטת את תנאי הראיות ואת אופן בדיקת כל אחד מהם, מקובצים לפי תפקידם במינימום:

תפקיד תנאי
נדרש שלמות; מפתח החותם מוצמד באמצעות --fingerprint; זמן חיצוני המכסה את הרשומה האחרונה (אישור RFC 3161 נבדק באמצעות --tsa-ca, אישור OpenTimestamps אושר באמצעות --check-bitcoin, פוסט העד נקרא מ-t.me באמצעות --channel, חותם ביטקוין של העד או אישור GitHub שנבדק)
תמיכה, אינה חלק מהמינימום עד עם מפתח משלו; נקודת ביקורת שנשמרה; ריצת איסוף מאומתת

המינימום הנדרש כראיה הוא עמידה בכל שלושת התנאים הנדרשים ביחס לרישום האחרון שיוצא; תהליך איסוף מאומת ומאושר מוסיף את attested הפרופיל. השורה האחרונה מציינת את התוצאה, והתשובה מפרטת את האפשרויות שיענו על התנאים החסרים. ללא --fingerprint השורה האחרונה מתחילה ב- EVIDENCE: minimum not met · missing: confirmed signer key. כאשר חותמות הזמן המאומתות מכסות רק רשומות מוקדמות יותר, התשובה מציינת את הרשומה שעד אליה מתקיים המינימום. --require evidence או --require attested יוצא עם קוד 2 כאשר לא הושג הפרופיל עבור כל הייצוא, ובדיקה שהתבקשה בשורת הפקודה ואינה ניתנת לביצוע מדווחת כלא בוצעה עם אותו קוד. כל דוח נושא את אותם תנאים עם מצבם באותה עותק ואת הפקודה שבודקת אותם. רמות האמינות --strict נשארים זמינים; פורמט הראיות מפרט את הבדיקות עבור כל מצב איסוף.

אם אתם חושדים בבעיה#

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