TgWitness / תיעוד

מה נבדק ←

הפניה / הגדרה

Telegram · גישה והרשאות

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

TgWitness / תיעוד · התחלת עבודה

התחלת עבודה

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

הגדרת חשבון · נתיבי חיבור · מודל אבטחה

שני תחומי פעילות, שתי משימות שונות#

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

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

הענק גישה למישהו#

  1. היכנסו כמנהל הראשי ופתחו 'כלים נוספים' → 'גישה'.
  2. תחת "הענק גישה למישהו", הזן שם שתוכל לזהות ביומן.
  3. בחרו את סביבות העבודה, ובמידת הצורך, את הצ'אטים הבודדים.
  4. בחר מה האדם הזה עשוי לעשות. האפשרות "הצג" כלולה תמיד.
  5. הגדר את תוקף ההרשאה, מגבלות הכניסה/הפעילות והכתובות המותרות לפי הצורך.
  6. לחץ על "צור גישה". העתק את האסימון כעת: הוא מוצג רק פעם אחת.
  7. שלחו את כתובת הפאנל ואת האסימון באופן פרטי. הנמען מזין את האסימון הזה בדף הכניסה הרגיל; הוא אינו זקוק לאסימון הפאנל הראשי שלכם או למפגש טלגרם.

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

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

בחר את ההרשאות#

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

הרשאה מה הוא מאפשר
view קראו צ'אטים מורשים, הודעות שנלכדו, פרופילים, קבצים ורשומות יומן מסוננות. כל אלה כלולים תמיד.
export ניתן לייצא היסטוריית צ'אט ותיקים. ייצוא ראיות מכל סביבת העבודה מחייב גישה לכל סביבת העבודה.
sources ניהול מקורות, צילומי מסך ולכידת פרופילים. גישה מוגבלת לצ'אטים יכולה לפעול רק בצ'אטים המותרים; גילוי מקורות והגדרות היקף ברמת החשבון נשארים סגורים.
collect הפעל או הפסק את פעולת האספן. נדרשת גישה לכל סביבת העבודה, מכיוון שהאיסוף משפיע על החשבון.
interact בצע אינטראקציות נתמכות ב-Telegram במסגרת היקף הגישה. גישה מוגבלת לצ'אט אינה מאפשרת שימוש בתצוגה מקדימה של קישורים ברמת החשבון.
settings שינוי הגדרות האיסוף, חותמות זמן, התראות, עותקים מחוץ לאתר ופרמטרים. דורש גישה לכל סביבת העבודה.
account התחבר או התנתק מ-Telegram ונהל את נתיבי החיבור. דורש גישה לכל סביבת העבודה.
board.read קרא את ההערות בלוח המקרים רק בתוך סביבת העבודה והצ'אטים המותרים.
board.write הוספת סימניות, הדגשות, קטעים, הערות ומצבי פתיחה/סקירה. נדרש גם `board.read`.
board.manage נהל אוספים, סטטוסים סופיים של הצוות וכרטיסי משתתפים אחרים. נדרשת גם גישה לקריאה/כתיבה ללוח.

רק המנהל הראשי יכול להוריד את מפתח השחזור של העותק החיצוני. גישה שהוענקה באמצעות settings או account אינה מעניקה גישה למפתח זה.

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

שלוש הגדרות שימושיות#

אדם היקף הרשאות
מבקר צ'אטים מוקלטים ממקרה אחד view
אנליסט המכין מסמך העברה הצ'אטים שיש לחקור ולייצא view, export; הוסף את interact רק אם עליהם לפעול דרך טלגרם
מפעיל איסוף סביבות עבודה שלמות נבחרות view, sources, collect; הוסיפו settings או account רק במידת הצורך

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

מגבלות ומפגשים#

הגדרה איך זה עובד
מושבים מקבילים הגבל את מספר הפעילויות המקבילות ל-1–100. כאשר מגיעים למגבלה, דחה את הכניסה הבאה או סיים את הפעילות הוותיקה ביותר.
כניסה מותרת הגבל את מספר השימושים המוצלחים באסימון לפתיחת הפעלות. הפעלות קיימות אינן מסתיימות רק משום שנעשה שימוש בכניסה המותרת האחרונה.
תקף עד תוקף הגישה פג לחלוטין. גישה שפג תוקפה אינה יכולה להתחבר או להמשיך לבצע בקשות.
דקות ללא פעילות זמן ההשהיה של חוסר פעילות בפגישה, מ-5 דקות עד 30 ימים. בקשות מוצלחות מאריכות אותו; חלון פתוח עשוי לשמור על פעילותו באמצעות סקירה.
כתובות מותרות קבל כתובות IP ספציפיות או תת-רשתות CIDR. השאר ריק כדי לאפשר כל כתובת, אלא אם כן מופעלת קישוריות לכניסה ראשונה.
התקשר לכניסה הראשונה הכניסה המוצלחת הראשונה קובעת את הכתובת המותרת עבור גישה זו.

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

שינוי או ביטול הגישה#

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

עותקי ייצוא שנשמרו שומרים על היוצר, סביבת העבודה, היקף הצ'אט וההרשאות הנדרשות. גישה שהונפקה יכולה להציג או להוריד את העותקים שלה רק כל עוד ההרשאות הללו עדיין בתוקף; עותקים המכילים את Case Board דורשים גם board.read. המנהל יכול לאחזר את כל העותקים. עותקים ישנים יותר ללא מטא-נתונים אלה וחבילות קבוצתיות מיועדים למנהל בלבד. כרטיסי הורדה ותגובות קבצים מוכנות בודקות מחדש את הגישה לאחר הכנת הקובץ, לפני שליחת הבייטים שלו. כל גישה, כולל המנהל, יכולה להחזיק עשרה כרטיסי הורדה ממתינים לכל סביבת עבודה; המגבלה לכל סביבת העבודה היא 1,000. כרטיסים פוקעים לאחר 120 שניות והם חד-פעמיים.

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

מה המנהל יכול לראות#

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

מחרוזות User-Agent המלאות בדפדפן אינן נשמרות במפגשי הגישה. שדרוג מסיר אותן גם ממטמון המפגשים הניתן לשינוי. יומן תהליכי הפאנל מסתיר כתובות IP, פרטי הזדהות URL וסודות מתויגים. יומני שירות מקומיים ו רשומות יומן שנחתמו בעבר אינם נכתבים מחדש. כללי הגישה ורשומות הכניסה החתומות עדיין משתמשות בכתובת הלקוח.

החלף את המפתח הראשי#

השתמשו ב"כלים נוספים" → "גישה" → "המגבלות שלי" → "הנפקת מפתח מנהל מחדש", או הפעל את הפקודה tgwitness token rotate מהתקנה מנוהלת בזמן שהלוח פועל. כל הפעלות הדפדפן הקיימות מסתיימות, כולל הפעלות שנפתחו באמצעות אסימוני עמיתים. הדפדפן המבקש מקבל הפעלה חדשה; שמרו את מפתח המנהל החדש לפני שתסתירו אותו. אסימוני עמיתים שהונפקו נשארים בתוקף עד לביטולם בנפרד. התקנה המשתמשת ב-TGWITNESS_TOKEN חייבת לשנות את הגדרת הסביבה הזו ולהפעיל מחדש.

גבולות בקשות ופרוקסי#

ה-API מאפשר עד 600 בקשות בדקה לכל לקוח ומשפחת אישורים: לוח בקרה, ארכיון/MCP או עד. תקופות ההמתנה לאימות נפרדות עבור משפחות אלה. עשר אימותים שנדחו בתוך דקה מפעילים תקופת המתנה אקספוננציאלית, החל משנייה אחת ועד חמש דקות. ניסיון כושל לאחר תקופת ההמתנה מאריך אותה; עשר דקות ללא ניסיון כושל מאפסות את ההסלמה. דחיות מחזירות HTTP 429 ו- Retry-After . המגבלות נמצאות בזיכרון, משותפות בין סביבות עבודה בתהליך לוח אחד; הפעלה מחדש מוחקת אותן. זרמים חיים מוגבלים לארבעה לכל אסימון נושא ו-32 לתהליך הלוח. פתיחת זרם גם צורכת מתקציב בקשות ה-API.

לגופי הבקשות יש מועד אחרון לקבלה של 60 שניות, המקוצר ל-10 שניות עבור כניסה, גישה לדמו, API לארכיון ונתיבי head של עד, או 8 שניות עבור העברת MCP. כל יישום מאפשר ארבעה גופים לא גמורים לכל כתובת לקוח, עם מגבלות כוללות של 32 ו-64 MiB של הקצאות נתיב שמורות. בקשות ללא גופים אינן צורכות את המשבצות הללו. גופים גדולים מדי מחזירים 413, גופים שפקע הזמן שלהם מחזירים 408, וחריגה מקיבולת הלקוח מחזירה 429 עם Retry-After: 1. מיצוי הקיבולת הכוללת של הגופים מחזיר 503 עם Retry-After.

כותרות IP מועברות מתעלמות, אלא אם כן העמית ה-TCP בפועל שייך ל- TGWITNESS_TRUSTED_PROXIES (כתובות IP מופרדות בפסיקים או CIDRs). הגדר TGWITNESS_PROXY_HEADER ל-x-forwarded-for או cf-connecting-ip. XFF עובר מהפרוקסי הקרוב ביותר לעבר העמית הלא-מהימן הראשון. מטא-נתונים של כתובות מהימנות שאינם תקינים או כפולים נדחים, ולכן אינם יכולים לרשת כתובת פרוקסי המופיעה ברשימת ההיתרים. המנהרה המהירה המנוהלת סומכת על המחבר המקומי של Cloudflare; ההגדרה של הדומיין הפרטי סומכת על Caddy המקומי. פריסות ישירות אינן סומכות על אף פרוקסי כברירת מחדל. אם אתה מפעיל את Uvicorn בעצמך, השבת את עיבוד כותרות הפרוקסי שלו, כך שגבולות אלה יקבלו את העמית בפועל.

TGWITNESS_PANEL_ALLOWED_IPS מגביל את כל הגישה ללוח הבקרה, כולל זו של המנהל, לכתובות IP או CIDR המפורטות ברשימה. בדיקת זהות הניתוב של תוכנית ההתקנה נשארת ציבורית ואינה מחזירה נתוני חשבון. יש לכלול את נתיב הניהול המקומי הנדרש לפני הפעלת רשימת ההיתרים. המדריך START-HERE להתקנה מנוהלת כולל את הוראות תצורת השירות והשחזור.

בוחר שאילתות API מסוג ws חייב לזהות את סביבת העבודה בנתיב הבקשה; בוחרים לא ידועים, שאינם תואמים או כפולים נדחים עם שגיאה 404.

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

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

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

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

מנהל ראשי וגבולות האמון

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

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