مرجع / الإعداد
Telegram · الوصول والأذونات
يمكنك تحديد نطاق الوصول إلى الحسابات والمحادثات، واختيار الأذونات، وتقييد الجلسات وعناوين IP، وسحب حق الوصول.
امنح المراجع حق الوصول إلى محادثة واحدة، أو امنح المحلل إذنًا لتصدير قضية، أو امنح المشغل حق التحكم في حسابات محددة. يحصل كل شخص على رمزه الخاص. ويبقى رمز لوحة التحكم الرئيسية بحوزة المسؤول.
إعداد الحساب · مسارات الاتصال · نموذج الأمان
نطاقان، وظيفتان مختلفتان#
يحدد نطاق التجميع ما يسجله الحساب: محادثات محددة، أو مجلد Telegram أو الحساب بأكمله. ويحدد نطاق الوصول أيًا من تلك الحسابات والمحادثات المسجلة يمكن لشخص آخر رؤيتها واستخدامها. ولا يؤدي منح حق الوصول إلى الانضمام إلى محادثة Telegram، أو بدء التجميع، أو منح أذونات حساب Telegram.
يمكن لحق الوصول فتح مساحات عمل محددة، أو محادثات محددة داخلها، أو جميع مساحات العمل، أو كل حساب في مجموعة حسابات. وتشمل جميع مساحات العمل، بما في ذلك تلك التي تُضاف لاحقًا، الحسابات المستقبلية أيضًا. كما يشمل حق الوصول إلى المجموعة الحسابات التي تُضاف إلى تلك المجموعة لاحقًا. حدد مساحات العمل صراحةً عندما يجب أن تقتصر الحالة عليها.
منح شخص ما حق الوصول#
- سجّل الدخول بصفة المسؤول الرئيسي وافتح المزيد من الأدوات → الوصول.
- تحت عنوان «منح شخص ما حق الوصول»، أدخل اسمًا ستتمكن من التعرف عليه في السجل.
- اختر مساحات العمل، وعند الحاجة، الدردشات الفردية.
- حدد ما قد يفعله هذا الشخص. يتم تضمين «عرض» دائمًا.
- قم بتعيين مدة الصلاحية، وحدود تسجيل الدخول/الجلسة، والعناوين المسموح بها حسب الحاجة.
- اضغط على «إنشاء وصول». انسخ الرمز الآن: فهو يظهر مرة واحدة فقط.
- أرسل عنوان اللوحة والرمز بشكل خاص. يقوم المستلم بإدخال هذا الرمز في صفحة تسجيل الدخول العادية؛ ولا يحتاج إلى رمز اللوحة الرئيسي الخاص بك أو إلى جلسة Telegram.
افتح اللوحة التي تحتوي على الرمز المميز الصادر في جلسة متصفح منفصلة وتحقق من المحادثات المرئية والإجراءات المسموح بها قبل تسليمها.
تظل أسماء الوصول في التخزين المحلي المشفر ويتم تحليلها بواسطة لوحة المسؤول. يتم حذف الأسماء من سجلات تدقيق الوصول الجديدة وإنشاء مساحات العمل؛ بينما تحتفظ السجلات الموقعة الحالية بحقولها الأصلية.
اختر الأذونات#
لإجراء عرض عام نصي فقط، استخدم «العرض العام» بدلاً من وصول المراجع العادي. فهو يعرض القنوات العامة المحددة صراحةً، والتعديلات والحذوفات المحتفظ بها، والإحصائيات الموقعة، مع حجب حقول المؤلف وإغلاق الملفات عند حدود واجهة برمجة التطبيقات (API). قم بإنشاء عرض وتحقق منه.
| الإذن | ما تتيحه هذه الأداة |
|---|---|
view |
اقرأ المحادثات المسموح بها، والرسائل الملتقطة، والملفات الشخصية، والملفات، وسجلات السجلات المُصفاة. كل ذلك متضمن دائمًا. |
export |
يُسمح بتصدير سجل المحادثات والملفات. يتطلب تصدير الأدلة الخاصة بمساحة العمل بأكملها الوصول إلى مساحة العمل بأكملها. |
sources |
إدارة المصادر واللقطات والتقاط ملفات التعريف. لا يمكن للوصول المحدود بالدردشات العمل إلا على الدردشات المسموح بها؛ بينما تظل إعدادات اكتشاف المصادر ونطاق البحث على مستوى الحساب بأكمله مغلقة. |
collect |
بدء تشغيل أداة التجميع أو إيقافها. يتطلب الوصول الكامل إلى مساحة العمل لأن عملية التجميع تؤثر على الحساب. |
interact |
قم بإجراء التفاعلات المدعومة على Telegram ضمن نطاق الوصول المسموح به. لا يمكن للوصول المحدود بالدردشة استخدام ميزة معاينة الروابط على مستوى الحساب بأكمله. |
settings |
يمكن تغيير إعدادات التجميع والطوابع الزمنية والإشعارات والنسخ خارج الموقع والمعلمات. يتطلب الوصول الكامل إلى مساحة العمل. |
account |
تسجيل الدخول إلى Telegram أو الخروج منه وإدارة مسارات الاتصال. يتطلب الوصول الكامل إلى مساحة العمل. |
board.read |
اقرأ ملاحظات لوحة الحالة فقط ضمن مساحة العمل والدردشات المسموح بها. |
board.write |
أضف الإشارات المرجعية، والمقاطع المميزة، والمقاطع المقتطعة، والتعليقات، وحالات الفتح/المراجعة. كما يحتاج إلى وظيفة «board.read». |
board.manage |
إدارة المجموعات وحالات الفريق النهائية وبطاقات المشاركين الآخرين. كما يتطلب صلاحية القراءة/الكتابة على اللوحة. |
لا يمكن إلا للمسؤول الرئيسي تنزيل مفتاح استعادة النسخة المتماثلة خارج الموقع.
ولا يمنح الوصول المفوض إلى settings أو account هذا المفتاح.
يتم التحقق من الأذونات ونطاقها معًا. لا يؤدي تحديد إذن ما إلى فتح محادثات أخرى أو إلغاء قفل عملية على مستوى مساحة العمل في حالة الوصول المحدود إلى محادثة معينة. للتصدير المتوازي، يجب أن يشمل الوصول الدردشة المصدرة في كل حساب محدد. لا يمكن للوصول الممنوح إنشاء أذونات وصول جديدة، أو إدارة جلسات الآخرين، أو فتح وحدة تحكم المسؤول.
ثلاثة إعدادات مفيدة#
| الشخص | النطاق | الأذونات |
|---|---|---|
| المراجع | المحادثات المسجلة لإحدى القضايا | view |
| محلل يقوم بإعداد عملية تسليم المهام | المحادثات المطلوب التحقيق فيها وتصديرها | view، export؛ أضف interact فقط إذا كان عليهم العمل عبر Telegram |
| مشغل جمع البيانات | مساحات عمل كاملة مختارة | view، sources، collect؛ أضف settings أو account فقط عند الحاجة |
تتضمن الإعدادات المسبقة لبدء نموذج Access أيضًا لوحة الحالات: يمكن للمراجع القراءة، ويمكن للمحلل القراءة والكتابة، ويمكن للمشغل إدارتها. تظل الإعدادات المسبقة قابلة للتعديل، ولا يتم توسيع الصلاحيات الحالية تلقائيًا. انظر لوحة الحالات لمعرفة نطاقات الدردشة الموروثة وخصوصية التصدير.
الحدود والجلسات#
| الإعداد | كيف تعمل |
|---|---|
| الجلسات الموازية | يجب تحديد عدد الجلسات المتزامنة بما يتراوح بين 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
طلبًا في الدقيقة لكل عميل ومجموعة بيانات اعتماد:
panel، أو archive/MCP، أو witness. فترات التهدئة الخاصة بالمصادقة منفصلة لكل مجموعة من هذه المجموعات.
يؤدي رفض عشر عمليات مصادقة في غضون دقيقة واحدة إلى بدء فترة تهدئة أسيّة، تبدأ من ثانية واحدة
وتصل إلى خمس دقائق. تؤدي أي محاولة فاشلة بعد فترة التهدئة إلى زيادة مدتها؛ وعشر دقائق
دون محاولة فاشلة تعيد ضبط التصعيد. تعيد عمليات الرفض رمز HTTP 429
و
Retry-After
. الحدود موجودة في الذاكرة، ومشتركة عبر مساحات العمل في عملية لوحة واحدة؛
وتؤدي إعادة التشغيل إلى مسحها. تقتصر البث المباشر على أربعة لكل رمز حامل و32
لعملية اللوحة. كما يستهلك فتح البث ميزانية طلبات واجهة برمجة التطبيقات.
يتم تحديد مهلة استلام نصوص الطلبات بـ 60 ثانية، وتُخفض إلى 10 ثانية لتسجيل الدخول، والوصول إلى العرض التوضيحي،
وواجهة برمجة تطبيقات الأرشيف ومسارات رأس الشاهد، أو 8 ثانية لنقل MCP. يسمح كل تطبيق
بأربعة نصوص غير مكتملة لكل عنوان عميل، مع حدود إجمالية تبلغ 32 و64 ميغابايت من
الحصص المخصصة للمسارات. لا تستهلك الطلبات التي لا تحتوي على نصوص هذه الحصص. تعود النصوص ذات الحجم الزائد
بالرمز 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 الخاص بالتثبيت المُدار
تعليمات تكوين الخدمة والاستعادة.
يجب أن يحدد محدد الاستعلام ws في واجهة برمجة التطبيقات (API) مساحة العمل في مسار الطلب؛
يتم رفض المحددات المجهولة أو غير المتطابقة أو المكررة برمز الخطأ 404.
تحتوي نصوص وأساليب اللوحة على بيانات تعريفية لسلامة SHA-384. كما تغطي خريطة الاستيراد وحدات JS المستوردة محليًّا في المتصفحات التي تدعم سلامة خريطة الاستيراد. يكون الرد اللغوي الذي يتم إنشاؤه ديناميكيًّا منفصلاً. تكتشف هذه الفحوصات استبدال الأصول بالنسبة للصفحة المُرسلة؛ حيث تأتي الصفحة نفسها وتجزئاتها من خادم اللوحة، لذا يجب حماية ذلك الخادم ومسار التوصيل الخاص به.
يجمع السجل منذ البداية بين سجلات العمليات وأنشطة السجل من كل مساحة عمل: عمليات تسجيل الدخول، والرفض، وتغييرات المسار، وإجراءات المشغل. وهو عبارة عن وحدة تحكم في الذاكرة للعملية الحالية، وليس نسخة دائمة من كل رسالة. تبقى أحداث الرسائل المتكررة في السجل بدلاً من ملء وحدة التحكم.
كما يؤدي إصدار حقوق الوصول وتغييرها وإلغاؤها، وبدء الجلسات أو إنهاؤها، إلى إنشاء
سجلات موثقة في دفتر «access.*». ولا يتم تضمين الرموز المميزة في تلك السجلات.
يتم الاحتفاظ بالرموز المميزة الصادرة وبيانات اعتماد الجلسات كقيم هاش في الخزينة المشفرة.
تنتمي عملية تسجيل الدخول عبر رمز الاستجابة السريعة (QR) المعلقة إلى جلسة اللوحة التي بدأت بها. إن إنهاء أو إلغاء تلك الجلسة، أو تدوير رمز اللوحة الرئيسي، يؤدي إلى إلغاء عميل QR المعلق على الخادم. وينطبق هذا أيضًا عندما يتعذر على المتصفح إرسال طلب الإلغاء الخاص به. كما يؤدي تدوير الرمز أيضًا إلى إلغاء عمليات تسجيل الدخول عبر QR التي بدأت مباشرةً باستخدام رمز اللوحة الرئيسي. يقوم طلب QR الذي ينتظر عملية أخرى بالتحقق من الوصول مرة أخرى قبل أن يبدأ. يتم الاحتفاظ بتفويضات Telegram المكتملة وعمليات تسجيل الدخول المعلقة التي بدأت بواسطة جلسة لوحة أخرى.
المسؤول الرئيسي وحدود الثقة
يظل رمز اللوحة الرئيسية غير مقيد. تؤدي عمليات تسجيل الدخول إلى المتصفح باستخدامه إلى إنشاء جلسات تخضع لحدود الجلسات التي حددها المسؤول. تحتفظ البرامج النصية التي ترسل الرمز الرئيسي مباشرةً بالوصول الكامل ولا تُحسب كجلسات متصفح.
هذا هو التحكم في الوصول على مستوى التطبيق في تثبيت واحد. تتشارك جميع مساحات العمل في عملية الخادم؛ وهذا لا يعني العزل عن مسؤول المضيف. حافظ على خصوصية الرمز الرئيسي وجلسات Telegram ومفاتيح التوقيع ودليل البيانات. رمز الشاهد هو نقطة تفتيش/بيانات اعتماد حالة منفصلة، وليس رمز وصول إلى اللوحة.