Ne znam s čim da uporedim provisioning. Možda sa mačkom? Čini se kao da može i bez nje, ali sa njom je malo bolje. Pogotovo ako ona radi ))
Postavljanje problema:
- Želim da postavljam SIP telefone brzo, lako, i sigurno. Prilikom instalacije telefona, a pogotovo prilikom njegove ponovne konfiguracije.
- Mnogi dobavljači imaju svoje formate konfiguracija, svoje alate za generisanje konfiguracija, svoje načine zaštite konfiguracija. A ne želim da se bavim svakim od njih.
- Mnoga rešenja za provisioning, a) orijentisana su na jednog dobavljača ili jedan telefonski sistem, b) prilično su glomazno ostvarena, puno skripti, parametara, brr…
Po tački 3, daću komentar da postoje odlični sistemi za provisioning , , , gde su javno dostupni šabloni za telefone različitih dobavljača. Postoje komercijalna rešenja, gde se takođe može konfigurisati u modulu provisioning rad telefona različitih proizvođača, na primer, ATS Yeastar.
Na Habré takođe ima puno recepata o tome kako konfigurisati uređaje različitih dobavljača: , . Ali kako se kaže, sve sisteme muči fatalni nedostatak. Zato ćemo napraviti svoj bicikl.
svoj format
Kao što se kaže u xkcd, ako ne želiš da se baviš sa 14 formata — . Zato koristimo zajedničke postavke za bilo koji telefon i napravit ćemo svoj json format konfiguracije.
Otprilike ovako:
{
"key": "sdgjdeu9443908",
"token": "590sfdsf8u984",
"model": "gxp1620",
"vendor": "grandstream",
"mac": "001565113af8",
"timezone_offset": "GMT+03",
"ntp_server": "pool.ntp.org",
"status": true,
"accounts": [
{
"name": "Mobilon",
"line": 1,
"sip_register": "sip.mobilonsip.ru",
"sip_name": "sip102",
"sip_user": "sip102",
"sip_password": "4321",
"sip_auth": "sip102"
}
]
}Dakle, u bilo kom telefonu je neophodno postaviti lokalno vreme, sip linije. Ovde je sve jednostavno. Još primere možemo pogledati .
svoj provisioning server
U uputstvima proizvođača obično postoji odeljak u kojem se navodi: uzmite csv, napišite logovanje-lozinku-mac-adresu, našim proprietarnim skriptom generišite fajlove, stavite ih pod web server Apache i biće dobro.
U sledećem odeljku priručnika obično se govori da takođe možemo šifrovati generisani konfiguracioni fajl.
Ali to je sve klasika. Savremeni pristup sa smutijem i Twitterom kaže da treba napraviti gotov web server koji neće biti toliko moćan kao Apache, nego će raditi samo jednu malu stvar. Formirati i slati konfiguracije putem linka.
Zaustavimo se ovdje i sjetimo se da skoro svi SIP telefoni sada mogu dobiti konfiguracije putem http/https, tako da druge implementacije (ftp, tftp, ftps) ne razmatramo. Svaki telefon zna svoju MAC adresu. Stoga ćemo napraviti dva linka: jedan personalizirani — po ključi uređaja, drugi zajednički, koji radi na poveznici zajedničkog tokena i MAC adrese.
Također, neću se zadržavati na zero-config, tj. postavkama telefona "od nule", tj. samo ga priključite u mrežu i on odmah radi. Ne, u mom scenariju, priključite ga u mrežu, izvršite prethodne postavke (konfigurirajte ga da dobije konfiguraciju s provizionog servera), a zatim pijete piña coladu i ponovo konfigurirate telefon kako treba preko provizije. Davanje Option 66 je briga DHCP servera.
Inače, umorio sam se govoriti "provisioning", pa se riječ skratila na "proviziju", nemojte me, molim vas, udarati nogama.
I još: naš provizijski server nema UI, tj. korisničkog sučelja. Možda, jednom, ali nisam siguran, jer mi nije potrebno. Međutim, postoji API za čuvanje/brisanje postavki, dobivanje liste podržanih dobavljača, modela, sve je opisano prema pravilima swagger specifikacije.
Zašto API, a ne UI? Pošto već imam svoj telefonski sistem, imam izvor vjerodajnica, gdje mogu uzeti te podatke, sastaviti potrebni JSON i objaviti na provizionom serveru. A već server provizije, prema pravilima navedenim u JSON datoteci, izdat će odgovarajućem uređaju njegovu konfiguraciju ili neće, ako uređaj nije ispravan, ili ne odgovara kriterijima navedenim također u ovom JSON-u.

Evo kakav je napravljen mikroservis za proviziju. Zove se , izvorni kod je dostupan na GitHub-u, također postoji , primjer korištenja dockera .
Ključne karakteristike:
u svakom slučaju ograničen pristup konfiguraciji po vremenu, po defaultu 10 minuta. Ako želite ponovo učiniti konfiguraciju dostupnom — ponovo objavite konfiguraciju.
jedan format za sve dobavljače, sve prilagodbe su uklonjene u sonata, šaljete standardizirani JSON, postavljate bilo koju dostupnu opremu.
sve pružene konfiguracije uređajima se evidentiraju, sve problematične tačke se mogu vidjeti u logu i vidjeti greške.
moguće je korištenje jednog zajedničkog linka s tokenom, svaki telefon dobiva svoju konfiguraciju, navodeći mac-adresu. Ili personalizirani link po ključu.
API za upravljanje i izdavanje konfiguracija telefonima su odvojeni po portovima.
Testovi. Za mene je bilo veoma važno fiksirati format izdane konfiguracije i pokriti sve uobičajene situacije izdavanja konfiguracije testovima. Da bi to sve radilo kako treba.
Mane:
Trenutno se ne koristi enkripcija u okviru sonate. Tj. naravno, možete početi koristiti https, postavljajući, na primjer, nginx ispred sonate. Ali, neki specifični načini još nisu aktivirani. Zašto? Projekat je još mlad, postavljen je tek ne znam ni sam koliko uređaja. I naravno, prikupjam ideje, povratne informacije. Dalje, da bi sve bilo sigurno, da se konfiguracije ne mogu prisluškivati u mreži, verovatno bi trebalo razmisliti o ključevima enkripcije, tls-u i sličnim stvarima, ali to će biti nastavak.
Nedostatak UI-a. Moguće je da je to značajan nedostatak za krajnjeg korisnika, ali za sistemskog administratora verovatno je važnija konzolna alatka nego potpuno razvijena aplikacija. Pravo je bilo planirati izradu konzolne alatke, ali nisam siguran da li je to potrebno?
Šta na kraju?
Mali i jednostavni web server za provođenje nekoliko modela telefona s API-jem za upravljanje.
Još jednom, kako to treba raditi?
- Instaliramo sonatu.
- Formiramo json-konfiguraciju i objavljujemo je u sonati.
- Zatim dobijamo od sonate link za provođenje.
- Zatim taj link navodimo u telefonskom aparatu.
- Aparat preuzima konfiguraciju.
u kasnijem radu samo dva koraka:
- Formiramo json-konfiguraciju i objavljujemo je u sonati.
- Aparat preuzima konfiguraciju.
Koji telefoni se provode?
Proizvođači Grandstream, Fanvil, Yealink. Konfiguracije unutar proizvođača su više-manje jednake, ali se mogu razlikovati u zavisnosti od firmware-a — možda će biti potrebno dodatno testirati.
Koja pravila mogu da se postave?
Po vremenu. Možete odrediti vreme do kada će konfiguracija biti dostupna.
Po mac-adresi. Pri dostavi konfiguracije putem personalizovanog linka, uređaj će takođe proveriti mac-adresu.
Po ip. Po ip-adresi sa koje je zahtjev poslat.
Kako komunicirati sa sonatom?
Preko API-ja, pravite http zahtjeve. API će biti dostupan u vašoj instalaciji. Pošto API podržava swagger specifikaciju, možete koristiti za testne zahtjeve prema API-ju.
U redu, odlična stvar, kako da probam?
Najlakši način za pokretanje docker slike na osnovu repozitorija . U repozitoriju se nalazi uputstvo za instalaciju.
А если знаю node.js?
Ako imate iskustva sa JavaScript-om, brzo ćete se snaći u svemu ovome.
Hoće li biti razvoja sonate?
Djelimično sam postigao svoje ciljeve. Dalji razvoj je pitanje mojih zadataka u vezi sa automatizacijom podešavanja telefona. Ima još mogućnosti za proširenje konfiguracija za podešavanje dugmadi na telefonu, dodavanje provizije adresara, možda još što, pišite u komentarima.
Rezime i zahvalnice
Biću rad da primim konstruktivne predloge/-nategove/-komentar i pitanja, jer može biti da nisam nešto dovoljno jasno opisao.
Takođe izražavam zahvalnost svim kolegama koji su pomagali, savetovali, testirali, obezbedili/poklonili telefone za testove. Zaista, projektom su u različitoj meri uključeni mnogi ljudi s kojima sam komunicirao na poslu, u chatovima i email-ovima. Hvala na idejama i mislima.
Izvor: habr.com
