SIP ट्रंक

SIP ट्रंक आपके फ़ोन सिस्टम को Bird से जोड़ता है। यह आपके PBX को आउटबाउंड कॉल के लिए एक पता देता है, तय करता है कि Bird उन कॉल को कैसे प्रमाणित करता है, और आपके नंबरों पर आने वाली कॉल भी प्राप्त कर सकता है। ट्रंक को Voice > SIP Trunks में कॉन्फ़िगर करें।

ज़्यादातर सेटअप के लिए एक ट्रंक काफ़ी है। अलग ट्रंक तब बनाएँ जब अलग साइटों या सिस्टम को अलग IP अनुमति सूचियाँ, API कुंजियाँ, सेशन क्रेडेंशियल सेटिंग या Digest एल्गोरिदम चाहिए हों।

ट्रंक बनाएँ

Create trunk चुनें और एक नाम दर्ज करें। डैशबोर्ड का यह लेबल आप बाद में बदल सकते हैं; यह कॉल के साथ नहीं भेजा जाता।

Bird ट्रंक को एक स्थायी SIP डोमेन देता है। यह डोमेन अपने फ़ोन सिस्टम में दर्ज करें, ताकि Bird कॉल को इस ट्रंक से जोड़ सके।

नया ट्रंक हर कॉल अस्वीकार करता है, जब तक आप यह तय न करें कि कॉल कौन कर सकता है: कोई IP रेंज, कोई API कुंजी, सेशन क्रेडेंशियल, या इनका संयोजन।

कॉल की दिशा

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

आउटबाउंड कॉलिंग का मतलब है कि आपका PBX Bird के ज़रिए कॉल करता है। Enable outbound चुनें। जब तक यह चालू नहीं होता, ट्रंक हर आउटबाउंड प्रयास अस्वीकार करता है, चाहे क्रेडेंशियल कुछ भी हों। ट्रंक के कनेक्शन विवरण, अनुमति सूचियाँ, कुंजियाँ, सेशन क्रेडेंशियल और Digest ऑफ़र सभी इसी सेक्शन में हैं, क्योंकि यही तय करते हैं कि कौन अंदर कनेक्ट कर सकता है।

इनबाउंड कॉलिंग का मतलब है कि Bird इस ट्रंक से जुड़े नंबरों पर आने वाली कॉल आपके PBX तक पहुँचाता है। Enable inbound चुनें, फिर कम से कम एक डिलीवरी गेटवे जोड़ें। जिस ट्रंक में कोई गेटवे नहीं है, वह अपने नंबरों पर आने वाली हर कॉल अस्वीकार कर देता है। इस सेक्शन की Inbound numbers सूची दिखाती है कि आपके कौन-से नंबर अपनी कॉल यहाँ भेजते हैं।

डिलीवरी गेटवे आपके फ़ोन सिस्टम का पता है। आखिरी गेटवे हटाने पर ट्रंक की इनबाउंड सेटिंग चालू रहती है, लेकिन आने वाली कॉल के लिए कोई डिलीवरी गंतव्य नहीं बचता। ट्रंक पर ट्रैफ़िक भेजने से पहले एक काम करने वाला गेटवे जोड़ें। आपके गेटवे को पहुँचाई गई कॉल स्वीकार करनी होगी, और इसके लिए वह Bird से SIP Digest चैलेंज का जवाब नहीं माँग सकता।

किसी नंबर को ट्रंक की ओर पॉइंट करने की सेटिंग नंबर पर की जाती है, यहाँ नहीं। इसके लिए, और गेटवे के नंबर फ़ॉर्मैट क्या करते हैं यह जानने के लिए, कॉल प्राप्त करना देखें।

चेतावनी: इनबाउंड कॉलिंग बंद करने पर इस ट्रंक की ओर पॉइंट करने वाले सभी नंबर वर्कस्पेस के डिफ़ॉल्ट रूट पर लौट जाते हैं। साथ ही, जो डिफ़ॉल्ट रूट इस ट्रंक को दर्शाता है, वह अस्वीकार पर रीसेट हो जाता है। इसे दोबारा चालू करने से इनमें से कुछ भी बहाल नहीं होता। ट्रंक हटाने का भी यही असर होता है।

कनेक्शन विवरण

अपने PBX में क्या दर्ज करना है, यह देखने के लिए कोई ट्रंक खोलें:

नोट: केवल IP अनुमति सूची के साथ आपको बस SIP डोमेन और एक पोर्ट चाहिए: यूज़रनेम और पासवर्ड API कुंजी ऑथेंटिकेशन के लिए हैं। जिस क्लाइंट के पास सेशन क्रेडेंशियल है, वह इसके बजाय उसी क्रेडेंशियल का पासवर्ड उपयोग करता है।

अपनी कॉल इनमें से किसी एक पोर्ट पर SIP डोमेन को भेजें:

कौन कॉल भेज सकता है, इसे नियंत्रित करना

ट्रंक उपकरणों को स्रोत IP पते, API कुंजी या कम समय तक मान्य सेशन क्रेडेंशियल से प्रमाणित कर सकता है। आपके क्लाइंट को जिन तरीकों की ज़रूरत है, उन्हें चालू करें।

इन्हें IP allow list, Allowed API keys और Session credentials में कॉन्फ़िगर करें। सहेजे गए बदलाव नई कॉल पर लागू होते हैं।

IP अनुमति सूची

वे सार्वजनिक पते जोड़ें जिनसे आपके उपकरण SIP भेजते हैं, एकल पतों या CIDR रेंज के रूप में, हर एक के साथ वैकल्पिक विवरण के साथ। सूची में एक भी प्रविष्टि होने पर, IP प्रवेश या अनुमत API कुंजियों का उपयोग करने वाली कॉल किसी सूचीबद्ध रेंज से ही आनी चाहिए। चालू किए गए सेशन क्रेडेंशियल प्रवेश का अलग रास्ता देते हैं और दूसरे पतों से भी उपयोग किए जा सकते हैं।

वह सार्वजनिक स्रोत पता जोड़ें जो Bird तक पहुँचता है। NAT के पीछे के उपकरणों के लिए, फ़ोन सिस्टम के निजी पते के बजाय राउटर का सार्वजनिक पता उपयोग करें। IP प्रवेश और अनुमत API कुंजियों के लिए, Bird असूचीबद्ध पतों से आने वाली कॉल को SIP लेयर पर ही अस्वीकार कर देता है, इसलिए वे आमतौर पर कॉल लॉग तक नहीं पहुँचतीं। गायब कॉल के लिए वॉइस समस्या निवारण देखें।

API कुंजी से प्रमाणीकरण

Bird इसके बजाय (या इसके साथ) हर कॉल से पासवर्ड माँग सकता है। यह प्रक्रिया SIP Digest प्रमाणीकरण है: Bird एक चुनौती भेजता है, आपका फ़ोन सिस्टम पासवर्ड के बजाय उसके हैश से जवाब देता है, और Bird उसे Bird API कुंजी से मिलाकर जाँचता है।

1. किसी API कुंजी को write स्तर पर voice अनुमति दें, क्योंकि ट्रंक इसी स्तर के आधार पर प्रमाणित करता है। यह अनुमति किसी मौजूदा कुंजी में जोड़ें या नई कुंजी बनाएँ। दोनों ही स्थितियों में कुंजी का सीक्रेट बिना बदले काम करता है: पहले से लगाई गई कुंजी वही सीक्रेट रखती है जिससे आपके सिस्टम कॉन्फ़िगर हैं, और नई कुंजी अपना सीक्रेट केवल एक बार, बनाते समय दिखाती है, इसलिए उसे उसी समय सहेज लें। API कुंजियाँ देखें।
2. ट्रंक पेज पर Allowed API keys के अंतर्गत वह कुंजी जोड़ें।
3. अपने PBX में यूज़रनेम bird और पासवर्ड कुंजी का सीक्रेट सेट करें।

सूची में कोई कुंजी जुड़ जाने के बाद, API-कुंजी प्रमाणीकरण के लिए सूचीबद्ध कुंजियों में से कोई एक ज़रूरी होती है। सेशन क्रेडेंशियल चालू होने पर एक अलग तरीका बने रहते हैं।

किसी कुंजी से voice अनुमति हटाते ही वह तुरंत प्रमाणित करना बंद कर देती है, लेकिन ट्रंक उसे अनुमत सूची में बनाए रखता है। अनुमति वापस जोड़ने पर ट्रंक उसी सीक्रेट के साथ फिर से काम करने लगता है, और ट्रंक या आपके PBX में कुछ बदलना नहीं पड़ता। जब तक अनुमति नहीं होती, ट्रंक पेज उस कुंजी को चिह्नित करता है, ताकि अनुमत सूची काम न करने पर काम करती हुई न दिखे।

किसी API कुंजी को रद्द या डिलीट करने पर, उसे अनुमति देने वाले हर ट्रंक पर उसकी प्रमाणीकरण क्षमता तुरंत खत्म हो जाती है, और यह स्थायी है। कुंजी बदलने के लिए पहले नई कुंजी ट्रंक में जोड़ें, फिर अपने उपकरण को उस पर ले जाएँ, और उसके बाद पुरानी कुंजी रद्द करें।

सेशन क्रेडेंशियल

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

इन्हें ट्रंक पेज पर Session credentials के अंतर्गत चालू करें; नए ट्रंक पर ये बंद रहते हैं। ये किसे प्रवेश देते हैं:

• डैशबोर्ड का फ़ोन, जो हर कॉल के लिए आपकी ओर से एक क्रेडेंशियल बनाता है।
• CLI से चलने वाला SIP क्लाइंट: bird voice tools test-call अपनी की जाने वाली कॉल के लिए एक क्रेडेंशियल बनाता है, और bird voice session-credentials create किसी अन्य क्लाइंट में पेस्ट करने के लिए एक क्रेडेंशियल बनाता है। दोनों को write स्तर की voice पहुँच चाहिए।

क्रेडेंशियल किसी एक ट्रंक का नहीं, बल्कि वर्कस्पेस का होता है, इसलिए क्लाइंट इसे सभी योग्य ट्रंकों पर इस्तेमाल कर सकता है। क्लाइंट को क्रेडेंशियल प्रस्तुत करना होता है, और ट्रंक पर सेशन क्रेडेंशियल चालू होने चाहिए। Bird पासवर्ड केवल क्रेडेंशियल बनाते समय लौटाता है।

लौटाई गई समाप्ति को वह अंतिम समय मानें जब तक क्रेडेंशियल किसी नई कॉल को प्रवेश दे सकता है। जिस सब्जेक्ट ने इसे बनाया, उसे सक्रिय रहना होगा: मानव उपयोगकर्ताओं के पास वर्कस्पेस भूमिका या संगठन-स्वामी पहुँच होनी चाहिए; API कुंजियाँ उसी टेनेंट की, रद्द न की गई और अवधि-समाप्त न हुई होनी चाहिए; सर्विस अकाउंट उसी टेनेंट में सक्रिय रहने चाहिए। कॉल करने की अनुमति क्रेडेंशियल बनाते समय जाँची जाती है। बाद की सब्जेक्ट जाँचें उस अनुमति की फिर से गणना नहीं करतीं और पहले से प्रवेश पा चुकी कॉल को समाप्त नहीं करतीं।

इन्हें चालू करने से IP अनुमति सूची में शामिल उपकरणों के कनेक्ट होने का तरीका नहीं बदलता: जिस ट्रंक पर कोई अनुमत API कुंजी नहीं है, उस पर सूचीबद्ध पते से आने वाली कॉल अब भी पासवर्ड चुनौती के बिना स्वीकार की जाती है।

Digest एल्गोरिदम

डिफ़ॉल्ट रूप से Bird पहले SHA-256 और फिर MD5 पेश करता है। आपका PBX उस पहले एल्गोरिदम से जवाब देता है जिसे वह सपोर्ट करता है।

जब आपके उपकरण को ज़रूरत हो, तो Digest algorithm में यह पेशकश बदलें। जो PBX SHA-256 से शुरू होने वाली चुनौती को ठीक से नहीं संभालता, उसके लिए MD5 only चुनें। ट्रंक केवल वही एल्गोरिदम स्वीकार करता है जो वह पेश करता है। API कुंजियाँ दोनों एल्गोरिदम के साथ काम करती हैं और उन्हें दोबारा जारी करने की ज़रूरत नहीं होती।

जिस भी ट्रंक से आप फ़ोन के ज़रिए कॉल करते हैं, उसकी पेशकश में MD5 रखें: ब्राउज़र केवल MD5 से जवाब देता है, इसलिए केवल SHA-256 पेश करने वाला ट्रंक हर ब्राउज़र कॉल अस्वीकार कर देता है।

ट्रंक हटाएँ

ट्रंक हटाना तुरंत लागू होता है: उसका SIP डोमेन नई कॉल स्वीकार करना बंद कर देता है, और उसकी ओर इंगित हर नंबर वर्कस्पेस के डिफ़ॉल्ट रूट पर लौट जाता है। पहले से चल रही कॉल जारी रहती हैं, और ट्रंक से हुई कॉल के रिकॉर्ड आपके कॉल लॉग में बने रहते हैं।

अगले चरण