Sonata – SIP varustamise server

Ma ei tea, millega provisioning'it võrrelda. Võib-olla kassiga? Tundub, et ilma selleta võib küll, aga sellega on natuke parem. Eriti kui ta töötab ))

Probleemi püstitus:

1. Soovin SIP-telefone kiiresti, lihtsalt ja turvaliselt seadistada. Telefoni paigaldamisel ja eriti selle uue konfigureerimise puhul.
2. Paljudel tootjatel on oma konfiguratsiooniformaadid, oma utiliidid konfiguratsioonide genereerimiseks, oma viisid konfiguratsioonide kaitsmiseks. Ja igaga tegelemine ei tõota väga huvitav olla.
3. Paljud provisioning'u lahendused, a) on suunatud ühele tootjale või ühele telefonisüsteemile, b) realiseeruvad üsna kohmakaid, hunnik skripte, parameetreid, jee...

Punkti 3 kohta annan kommentaari, et on suurepäraseid provisioning süsteeme FreePBX jaoks, FusionPBX jaoks, Kazoo jaoks, kus on avatud ligipääsuga mallid erinevate tootjate telefonide jaoks. On ka kommertslahendusi, kus saab samuti seadistada erinevate tootjate telefonide tööd provisioning moods, näiteks Yeastar PBX.

Habr's on samuti palju retsepte, kuidas seadistada erinevate tootjate aparatuure: üks, kaks. Aga nagu öeldakse, kõigil süsteemidel on surmav puudus. Seega teeme oma jalgratta.

oma formaat

Nagu xkcd-s öeldakse, kui sul pole tahtmist tegeleda 14 formaadiga — mõtle 15. välja. Seega kasutame üldiseid seadistusi igale telefonile ja loome oma json-formaadi konfiguratsiooni.

Umbes selline:

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

Nii et igas telefonis on vajalik seadistada kohalik aeg, sip-jooned. Siin on kõik lihtne. Veel näiteid saab vaadata siin.

oma provisioning server

Tootja manuaalides on tavaliselt punkt, kus öeldakse: võtke csv, kirjutage sinna login-parool-maci-aadress, genereerige meie spetsiaalse skripti abil failid, pange need Apache veebiserverisse ja kõik on hästi.

Järgmisel manuaali punktis räägitakse tavaliselt sellest, et genereeritud konfiguratsioonifaili on võimalik ka krüpteerida.

Aga see on kõik klassika. Kaasaegne lähenemine smuutide ja Twitteri mõttes ütleb, et tuleb luua valmis veebiserver, mis ei ole nii võimas kui Apache, vaid teeb ainult ühte väikest asja. Kujundab ja annab konfigureeringud linkide kaudu.

Siin peatume ja meenutame, et peaaegu kõik SIP-telefonid saavad nüüd konfigureerimisi http/https kaudu, seega me teisi teostusi (ftp, tftp, ftps) ei käsitle. Igal telefonil on oma MAC-aadress. Seetõttu loome kaks linki: üks isiklik — seadme võtme kaudu, ja teine üldine, mis töötab koos üldise tokeni ja MAC-aadressiga.

Ma ei peatuks ka zero-config'i ehk telefoni seadistamise «nullist», st te pistate selle võrku ja see töötab. Ei, minu stsenaariumis, te pistate selle võrku, teete esialgse seadistamise (seadistate selle saama konfi teenuselt), ja seejärel joote pina coladat ja seadistate telefoni nagu vaja läbi provision'i. Option 66 jagamine on DHCP-serveri ülesanne.

Muide, olen täiesti tüdinud öeldes «provisioning», seetõttu lühenes sõna «provision», palun ärge ilumise jalaga virutage.

Ja veel: meie provision-serveril ei ole UI-d, st kasutajaliidest. Võib-olla kunagi, aga pole kindel, kuna mul seda ei ole vaja. Selle asemel on olemas API seadete salvestamiseks/kustutamiseks, toetatavate tootjate, mudelite loendi saamiseks, kõik on kirjeldatud swagger spetsifikatsiooni reeglite järgi.

Miks API, mitte UI? Kuna mul on juba oma telefonisüsteem, siis mul on allikaid, kust võtta neid andmeid, koostada vajalik JSON ja avaldada provision-serveris. Ja provision-server juba reeglite järgi, mis on määratletud JSON-failis, annab vajalikule seadmele selle konfi või ei anna, kui seade ei ole õige või ei vasta ka kriteeriumitele, mis on samuti antud selles JSON'is.

Nii et see on selline provision-mikroteenus. Nimeks sonata, algkood on saadaval GitHubis, samuti on olemas valmis dokkeri pilt, näide dockeri kasutamisest siin.

Peamised funktsioonid:

• igaühel on igal juhul ajaliselt piiratud juurdepääs konfigile, vaike aeg on 10 minutit. Kui soovite uuesti konfi kätte saada, avaldage konfiguratsioon taas.

• üks formaat kõigi tootjate jaoks, kogu kohandamine on viidud sonatasse, saadate standardiseeritud JSON-i, seadistate mis tahes saadaval olevat seadmet.

• kõik seadmetele antud konfigid logitakse, kõik probleemsed kohad on logis vaadatavad ja vead nähtavad.

• võimalik kasutada ühte üldist linki koos tokeniga, iga telefon saab oma konfigureerimise, märkides mac-aadressi. Või isiklik linki key järgi.

• API telefonide haldamiseks (management) ja konfigureerimise (provisioning) andmiseks on jagatud portide kaupa.

• Testid. Minu jaoks oli väga oluline fikseerida välja antud konfigureerimise vorming ja katta kõik tavalised konfigureerimise andmise olukorrad testidega. Selleks, et kõik töötaks selgelt.

Miinused:

Praegu ei kasutata sonata raames krüpteerimist. See tähendab, et muidugi saate alustada https-i kasutamist, paigaldades näiteks nginx sonata ette. Kuid kaubanduslikud meetodid pole veel kasutusele võetud. Miks? Projekt on veel noor, on konfigureeritud vaid paar sadu seadmeid. Ja kogun muidugi ideid ja tagasisidet. Edasi, et kõik oleks turvaline, et konfigureerimisi ei saaks võrgu pealt nuhkida, on tõenäoliselt mõttekas vaeva nähagi krüptimisvõtmete, TLS ja muude asjadega, kuid see on jätk.

UI puudumine. See võib olla lõppkasutaja jaoks oluline miinus, kuid süsteemiadministraatori jaoks on tõenäoliselt tähtsam käsurea utiliit kui täielik rakendus. Käsurea utiliidi loomine oli plaanides, kuid ei ole kindel, kas see on vajalik?

Kokkuvõttes?

Väike ja lihtne veebiserver mitme telefonimudeli konfigureerimiseks koos API-ga haldamiseks.

Kordame, kuidas see peaks töötama?

1. Paigaldame sonata.
2. Koostame json-konfigureerimise ja avaldame selle sonatas.
3. Seejärel saame sonatalt linki konfigureerimiseks.
4. Seejärel märgime selle lingi telefoniaparaati.
5. Seade tõmbab konfigureerimise

järgnevas kasutuses vaid kaks sammu:

1. Koostame json-konfigureerimise ja avaldame selle sonatas.
2. Seade tõmbab konfigureerimise

Millised telefonid konfigureeritakse?

Müüjad Grandstream, Fanvil, Yealink. Konfigureerimised müüja raames on enam-vähem ühte moodi, kuid võivad sõltuda versioonist — võib-olla on vajalik täiendav testimine.

Milliseid reegleid on võimalik seadistada?

Aja järgi. Saate määrata aja, millal konfigureerimine on kättesaadav.
Mac-aadressi järgi. Isikliku lingi kaudu konfigureerimise andmisel kontrollitakse samuti seadme mac-aadressi.
IP järgi. IP-aadressi põhjal, kust päring tehti.

Kuidas sonataga suhelda?

API kaudu, tehes http päringuid. API on teie installatsioonis saadaval. Kuna API toetab swagger spetsifikatsiooni, saate kasutada online-ülevaatusriista API testpäringute tegemiseks.

Ok, suurepärane. Asja on lahe, kuidas proovida?

Lihtsaim on käivitada docker-pilt, mis põhineb hoidlas sonata-sample. Hoidlas on paigaldusjuhend.

А если знаю node.js?

Kui sul on JavaScripti kasutamises kogemusi, siis sa saad kiiresti aru, kuidas siin kõik toimib.

Kas sonata areneb edasi?

Olen osaliselt oma eesmärke saavutanud. Edasiarendus on seotud minu ülesannetega telefonide seadistamise automatiseerimise teemal. On veel võimalus laiendada konfigureerimist telefoninuppude seadistamiseks, lisada teenuse osutamise kontaktide aadressiraamat, võib-olla veel midagi — kirjuta kommentaarides.

Kokkuvõte ja tänusõnad

Olen avatud konstruktiivsetele ettepanekutele/vastuväidetele/kommentaaridele ja küsimustele, kuna võib olla, et olen midagi ebaselgelt kirjeldanud.

Tänan kõiki kolleege, kes aitasid, nõustasid, testisid, pakkusid/kingitasid testimiseks telefone. Tõeliselt on projekti seotud mitmed inimesed, kellega ma olen töötanud, vestelnud, AsterConfvestluste ja e-kirjade kaudu. Aitäh ideede ja mõtete eest.

Allikas: habr.com