TgWitness / दस्तावेज़ीकरण

क्या परीक्षण किया गया है →

संदर्भ / सेटअप

Telegram · पहुँच और अनुमतियाँ

खातों और चैट्स के लिए सीमित पहुँच प्रदान करें, अनुमतियाँ चुनें, सत्रों और आईपी पतों को सीमित करें, और पहुँच वापस ले लें।

टीजीविटनेस / दस्तावेज़ीकरण · शुरुआत करना

शुरुआत करना

एक समीक्षक को एक चैट तक पहुंच दें, एक विश्लेषक को एक मामले को निर्यात करने की अनुमति दें, या एक ऑपरेटर को चयनित खातों का नियंत्रण दें। प्रत्येक व्यक्ति को अपना टोकन मिलता है। मुख्य पैनल का टोकन प्रशासक के पास रहता है।

खाता सेटअप · कनेक्शन मार्ग · सुरक्षा मॉडल

दो दायरे, दो अलग-अलग काम#

संग्रह का दायरा यह तय करता है कि कोई खाता क्या रिकॉर्ड करता है: चुनी हुई चैट्स, एक टेलीग्राम फ़ोल्डर या पूरा खाता। पहुँच का दायरा यह तय करता है कि उन रिकॉर्ड किए गए खातों और चैट्स में से कोई दूसरा व्यक्ति कौन सा देख और उपयोग कर सकता है। पहुँच देने से कोई टेलीग्राम चैट जुड़ती नहीं है, संग्रह शुरू नहीं होता या टेलीग्राम खाते की अनुमति नहीं मिलती।

एक एक्सेस चयनित वर्कस्पेस, उनमें चयनित चैट, सभी वर्कस्पेस, या एक अकाउंट ग्रुप का हर अकाउंट खोल सकता है। सभी वर्कस्पेस, जिसमें बाद में जोड़े गए वर्कस्पेस भी शामिल हैं, भविष्य के अकाउंट्स को भी कवर करते हैं। एक ग्रुप एक्सेस भी उस ग्रुप में बाद में जोड़े गए अकाउंट्स को कवर करता है। जब कोई केस केवल उन्हीं तक सीमित रहना चाहिए, तो वर्कस्पेस को स्पष्ट रूप से चुनें।

किसी को पहुँच दें#

  1. मुख्य प्रशासक के रूप में साइन इन करें और More tools → Access खोलें।
  2. 'किसी को एक्सेस दें' के अंतर्गत, लॉग में दिखाई देने वाला कोई नाम दर्ज करें।
  3. वर्कस्पेस चुनें और जहाँ आवश्यक हो, व्यक्तिगत चैट चुनें।
  4. चुनें कि यह व्यक्ति क्या कर सकता है। व्यू हमेशा शामिल होता है।
  5. आवश्यकतानुसार समाप्ति तिथि, साइन-इन/सत्र सीमाएँ और अनुमत पते सेट करें।
  6. Create पर क्लिक करें। अब टोकन कॉपी करें: यह केवल एक बार ही दिखाई देता है।
  7. पैनल का पता और टोकन निजी तौर पर भेजें। प्राप्तकर्ता उस टोकन को सामान्य साइन-इन पेज पर दर्ज करता है; उन्हें आपके मुख्य पैनल टोकन या टेलीग्राम सत्र की आवश्यकता नहीं होती।

जारी किए गए टोकन के साथ पैनल को एक अलग ब्राउज़र सत्र में खोलें और इसे सौंपने से पहले दिखाई देने वाली चैट्स और अनुमत क्रियाओं की जाँच करें।

एक्सेस नाम एन्क्रिप्टेड लोकल स्टोरेज में रहते हैं और प्रशासक के पैनल द्वारा हल किए जाते हैं। नए एक्सेस और वर्कस्पेस-निर्माण ऑडिट रिकॉर्ड से नाम हटा दिए जाते हैं; मौजूदा हस्ताक्षरित रिकॉर्ड अपने मूल फ़ील्ड बनाए रखते हैं।

अनुमतिएँ चुनें#

केवल टेक्स्ट-आधारित सार्वजनिक प्रदर्शन के लिए, सामान्य समीक्षक पहुँच के बजाय सार्वजनिक शोकेस का उपयोग करें। यह स्पष्ट रूप से चयनित सार्वजनिक चैनलों, संरक्षित संपादन और हटाई गई वस्तुओं, और हस्ताक्षरित आँकड़ों को दिखाता है, जिसमें लेखक के क्षेत्र हटा दिए गए हैं और एपीआई सीमा पर फ़ाइलें बंद कर दी गई हैं। एक शोकेस बनाएँ और सत्यापित करें।

अनुमति यह क्या अनुमति देता है
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 जोड़ें

एक्सेस फॉर्म के शुरुआती प्रीसेट में केस बोर्ड भी शामिल हैं: समीक्षक पढ़ सकता है, विश्लेषक पढ़ और लिख सकता है, और ऑपरेटर इसे प्रबंधित कर सकता है। प्रीसेट संपादन योग्य रहते हैं, और मौजूदा अनुमतियाँ स्वचालित रूप से विस्तारित नहीं होती हैं। विरासत में मिले चैट स्कोप और निर्यात गोपनीयता के लिए केस बोर्ड देखें।

सीमाएँ और सत्र#

सेटिंग यह कैसे काम करता है
समांतर सत्र एक साथ चल रहे सत्रों को 1–100 तक सीमित करें। सीमा पर पहुँचने पर अगले साइन-इन को अस्वीकार करें या सबसे पुराने सत्र को समाप्त कर दें।
साइन-इन की अनुमति है टोकन के सफल उपयोगों को केवल सत्र शुरू करने तक सीमित करें। केवल इसलिए कि अंतिम अनुमत साइन-इन का उपयोग हो चुका है, मौजूदा सत्र समाप्त नहीं होते।
मान्य तक पहुँच के लिए पूर्ण समाप्ति। समाप्त हो चुकी पहुँच साइन इन नहीं कर सकती और अनुरोध करना जारी नहीं रख सकती।
गतिविधि रहित मिनट सत्र निष्क्रियता टाइमआउट, 5 मिनट से 30 दिनों तक। सफल अनुरोध इसे बढ़ाते हैं; एक खुला पैनल पोलिंग द्वारा स्वयं को सक्रिय रख सकता है।
अनुमत पते विशिष्ट IP पतों या CIDR सबनेट्स को स्वीकार करें। जब तक प्रथम-साइन-इन बाइंडिंग सक्षम न हो, किसी भी पते की अनुमति देने के लिए इसे खाली छोड़ दें।
पहले साइन-इन से बाँधें पहली सफल साइन-इन उस पहुँच के लिए अनुमत पते को निर्धारित करती है।

आईपी वह क्लाइंट पता है जो एप्लिकेशन को दिखाई देता है। रिवर्स प्रॉक्सी या टनल के पीछे, आईपी नियमों पर भरोसा करने से पहले ओपन सेशंस में दिखाए गए पते की जाँच करें: अन्यथा कई उपयोगकर्ता प्रॉक्सी के पते को साझा करते हुए दिखाई दे सकते हैं।

पहुँच बदलें या वापस लें#

इसका दायरा, अनुमतियाँ या सीमाएँ बदलने के लिए 'प्रदान की गई पहुँच' के अंतर्गत किसी प्रविष्टि को संपादित करें। दायरा और अनुमतिओं में बदलावों की जाँच बाद के अनुरोधों पर की जाती है, जिसमें वे सत्र भी शामिल हैं जो पहले से ही खुले हैं। पहुँच रद्द करने से उसके सत्र समाप्त हो जाते हैं और जारी किया गया टोकन अमान्य हो जाता है। खुले सत्र प्रशासक को पूरी पहुँच रद्द किए बिना एक व्यक्तिगत सत्र समाप्त करने की भी अनुमति देते हैं।

सहेजी गई एक्सपोर्ट कॉपीज़ अपने निर्माता, वर्कस्पेस, चैट स्कोप और आवश्यक अनुमतियों को बनाए रखती हैं। जारी की गई एक्सेस केवल तब ही अपनी कॉपीज़ को सूचीबद्ध या डाउनलोड कर सकती है जब वे अनुमतियाँ अभी भी लागू हों; केस बोर्ड वाली कॉपीज़ के लिए भी board.read की आवश्यकता होती है। प्रशासक सभी कॉपीज़ को पुनः प्राप्त कर सकता है। इस मेटाडेटा के बिना पुरानी प्रतियाँ और समूह बंडल केवल प्रशासक के लिए हैं। डाउनलोड टिकट और तैयार फ़ाइल प्रतिक्रियाएँ फ़ाइल तैयार करने के बाद, उसके बाइट्स भेजने से पहले, एक्सेस की फिर से जाँच करती हैं। प्रत्येक एक्सेस, जिसमें प्रशासक भी शामिल है, प्रति कार्यक्षेत्र दस लंबित डाउनलोड टिकट रख सकता है; कार्यक्षेत्र-व्यापी सीमा 1,000 है। टिकट 120 सेकंड के बाद समाप्त हो जाते हैं और एक-बार उपयोग के लिए होते हैं।

रद्दीकरण उन फ़ाइलों को वापस नहीं ला सकता जिन्हें कोई पहले ही डाउनलोड कर चुका है। साइन आउट करना, पैनल को लॉक करना या सत्र समाप्त करना चल रहे कलेक्टर को नहीं रोकता।

प्रशासक क्या देख सकता है#

समीक्षक और विश्लेषक प्रॉक्सी एंडपॉइंट, पूल डायग्नोस्टिक्स, सर्वर पथ या कच्ची कनेक्शन त्रुटियों के बिना संग्रह की प्रगति प्राप्त करते हैं। कनेक्शन डायग्नोस्टिक्स के लिए पूरे वर्कस्पेस पर account अनुमति की आवश्यकता होती है। सूचना पढ़ने, ऑफ-साइट-कॉपी और पैरामीटर सेटिंग्स के लिए settings अनुमति की आवश्यकता होती है।

पूर्ण ब्राउज़र User-Agent स्ट्रिंग्स एक्सेस सत्रों में बनाए नहीं रखे जाते हैं। एक अपग्रेड उन्हें परिवर्तनीय सत्र कैश से भी हटा देता है। पैनल प्रक्रिया लॉग आईपी लिटरल, यूआरएल क्रेडेंशियल और लेबल किए गए सीक्रेट्स को मास्क करता है। स्थानीय सेवा लॉग और पहले से साइन किए गए जर्नल रिकॉर्ड फिर से नहीं लिखे जाते हैं। एक्सेस नियम और साइन किए गए साइन-इन रिकॉर्ड अभी भी क्लाइंट एड्रेस का उपयोग करते हैं।

मुख्य कुंजी को बदलें#

अधिक उपकरण → पहुँच → मेरी सीमाएँ → प्रशासक कुंजी पुनः जारी करें का उपयोग करें, या पैनल चलने के दौरान एक प्रबंधित इंस्टॉलेशन से tgwitness token rotate चलाएँ। सभी मौजूदा ब्राउज़र सत्र समाप्त हो जाते हैं, जिसमें सहकर्मी टोकन के साथ खोले गए सत्र भी शामिल हैं। अनुरोध करने वाले ब्राउज़र को एक नया सत्र प्राप्त होता है; इसे छिपाने से पहले नई प्रशासक कुंजी सहेजें। जारी किए गए सहकर्मी टोकन अलग से रद्द किए जाने तक मान्य रहते हैं। TGWITNESS_TOKEN का उपयोग करने वाले एक इंस्टॉलेशन को उस वातावरण सेटिंग को बदलना चाहिए और पुनः आरंभ करना चाहिए।

अनुरोध और प्रॉक्सी सीमाएँ#

एपीआई प्रति क्लाइंट और क्रेडेंशियल परिवार (पैनल, आर्काइव/MCP या विटनेस) प्रति मिनट अधिकतम 600 अनुरोध स्वीकार करता है: इन परिवारों के लिए प्रमाणीकरण कूलडाउन अलग-अलग होते हैं। एक मिनट के भीतर दस अस्वीकृत प्रमाणीकरण एक घातीय कूलडाउन शुरू करते हैं, जो एक सेकंड से लेकर पांच मिनट तक होता है। कूलडाउन के बाद एक असफल प्रयास इसे बढ़ा देता है; बिना किसी असफल प्रयास के दस मिनट का समय एस्केलेशन को रीसेट कर देता है। अस्वीकृतियों पर HTTP 429 और Retry-After लौटाया जाता है। सीमाएँ मेमोरी में होती हैं, जो एक पैनल प्रक्रिया में वर्कस्पेस के बीच साझा होती हैं; पुनरारंभ करने पर वे साफ़ हो जाती हैं। लाइव स्ट्रीम प्रति बेयरर टोकन चार और पैनल प्रक्रिया के लिए 32 तक सीमित हैं। एक स्ट्रीम खोलने से भी API अनुरोध बजट की खपत होती है।

रिक्वेस्ट बॉडीज़ की रिसीव डेडलाइन 60 सेकंड की होती है, जो लॉगिन, डेमो एक्सेस, आर्काइव एपीआई और विटनेस-हेड पाथ के लिए घटाकर 10 सेकंड, या MCP ट्रांसपोर्ट के लिए 8 सेकंड हो जाती है। प्रत्येक एप्लिकेशन प्रति क्लाइंट एड्रेस चार अधूरे बॉडीज़ की अनुमति देता है, जिनकी कुल सीमा 32 और 64 MiB का आरक्षित रूट अलाउंसमेंट है। बिना बॉडी वाली रिक्वेस्ट इन स्लॉट्स का उपयोग नहीं करती हैं। बड़े आकार की बॉडी पर 413 की त्रुटि लौटती है, समय-सीमा समाप्त होने पर 408 की त्रुटि लौटती है, और क्लाइंट क्षमता से अधिक होने पर 429 की त्रुटि लौटती है। Retry-After: 1. कुल बॉडी क्षमता समाप्त होने पर 503 लौटाता है Retry-After.

आगे भेजे गए IP हेडर अनदेखा कर दिए जाते हैं जब तक कि वास्तविक TCP पीयर TGWITNESS_TRUSTED_PROXIES (कॉमा-सेपरेटेड IPs या CIDRs) का हिस्सा न हो। TGWITNESS_PROXY_HEADER को x-forwarded-for या cf-connecting-ip पर सेट करें। XFF को सबसे करीबी प्रॉक्सी से पहले अविश्वसनीय पीयर की ओर ट्रैक किया जाता है। खराब या डुप्लिकेट ट्रस्टेड एड्रेस मेटाडेटा को अस्वीकार कर दिया जाता है, इसलिए यह एक अनुमत प्रॉक्सी एड्रेस को इनहेरिट नहीं कर सकता है। प्रबंधित क्विक टनल स्थानीय क्लाउडफ्लेयर्ड कनेक्टर पर भरोसा करता है; ओन-डोमेन सेटअप स्थानीय कैडी पर भरोसा करता है। डायरेक्ट डिप्लॉयमेंट्स डिफ़ॉल्ट रूप से किसी भी प्रॉक्सी पर भरोसा नहीं करते हैं। यदि आप स्वयं यूविकॉर्न लॉन्च कर रहे हैं, तो इसकी प्रॉक्सी-हेडर प्रोसेसिंग को अक्षम करें ताकि यह बाउंड्री वास्तविक पीयर को प्राप्त कर सके।

TGWITNESS_PANEL_ALLOWED_IPS सभी पैनल एक्सेस को, प्रशासक सहित, सूचीबद्ध IPs या CIDRs तक सीमित करता है। इंस्टॉलर राउटिंग-आईडेंटिटी प्रोब सार्वजनिक रहती है और कोई खाता डेटा नहीं लौटाती है। एलाउलिस्ट को सक्षम करने से पहले आवश्यक स्थानीय प्रशासनिक मार्ग शामिल करें। एक प्रबंधित इंस्टॉलेशन के START-HERE गाइड में सेवा कॉन्फ़िगरेशन और रिकवरी निर्देश शामिल होते हैं।

एक API ws क्वेरी सेलेक्टर को अनुरोध पथ में कार्यक्षेत्र की पहचान करनी चाहिए; अज्ञात, मेल न खाने वाले और डुप्लिकेट सेलेक्टर 404 के साथ अस्वीकार कर दिए जाते हैं।

पैनल स्क्रिप्ट और शैलियाँ SHA-384 अखंडता मेटाडेटा ले जाती हैं। एक इम्पोर्ट मैप उन ब्राउज़रों में स्थानीय रूप से आयात किए गए JS मॉड्यूल को भी कवर करता है जो इम्पोर्ट-मैप अखंडता का समर्थन करते हैं। गतिशील रूप से उत्पन्न भाषा प्रतिक्रिया अलग होती है। ये जाँचें वितरित पेज के सापेक्ष संपत्ति प्रतिस्थापन का पता लगाती हैं; पेज स्वयं और इसके हैश पैनल सर्वर से आते हैं, इसलिए उस सर्वर और उसके वितरण पथ की सुरक्षा करें।

शुरुआत से यह लॉग हर वर्कस्पेस की जर्नल गतिविधि के साथ प्रक्रिया लॉग को जोड़ता है: साइन-इन, अस्वीकृतियाँ, मार्ग परिवर्तन और ऑपरेटर क्रियाएँ। यह वर्तमान प्रक्रिया के लिए एक इन-मेमोरी कंसोल है, न कि हर संदेश की एक स्थायी प्रति। बार-बार होने वाली संदेश घटनाएँ कंसोल भरने के बजाय जर्नल में ही रहती हैं।

एक्सेस जारी करने, बदलने और रद्द करने, और सत्र शुरू करने या समाप्त करने से भी हस्ताक्षरित access.* जर्नल रिकॉर्ड बनते हैं। उन रिकॉर्ड्स में टोकन शामिल नहीं होते हैं। जारी किए गए टोकन और सत्र क्रेडेंशियल एन्क्रिप्टेड वॉल्ट में हैश के रूप में रखे जाते हैं।

एक लंबित QR साइन-इन उस पैनल सत्र से संबंधित है जिसने इसे शुरू किया था। उस सत्र को समाप्त करने या रद्द करने, या मुख्य पैनल टोकन को घुमाने से, सर्वर पर उसका लंबित QR क्लाइंट रद्द हो जाता है। यह तब भी लागू होता है जब ब्राउज़र अपनी रद्दीकरण अनुरोध नहीं भेज पाता है। टोकन रोटेशन से मुख्य पैनल टोकन के साथ सीधे शुरू किए गए QR साइन-इन भी रद्द हो जाते हैं। किसी अन्य ऑपरेशन की प्रतीक्षा कर रहा QR अनुरोध शुरू होने से पहले फिर से एक्सेस की जाँच करता है। अन्य पैनल सत्र द्वारा शुरू किए गए पूर्ण टेलीग्राम अधिकृतकरण और लंबित साइन-इन संरक्षित रहते हैं।

मुख्य प्रशासक और विश्वास सीमा

मुख्य पैनल टोकन अप्रतिबंधित बना रहता है। इसके साथ ब्राउज़र साइन-इन सत्र बनाते हैं जो प्रशासक द्वारा कॉन्फ़िगर की गई सत्र सीमाओं के अधीन होते हैं। मुख्य टोकन को सीधे भेजने वाली स्क्रिप्ट्स पूरी पहुँच बनाए रखती हैं और उन्हें ब्राउज़र सत्रों के रूप में नहीं गिना जाता है।

यह एक इंस्टॉलेशन में एप्लिकेशन-स्तर का एक्सेस कंट्रोल है। सभी वर्कस्पेस सर्वर प्रक्रिया को साझा करते हैं; यह होस्ट प्रशासक से अलगाव नहीं है। मुख्य टोकन, टेलीग्राम सत्र, साइनिंग कुंजियाँ और डेटा निर्देशिका को निजी रखें। एक विटनेस टोकन एक अलग चेकपॉइंट/स्वास्थ्य प्रमाण-पत्र है, न कि पैनल एक्सेस टोकन।