Sonata - SIP უზრუნველყოფის სერვერი

არ ვიცი რა შევადარო უზრუნველყოფა. იქნებ კატასთან ერთად? როგორც ჩანს, ამის გარეშე შესაძლებელია, მაგრამ მასთან ერთად ცოტა უკეთესია. მითუმეტეს თუ მუშაობს))

პრობლემის ფორმულირება:

1. მინდა დავაყენო SIP ტელეფონები სწრაფად, მარტივად და უსაფრთხოდ. ტელეფონის დაყენებისას და მით უმეტეს მისი ხელახალი კონფიგურაციისას.
2. ბევრ მომწოდებელს აქვს საკუთარი კონფიგურაციის ფორმატები, კონფიგურაციის გენერირების საკუთარი საშუალებები და კონფიგურაციის დაცვის საკუთარი გზები. და მე ნამდვილად არ მინდა ყველასთან ურთიერთობა.
3. მრავალი უზრუნველყოფის გადაწყვეტა, ა) ორიენტირებულია ერთ გამყიდველზე ან ერთ სატელეფონო სისტემაზე, ბ) საკმაოდ შრომატევადი დანერგვა, ბევრი სკრიპტი, პარამეტრი, brrr...

მე-3 პუნქტთან დაკავშირებით მე გავაკეთებ კომენტარს, რომ არის შესანიშნავი უზრუნველყოფის სისტემები FreePBX-ისთვის, FusionPBX-ისთვის, კაზოოსთვის, სადაც სხვადასხვა გამყიდველის ტელეფონების შაბლონები საჯაროდ არის ხელმისაწვდომი. არსებობს კომერციული გადაწყვეტილებები, სადაც ასევე შეგიძლიათ დააკონფიგურიროთ ტელეფონების მუშაობა სხვადასხვა მწარმოებლისგან, უზრუნველყოფის მოდულში, მაგალითად, Yeastar PBX.

Habré ასევე სავსეა რეცეპტებით, თუ როგორ უნდა დააყენოთ მოწყობილობები სხვადასხვა გამყიდველებისგან: დრო, два. მაგრამ როგორც ამბობენ, ყველა სისტემას აქვს ფატალური ნაკლი. ასე რომ, ჩვენ თვითონ გავაკეთებთ ველოსიპედს.

თქვენი ფორმატი

როგორც ამბობენ xkcd-ში, თუ არ გინდა საქმე 14 ფორმატთან - გამოვიდეს მე-15. ამიტომ, ჩვენ ვიყენებთ ზოგად პარამეტრებს ნებისმიერი ტელეფონისთვის და ვქმნით საკუთარ json კონფიგურაციის ფორმატს.

Რაღაც მსგავსი:

{
   "key": "sdgjdeu9443908",
   "token": "590sfdsf8u984",
   "model": "gxp1620",
   "vendor": "grandstream",
   "mac": "001565113af8",
   "timezone_offset": "GMT+03",
   "ntp_server": "pool.ntp.org",
   "status": true,
   "accounts": [
      {
         "name": "Мобилон",
         "line": 1,
         "sip_register": "sip.mobilonsip.ru",
         "sip_name": "sip102",
         "sip_user": "sip102",
         "sip_password": "4321",
         "sip_auth": "sip102"
      }
   ]
}

ასე რომ, ნებისმიერ ტელეფონში თქვენ უნდა დააკონფიგურიროთ ადგილობრივი დრო და SIP ხაზები. აქ ყველაფერი მარტივია. შეგიძლიათ ნახოთ მეტი მაგალითი აქ.

თქვენი საკუთარი სერვერის უზრუნველყოფა

მწარმოებლის სახელმძღვანელოებში, როგორც წესი, არის წერტილი, სადაც ნათქვამია: აიღეთ csv, ჩაწერეთ თქვენი შესვლა-პაროლი-mac-მისამართი, შექმენით ფაილები ჩვენი საკუთრების სკრიპტის გამოყენებით, განათავსეთ ისინი Apache ვებ სერვერის ქვეშ და ყველაფერი კარგად იქნება.

სახელმძღვანელოს შემდეგი პუნქტი ჩვეულებრივ გეუბნებათ, რომ თქვენ ასევე შეგიძლიათ გენერირებული კონფიგურაციის ფაილის დაშიფვრა.

მაგრამ ეს ყველაფერი კლასიკაა. სმუზითა და ტვიტერის თანამედროვე მიდგომა ამბობს, რომ თქვენ უნდა გააკეთოთ მზა ვებ სერვერი, რომელიც არ იქნება ისეთი ძლიერი, როგორც Apache, მაგრამ გააკეთებს მხოლოდ ერთ წვრილმანს. შექმენით და გაგზავნეთ კონფიგურაციები ბმულის გამოყენებით.

მოდით შევჩერდეთ აქ და გვახსოვდეს, რომ თითქმის ყველა SIP ტელეფონს ახლა შეუძლია კონფიგურაციის მიღება http/https-ის საშუალებით, ამიტომ ჩვენ არ განვიხილავთ სხვა განხორციელებებს (ftp, tftp, ftps). შემდეგ თითოეულმა ტელეფონმა იცის თავისი MAC მისამართი. აქედან გამომდინარე, ჩვენ გავაკეთებთ ორ ბმულს: ერთი პირადი - მოწყობილობის გასაღების საფუძველზე, მეორე ზოგადი, რომელიც მუშაობს საერთო ტოკენისა და MAC მისამართის კომბინაციით.

ასევე, არ შევჩერდები zero-config-ზე, ე.ი. ტელეფონის დაყენება ნულიდან, ე.ი. თქვენ შეაერთეთ იგი ქსელში და დაიწყო მუშაობა. არა, ჩემს სცენარში, თქვენ შეაერთებთ მას ქსელში, გააკეთეთ წინასწარი ინსტალაცია (დააყენეთ კონფიგურაციის მისაღებად პროვიაჟირების სერვერიდან) და შემდეგ დალიეთ pina colada და საჭიროებისამებრ განაახლეთ ტელეფონის კონფიგურაცია. 66 ვარიანტის განაწილება არის DHCP სერვერის პასუხისმგებლობა.

სხვათა შორის, სრულიად დავიღალე „პროვიჟირების“ თქმით, ამიტომ სიტყვა შემოიკლდა „დებულებაზე“, გთხოვ, წიხლებს ნუ მაკარებ.

და კიდევ ერთი რამ: ჩვენს პროვიაჟირების სერვერს არ აქვს UI, ე.ი. მომხმარებლის ინტერფეისი. შესაძლოა, ჯერჯერობით, მაგრამ არ ვარ დარწმუნებული, რადგან... მე არ მჭირდება. მაგრამ არსებობს API პარამეტრების შესანახად/წაშლისთვის, მხარდაჭერილი მომწოდებლების, მოდელების სიის მისაღებად, ყველაფერი აღწერილია swagger-ის სპეციფიკაციის კანონების მიხედვით.

რატომ API და არა UI? იმიტომ რომ მე უკვე მაქვს საკუთარი სატელეფონო სისტემა, შემდეგ მაქვს რწმუნებათა სიგელების წყარო, სადაც უბრალოდ უნდა ავიღო ეს მონაცემები, შევადგინო საჭირო json და გამოვაქვეყნო პროვიაჟირების სერვერზე. და დებულების სერვერი, json ფაილში მითითებული წესების მიხედვით, მისცემს საჭირო მოწყობილობას მის კონფიგურაციას ან არ მისცემს მას, თუ მოწყობილობა არ არის სწორი ან არ აკმაყოფილებს ამ json-ში მითითებულ კრიტერიუმებს.

ასე აღმოჩნდა მიწოდების მიკროსერვისი. დაურეკა სონატა, წყაროს კოდი ხელმისაწვდომია GitHub-ზე, ასევე არსებობს მზა დოკერის სურათი, დოკერის გამოყენების მაგალითი აქ.

ძირითადი მახასიათებლები:

• ნებისმიერ შემთხვევაში, კონფიგურაციაზე წვდომა შეზღუდული დროით, ნაგულისხმევად 10 წუთი. თუ გსურთ კონფიგურაციის ხელახლა ხელმისაწვდომობა, ხელახლა გამოაქვეყნეთ კონფიგურაცია.

• ერთი ფორმატი ყველა გამყიდველისთვის, ყველა კორექტირება ამოღებულია სონატაში, თქვენ აგზავნით სტანდარტიზებულ json-ს, აკონფიგურირებთ ნებისმიერ ხელმისაწვდომ აღჭურვილობას.

• მოწყობილობებზე გაცემული ყველა კონფიგურაცია აღრიცხულია, ყველა პრობლემური სფეროს ნახვა შესაძლებელია ჟურნალში და შეცდომების ნახვა

• შესაძლებელია ერთი საერთო ბმულის გამოყენება ჟეტონთან ერთად; თითოეული ტელეფონი იღებს საკუთარ კონფიგურაციას mac მისამართის მითითებით. ან პირადი ბმული გასაღების საშუალებით.

• API-ები მენეჯმენტისთვის (მართვა) და ტელეფონებისთვის კონფიგურაციის მიწოდებისთვის (მოწოდება) იყოფა პორტების მიხედვით

• ტესტები. ჩემთვის ძალიან მნიშვნელოვანი იყო გაცემული კონფიგურაციის ფორმატის დაფიქსირება და კონფიგურაციის გაცემის ყველა ჩვეულებრივი სიტუაციის ტესტებით დაფარვა. ისე, რომ ეს ყველაფერი ნათლად მუშაობს.

Cons:

ჯერჯერობით, დაშიფვრა არანაირად არ გამოიყენება სონატაში. იმათ. თქვენ, რა თქმა უნდა, შეგიძლიათ დაიწყოთ https-ის გამოყენება, მაგალითად, სონატის წინ nginx-ის დაყენებით. მაგრამ საკუთრების მეთოდები ჯერ არ არის გამოყენებული. რატომ? პროექტი ჯერ კიდევ ახალგაზრდაა, მან გამოუშვა თავისი პირველი ასეული მოწყობილობა. და, რა თქმა უნდა, ვაგროვებ იდეებსა და გამოხმაურებებს. გარდა ამისა, იმისათვის, რომ ყველაფერი უსაფრთხო იყოს, ისე, რომ კონფიგურაციები არ მოხდეს ქსელში, ალბათ ღირს შეწუხება დაშიფვრის გასაღებებით, tls-ით და მათთან ერთად ზღარბით, მაგრამ ეს იქნება გაგრძელება.

ინტერფეისის ნაკლებობა. შესაძლოა, ეს საბოლოო მომხმარებლისთვის მნიშვნელოვანი მინუსია, მაგრამ სისტემის ადმინისტრატორისთვის კონსოლის პროგრამა უფრო მნიშვნელოვანია, ვიდრე სრულფასოვანი აპლიკაცია. იყო დაგეგმილი კონსოლის კომუნალური პროგრამის შექმნა, მაგრამ დარწმუნებული არ ვარ, საჭიროა თუ არა?

შედეგი?

მცირე და მარტივი ვებ სერვერი რამდენიმე ტელეფონის მოდელის API-ით მართვისთვის.

კიდევ ერთხელ, როგორ უნდა იმუშაოს ეს?

1. სონატის დაყენება.
2. ჩვენ ვქმნით json კონფიგურაციას და ვაქვეყნებთ მას სონატაში.
3. შემდეგ ჩვენ ვიღებთ უზრუნველყოფის ბმულს სონატადან.
4. შემდეგ ტელეფონში მივუთითებთ ამ ბმულს.
5. მოწყობილობა იტვირთება კონფიგურაცია

მომდევნო ოპერაციაში მხოლოდ ორი ნაბიჯია:

1. ჩვენ ვქმნით json კონფიგურაციას და ვაქვეყნებთ მას სონატაში
2. მოწყობილობა იტვირთება კონფიგურაცია

რომელი ტელეფონების პოპულარიზაცია მოხდება?

გამყიდველები Grandstream, Fanvil, Yealink. კონფიგურაციები გამყიდველში მეტ-ნაკლებად იგივეა, მაგრამ შეიძლება განსხვავდებოდეს პროგრამული უზრუნველყოფის მიხედვით - შეიძლება საჭირო გახდეს დამატებითი ტესტირება.

რა წესები შეგიძლიათ დააწესოთ?

დროით. თქვენ შეგიძლიათ მიუთითოთ დრო, სანამ კონფიგურაცია ხელმისაწვდომი იქნება.
მაკ მისამართით. მოწყობილობის პირადი ბმულის საშუალებით კონფიგურაციის გაგზავნისას, ასევე მოწმდება Mac მისამართი.
IP-ით. IP მისამართით, საიდანაც მოხდა მოთხოვნა.

როგორ ვითანამშრომლოთ სონატასთან?

API-ის საშუალებით, http მოთხოვნების შედგენა. API ხელმისაწვდომი იქნება თქვენს ინსტალაციაში. იმიტომ რომ API მხარს უჭერს swagger სპეციფიკაციას, შეგიძლიათ გამოიყენოთ ონლაინ კომუნალური API-ს სატესტო მოთხოვნებისთვის.

კარგი, მშვენივრად. მაგარი რაღაცეებია, როგორ უნდა სცადო?

უმარტივესი გზაა დოკერის გამოსახულების განლაგება საცავზე დაფუძნებული სონატა-ნიმუში. საცავი შეიცავს ინსტალაციის ინსტრუქციებს.

რა მოხდება, თუ ვიცი node.js?

თუ თქვენ გაქვთ JavaScript-ის გამოყენების გამოცდილება, მაშინ სწრაფად გაიგებთ, როგორ მუშაობს აქ ყველაფერი.

იქნება სონატას განვითარება?

ნაწილობრივ მივაღწიე ჩემს მიზნებს. შემდგომი განვითარება არის ჩემი ამოცანების საკითხი ტელეფონის დაყენების ავტომატიზაციის თემაზე. ასევე არის შესაძლებლობა გააფართოვოთ კონფიგურაციები ტელეფონის ღილაკების კონფიგურაციისთვის, დაამატეთ მისამართების წიგნის უზრუნველყოფა, შესაძლოა სხვა რამ, დაწერეთ კომენტარებში.

შეჯამება და მადლიერება

მოხარული ვიქნები მქონდეს კონსტრუქციული წინადადებები/პროტესტები/კომენტარები და კითხვები, რადგან... შესაძლოა, მან რაღაც გაუგებრად აღწერა.

ასევე მადლობას ვუხდი ყველა ჩემს კოლეგას, ვინც დაეხმარა, ურჩია, გამოსცადა და მოგვაწოდა/აჩუქა ტელეფონები ტესტებისთვის. სინამდვილეში, ბევრი ადამიანი, ვისთანაც სამსახურში მქონდა ურთიერთობა, სხვადასხვა ხარისხით არის ჩართული პროექტში, AsterConfე, ჩეთებსა და ელ.წერილებში. მადლობა იდეებისა და აზრებისთვის.

წყარო: www.habr.com