منبع / راهاندازی
Telegram · دسترسی و مجوزها
اعطای دسترسی محدود به حسابها و چتها، انتخاب مجوزها، محدود کردن جلسات و آدرسهای IP و لغو دسترسی.
TgWitness / مستندسازی · شروع کار
به یک بازبین دسترسی به یک چت، به یک تحلیلگر اجازه صدور یک پرونده، یا به یک اپراتور کنترل حسابهای منتخب بدهید. هر شخص توکن مخصوص به خود را دریافت میکند. توکن پنل اصلی نزد مدیر باقی میماند.
راهاندازی حساب · مسیرهای اتصال · مدل امنیتی
دو دامنه، دو وظیفه متفاوت#
دامنهٔ جمعآوری مشخص میکند که یک حساب چه چیزی را ضبط میکند: چتهای منتخب، یک پوشه تلگرام یا کل حساب. دامنهٔ دسترسی مشخص میکند که کدام یک از آن حسابها و چتهای ضبطشده را شخص دیگری میتواند ببیند و استفاده کند. اعطای دسترسی به معنای پیوستن به یک چت تلگرام، شروع جمعآوری یا اعطای مجوزهای حساب تلگرام نیست.
یک دسترسی میتواند فضاهای کاری، چتهای منتخب در آنها، تمام فضاهای کاری، یا هر حساب کاربری یک گروه حساب را باز کند. تمام فضاهای کاری، از جمله فضاهای کاری که بعداً اضافه میشوند، حسابهای آینده را نیز پوشش میدهند. یک دسترسی گروهی نیز حسابهای کاربری که بعداً به آن گروه اضافه میشوند را پوشش میدهد. هنگامی که یک پرونده باید محدود به فضاهای کاری معین باقی بماند، آنها را صراحتاً انتخاب کنید.
دسترسی به کسی بدهید#
- بهعنوان مدیر اصلی وارد شوید و ابزارهای بیشتر → دسترسی را باز کنید.
- در بخش «دسترسی به کسی بدهید»، نامی را وارد کنید که در لاگ برایتان قابل تشخیص باشد.
- فضاهای کاری را انتخاب کنید و در صورت نیاز، چتهای فردی را نیز انتخاب کنید.
- انتخاب کنید که این شخص ممکن است چه کاری انجام دهد. «مشاهده» همیشه گنجانده شده است.
- زمان انقضا، محدودیتهای ورود/جلسه و آدرسهای مجاز را طبق نیاز تنظیم کنید.
- روی «ایجاد دسترسی» کلیک کنید. توکن را همین حالا کپی کنید: فقط یکبار نمایش داده میشود.
- آدرس پنل و توکن را بهصورت خصوصی ارسال کنید. دریافتکننده آن توکن را در صفحه ورود عادی وارد میکند؛ او نیازی به توکن اصلی پنل شما یا یک جلسه تلگرام ندارد.
پنل را با توکن صادرشده در یک جلسهٔ مجزای مرورگر باز کنید و پیش از تحویل آن، چتهای قابلمشاهده و اقدامات مجاز را بررسی کنید.
نامهای دسترسی در ذخیرهسازی محلی رمزگذاریشده باقی میمانند و توسط پنل مدیر حل میشوند. نامها از سوابق جدید دسترسی و ایجاد فضای کاری در سوابق حسابرسی حذف میشوند؛ سوابق امضا شده موجود فیلدهای اصلی خود را حفظ میکنند.
انتخاب مجوزها#
برای یک نمایش عمومی متنی، به جای دسترسی بازبین معمولی از «نمایش عمومی» استفاده کنید. این حالت، کانالهای عمومی صریحاً انتخابشده، ویرایشها و حذفهای نگهداریشده، و آمار امضا شده را نشان میدهد، در حالی که فیلدهای نویسنده حذف شده و فایلها در مرز API بسته میشوند. یک نمایش را ایجاد و تأیید کنید.
| مجوز | چه امکاناتی فراهم میکند |
|---|---|
view |
گفتگوهای مجاز، پیامهای ضبطشده، پروفایلها، فایلها و سوابق مجلهٔ فیلترشده را بخوانید. همیشه گنجانده شده است. |
export |
صادرات تاریخچه چت و پروندهها مجاز است. صادرات شواهد کل فضای کاری نیازمند دسترسی به کل فضای کاری است. |
sources |
مدیریت منابع، اسنپشاتها و ضبط پروفایل. دسترسی محدود به چتها تنها میتواند روی چتهای مجاز عمل کند؛ کشف منابع در سطح حساب و تنظیمات دامنه بسته میمانند. |
collect |
راهاندازی یا توقف یک جمعآورنده. نیازمند دسترسی کامل به فضای کاری است زیرا جمعآوری بر حساب کاربری تأثیر میگذارد. |
interact |
تعاملات پشتیبانیشده تلگرام را در محدوده دسترسی انجام دهید. دسترسی محدود به چت نمیتواند از پیشنمایش لینک در سطح حساب استفاده کند. |
settings |
تنظیمات جمعآوری، برچسبهای زمانی، اعلانها، نسخههای خارج از محل و پارامترها را تغییر دهید. نیازمند دسترسی کامل به فضای کاری است. |
account |
وارد یا خارج شوید از تلگرام و مسیرهای اتصال را مدیریت کنید. نیازمند دسترسی کامل به فضای کاری است. |
board.read |
یادداشتهای تخته پرونده را تنها در محدوده فضای کاری و چتهای مجاز بخوانید. |
board.write |
افزودن نشانکها، برجستهسازیها، اسلایسها، نظرات و وضعیتهای باز/بازبینی. همچنین به board.read نیاز دارد. |
board.manage |
مدیریت مجموعهها، وضعیتهای نهایی تیم و کارتهای سایر شرکتکنندگان. همچنین نیاز به دسترسی خواندن/نوشتن تابلو دارد. |
تنها مدیر اصلی میتواند کلید بازیابی نسخه تکراری خارج از محل را دانلود کند.
دسترسی تفویضشده به settings یا account این کلید را اعطا نمیکند.
مجوزها و دامنه دسترسی با هم بررسی میشوند. تیک زدن یک مجوز، چتهای دیگر را باز نمیکند و برای یک دسترسی محدود به یک چت، عملیات در سطح کل فضای کاری را فعال نمیسازد. برای یک خروجیگیری موازی، دسترسی باید در هر حساب کاربری انتخابشده، چت صادرشده را پوشش دهد. یک دسترسی صادرشده نمیتواند دسترسیهای جدید ایجاد کند، جلسات افراد دیگر را مدیریت کند یا کنسول ادمین را باز کند.
سه پیکربندی مفید#
| شخص | دامنه | مجوزها |
|---|---|---|
| بازبین | گفتوگوهای ضبطشده یک پرونده | view |
| تحویلگیرنده در حال آمادهسازی گزارش تحویل | گفتوگوها برای بررسی و صدور | view، export؛ فقط در صورتی interact را اضافه کنید که قرار باشد از طریق تلگرام اقدام کنند |
| اپراتور جمعآوری | فضای کاریهای انتخابشدهٔ کامل | view، sources، collect؛ فقط در صورت نیاز settings یا account را اضافه کنید |
پیشتنظیمات اولیه فرم دسترسی همچنین شامل «تخته پرونده» است: بازبین میتواند بخواند، تحلیلگر میتواند بخواند و بنویسد، و اپراتور میتواند آن را مدیریت کند. پیشتنظیمات همچنان قابل ویرایش هستند و امتیازات موجود به طور خودکار گسترش نمییابند. برای دامنههای چت ارثبری شده و حریم خصوصی صادرات، به «تخته پرونده» مراجعه کنید.
محدودیتها و جلسات#
| تنظیمات | نحوه کار |
|---|---|
| جلسات موازی | جلسات همزمان را به ۱ تا ۱۰۰ محدود کنید. در صورت رسیدن به حد، ورود بعدی را رد کنید یا قدیمیترین جلسه را خاتمه دهید. |
| ورود مجاز است | استفادهٔ موفقیتآمیز از توکن را به شروع جلسات محدود کنید. جلسات موجود تنها به این دلیل که آخرین ورود مجاز استفاده شده است، پایان نمییابند. |
| اعتبار تا | انقضای مطلق برای دسترسی. دسترسی منقضیشده نمیتواند وارد شود یا به ارسال درخواستها ادامه دهد. |
| دقایق بدون فعالیت | زمان انقضای عدم فعالیت جلسه، از ۵ دقیقه تا ۳۰ روز. درخواستهای موفق آن را تمدید میکنند؛ یک پنل باز میتواند با ارسال درخواستهای دورهای خود را فعال نگه دارد. |
| آدرسهای مجاز | پذیرفتن آدرسهای IP خاص یا زیرشبکههای CIDR. خالی گذاشتن برای اجازه دسترسی به هر آدرس مگر اینکه پیوند اولین ورود فعال باشد. |
| به اولین ورود متصل شود | اولین ورود موفق، آدرس مجاز برای آن دسترسی را تعیین میکند. |
آدرس IP، آدرس کلاینت است که توسط برنامه مشاهده میشود. در پشت یک پروکسی معکوس یا تونل، پیش از اتکا به قوانین IP، آدرسی را که در بخش «جلسات باز» (Open sessions) نمایش داده میشود بررسی کنید: در غیر این صورت، ممکن است چندین کاربر به اشتراک گذاشتن آدرس پروکسی ظاهر شوند.
تغییر یا لغو دسترسی#
یک ورودی را در بخش «دسترسی اعطا شده» ویرایش کنید تا دامنه، مجوزها یا محدودیتهای آن را تغییر دهید. تغییرات دامنه و مجوز در درخواستهای بعدی بررسی میشوند، از جمله درخواستهای مربوط به جلسات (session) که از قبل باز هستند. لغو دسترسی، جلسات آن را پایان میدهد و توکن صادر شده را غیرقابل استفاده میکند. جلسات باز همچنین به مدیر اجازه میدهد یک جلسه فردی را بدون لغو کل دسترسی، پایان دهد.
نسخههای صادرشدهٔ خروجی، خالق، فضای کاری، دامنهٔ گفتگو و مجوزهای لازم خود را حفظ میکنند.
یک دسترسی صادرشده فقط زمانی میتواند نسخههای خود را فهرست یا دانلود کند که آن مجوزها همچنان معتبر باشند؛
نسخههایی که حاوی 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 ثانیهای هستند که برای ورود به سیستم، دسترسی نمایشی،
API آرشیو و مسیرهای شاهد-سرور به 10 ثانیه و برای انتقال MCP به 8 ثانیه کاهش مییابد. هر برنامه اجازه میدهد
چهار بدنهی ناتمام به ازای هر آدرس مشتری، با محدودیت کلی 32 و 64 مگابایت از تخصیصات مسیر رزروشده.
درخواستهایی که فاقد بدنهاند این اسلاتها را اشغال نمیکنند. بدنههای بزرگتر از حد مجاز کد 413 را برمیگردانند، بدنههای با زمانمنتقضیشده کد 408 را برمیگردانند، و ظرفیت مشتری که از حد عبور کرده باشد کد 429 را با Retry-After: 1 برمیگرداند.
در صورت اتمام ظرفیت کلی بدنه، کد 503 با Retry-After بازگردانده میشود.
سربرگهای IP فوروارد شده نادیده گرفته میشوند، مگر اینکه همتای واقعی TCP به
TGWITNESS_TRUSTED_PROXIES (آدرسهای IP جدا شده با ویرگول یا CIDRها) تعلق داشته باشد. TGWITNESS_PROXY_HEADER را روی x-forwarded-for یا cf-connecting-ip تنظیم کنید. XFF از نزدیکترین پروکسی به سمت اولین همتای غیرقابل اعتماد ردیابی میشود. متادیتای آدرس معتبر نامعتبر یا تکراری رد میشود، بنابراین نمیتواند یک آدرس پروکسی مجاز را به ارث ببرد. تونل سریع مدیریتشده به کانکتور محلی Cloudflared اعتماد میکند؛ راهاندازی دامنه-خود به Caddy محلی اعتماد میکند.
استقرارهای مستقیم به طور پیشفرض به هیچ پروکسی اعتماد نمیکنند. اگر خودتان Uvicorn را راهاندازی میکنید، پردازش هدر پروکسی آن را غیرفعال کنید تا این مرز، همتای واقعی را دریافت کند.
TGWITNESS_PANEL_ALLOWED_IPS دسترسی به تمامی پنلها، از جمله پنل ادمین، را به IPها یا CIDRهای فهرستشده محدود میکند. پروب هویت مسیریابی (routing-identity) نصبکننده عمومی باقی میماند و هیچ دادهای از حساب کاربری بازنمیگرداند. قبل از فعالسازی لیست مجاز (allowlist)، مسیر اداری محلی مورد نیاز را اضافه کنید. راهنمای START-HERE یک نصب مدیریتشده شامل پیکربندی سرویس و دستورالعملهای بازیابی است.
یک انتخابگر پرسوجوی API ws باید فضای کاری را در مسیر درخواست مشخص کند؛
انتخابگرهای ناشناخته، نامطابق و تکراری با کد خطای 404 رد میشوند.
اسکریپتها و استایلهای پنل دارای متادیتای یکپارچگی SHA-384 هستند. یک نقشهٔ وارداتی همچنین ماژولهای JS وارداتی محلی را در مرورگرهایی که از یکپارچگی import-map پشتیبانی میکنند، پوشش میدهد. پاسخ زبانی تولیدشده به صورت پویا، جداگانه است. این بررسیها، جایگزینی داراییها را نسبت به صفحهٔ تحویلدادهشده تشخیص میدهند؛ خود صفحه و هشهای آن از سرور پنل میآیند، بنابراین آن سرور و مسیر تحویل آن را محافظت کنید.
لاگ از زمان شروع، لاگهای فرآیند را با فعالیتهای دفترچه یادداشت از هر فضای کاری ترکیب میکند: ورودها، ردها، تغییرات مسیر و اقدامات اپراتور. این یک کنسول در حافظهی رم برای فرآیند جاری است، نه یک کپی دائمی از هر پیام. رویدادهای پیامهای مکرر به جای پر کردن کنسول، در دفترچه یادداشت باقی میمانند.
اعطا، تغییر و لغو دسترسی، و شروع یا پایان جلسات نیز، سوابق دفتر روزنامه امضا شده با access.* ایجاد میکنند. توکنها در این سوابق گنجانده نمیشوند. توکنهای صادر شده و اعتبارنامههای جلسه به صورت هش در گاوصندوق رمزگذاری شده نگهداری میشوند.
ورود QR در حال انتظار متعلق به جلسه پنلی است که آن را آغاز کرده است. پایان دادن به آن جلسه یا لغو آن، یا چرخاندن توکن اصلی پنل، مشتری QR در حال انتظار را در سرور لغو میکند. این امر زمانی نیز صدق میکند که مرورگر نتواند درخواست لغو خود را ارسال کند. چرخش توکن همچنین ورودهای QR را که مستقیماً با توکن اصلی پنل آغاز شدهاند، لغو میکند. یک درخواست QR که در انتظار یک عملیات دیگر است، قبل از شروع، دسترسی را مجدداً بررسی میکند. مجوزهای تلگرام تکمیلشده و ورودهای در حال انتظار که توسط یک جلسه پنل دیگر آغاز شدهاند، حفظ میشوند.
مدیر اصلی و مرز اعتماد
توکن پنل اصلی بدون محدودیت باقی میماند. ورود با آن به مرورگر، جلسات را ایجاد میکند که تابع محدودیتهای جلسهای است که مدیر پیکربندی کرده است. اسکریپتهایی که توکن اصلی را مستقیماً ارسال میکنند، دسترسی کامل خود را حفظ میکنند و به عنوان جلسات مرورگر شمرده نمیشوند.
این کنترل دسترسی در سطح برنامه در یک نصب واحد است. تمام فضاهای کاری فرآیند سرور را به اشتراک میگذارند؛ این جداسازی از مدیر میزبان نیست. توکن اصلی، جلسات تلگرام، کلیدهای امضا و دایرکتوری داده را خصوصی نگه دارید. توکن شاهد یک نقطه کنترل/اعتبار سلامت جداگانه است، نه توکن دسترسی به پنل.