- Domov
- /
- Článok
Konfigurácia nastavení profilu pre telefóny radu 9800 a 8875 (BroadWorks)
Tento článok Pomocníka je určený pre Cisco stolový telefón série 9800 a Cisco videotelefón 8875 registrovaný na Cisco BroadWorks. Informácie na tejto stránke zahŕňajú opätovnú synchronizáciu profilu, manuálne použitie profilu a syntax konfigurácie.
Konfigurácia telefónu na opätovnú synchronizáciu profilu
Opätovná synchronizácia profilu telefónu cez TFTP
Telefón podporuje viacero sieťových protokolov na načítanie konfiguračných profilov. Najzákladnejší protokol prenosu profilu je TFTP (RFC1350). TFTP je široko používaný na poskytovanie sieťových zariadení v súkromných sieťach LAN. Hoci sa neodporúča nasadenie vzdialených koncových bodov na internete, TFTP môže byť vhodné na nasadenie v malých organizáciách, na interné predbežné poskytovanie a na vývoj a testovanie. V nasledujúcom postupe sa profil zmení po stiahnutí súboru zo servera TFTP.
| 1 |
V prostredí siete LAN pripojte počítač a telefón k rozbočovaču, prepínaču alebo malému smerovaču. |
| 2 |
V počítači nainštalujte a aktivujte server TFTP. |
| 3 |
Použite textový editor na vytvorenie konfiguračného profilu. Ak chcete overiť, či bol profil neskôr poskytnutý v telefóne, môžete niektoré hodnoty nastaviť ako značky. Nastavte napríklad hodnotu pre GPP_A na hodnotu 12345678, ako je znázornené v nasledujúcom príklade:
|
| 4 |
Uložte konfiguračný súbor XML do koreňového adresára servera TFTP. Môžete overiť, či je server TFTP správne nakonfigurovaný: požiadajte o súbor konfiguračného profilu pomocou iného klienta TFTP ako telefónu. Prednostne použite klienta TFTP, ktorý beží na hostiteľovi oddelenom od poskytujúceho servera. |
| 5 |
Vo webovom prehliadači na počítači otvorte administračnú webovú stránku. Ak napríklad predpokladáte, že adresa IP telefónu je 192.168.1.100, otvorte vo webovom prehliadači nasledujúcu adresu URL:
|
| 6 |
Vyberte možnosť Tab a skontrolujte hodnoty všeobecných parametrov GPP_A prostredníctvom GPP_P. Tieto by mali byť prázdne. |
| 7 |
Znova synchronizujte testovací telefón s konfiguračným profilom, ktorý ste vytvorili otvorením URL adresy na opätovnú synchronizáciu vo webovom prehliadači. Príklad: Ak je adresa IP servera TFTP 192.168.1.200, príkaz by mal byť podobný nasledujúcemu príkladu:
Keď telefón prijme tento príkaz, zariadenie na adrese 192.168.1.100 požiada o súbor |
| 8 |
Skontrolujte, či bol parameter správne aktualizovaný. Obnovte webovú stránku správy a prejdite na . Parameter GPP_A by teraz mal obsahovať hodnotu 12345678. |
Zriadenie profilu špecifického pre telefón na serveri TFTP
| 1 |
Získajte MAC adresu telefónu zo štítku produktu. (Adresa MAC je číslo, ktoré používa čísla a malé hexadecimálne číslice, napríklad 000e08aabbcc. |
| 2 |
Premenujte konfiguračný súbor na Príklad:
|
| 3 |
Presuňte nový súbor do virtuálneho koreňového adresára servera TFTP. |
| 4 |
Prejdite na webovú stránku správy telefónu. |
| 5 |
Vyberte položku ). |
| 6 |
Zadajte cestu k súboru profilu do poľa Pravidlo profilu. Príklad: Predpokladajme, že adresa TFTP servera IP je 192.168.1.200 a názov súboru profilu je
|
| 7 |
Kliknite na možnosť Odoslať všetky zmeny. To spôsobí okamžitý reštart a resynchronizáciu. Pri ďalšej synchronizácii telefón načíta nový súbor rozbalením výrazu makra $MA na svoju adresu MAC. |
Opätovná synchronizácia profilu telefónu s HTTP GET
| 1 |
Nainštalujte HTTP server na lokálny počítač alebo iného prístupného hostiteľa. Open source server Apache je možné stiahnuť z internetu. |
| 2 |
Nahrajte súbor konfiguračného profilu do virtuálneho koreňového adresára nainštalovaného servera. |
| 3 |
Ak chcete overiť správnu inštaláciu servera a prístup k súboru profilu, otvorte profil pomocou webového prehliadača. |
| 4 |
Upravte Profile_Rule testovacieho telefónu tak, aby smeroval na server HTTP namiesto servera TFTP, aby ste mohli pravidelne sťahovať jeho profil. Napríklad za predpokladu, že server HTTP je na 192.168.1.300 a názov súboru profilu je basic.txt, zadajte nasledujúcu hodnotu:
|
| 5 |
Kliknite na možnosť Odoslať všetky zmeny. To spôsobí okamžitý reštart a resynchronizáciu. |
| 6 |
Sledujte hlásenia syslogu, ktoré telefón odosiela. Pravidelná resynchronizácia by teraz mala získavať profil zo servera HTTP. |
| 7 |
V denníkoch servera HTTP sledujte, ako sa informácie, ktoré identifikujú testovací telefón, zobrazujú v denníku agentov používateľov. Tieto informácie by mali zahŕňať výrobcu, názov produktu, aktuálnu verziu firmvéru a sériové číslo. |
Automatická opätovná synchronizácia profilu telefónu
Zariadenie sa môže pravidelne synchronizovať s poskytujúcim serverom, aby sa zabezpečilo, že všetky zmeny profilu vykonané na serveri sa rozšíria do koncového zariadenia (na rozdiel od odoslania explicitnej požiadavky na opätovnú synchronizáciu koncovému bodu).
Aby sa telefón pravidelne opakoval so serverom, pomocou parametra Profile_Rule sa definuje adresa URL konfiguračného profilu a pomocou parametra Resync_Periodic sa definuje doba opakovanej synchronizácie.
| 1 |
Prejdite na webovú stránku správy telefónu. |
| 2 |
Vyberte položku ). |
| 3 |
Definujte parameter Profile_Rule. Tento príklad predpokladá adresu TFTP servera IP 192.168.1.200. |
| 4 |
Do poľa Periodická synchronizácia zadajte malú hodnotu na testovanie, napríklad 30 sekúnd. |
| 5 |
Kliknite na položku Odoslať všetky zmeny. Po nastavení nových parametrov sa telefón dvakrát za minútu znova synchronizuje s konfiguračným súborom zadaným v adrese URL. |
| 6 |
Sledujte výsledné hlásenia v sledovaní syslogu. |
| 7 |
Uistite sa, že pole Obnoviť synchronizáciu pri resetovaní je nastavené na hodnotu Áno.
|
| 8 |
Vypnite a znova zapnite telefón, aby ste vynútili jeho opätovnú synchronizáciu s obstarávacím serverom. Ak operácia resynchronizácie z akéhokoľvek dôvodu zlyhá, napríklad ak server neodpovedá, jednotka počká (počet sekúnd nakonfigurovaných v časti Oneskorenie opakovania chyby synchronizácie), kým sa pokúsi o opätovnú synchronizáciu. Ak je chyba opakovanej synchronizácie Oneskorenie opakovania nula, telefón sa nepokúsi o opätovnú synchronizáciu po neúspešnom pokuse o opätovnú synchronizáciu. |
| 9 |
(Voliteľné) Nastavte hodnotu poľa Chyba synchronizácie Oneskorenie pokusu o opakovanie na malé číslo, napríklad 30.
|
| 10 |
Zakážte server TFTP a sledujte výsledky vo výstupe syslogu. |
Parametre resynchronizácie profilu
Nasledujúca tabuľka definuje funkciu a použitie parametrov resynchronizácie profilu v časti Profil konfigurácie pod položkou Tab na webovej stránke telefónu. Definuje tiež syntax reťazca, ktorý sa pridá do konfiguračného súboru telefónu (cfg.xml) s kódom XML na konfiguráciu parametra.
|
Parameter |
Popis |
|---|---|
|
Povoliť poskytovanie |
Povoľuje alebo zakazuje akcie opätovnej synchronizácie konfiguračného profilu.
Predvolená hodnota: Áno |
|
Resynchronizovať pri resetovaní |
Určuje, či telefón opätovne synchronizuje konfigurácie s poskytujúcim serverom po zapnutí a po každom pokuse o aktualizáciu.
Predvolená hodnota: Áno |
|
Resynchronizácia náhodného oneskorenia |
Zabraňuje preťaženiu poskytujúceho servera, keď sa súčasne zapne veľký počet zariadení a pokúsi sa o počiatočnú konfiguráciu. Toto oneskorenie je účinné iba pri počiatočnom pokuse o konfiguráciu po zapnutí alebo resetovaní zariadenia. Parameter je maximálny časový interval, ktorý zariadenie čaká, kým nadviaže kontakt s poskytujúcim serverom. Skutočné oneskorenie je pseudonáhodné číslo medzi 0 a touto hodnotou. Tento parameter je v jednotkách po 20 sekundách. Platná hodnota sa pohybuje medzi 0 a 65535.
Predvolená hodnota je 2 (40 sekúnd). |
|
Resynchronizovať o (HHmm) |
Čas (HHmm), počas ktorého sa telefón znova synchronizuje s poskytujúcim serverom. Hodnota pre toto pole musí byť štvormiestne číslo v rozsahu od 0000 do 2400 na označenie času vo formáte HHmm. Napríklad 0959 označuje 09:59.
Predvolená hodnota je prázdna. Ak je hodnota neplatná, parameter sa ignoruje. Ak je tento parameter nastavený s platnou hodnotou, parameter Periodická synchronizácia sa ignoruje. |
|
Resynchronizácia s náhodným oneskorením |
Zabraňuje preťaženiu poskytujúceho servera, keď sa súčasne zapína veľký počet zariadení. Aby sa zabránilo zaplaveniu požiadaviek na opakovanú synchronizáciu na server z viacerých telefónov, telefón sa znova synchronizuje v rozsahu medzi hodinami a minútami a hodinami a minútami plus náhodným oneskorením (hhmm, hhmm + random_delay). Ak napríklad náhodné oneskorenie = (Resynchronizovať pri náhodnom oneskorení + 30)/60 minút, vstupná hodnota v sekundách sa skonvertuje na minúty, pričom na výpočet posledného intervalu random_delay sa zaokrúhli nahor na nasledujúcu minútu.
Platná hodnota sa pohybuje medzi 600 a 65535. Ak je hodnota menšia ako 600, náhodné oneskorenie je medzi 0 a 600. Predvolená hodnota je 600 sekúnd (10 minút). |
|
Periodická resynchronizácia |
Časový interval medzi pravidelnou opakovanou synchronizáciou s poskytujúcim serverom. Priradený časovač resynchronizácie je aktívny až po prvej úspešnej synchronizácii so serverom. Platné formáty sú nasledovné:
Nastavte tento parameter na nulu, aby ste zakázali pravidelnú opakovanú synchronizáciu. Predvolená hodnota je 3600 sekundy. |
|
Chyba opätovnej synchronizácie Oneskorenie opakovania |
Ak operácia opätovnej synchronizácie zlyhá, pretože telefón nedokázal načítať profil zo servera, prevzatý súbor je poškodený alebo sa vyskytne vnútorná chyba, telefón sa pokúsi o opätovnú synchronizáciu po zadanom čase v sekundách. Platné formáty sú nasledovné:
Ak je oneskorenie nastavené na 0, zariadenie sa po neúspešnom pokuse o opätovnú synchronizáciu nepokúsi znova synchronizovať.
Predvolené: 60,120,240,480,960,1920,3840,7680,15360,30720,61440,86400 |
|
Oneskorenie nútenej resynchronizácie |
Maximálne oneskorenie (v sekundách), ktoré telefón počká pred vykonaním resynchronizácie. Zariadenie sa nesynchronizuje, kým je aktívna niektorá z jeho telefónnych liniek. Keďže resynchronizácia môže trvať niekoľko sekúnd, je žiaduce pred opätovnou synchronizáciou počkať, kým zariadenie nebude dlhšiu dobu nečinné. To umožňuje používateľovi uskutočňovať hovory postupne bez prerušenia. Zariadenie má časovač, ktorý začne odpočítavať, keď sa všetky jeho linky stanú nečinnými. Tento parameter je počiatočná hodnota počítadla. Udalosti opätovnej synchronizácie sa oneskoria, kým toto počítadlo neklesne na nulu. Platná hodnota sa pohybuje medzi 0 a 65535.
Predvolená hodnota je 14,400 sekundy. |
|
Resynchronizácia z SIP |
Riadi požiadavky na operácie opätovnej synchronizácie prostredníctvom udalosti SIP NOTIFY odoslanej z proxy servera poskytovateľa služieb do telefónu. Ak je táto možnosť povolená, server proxy môže požiadať o opätovnú synchronizáciu odoslaním správy SIP NOTIFY obsahujúcej hlavičku Udalosť: opätovná synchronizácia do zariadenia.
Predvolená hodnota: Áno |
|
Opätovná synchronizácia po pokuse o inováciu |
Povolí alebo zakáže operáciu opätovnej synchronizácie po vykonaní akejkoľvek aktualizácie. Ak je vybratá možnosť Áno , synchronizácia sa spustí po inovácii firmvéru.
Predvolená hodnota: Áno |
|
Spúšťač resynchronizácie 1 Spúšťač opätovnej synchronizácie 2 |
Ak sa logická rovnica v týchto parametroch vyhodnotí ako nepravda, opätovná synchronizácia sa nespustí ani vtedy, keď je položka Pri obnovení nastavená na hodnotu TRUE. Tieto spúšťače opätovnej synchronizácie ignoruje iba opätovná synchronizácia prostredníctvom adresy URL priamej akcie a upozornenia SIP. Parametre je možné naprogramovať pomocou podmieneného výrazu, ktorý prechádza makro rozšírením. Platné makro rozšírenia nájdete v časti Premenné rozšírenia makier v časti Parametre poskytovania.
Predvolené: Prázdne |
|
Používateľom konfigurovateľná resynchronizácia |
Umožňuje používateľovi resynchronizovať telefón z ponuky na obrazovke telefónu. Ak je nastavená možnosť Áno, používateľ môže znova synchronizovať konfiguráciu telefónu zadaním pravidla profilu z telefónu. Ak je parameter Pravidlo profilu nastavenýna hodnotu Nie , nezobrazuje sa v ponuke na obrazovke telefónu.
Predvolená hodnota: Áno |
|
Resynchronizácia na FNF zlyhala |
Resynchronizácia sa zvyčajne považuje za neúspešnú, ak požadovaný profil nie je prijatý zo servera. Tento parameter prepíše toto správanie. Keď je nastavená na hodnotu Nie, zariadenie akceptuje odpoveď zo servera
Predvolená hodnota: Áno |
|
Typ overenia profilu |
Určuje poverenia, ktoré sa použijú na overenie profilového konta. Dostupné možnosti sú:
Predvolené: Základné overovanie HTTP Ďalšie informácie nájdete v časti Zadanie typu overenia profilu v časti Určenie telefónu na opätovnú synchronizáciu profilu. |
|
Pravidlo profilu Pravidlo profilu B Pravidlo profilu C Pravidlo profilu D |
Každé pravidlo profilu informuje telefón o zdroji, z ktorého má získať profil (konfiguračný súbor). Počas každej operácie opätovnej synchronizácie telefón použije všetky profily postupne. Ak na konfiguračné súbory používate šifrovanie AES-256-CBC, zadajte šifrovací kľúč s kľúčovým slovom
Šifrovací kľúč môžete voliteľne uzavrieť do dvojitých úvodzoviek (").
Predvolené nastavenie: |
|
DHCP Možnosť použitia |
Možnosti DHCP oddelené čiarkami, ktoré sa používajú na načítanie firmvéru a profilov. Predvolené: 66,160,159,150,60,43,125 |
|
Možnosť použitia DHCPv6 |
Možnosti DHCP oddelené čiarkami, ktoré sa používajú na načítanie firmvéru a profilov. Predvolené: 17,160,159 |
Poskytovanie prostredníctvom Cisco XML
Telefóny môžete zriaďovať prostredníctvom funkcií Cisco XML.
Objekt XML môžete do telefónu odoslať paketom SIP Notify alebo HTTP POST do rozhrania CGI telefónu: http://PhoneIPAddress/CGI/Execute.
CP-xxxx-3PCC rozširuje funkciu Cisco XML na podporu poskytovania prostredníctvom objektu XML:
<CP-xxxx-3PCCExecute> <ExecuteItem URL=Resync:[pravidlo-profil]/> </CP-xxxx-3PCCExecute>
Keď telefón prijme objekt XML, stiahne obstarávací súbor z [pravidlo profilu]. Toto pravidlo používa makrá na zjednodušenie vývoja aplikácie XML služieb.
Rozlíšenie URL s makro rozšírením
Podadresáre s viacerými profilmi na serveri poskytujú pohodlnú metódu na správu veľkého počtu nasadených zariadení. Adresa URL profilu môže obsahovať:
-
Názov poskytujúceho servera alebo explicitná adresa IP. Ak profil identifikuje poskytujúci server podľa názvu, telefón vykoná vyhľadávanie DNS na rozpoznanie názvu.
-
Neštandardný port servera, ktorý je zadaný v adrese URL pomocou štandardnej syntaxe
:p ortnasledujúcej za názvom servera. -
Podadresár virtuálneho koreňového adresára servera, v ktorom je uložený profil, určený pomocou štandardného zápisu URL a spravovaný makro rozšírením.
Napríklad nasledujúci Profile_Rule vyžaduje súbor profilu ($PN.cfg) v podadresári servera/Cisco/config zo servera TFTP, ktorý je spustený na hostiteľovi prov.telco.com a počúva pripojenie na porte 6900:
<Profile_Rule>
tftp://prov.telco.com:6900/cisco/config/$PN.cfg
</Profile_Rule>
Profil pre každý telefón môže byť identifikovaný v univerzálnom parametri, pričom jeho hodnota je uvedená v rámci pravidla spoločného profilu pomocou makro rozšírenia.
Predpokladajme napríklad, že GPP_B je definované ako Dj6Lmp23Q.
Profile_Rule má hodnotu:
TFTP://prov.telco.com/cisco/$B/$MA.cfg
Po opätovnej synchronizácii zariadenia a rozbalení makier telefón s adresou MAC 000e08012345 požiada o profil s názvom, ktorý obsahuje adresu MAC zariadenia na nasledujúcej adrese URL:
TFTP://prov.telco.com/cisco/Dj6Lmp23Q/000e08012345.cfg
Zadajte typ overenia profilu
Overenie profilu umožňuje používateľom telefónu opätovne synchronizovať obstarávací profil s telefónom. Informácie o overení sa vyžadujú, keď sa telefón pokúša o opätovnú synchronizáciu a prevzatie konfiguračného súboru prvýkrát a zobrazí sa chyba overenia HTTP alebo HTTPS 401. Keď zapnete túto funkciu, v telefóne sa zobrazí obrazovka nastavenia profilového konta v nasledujúcich situáciách:
-
Keď sa počas prvého poskytovania po reštarte telefónu vyskytne chyba overenia HTTP alebo HTTPs 401
-
Keď je používateľské meno a heslo profilového účtu prázdne
-
Ak v pravidle profilu nie je žiadne meno používateľa a heslo
Ak obrazovku nastavenia profilového konta zmeškáte alebo ignorujete, používateľ môže získať prístup k obrazovke nastavenia aj prostredníctvom ponuky na obrazovke telefónu alebo k kontextovému tlačidlu Nastavenie , ktoré sa zobrazí iba vtedy, keď v telefóne nie je zaregistrovaná žiadna linka.
Keď túto funkciu vypnete, obrazovka nastavenia profilového konta sa v telefóne nezobrazí.
Prihlasovacie meno a heslo v poli Pravidlo profilu majú vyššiu prioritu ako profilový účet.
-
Ak do poľa Pravidlo profilu zadáte správnu adresu URL bez mena používateľa a hesla, telefón vyžaduje overenie alebo overenie na opätovnú synchronizáciu profilu. So správnym profilovým účtom prebehne overenie. Pri nesprávnom profile účte overenie zlyhá.
-
Ak do poľa Pravidlo profilu zadáte správnu adresu URL so správnym menom používateľa a heslom, telefón vyžaduje overenie alebo overenie na opätovnú synchronizáciu profilu. Profilové konto sa nepoužíva na opätovnú synchronizáciu telefónu. Prihlásenie bolo úspešné.
-
Ak do poľa Pravidlo profilu zadáte správnu adresu URL s nesprávnym menom používateľa a heslom, telefón vyžaduje overenie alebo overenie na opätovnú synchronizáciu profilu. Konto profilu sa nepoužíva na opätovnú synchronizáciu telefónu. Prihlásenie vždy zlyhá.
-
Ak do poľa Pravidlo profilu zadáte nesprávnu adresu URL, prihlásenie vždy zlyhá.
Parametre v konfiguračnom súbore telefónu môžete tiež nakonfigurovať pomocou kódu XML (cfg. xml).
Typ overenia profilu môžete určiť na webovej stránke správy telefónu.
| 1 |
Prejdite na webovú stránku správy telefónu. |
| 2 |
Vyberte položku ). |
| 3 |
V časti Konfiguračný profil nastavte parameter Typ overenia profilu a zadajte poverenia, ktoré sa použijú na overenie konta profilu. Tento parameter môžete nakonfigurovať v súbore konfigurácie telefónu XML (cfg.XML) zadaním reťazca v tomto formáte:
Možnosti:
Predvolené: Základné overovanie HTTP |
| 4 |
Kliknite na možnosť Odoslať všetky zmeny. |
Manuálne použitie profilu v telefóne
Stiahnite si konfiguračný súbor do telefónu zo servera TFTP
Ak chcete stiahnuť konfiguračný súbor do serverovej aplikácie TFTP v počítači, postupujte podľa týchto krokov.
| 1 |
Pripojte počítač k portu LAN na telefóne. |
| 2 |
Spustite v počítači serverovú aplikáciu TFTP a uistite sa, že konfiguračný súbor je k dispozícii v koreňovom adresári TFTP. |
| 3 |
Vo webovom prehliadači zadajte adresu IP telefónnej siete LAN, adresu IP počítača, názov súboru a prihlasovacie údaje. Použite tento formát:
Príklad:
|
Stiahnite si konfiguračný súbor do telefónu pomocou cURL
Ak chcete prevziať konfiguráciu do telefónu pomocou adresy cURL, postupujte podľa týchto krokov. Tento nástroj príkazového riadka sa používa na prenos údajov so syntaxou adresy URL. Ak si chcete stiahnuť cURL, navštívte:
https://curl.haxx.se/download.html
Odporúčame, aby ste nepoužívali cURL na POST konfigurácie telefónu, pretože používateľské meno a heslo sa môžu zachytiť pri používaní adresy cURL.
| 1 |
Pripojte počítač k portu LAN na telefóne. |
| 2 |
Stiahnite si konfiguračný súbor do telefónu zadaním nasledujúceho príkazu cURL:
|
Referencie pre konfiguráciu profilu
Telefón prijíma konfigurácie vo formáte XML.
V príkladoch v tejto časti sa používajú konfiguračné profily so syntaxou XML.
Formáty konfiguračného profilu
Profil konfigurácie definuje hodnoty parametrov telefónu.
Formát konfiguračného profilu XML používa na zostavenie parametrov a hodnôt štandardné nástroje XML na tvorbu.
Každý telefón má inú sadu funkcií, a teda inú sadu parametrov.
Otvorený formát profilu
Profil otvoreného formátu je textový súbor so syntaxou podobnou XML v hierarchii prvkov s atribútmi prvkov a hodnotami. Tento formát umožňuje použiť štandardné nástroje na vytvorenie konfiguračného súboru. Konfiguračný súbor XML je možné odoslať z obstarávacieho servera do telefónu počas operácie resynchronizácie bez kompilácie ako binárny objekt.
Telefón môže akceptovať formáty konfigurácie generované štandardnými nástrojmi. Táto funkcia uľahčuje vývoj serverového softvéru back-end poskytovania, ktorý generuje konfiguračné profily z existujúcich databáz.
Na ochranu dôverných informácií v konfiguračnom profile poskytuje poskytujúci server konfiguračný súbor XML do telefónu prostredníctvom kanála zabezpečeného TLS. Voliteľne môže byť súbor komprimovaný pomocou algoritmu gzip deflate (RFC1951).
Súbor je možné zašifrovať jednou z týchto metód šifrovania:
-
Šifrovanie AES-256-CBC
-
Šifrovanie obsahu HTTP založené na RFC-8188 pomocou šifrovania AES-128-GCM
Konfiguračný súbor môže obsahovať tieto súčasti:
-
Značky prvkov
-
Vlastnosti
-
Parametre
-
Funkcie formátovania
-
XML komentáre
Príklad: Formát otvoreného profilu
<flat-profile> <Resync_On_Reset> Áno </Resync_On_Reset> <Resync_Periodic> 7200 </Resync_Periodic> <Profile_Rule> tftp://prov.telco.com:6900/cisco/config/CP_xxxx_MPP.cfg</Profile_Rule> </flat-profile>
Značka <plochého profilu>prvkov obklopuje všetky prvky parametrov, ktoré telefón rozpozná.
Vlastnosti značky prvku
Pri vytváraní alebo aktualizácii konfiguračného súboru majte na pamäti nasledujúce pravidlá.
-
Formát poskytovania XML a webové používateľské rozhranie umožňujú konfiguráciu rovnakých nastavení. Názvy značiek XML a názvy polí vo webovom používateľskom rozhraní sú podobné, ale líšia sa v dôsledku obmedzení názvov prvkov XML. Napríklad podčiarknutia ( _ ) v konfiguračnom súbore XML namiesto medzier vo webovom používateľskom rozhraní.
-
Telefón rozpozná prvky so správnymi názvami parametrov, ktoré sú zapuzdrené v špeciálnom
<plochom profile>prvku. -
Názvy prvkov sú uzavreté v uhlových zátvorkách.
-
Väčšina názvov prvkov je podobná názvom polí vo webovom používateľskom rozhraní telefónu s nasledujúcimi úpravami:
-
Názvy prvkov nesmú obsahovať medzery ani špeciálne znaky. Ak chcete odvodiť názov prvku z názvu webového poľa, nahraďte podčiarknutím každú medzeru alebo špeciálne znaky
[,],(,), alebo/.Príklad: Prvok <Resync_On_Reset> predstavuje pole Resync On Reset .
-
Každý názov prvku musí byť jedinečný. Vo webovom používateľskom rozhraní telefónu sa rovnaké polia môžu zobraziť na viacerých webových stránkach, ako sú napríklad stránky Linka, Používateľ a Klapka. Pripojte
[n]k názvu prvku, aby ste označili číslo, ktoré sa zobrazuje na strane Tab.Príklad: The
<Dial_Plan_1_>element predstavuje plán vytáčania pre linku 1.
-
-
Každá značka otváracieho prvku musí mať zodpovedajúcu značku uzatváracieho prvku. Príklad:
<plochý profil> <Resync_On_Reset> Áno </Resync_On_Reset> <Resync_Periodic> 7200 </Resync_Periodic> <Profile_Rule>TFTP://prov.telco.com: 6900/cisco/config/CP_xxxx_MPP.cfg </Profile_Rule> </flat-profile> -
V značkách prvkov sa rozlišujú veľké a malé písmená.
-
Prázdne značky prvkov sú povolené a budú interpretované ako konfigurácia hodnoty, ktorá má byť prázdna. Zadajte značku počiatočného prvku bez zodpovedajúcej značky prvku a Insert medzeru a lomku dopredu pred zátvorkou uhla zatvárania (>). V tomto príklade je pravidlo profilu B prázdne:
<Profile_Rule_B /> -
Prázdnu značku prvku možno použiť na zabránenie prepísania hodnôt zadaných používateľom počas operácie opätovnej synchronizácie. V nasledujúcom príklade sa nastavenia rýchlej voľby používateľa nezmenia:
<plochý profil> <Speed_Dial_2_Name ua="rw"/> <Speed_Dial_2_Number ua="rw"/> <Speed_Dial_3_Name ua="rw"/> <Speed_Dial_3_Number ua="rw"/> <Speed_Dial_4_Name ua="rw"/> <Speed_Dial_4_Number ua="rw"/> <Speed_Dial_5_Name ua="rw"/> <Speed_Dial_5_Number ua="rw"/> <Speed_Dial_6_Name ua="rw"/> <Speed_Dial_6_Number ua="rw"/> <Speed_Dial_7_Name ua="rw"/> <Speed_Dial_7_Number ua="rw"/> <Speed_Dial_8_Name ua="rw"/> <Speed_Dial_8_Number ua="rw"/> <Speed_Dial_9_Name ua="rw"/> <Speed_Dial_9_Number ua="rw"/> </flat-profile> -
Použite prázdnu hodnotu na nastavenie zodpovedajúceho parametra na prázdny reťazec. Zadajte otvárací a zatvárací prvok bez akejkoľvek hodnoty medzi nimi. V nasledujúcom príklade je parameter GPP_A nastavený na prázdny reťazec.
<plochý profil> <GPP_A> </GPP_A> </plochý profil> -
Názvy nerozpoznaných prvkov sa ignorujú.
Vlastnosti parametrov
Tieto vlastnosti sa vzťahujú na parametre:
Všetky parametre, ktoré nie sú špecifikované profilom, zostanú v telefóne nezmenené.
Nerozpoznané parametre sa ignorujú.
Ak profil otvoreného formátu obsahuje viacero výskytov rovnakej značky parametra, posledný takýto výskyt má prednosť pred predchádzajúcimi výskytmi. Ak sa chcete vyhnúť neúmyselnému prepísaniu konfiguračných hodnôt parametra, odporúčame, aby každý profil špecifikoval najviac jednu inštanciu parametra.
Posledný spracovaný profil má prednosť. Ak viac profilov špecifikuje rovnaký konfiguračný parameter, hodnota druhého profilu má prednosť.
Formáty reťazcov
Na formátovanie reťazcov sa vzťahujú tieto vlastnosti:
Komentáre sú povolené prostredníctvom štandardnej syntaxe XML.
<!-- Môj komentár je napísaný tu -->Úvodné a koncové medzery sú povolené z dôvodu čitateľnosti, ale odstránia sa z hodnoty parametra.
Nové čiary v rámci hodnoty sa skonvertujú na medzery.
Hlavička formulára
XML<? ?>je povolené, ale telefón to ignoruje.Ak chcete zadať špeciálne znaky, použite základné úniky znakov XML, ako je znázornené v nasledujúcej tabuľke.
Špeciálny charakter
XML Úniková sekvencia
& (ampersand)
&
< (menej ako)
<
> (viac ako)
>
" (apostrof)
'
" (dvojitá úvodzovka)
"
V nasledujúcom príklade sú zadané úniky znakov, ktoré predstavujú symboly väčšie a menšie ako, ktoré sú požadované v pravidle plánu vytáčania. Tento príklad definuje plán vytáčania informačnej horúcej linky, ktorý nastavuje <Dial_Plan_1_> parameter () rovné (S0 <:18005551212>).
<plochý profil> <Dial_Plan_1_> (S0 <:18005551212>) </Dial_Plan_1_> </plochý profil>Číselný znak uniká pomocou desatinných a hexadecimálnych hodnôt (s.a.
(a.), sú preložené.Firmvér telefónu podporuje iba znaky ASCII.
Kompresia otvoreného profilu
Podporovanou metódou kompresie je algoritmus gzip deflate (RFC1951). Pomôcka gzip a kompresná knižnica, ktorá implementuje rovnaký algoritmus (zlib), sú k dispozícii na internetových stránkach.
Na identifikáciu kompresie telefón očakáva, že komprimovaný súbor bude obsahovať hlavičku kompatibilnú s gzip. Vyvolanie nástroja gzip na pôvodnom profile Open vygeneruje hlavičku. Telefón skontroluje hlavičku prevzatého súboru, aby určil formát súboru.
Ak je napríklad profil.XML platným profilom, akceptuje sa aj profile.xml.gz súboru . Tento typ profilu je možné vygenerovať pomocou niektorého z nasledujúcich príkazov:
-
>Profil GZIP.XMLNahradí pôvodný súbor komprimovaným súborom.
-
>Profil mačky.XML | GZIP > profile.xml.gzPonechá pôvodný súbor na mieste a vytvorí nový komprimovaný súbor.
Šifrovanie otvoreného profilu
Na zašifrovanie otvoreného konfiguračného profilu, ktorý je alebo nie je komprimovaný, možno použiť šifrovanie symetrickým kľúčom. Kompresia, ak sa používa, sa musí použiť ešte pred šifrovaním.
Poskytovací server na riešenie počiatočného poskytovania telefónu po nasadení používa HTTPS. Predšifrovanie konfiguračných profilov offline umožňuje použitie HTTP na následnú resynchronizáciu profilov. Tým sa znižuje záťaž servera HTTPS pri rozsiahlych nasadeniach.
Telefón podporuje dva spôsoby šifrovania konfiguračných súborov:
-
Šifrovanie AES-256-CBC
-
Šifrovanie obsahu HTTP podľa normy RFC 8188 so šifrou AES-128-GCM
Kľúč alebo šifrovacia technika vstupu (IKM) musia byť dopredu pripravené a vložené do jednotky. Bezpečné spustenie tajného kľúča dosiahnete použitím HTTPS.
Názov konfiguračného súboru nevyžaduje špecifický formát, ale názov súboru, ktorý končí príponou .cfg , zvyčajne označuje konfiguračný profil.
Šifrovanie AES-256-CBC
Telefón podporuje šifrovanie AES-256-CBC pre konfiguračné súbory.
Šifrovanie môže vykonať šifrovací nástroj OpenSSL, ktorý môžete stiahnuť z rôznych internetových stránok. Podpora 256-bitového šifrovania AES môže vyžadovať rekompiláciu nástroja, aby bol povolený kód AES. Firmvér bol testovaný na verzii openssl-1.1.1d.
Profil očakáva, že šifrovaný súbor bude mať rovnaký formát, ako ten vygenerovaný nasledujúcim príkazom:
# príklad šifrovacieho kľúča = SecretPhrase1234 openssl enc –e –aes-256-cbc –k SecretPhrase1234 –in profile.XML –out profile.cfg # analogické vyvolanie komprimovaného súboru XML openssl enc –e –aes-256-cbc –k SecretPhrase1234 –in profile.xml.gz –out profile.cfg
Malé písmeno -k pred tajným kľúčom, ktorý môže byť akýkoľvek obyčajný text, a ktorý sa používa na generovanie 64-bitovej soli. Keď je tajný kľúč určený argumentom -k, šifrovací nástroj vytvorí náhodný 128-bitový počiatočný vektor a 256-bitový šifrovací kľúč.
Keď je tento druh šifrovania použitý na konfiguračnom profile, telefón musí poznať hodnotu tajného kľúča, aby dokázal súbor rozšifrovať. Táto hodnota je určená ako kvalifikátor v URL profilu. Syntax s použitím explicitnej URL je nasledovná:
[--key "SecretPhrase1234"] http://prov.telco.com/path/profile.cfg
Táto hodnota sa programuje pomocou jedného z Profile_Rule parametrov .
Niekoľko parametrov poskytovania prechádza pred vyhodnotením internou makroexpanziou. Tento krok predbežného vyhodnotenia poskytuje väčšiu flexibilitu pri kontrole aktivít resynchronizácie a inovácie telefónu.
Tieto skupiny parametrov prechádzajú pred vyhodnotením makroexpanziou:
-
Resync_Trigger_*
-
Profile_Rule*
-
Log_xxx_Msg
-
Upgrade_Rule
Za určitých podmienok prechádzajú makrorozšírením aj niektoré univerzálne parametre (GPP_*), ako je explicitne uvedené v časti Voliteľné argumenty opätovnej synchronizácie nižšie.
Počas makro rozšírenia obsah pomenovaných premenných nahradí výrazy tvaru $NAME a $(NAME). Tieto premenné zahŕňajú univerzálne parametre, niekoľko identifikátorov produktov, určité časovače udalostí a hodnoty stavu poskytovania. Úplný zoznam nájdete v časti Premenné rozšírenia makier v časti Parametre poskytovania.
V nasledujúcom príklade sa výraz $(MAU) používa na Insert adresy MAC 000E08012345.
Správca zadá: $(MAU)config.cfg
Výsledné makro rozšírenie pre zariadenie s MAC adresou 000E08012345 je: 000E08012345config.cfg
Ak názov makra nie je rozpoznaný, zostane nerozbalený. Napríklad názov STRANGE nie je rozpoznaný ako platný názov makra, zatiaľ čo MAU je rozpoznaný ako platný názov makra.
Správca zadá: $STRANGE$MAU.cfg
Výsledné makro rozšírenie pre zariadenie s MAC adresou 000E08012345 je: $STRANGE 000E08012345.cfg
Makro expanzia sa nepoužíva rekurzívne. Napríklad $$MAU" sa rozbalí do $MAU" ($$ sa rozbalí) a nebude mať za následok adresu MAC.
Obsah parametrov špeciálneho účelu GPP_SA až GPP_SD sa mapuje na makrovýrazy $SA prostredníctvom $SD. Tieto parametre sú iba makro rozbalené ako argument možností - -key , --uid a --pwd v adrese URL na opätovnú synchronizáciu.
Podmienené výrazy môžu spúšťať udalosti opätovnej synchronizácie a vyberať si z alternatívnych adries URL pre operácie opätovnej synchronizácie a inovácie.
Podmienené výrazy pozostávajú zo zoznamu porovnaní oddelených operátorom a . Všetky porovnania musia byť splnené, aby bola podmienka pravdivá.
Každé porovnanie sa môže týkať jedného z nasledujúcich troch typov literálov:
-
Celočíselné hodnoty
-
Čísla verzií softvéru alebo hardvéru
-
Reťazce s dvojitými úvodzovkami
Čísla verzií
Verzia softvéru pre Cisco Video Phone 8875 používa tento formát (kde BN je číslo zostavy):
PHONEOSyyyy.1-0-1-0001-BN
kde rrrr označuje model telefónu alebo rad telefónu; 1 je hlavná verzia; 0 je vedľajšia verzia; 1-0001 je mikroverzia; a BN je číslo zostavy.
Porovnávací reťazec musí mať rovnaký formát. V opačnom prípade sa vyskytne chyba analýzy formátu.
Pri porovnávaní verzie softvéru sa porovnáva hlavná verzia, vedľajšia verzia a mikroverzia v poradí a číslice úplne vľavo majú prednosť pred posledne menovanými. Ak sú čísla verzií identické, porovná sa číslo zostavy.
Príklady čísla platnej verzie
PHONEOS-8875.1-0-1-0001-19
Porovnanie
Citované reťazce možno porovnať pre rovnosť alebo nerovnosť. Celé čísla a čísla verzií je možné porovnať aj aritmeticky. Porovnávacie operátory môžu byť vyjadrené ako symboly alebo ako akronymy. Akronymy sú vhodné na vyjadrenie stavu v profile otvoreného formátu.
|
Operátor |
Alternatívna syntax |
Popis |
Použiteľné pre celočíselné a verzné operandy |
Použiteľné pre citované strunové operandy |
|---|---|---|---|---|
|
= |
EQ |
rovná sa |
Áno |
Áno |
|
!= |
Nie |
nerovná sa |
Áno |
Áno |
|
< |
Lt |
menšie ako |
Áno |
Nie |
|
<= |
Le |
menšie alebo rovné |
Áno |
Nie |
|
> |
Gt |
väčšie ako |
Áno |
Nie |
|
>= |
Ge |
väčšie alebo rovné |
Áno |
Nie |
|
A |
|
a |
Áno |
Áno |
Je dôležité uzavrieť makro premenné do dvojitých úvodzoviek, kde sa očakáva reťazec doslovný. Nerobte to tam, kde sa očakáva číslo alebo číslo verzie.
Pri použití v kontexte parametrov Profile_Rule* a Upgrade_Rule musia byť podmienené výrazy uzavreté v syntaxi "(expr)?", ako je to v tomto príklade pravidla aktualizácie. Nezabudnite nahradiť BN číslom zostavenia firmvéru, na ktorý chcete inovovať.
($SWVER ne PHONEOS-8875.1-0-1-0001-19)? http://ps.tell.com/sw/PHONEOS-8875.1-0-1-0001-BN.loads
Na konfiguráciu parametrov Resync_Trigger_* nepoužívajte predchádzajúcu syntax so zátvorkami.
Pomocou syntaxe štandardnej adresy URL zadajte spôsob načítania konfiguračných súborov a načítania firmvéru v parametroch Profile_Rule* a Upgrade_Rule. Syntax je nasledovná:
[ scheme:// ] [ server [:p ort]] cesta k súboru
Kde schéma je jednou z týchto hodnôt:
-
TFTP
-
HTTP
-
HTTPS
Ak sa schéma vynechá, predpokladá sa TFTP. Server môže byť názov hostiteľa rozpoznaný DNS alebo číselná adresa IP. Port je cieľové číslo portu UDP alebo TCP. Cesta k súboru musí začínať koreňovým adresárom (/); Musí to byť absolútna cesta.
Ak server chýba, použije sa server TFTP určený prostredníctvom DHCP (možnosť 66).
Pre pravidlá aktualizácie musí byť zadaný server.
Ak port chýba, použije sa štandardný port pre zadanú schému. TFTP používa UDP port 69, HTTP používa TCP port 80, HTTPS používa TCP port 443.
Musí byť prítomná cesta k súboru. Nemusí nevyhnutne odkazovať na statický súbor, ale môže indikovať dynamický obsah získaný pomocou CGI.
Makro rozšírenie sa vzťahuje na webové adresy. Tu sú príklady platných adries URL:
/$MA.cfg /cisco/cfg.XML 192.168.1.130/profiles/init.cfg TFTP://prov.call.com/cpe/cisco$MA.cfg http://neptune.speak.net:8080/prov/$D/$E.cfg https://secure.me.com/profile?Linksys
Pri použití DHCP možnosti 66 pravidlá inovácie nepodporujú prázdnu syntax. Platí len pre pravidlo profilu*.
Šifrovanie obsahu HTTP podľa normy RFC 8188
Telefón podporuje šifrovanie obsahu HTTP založené na RFC 8188 s šifrovaním AES-128-GCM pre konfiguračné súbory. Pri tejto metóde šifrovania môže hlavičky správ HTTP prečítať akýkoľvek subjekt. Obsah správy však môžu prečítať iba subjekty, ktoré poznajú šifrovaciu techniku vstupu (IKM). Keď je telefón vybavený službou IKM, telefón a obstarávací server si môžu bezpečne vymieňať konfiguračné súbory, pričom umožňujú sieťovým prvkom tretích strán používať hlavičky správ na analytické a monitorovacie účely.
Konfiguračný parameter XML IKM_HTTP_Encrypt_Content obsahuje IKM v telefóne. Z bezpečnostných dôvodov nie je tento parameter dostupný na webovej stránke správy telefónu. Nie je viditeľný ani v konfiguračnom súbore telefónu, ku ktorému máte prístup z adresy IP telefónu alebo zo správ o konfigurácii telefónu odoslaných na obstarávací server.
Ak chcete použiť šifrovanie založené na RFC 8188, uistite sa, že:
-
Poskytnite telefónu IKM zadaním IKM s parametrom
XML IKM_HTTP_Encrypt_Contentv konfiguračnom súbore, ktorý sa odosiela z poskytujúceho servera do telefónu. -
Ak sa toto šifrovanie použije na konfiguračné súbory odoslané z poskytujúceho servera do telefónu, uistite sa, že hlavička HTTP kódujúca obsah v konfiguračnom súbore má
AES128GCM
.Ak táto hlavička chýba, má prednosť metóda AES-256-CBC. Telefón použije dešifrovanie AES-256-CBC, ak je v pravidle profilu prítomný kľúč AES-256-CBC, bez ohľadu na IKM.
-
Ak chcete, aby telefón použil toto šifrovanie na správy o konfigurácii, ktoré odosiela na obstarávací server, uistite sa, že v pravidle hlásenia nie je zadaný žiadny kľúč AES-256-CBC.
Voliteľné argumenty opätovnej synchronizácie
Voliteľné argumenty, kľúč, uid a pwd môžu predchádzať adresám URL zadaným v Profile_Rule* parametroch, ktoré sú spoločne uzavreté hranatými zátvorkami.
Možnosť --key informuje telefón, že konfiguračný súbor, ktorý prijme z poskytujúceho servera, je šifrovaný šifrovaním AES-256-CBC, pokiaľ to hlavička Content-Encoding v súbore nenaznačuje AES128GCM
Šifrovanie. Samotný kľúč je špecifikovaný ako reťazec nasledujúci za výrazom --key. Kláves môže byť voliteľne uzavretý v dvojitých úvodzovkách ("). Telefón používa kľúč na dešifrovanie konfiguračného súboru.
Príklady použitia
[--key VerySecretValue] [--key "moja tajná fráza"] [--Kľúč A37D2FB9055C1D04883A0745EB0917A4]
Voliteľné argumenty v zátvorkách sú rozbalené na makro. Parametre špeciálneho účelu, GPP_SA až GPP_SD, sú makro rozšírené na makropremenné, $SA až $SD, iba ak sa používajú ako kľúčové argumenty možností. Pozrite si tieto príklady:
[--key $SC] [--kláves "$SD"]
V profiloch otvoreného formátu musí byť argument to-key rovnaký ako argument k možnosti k , ktorý je zadaný pre openssl.
Možnosti uid a pwd je možné použiť na zadanie ID používateľa a hesla, ktoré sa odošlú ako odpoveď na výzvy overovania HTTP Basic a Digest, keď sa požaduje zadaná adresa URL. Voliteľné argumenty v zátvorkách sú rozbalené na makro. Parametre špeciálneho účelu, GPP_SA až GPP_SD, sú makro rozšírené na makropremenné, $SA až $SD, iba ak sa používajú ako kľúčové argumenty možností. Pozrite si tieto príklady:
GPP_SA = MyUserID GPP_SB = MySecretPassword
[--uid $SA --pwd $SB] https://provisioning_server_url/path_to_your_config/your_config.xml
By sa potom rozšíril na:
[--uid MyUserID --pwdMySecretPassword] https://provisioning_server_url/path_to_your_config/your_config.xml
Typy údajov
Tieto typy údajov sa používajú s parametrami konfiguračného profilu:
-
{a,b,c,...}—Výber medzi a, b, c, ...
-
Bool – boolovská hodnota "áno" alebo "nie".
-
CadScript – miniskript, ktorý určuje parametre kadencie signálu. Maximálne 127 znakov.
Syntax: S1[; S2], pričom:
-
Si=Di(nai,1/offi,1[,oni,2/offi,2[,oni,3/offi,3[,oni,4/offi,4[,oni,5/offi,5[,oni,6/offi,6]]]]]) a je známy ako úsek.
-
Nai,j a offi,j sú trvanie zapnutia/vypnutia v sekundách segmentu . I = 1 alebo 2 a j = 1 až 6.
-
Di je celková dĺžka úseku v sekundách.
Všetky doby trvania môžu mať až tri desatinné miesta, aby poskytovali rozlíšenie 1 ms. Zástupný znak "*" znamená nekonečné trvanie. Segmenty v rámci sekcie sa prehrávajú v poradí a opakujú sa, až kým sa neodohrá celkové trvanie.
Príklad 1:
60(2/4) Počet kadenčných úsekov = 1 Kadenčný úsek 1: Dĺžka úseku = 60 s Počet segmentov = 1 Segment 1: zapnuté = 2s, vypnuté = 4 s Celková dĺžka krúžku = 60 sPríklad 2 – Rozlišovací krúžok (krátky, krátky, krátky, dlhý):
60(.2/.2,.2/.2,.2/.2,1/4) Počet sekcií kadencie = 1 Kadenčný úsek 1: Dĺžka sekcie = 60s Počet segmentov = 4 Segment 1: zapnuté = 0,2 s, vypnuté = 0,2 s Segment 2: zapnuté = 0,2 s, vypnuté = 0,2 s Segment 3: zapnuté = 0,2 s, vypnuté = 0,2 s Segment 4: zapnuté = 1,0 s, vypnuté = 4,0 s Celková dĺžka zvonenia = 60 s -
-
DialPlanScript – syntax skriptovania, ktorá sa používa na určenie plánov vytáčania linky 1 a 2.
-
Float<n> – hodnota s pohyblivou desatinnou čiarkou s presnosťou na deväť desatinných miest.
-
FQDN—Úplný názov domény. Môže obsahovať až 63 znakov. Príklady sú tieto:
sip.Cisco.com:5060 alebo 109.12.14.12:12345
sip.Cisco.com alebo 109.12.14.12
-
FreqScript – miniskript, ktorý špecifikuje parametre frekvencie a úrovne tónu. Obsahuje až 127 znakov.
Syntax: F 1@L 1[,F2@L2[,F3@L3[,F4@L4[,F5@L5[,F6@L6]]]]], kde:
-
F1 – F6 sú frekvencie v Hz (iba nepodpísané celé čísla).
-
L1 – L6 sú zodpovedajúce úrovne v dBm (s maximálne jedným desatinným miestom).
Biele medzery pred a za čiarkou sú povolené, ale neodporúčajú sa.
Príklad 1 – tón čakajúceho hovoru:
440@-10 Počet frekvencií = 1 Frekvencia 1 = 440 Hz pri –10 dBmPríklad 2 – oznamovací tón:
350@-19,440@-19 Počet frekvencií = 2 Frekvencia 1 = 350 Hz pri –19 dBm Frekvencia 2 = 440 Hz pri –19 dBm -
-
IP— Platná adresa IPv4 vo forme x.x.x.x, kde x je medzi 0 a 255. Príklad: 10.1.2.100.
-
ID používateľa – používateľ ID tak, ako sa zobrazuje v adrese URL; Maximálne 63 znakov.
-
Telefón – reťazec telefónnych čísel, napríklad 14081234567, *69, *72, 345678; alebo všeobecnú webovú adresu, napríklad 1234@10.10.10.100:5068 alebo jsmith@Cisco.com. Reťazec môže obsahovať až 39 znakov.
-
PhTmplt – šablóna telefónneho čísla. Každá šablóna môže obsahovať jeden alebo viac vzorov oddelených čiarkou (,). Medzery na začiatku každého vzoru sa ignorujú. "?" a "*" predstavujú zástupné znaky. Ak chcete reprezentovať doslovne, použite %xx. Napríklad %2a predstavuje *. Šablóna môže obsahovať až 39 znakov. Príklady: "1408*, 1510*", "1408123????, 555?1.".
-
Port—TCP/UDP Číslo portu (0-65535). Môže byť špecifikovaný v desiatkovom alebo hexadecimálnom formáte.
-
ProvisioningRuleSyntax – syntax skriptovania, ktorá sa používa na definovanie pravidiel resynchronizácie konfigurácie a aktualizácie firmvéru.
-
PwrLevel – úroveň výkonu vyjadrená v dBm s jedným desatinným miestom, napríklad –13,5 alebo 1,5 (dBm).
-
RscTmplt—Šablóna kódu stavu odpovede SIP, napríklad "404, 5*", "61?", "407, 408, 487, 481". Môže obsahovať až 39 znakov.
-
Sig<n> – podpísaná n-bitová hodnota. Môže byť špecifikovaný v desiatkovom alebo hexadecimálnom formáte. Pred zápornými hodnotami musí byť znak "-". Znamienko + pred kladnými hodnotami je voliteľné.
-
Hviezdne kódy – aktivačný kód doplnkovej služby, napríklad *69. Kód môže obsahovať maximálne 7 znakov.
-
Str<n> – všeobecný reťazec s maximálne deviatimi nevyhradenými znakmi.
-
Čas<n> – čas v sekundách s maximálne deviatimi desatinnými miestami. Nadbytočné zadané desatinné miesta sa ignorujú.
-
ToneScript – miniskript, ktorý určuje frekvenciu, úroveň a kadenčné parametre tónu priebehu hovoru. Skript môže obsahovať až 127 znakov.
Syntax: FreqScript; Z1[; Z2].
Úsek Z1 je podobný úseku S1 v CadScripte, s tým rozdielom, že za každým segmentom zapnutia/vypnutia nasleduje parameter frekvenčných zložiek: Z1 = D1(nai,1/offi,1/fi,1[,oni,2/off i,2/fi,2 [,oni,3/offi,3/fi, 3 [,nai,4/offi,4/fi,4 [,oni,5/offi,5/fi,5 [,oni,6/offi,6/fi,6]]]]]) kde:
-
fi,j = n1[+n2]+n3[+n4[+n5[+n6]]]]].
-
1 < nk < 6 určuje frekvenčné komponenty vo FreqScripte, ktoré sa používajú v danom segmente.
Ak sa v segmente používa viac ako jedna frekvenčná zložka, zložky sa spočítajú.
Príklad 1 – oznamovací tón:
350@-19,440@-19; 10(*/0/1+2) Počet frekvencií = 2 Frekvencia 1 = 350 Hz pri –19 dBm Frekvencia 2 = 440 Hz pri –19 dBm Počet sekcií kadencie = 1 Kadencia Sekcia 1: Dĺžka sekcie = 10 s Počet segmentov = 1 Segment 1: zapnutý = navždy, s frekvenciami 1 a 2 Celková dĺžka tónu = 10sPríklad 2 – Zasekávací tón:
350@-19,440@-19; 2(.1/.1/1+2); 10(*/0/1+2) Počet frekvencií = 2 Frekvencia 1 = 350 Hz pri –19 dBm Frekvencia 2 = 440 Hz pri –19 dBm Počet kadenčných úsekov = 2 Kadencia Sekcia 1: Dĺžka úseku = 2s Počet segmentov = 1 Segment 1: zapnuté = 0,1 s, vypnuté = 0,1 s s frekvenciami 1 a 2 Kadencia Sekcia 2: Dĺžka sekcie = 10 s Počet segmentov = 1 segment 1: Zapnuté = navždy, s frekvenciami 1 a 2 Celková dĺžka tónu = 12s -
-
Uns<n> – nepodpísaná n-bitová hodnota, kde n = 8, 16 alebo 32. Môže byť špecifikovaný v desatinnom alebo hexadecimálnom formáte, napríklad 12 alebo 0x18, pokiaľ sa hodnota zmestí do n bitov.
Majte ich na pamäti:
- <Par Name> predstavuje názov konfiguračného parametra. V profile sa zodpovedajúca značka vytvorí nahradením medzery podčiarknutím "_", napríklad Par_Name.
- Prázdne pole predvolenej hodnoty znamená prázdny reťazec < "" >.
- Telefón naďalej používa posledné nakonfigurované hodnoty pre značky, ktoré sa nenachádzajú v danom profile.
- Šablóny sa porovnávajú v uvedenom poradí. Vyberie sa prvá, nie najbližšia zhoda. Názov parametra sa musí presne zhodovať.
- Ak je v profile uvedená viac ako jedna definícia parametra, posledná takáto definícia v súbore je tá, ktorá sa prejaví v telefóne.
- Špecifikácia parametra s prázdnou hodnotou parametra vráti parameter späť na predvolenú hodnotu. Ak chcete namiesto toho zadať prázdny reťazec, použite ako hodnotu parametra prázdny reťazec "".