V tomto článku
dropdown icon
Konfigurácia telefónu na opätovnú synchronizáciu profilu
    Znova synchronizujte profil telefónu cez TFTP
    Poskytnutie profilu špecifického pre telefón na serveri TFTP
    Znova synchronizujte profil telefónu pomocou HTTP GET
    Automaticky znovu synchronizujte profil telefónu
    Parametre resynchronizácie profilu
    Poskytovanie prostredníctvom Cisco XML
    Rozlíšenie URL s rozšírením makra
    Zadajte typ autentifikácie profilu
dropdown icon
Manuálne použitie profilu do telefónu
    Stiahnite si konfiguračný súbor do telefónu zo servera TFTP
    Stiahnite si konfiguračný súbor do telefónu pomocou cURL
dropdown icon
Referencie pre konfiguráciu profilu
    Konfiguračné formáty profilov
    Kompresia otvoreného profilu
    Otvorte šifrovanie profilu
    Voliteľné argumenty opätovnej synchronizácie
    Typy údajov

Konfigurácia nastavení profilu pre telefóny série 9800 a 8875 (BroadWorks)

list-menuV tomto článku
list-menuSpätná väzba?

Tento článok pomocníka je určený pre Cisco Desk Phone 9800 Series a Cisco Video Phone 8875 registrovaný v spoločnosti Cisco BroadWorks. Informácie na tejto stránke zahŕňajú opätovnú synchronizáciu profilu, manuálne použitie profilu a syntaxu konfigurácie.

Konfigurácia telefónu na opätovnú synchronizáciu profilu

Znova synchronizujte profil telefónu cez TFTP

Telefón podporuje viacero sieťových protokolov na načítanie konfiguračných profilov. Najzákladnejším protokolom 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 TFTP neodporúča na nasadenie vzdialených koncových bodov na internete, 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 upraví po stiahnutí súboru zo servera TFTP.

1

V prostredí 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

Na vytvorenie konfiguračného profilu použite textový editor.

Ak chcete overiť, či bol profil poskytnutý vášmu telefónu neskôr, môžete niektoré hodnoty nastaviť ako značky. Napríklad nastavte hodnotu pre GPP_A na 12345678, ako je znázornené v nasledujúcom príklade:

<flat-profile>
  <GPP_A> 12345678
  </GPP_A>
</flat-profile>
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. Výhodne použite klienta TFTP, ktorý je spustený na samostatnom hostiteľovi od poskytovacieho servera.

5

Vo webovom prehliadači v počítači otvorte webovú stránku správy. Predpokladajme napríklad, že adresa IP telefónu je 192.168.1.100, vo webovom prehliadači otvorte nasledujúcu adresu URL:


http://192.168.1.100/admin/advanced

6

Vyberte kartu Hlas > Provisioning a skontrolujte hodnoty všeobecných parametrov GPP_A cez GPP_P. Tieto by mali byť prázdne.

7

Znova synchronizujte testovací telefón s konfiguračným profilom, ktorý ste vytvorili otvorením adresy URL pre 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:


http://192.168.1.100/admin/resync?tftp://192.168.1.200/basic.txt

Keď telefón prijme tento príkaz, zariadenie na adrese 192.168.1.100 požaduje súbor konfiguračného profilu basic.txt zo servera TFTP na adrese IP 192.168.1.200. Telefón potom analyzuje stiahnutý súbor a aktualizuje parameter GPP_A o hodnotu 12345678.

8

Skontrolujte, či bol parameter správne aktualizovaný. Obnovte webovú stránku správy a prejdite na položku Voice > Provisioning.

Parameter GPP_A by teraz mal obsahovať hodnotu 12345678.

Poskytnutie profilu špecifického pre telefón na serveri TFTP

1

Získajte MAC adresu telefónu z jeho štítku produktu. (MAC adresa je číslo pomocou čísel a malých šesťhranných číslic, napríklad 000e08aabbcc.

2

Premenujte svoj konfiguračný súbor na CP-xxxx macaddress.cfg (nahradenie xxxx číslom modelu a macaddress MAC adresou telefónu).

Príklad:

CP-8875 000e08aabbcc.cfg

3

Presuňte nový súbor do virtuálneho koreňového adresára servera TFTP.

4

Vstúpte na webovú stránku správy telefónu.

5

Vyberte polož ky Hlas > Poskytovanie.

6

Do poľa Pravidlo profilu zadajte c estu súboru profilu.

Príklad: Predpokladajme, že adresa IP servera TFTP je 192.168.1.200 a názov súboru profilu je


<Profile_Rule>
tftp://192.168.1.200/CP-8875$MA.cfg
</Profile_Rule>
7

Kliknite na polož ku Odoslať všetky zmeny. To spôsobí okamžitý reštart a opätovnú synchronizáciu.

Keď dôjde k ďalšej opätovnej synchronizácii, telefón načíta nový súbor rozšírením výrazu makra $MA na svoju MAC adresu.

Znova synchronizujte profil telefónu pomocou HTTP GET

1

Nainštalujte server HTTP do lokálneho počítača alebo iného prístupného hostiteľa.

Open source server Apache si môžete 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 pravidlo Profile_Rule testovacieho telefónu tak, aby namiesto servera TFTP ukazoval na server HTTP, aby sa jeho profil pravidelne sťahoval.

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:

<Profile_Rule>
http://192.168.1.200/basic.txt
</Profile_Rule>
5

Kliknite na polož ku Odoslať všetky zmeny. To spôsobí okamžitý reštart a opätovnú synchronizáciu.

6

Sledujte správy syslog, ktoré telefón odosiela. Pravidelná resynchronizácia by teraz mala získavať profil zo servera HTTP.

7

V protokoloch servera HTTP sledujte, ako sa informácie, ktoré identifikujú testovací telefón, zobrazujú v denníku používateľských agentov.

Tieto informácie by mali obsahovať výrobcu, názov produktu, aktuálnu verziu firmvéru a sériové číslo.

Automaticky znovu synchronizujte profil telefónu

Zariadenie môže pravidelne resynchronizovať s poskytovacím serverom, aby sa zabezpečilo, že všetky zmeny profilu vykonané na serveri sa šíria do zariadenia koncového bodu (na rozdiel od odoslania explicitnej žiadosti o opätovnú synchronizáciu na koncový bod).

Ak chcete spustiť pravidelnú resynchronizáciu telefónu so serverom, URL konfiguračného profilu sa definuje pomocou parametra Profile_Rule a perióda resynchronizácie sa definuje pomocou parametra Resync_Periodic.

1

Vstúpte na webovú stránku správy telefónu.

2

Vyberte polož ky Hlas > Poskytovanie.

3

Definujte parameter Profile_Rule. Tento príklad predpokladá IP adresu servera TFTP 192.168.1.200.

4

Do poľa Resync Peri odická zadajte malú hodnotu na testovanie, napríklad 30 sekúnd.

5

Kliknite na polož ku Odoslať všetky zmeny.

S novými nastaveniami parametrov sa telefón znova synchronizuje dvakrát za minútu s konfiguračným súborom, ktorý určuje adresa URL.

6

Sledujte výsledné správy v slede syslog.

7

Uistite sa, že pole Resync pri resetovaní je nastavené na hodnotu Áno.


<Resync_On_Reset>Yes</Resync_On_Reset>

8

Napájanie telefónu prinútite opätovnú synchronizáciu s poskytovacím serverom.

Ak operácia opätovnej synchronizácie zlyhá z akéhokoľvek dôvodu, napríklad ak server nereaguje, jednotka počká (na počet sekúnd nakonfigurovaných v opätovnom skúšaní oneskorenia chyby opätovného vyskúšania) predtým, ako sa pokúsi o opätovnú synchroniz áciu. Ak je oneskorenie opätovného skúšania chyby opätovnej synchroniz ácie nula, telefón sa po neúspešnom pokuse o opätovnú synchronizáciu nepokúsi znovu synchronizovať.

9

(Voliteľné) Nastavte hodnotu poľa O pätovné oneskorenie chy by Resync na malé číslo, napríklad 30.


<Resync_Error_Retry_Delay>30</Resync_Error_Retry_Delay>

10

Vypnite server TFTP a sledujte výsledky vo výstupe syslog.

Parametre resynchronizácie profilu

Nasledujúca tabuľka definuje funkciu a použitie parametrov opätovnej synchronizácie profilu v sekcii Konfiguračný profil na karte H las > Provisioning na webovej stránke telefónu. Definuje tiež syntax reťazca, ktorý je pridaný do konfiguračného súboru telefónu (cfg.xml) s kódom XML na konfiguráciu parametra.

Tabuľka 1. Parametre resynchronizácie profilu

Parameter

Popis

Povoliť poskytovanie

Povolí alebo odmieta akcie opätovnej synchronizácie profilu konfigurácie.

  • V konfiguračnom súbore telefónu (cfg.xml) s XML zadajte reťazec v tomto formáte:

    <Provision_Enable ua="na">Áno</Provision_Enable>
  • Na webovej stránke telefónu nastavte toto pole na hodnotu Áno, aby ste povolili akcie opätovnej synchronizácie, alebo Nie na blokovanie akcií opätovnej synchronizácie.

Predvolené: Áno

Resynchronizácia pri resetovaní

Určuje, či telefón po zapnutí a po každom pokuse o aktualizáciu opätovne synchronizuje konfigurácie s poskytovacím serverom.

  • V konfiguračnom súbore telefónu (cfg.xml) s XML zadajte reťazec v tomto formáte:

    <Resync_On_Reset ua="na">Áno</Resync_On_Reset>
  • Na webovej stránke telefónu nastavte toto pole na možnosť Áno, aby ste povolili opätovnú synchronizáciu pri zapnutí alebo resetovaní, alebo Nie, aby ste zablokovali opätovnú synchronizáciu pri zapnutí alebo resetovaní.

Predvolené: Áno

Resynchronizácia náhodného oneskorenia

Zabraňuje preťaženiu poskytovacieho servera pri súčasnom zapnutí veľkého počtu zariadení a pokuse o počiatočnú konfiguráciu. Toto oneskorenie je účinné len pri počiatočnom pokuse o konfiguráciu po zapnutí alebo resetovaní zariadenia.

Parameter je maximálny časový interval, ktorý zariadenie čaká pred nadviazaním kontaktu s poskytovacím serverom. Skutočné oneskorenie je pseudo-náhodné číslo medzi 0 a touto hodnotou.

Tento parameter je v jednotkách 20 sekúnd.

Platná hodnota sa pohybuje medzi 0 a 65535.

  • V konfiguračnom súbore telefónu (cfg.xml) s XML zadajte reťazec v tomto formáte:

    <Resync_Random_Delay ua="na">2</Resync_Random_Delay>
  • Na webovej stránke telefónu zadajte počet jednotiek (20 sekúnd), na ktoré telefón oneskorí opätovnú synchronizáciu po zapnutí alebo resetovaní.

Predvolená hodnota je 2 (40 sekúnd).

Resynchronizácia pri (HHmm)

Čas (HHmm), ktorý telefón resynchronizuje so serverom poskytovania.

Hodnota tohto poľa musí byť štvormiestne číslo v rozmedzí od 0000 do 2400, aby sa určil čas vo formáte HHmm. Napríklad 0959 označuje 09:59.

  • V konfiguračnom súbore telefónu (cfg.xml) s XML zadajte reťazec v tomto formáte:

    <Resync_At__HHmm_ ua="na">0959</Resync_At__HHmm_>
  • Na webovej stránke telefónu zadajte čas vo formáte HHMM na spustenie opätovnej synchronizácie telefónu.

Predvolená hodnota je prázdna. Ak je hodnota neplatná, parameter sa ignoruje. Ak je tento parameter nastavený s platnou hodnotou, parameter Resync Periodic sa ignoruje.

Resynchronizácia s náhodným oneskorením

Zabraňuje preťaženiu poskytovacieho servera pri súčasnom zapnutí veľkého počtu zariadení.

Aby sa zabránilo zaplaveniu požiadaviek na opätovnú synchronizáciu na server z viacerých telefónov, telefón sa resynchronizuje v rozsahu medzi hodinami a minútami a hodinami a minútami plus náhodným oneskorením (hhmm, hhmm+random_delay). Napríklad, ak je náhodné oneskorenie = (Resync pri náhodnom oneskoreniu + 30) /60 minút, vstupná hodnota v sekundách sa prevedie na minúty a zaokrúhľuje sa nahor na ďalšiu minútu, aby sa vypočítal konečný interval random_delay.

  • V konfiguračnom súbore telefónu (cfg.xml) s XML zadajte reťazec v tomto formáte:

    <Resync_At_Random_Delay ua="na">600</Resync_At_Random_Delay>
  • Na webovej stránke telefónu zadajte časové obdobie v sekundách.

Platná hodnota sa pohybuje medzi 600 a 65535.

Ak je hodnota menšia ako 600, vnútorné náhodné oneskorenie je medzi 0 a 600.

Predvolená hodnota je 600 sekúnd (10 minút).

Periodická resynchronizácia

Časový interval medzi periodickou resynchronizáciou s poskytovacím serverom. Pridružený časovač opätovnej synchronizácie je aktívny až po prvej úspešnej synchronizácii so serverom.

Platné formáty sú nasledovné:

  • Celé číslo

    Príklad: Vstup 3000 znamená, že ďalšia resynchronizácia nastane za 3000 sekúnd.

  • viacnásobné celé čísla

    Príklad: Vstup 600 200 300 indikuje, že prvá resynchronizácia nastane za 600 sekúnd, druhá resynchronizácia nastane za 1200 sekúnd po prvej a tretia resynchronizácia nastane za 300 sekúnd po druhej.

  • Časový rozsah

    Príklad: vstup 2400+30 znamená, že ďalšia resynchronizácia nastane v rozmedzí 2400 až 2430 sekúnd po úspešnej opätovnej synchronizácii.

  • V konfiguračnom súbore telefónu (cfg.xml) s XML zadajte reťazec v tomto formáte:

    <Resync_Periodic ua="na">3600</Resync_Periodic>
  • Na webovej stránke telefónu zadajte časové obdobie v sekundách.

Nastavte tento parameter na nulu, aby ste zakázali periodickú resynchronizáciu.

Predvolená hodnota je 3600 sekúnd.

Oneskorenie opätovného skúšania chyby opätov

Ak operácia opätovnej synchronizácie zlyhá, pretože telefón nedokázal načítať profil zo servera alebo je stiahnutý súbor poškodený alebo sa vyskytne interná chyba, telefón sa pokúsi znova synchronizovať po čase určenom v sekundách.

Platné formáty sú nasledovné:

  • Celé číslo

    Príklad: Vstup 300 znamená, že ďalší opätovný pokus o opätovnú synchronizáciu nastane za 300 sekúnd.

  • viacnásobné celé čísla

    Príklad: Vstup 600 200 300 indikuje, že prvý opätovný pokus nastane 600 sekúnd po zlyhaní, druhý opätovný pokus nastane 1200 sekúnd po zlyhaní prvého opätovného pokusu a tretí opätovný pokus nastane 300 sekúnd po zlyhaní druhého opätovného pokusu.

  • Časový rozsah

    Príklad: vstup 2400+30 naznačuje, že ďalší opätovný pokus nastane v rozmedzí 2400 až 2430 sekúnd po zlyhaní opätovnej synchronizácie.

Ak je oneskorenie nastavené na hodnotu 0, zariadenie sa po neúspešnom pokuse o opätovnú synchronizáciu nepokúsi znova synchronizovať.

  • V konfiguračnom súbore telefónu (cfg.xml) s XML zadajte reťazec v tomto formáte:

    <Resync_Error_Retry_Delay ua="na">60120.240.480,960.1920.3840.768015360.30720.61440.86400</Resync_Error_Retry_Delay>
  • Na webovej stránke telefónu zadajte časové obdobie v sekundách.

Predvolené: 60,120,240,480,960,1920,3840,7680,15360,30720,640,15360,30720,61440,86400

Oneskorenie nútenej resynchronizácie

Maximálne oneskorenie (v sekundách) telefón čaká pred vykonaním resynchronizácie.

Zariadenie sa nesynchronizuje, keď je aktívna jedna z jeho telefónnych liniek. Pretože opätovná synchronizácia môže trvať niekoľko sekúnd, je žiaduce počkať, kým zariadenie nebude dlhšiu dobu nečinné pred resynchronizáciou. To umožňuje používateľovi uskutočňovať volania postupne bez prerušenia.

Zariadenie má časovač, ktorý začína odpočítavať, keď sa všetky jeho riadky stanú nečinnými. Tento parameter je počiatočná hodnota počítadla. Udalosti resynchronizácie sú oneskorené, kým sa toto počítadlo nezníži na nulu.

Platná hodnota sa pohybuje medzi 0 a 65535.

  • V konfiguračnom súbore telefónu (cfg.xml) s XML zadajte reťazec v tomto formáte:

    <Forced_Resync_Delay ua="na">14400</Forced_Resync_Delay>
  • Na webovej stránke telefónu zadajte časové obdobie v sekundách.

Predvolená hodnota je 14 400 sekúnd.

Resynchronizácia zo 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 to povolené, proxy môže požiadať o opätovnú synchronizáciu odoslaním správy SIP NOTIFY obsahujúcej hlavičku Udalosť: resync do zariadenia.

  • V konfiguračnom súbore telefónu (cfg.xml) s XML zadajte reťazec v tomto formáte:

    <Resync_From_SIP ua="na">Áno</Resync_From_SIP>
  • Na webovej stránke telefónu vyberte možnosť Áno, aby ste túto funkciu povolili, alebo Nie, aby ste ju vypínali.

Predvolené: Áno

Opätovná synchronizácia po pokuse o inováciu

Po vykonaní aktualizácie povolí alebo vypne operáciu opätovnej synchronizácie. Ak je vybratá možnosť Áno, synchronizácia sa spustí po aktualizácii firmvéru.

  • V konfiguračnom súbore telefónu (cfg.xml) s XML zadajte reťazec v tomto formáte:

    <Resync_After_Upgrade_Attempt ua="na">Áno</Resync_After_Upgrade_Attempt>
  • Na webovej stránke telefónu vyberte možnosť Áno, ak chcete spustiť opätovnú synchronizáciu po aktualizácii firmvéru, alebo Nie, ak chcete nesynchronizovať opätovnú synchronizáciu.

Predvolené: Áno

Spúšťač resynchronizácie 1

Spúšťač resynchronizácie 2

Ak sa logická rovnica v týchto parametroch hodnotí na FALSE, opätovná synchronizácia sa nespustí ani vtedy, keď je Resync On Reset nastavená na hodnotu TRUE. Iba opätovná synchronizácia prostredníctvom adresy URL priamej akcie a upozornenia SIP ignoruje tieto spúšťače opätovnej synchronizácie.

Parametre je možné naprogramovať podmieneným výrazom, ktorý prechádza rozšírením makra. Platné rozšírenia makr nájdete v časti Premenné rozšírenia makra v časti Paramet re posky tovania.

  • V konfiguračnom súbore telefónu (cfg.xml) s XML zadajte reťazec v tomto formáte:

    <Resync_Trigger_1 ua="na">$ UPGTMR gt 300 a $PRVTMR ge 600</Resync_Trigger_1>

    <Resync_Trigger_2 ua="na"/>

  • Na webovej stránke telefónu zad ajte spúšťače.

Predvolené: Prázdne

Používateľsky konfigurovateľná Resync

Umožňuje používateľovi znovu synchronizovať telefón z ponuky obrazovky telefónu. Ak je nastaven á na položku Áno, používateľ môže znovu synchronizovať konfiguráciu telefónu zadaním pravidla profilu z telefónu. Ak je nastavená na hodnotu Nie, parameter Pravidlo profilu sa v ponuke obrazovky telefónu nezobrazí.

  • V konfiguračnom súbore telefónu (cfg.xml) s XML zadajte reťazec v tomto formáte:

    <User_Configurable_Resync ua="na">Áno</User_Configurable_Resync>

  • Na webovej stránke telefónu vyberte možnosť Áno, aby ste v ponuke telefónu zobrazili parameter Pravid lo profilu, alebo vyberte položku Nie, aby ste tento parameter skryli.

Predvolené: Áno

Resynchronizácia zlyhá na FNF

Opätovná synchronizá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. Ak je nastavená na položku Nie, zariadenie prijme odpoveď zo servera nenájdenú ako úspeš nú opätovnú synchronizáciu.

  • V konfiguračnom súbore telefónu (cfg.xml) s XML zadajte reťazec v tomto formáte:

    <Resync_Fails_On_FNF ua="na">Áno</Resync_Fails_On_FNF>
  • Na webovej stránke telef ónu vyberte možnosť Áno, ak chcete odobrať odpoveď zo súboru nenájdeného ako neúspešnú opätovnú synchronizáciu, alebo vyberte položku Nie, ak chcete odobrať odpoveď na súbor nenájdený ako úspešnú opätovnú synchroniz áciu.

Predvolené: Áno

Typ autentifikácie profilu

Určuje poverenia, ktoré sa majú použiť na overenie účtu profilu. Dostup né možnosti sú:

  • Zaká zané: Zakáže funkciu profilového účtu. Keď je táto funkcia vypnutá, pon uka Nastavenia konta profilu sa na obrazovke telefónu nezobrazí.

  • Základné ove renie HTTP: Prihlasovacie údaje HTTP sa používajú na overenie účtu profilu.

  • Overenie XSI: Prihlasovacie údaje XSI alebo poverenia XSI SIP sa používajú na overenie účtu profilu. Prihlasovacie údaje závisia od typu autentifikácie XSI pre telefón:

    • Keď je typ autentifikácie XSI pre telefón nastavený na Prihlasovacie údaje, použi jú sa prihlasovacie údaje XSI.

    • Keď je typ autentifikácie XSI pre telefón nastavený na hodnotu SIP poverenia, použijú sa poverenia XSI SIP.

  • V konfiguračnom súbore telefónu (cfg.xml) s XML zadajte reťazec v tomto formáte:

    <Profile_Authentication_Type ua="na">Základná autentifikácia Http</Profile_Authentication_Type>
  • Na webovej stránke telefónu vyberte zo zoznamu možnosť, aby telefón overoval opätovnú synchronizáciu profilu.

Predvolené: Základná autentifikácia HTTP

Ďalšie informácie nájdete v téme Určenie typu overovania profilu v časti Zadanie 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 aplikuje všetky profily postupne.

Ak používate šifrovanie AES-256-CBC na konfiguračné súbory, zadajte šifrovací kľúč s kľúčovým slovom --key nasledovne:

[--kľúč] <encryption key>

Šifrovací kľúč môžete priložiť do dvojitých úvodzoviek („) voliteľne.

  • V konfiguračnom súbore telefónu (cfg.xml) s XML zadajte reťazec v tomto formáte:

    <Profile_Rule ua="na">/$psn.xml</Profile_Rule>

    <Profile_Rule_B ua="na"/>

    <Profile_Rule_C ua="na"/>

    <Profile_Rule_D ua="na"/>

  • Na webovej stránke telef ónu zadajte pravidlo profilu.

Predvolené: /$psn.xml

Možnosť použitia DHCP

Možnosti DHCP, vymedzené čiarkami, používané na načítanie firmvéru a profilov.

Predvolené: 66,160,159,150,60,43,125

Možnosť použitia DHCPv6

Možnosti DHCP, vymedzené čiarkami, používané na načítanie firmvéru a profilov.

Predvolené: 17,160,159

Poskytovanie prostredníctvom Cisco XML

Telefóny môžete poskytovať prostredníctvom funkcií Cisco XML.

Objekt XML môžete poslať do telefónu pomocou paketu 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:[profile-rule]/>
</CP-xxxx-3PCCExecute>

Keď telefón prijme objekt XML, stiahne súbor poskytovania z [profile-rule]. Toto pravidlo používa makrá na zjednodušenie vývoja aplikácie služieb XML.

Rozlíšenie URL s rozšírením makra

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 servera poskytujúceho alebo explicitnú IP adresu. Ak profil identifikuje server poskytovania podľa názvu, telefón vykoná vyhľadávanie DNS na vyriešenie názvu.

  • Neštandardný port servera, ktorý je zadaný v adrese URL pomocou štandardnej syntaxe:port podľa názvu servera.

  • Podadresár virtuálneho koreňového adresára servera, v ktorom je profil uložený, špecifikovaný pomocou štandardnej notácie URL a spravovaný rozšírením makra.

Nasledujúce pravidlo Profile_Rule napríklad pož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 port 6900:


<Profile_Rule>
tftp://prov.telco.com:6900/cisco/config/$PN.cfg
</Profile_Rule>

Profil každého telefónu je možné identifikovať v parametri všeobecného účelu, pričom jeho hodnota je uvedená v rámci spoločného pravidla profilu pomocou rozšírenia makra.

Predpokladajme napríklad, že GPP_B je definovaný ako Dj6Lmp23Q.

Pravidlo profilu má hodnotu:


tftp://prov.telco.com/cisco/$B/$MA.cfg

Keď sa zariadenie opätovne synchronizuje a makrá sa rozšíria, telefón s MAC adresou 000e08012345 požaduje profil s názvom, ktorý obsahuje MAC adresu zariadenia na nasledujúcej adrese URL:


tftp://prov.telco.com/cisco/Dj6Lmp23Q/000e08012345.cfg

Zadajte typ autentifikácie profilu

Autentifikácia profilu umožňuje používateľom telefónu opätovne synchronizovať profil poskytovania do telefónu. Informácie o autentifikácii sú potrebné, keď sa telefón pokúša znovu synchronizovať a stiahnuť konfiguračný súbor po prvýkrát a zobrazí sa chyba autentifikácie HTTP alebo HTTPS 401. Po povolení tejto funkcie sa v telefóne zobraz í obrazovka Nastavenie konta profilu v nasledujúcich situáciách:

  • Keď sa počas prvého poskytovania po reštarte telefónu vyskytne chyba autentifikácie HTTP alebo HTTPs 401

  • Keď sú používateľské meno a heslo profilového účtu prázdne

  • Ak v pravidle profilu nie sú žiadne používateľské meno a heslo

Ak je obrazovka nastavenia profilu zmeškaná alebo ignorovaná, používateľ môže pristupovať k obrazovke nastavenia aj prostredníctvom ponuky obrazovky telefónu alebo softklávesu Nastav enia, ktoré sa zobrazí iba vtedy, keď nie je zaregistrovaný žiadny riadok v telefóne.

Keď túto funkciu vypnete, obrazovka nastavenia konta profilu sa v telefóne nezobrazí.

Používateľské meno a heslo v poli Pravidlo profilu majú vyššiu prioritu ako profil účtu.

  • Ak v poli Pravidlo profilu zadáte správnu adresu URL bez používateľského mena a hesla, telefón vyžaduje autentifikáciu alebo súhrn na opätovnú synchronizáciu profilu. Pri správnom profilovom účte prechádza autentifikácia. Pri nesprávnom profilovom účte autentifikácia zlyhá.

  • Keď v poli Pravidlo profilu zadáte správnu adresu URL so správnym používateľským menom a heslom, telefón vyžaduje autentifikáciu alebo súhrn na opätovnú synchronizáciu profilu. Profilový účet sa nepoužíva na resynchronizáciu telefónu. Prihlásenie je úspešné.

  • Ak v poli Pravidlo profilu zadáte správnu adresu URL s nesprávnym používateľským menom a heslom, telefón vyžaduje autentifikáciu alebo súhrn na opätovnú synchronizáciu profilu. Konto profilu sa nepoužíva na resynchronizáciu telefónu. Prihlásenie vždy zlyhá.

  • Ak v poli Pravid lo profilu zadáte nesprávnu adresu URL, prihlásenie vždy zlyhá.

Parametre v konfiguračnom súbore telefónu môžete nakonfigurovať aj pomocou kódu XML (cfg.xml).

Typ autentifikácie profilu môžete zadať na webovej stránke správy telefónu.

1

Vstúpte na webovú stránku správy telefónu.

2

Vyberte polož ky Hlas > Poskytovanie.

3

V časti Kon figuračný profil nastavte parameter Typ overenia profilu, aby ste zadali poverenia, ktoré sa majú použiť na overenie profilového konta.

Tento parameter môžete nakonfigurovať v súbore XML konfigurácie telefónu (cfg.xml) zad aním reťazca v tomto formáte:

<Profile_Authentication_Type ua="na">Disabled</Profile_Authentication_Type>

Možnosti:

  • Zaká zané: Vypne funkciu profilového účtu. Keď je táto funkcia zakázaná, ponuka Nastavenia konta profilu sa na obrazovke telefónu nezobrazí.

  • Základné ove renie HTTP: Prihlasovacie údaje HTTP sa používajú na overenie účtu profilu.

  • Overenie XSI: Prihlasovacie údaje XSI alebo poverenia XSI SIP sa používajú na overenie účtu profilu. Prihlasovacie údaje závisia od typu autentifikácie XSI pre telefón:

    Keď je typ autentifikácie XSI pre telefón nastavený na Prihlasovacie údaje, použijú sa prihlasovacie údaje XSI.

    Keď je typ autentifikácie XSI pre telefón nastavený na hodnotu SIP poverenia, použijú sa poverenia XSI SIP.

Predvolené: Základná autentifikácia HTTP

4

Kliknite na polož ku Odoslať všetky zmeny.

Manuálne použitie profilu do telefónu

Stiahnite si konfiguračný súbor do telefónu zo servera TFTP

Dokončite tieto kroky a stiahnite si konfiguračný súbor do aplikácie servera TFTP v počítači.

1

Pripojte počítač k portu LAN telefónu.

2

Spustite aplikáciu servera TFTP v počítači a uistite sa, že konfiguračný súbor je k dispozícii v koreňovom adresári TFTP.

3

Vo webovom prehliadači zadajte IP adresu telefónu LAN, adresu IP počítača, názov súboru a prihlasovacie údaje. Použite tento formát:

http://<WAN_IP_Address>/admin/resync?tftp://<PC_IP_Address>/<file_name>&xuser=admin&xpassword=<password>

Príklad:

http://192.168.15.1/admin/resync?tftp://192.168.15.100/my_config.xml&xuser=admin&xpassword=admin

Stiahnite si konfiguračný súbor do telefónu pomocou cURL

Dokončite tieto kroky a stiahnite konfiguráciu do telefónu pomocou cURL. Tento nástroj príkazového riadka sa používa na prenos údajov pomocou syntaxe URL. Ak chcete stiahnuť cURL, navštívte:

https://curl.haxx.se/download.html

Odporúčame vám nepoužívať cURL na zverejnenie konfigurácie v telefóne, pretože používateľské meno a heslo môžu byť zachytené počas používania cURL.

1

Pripojte počítač k portu LAN telefónu.

2

Stiahnite si konfiguračný súbor do telefónu zadaním nasledujúceho príkazu cURL:

curl –d @my_config.xml
“http://192.168.15.1/admin/config.xml&xuser=admin&xpassword=admin”

Referencie pre konfiguráciu profilu

Telefón prijíma konfigurácie vo formáte XML.

Príklady v tejto časti používajú konfiguračné profily so syntaxou XML.

Konfiguračné formáty profilov

Konfiguračný profil definuje hodnoty parametrov pre telefón.

Formát XML konfiguračného profilu používa na kompiláciu parametrov a hodnôt štandardné nástroje na vytváranie XML.

Podporovaná je iba sada znakov UTF-8. Ak upravíte profil v editore, nemeňte formát kódovania; v opačnom prípade telefón nedokáže rozpoznať súbor.

Každý telefón má inú sadu funkcií, a teda inú sadu parametrov.

Otvoriť formát profilu

Profil otvoreného formátu je textový súbor so syntaxou podobnou XML v hierarchii prvkov s atribútmi a hodnotami prvkov. Tento formát umožňuje používať štandardné nástroje na vytvorenie konfiguračného súboru. Konfiguračný súbor XML môže byť odoslaný z poskytovacieho servera do telefónu počas operácie resynchronizácie bez kompilácie ako binárneho objektu.

Telefón môže akceptovať konfiguračné formáty, ktoré generujú štandardné nástroje. Táto funkcia uľahčuje vývoj serverového softvéru na poskytovanie back-end, ktorý generuje konfiguračné profily z existujúcich databáz.

Na ochranu dôverných informácií v konfiguračnom profile poskytujúci server poskytne konfiguračný súbor XML do telefónu cez kanál zabezpečený TLS. Voliteľne je možné súbor komprimovať 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 s šifrovaním AES-128-GCM

Konfiguračný súbor môže obsahovať tieto komponenty:

  • Značky prvkov

  • Atribúty

  • Parametre

  • Funkcie formátovania

  • XML komentáre

Príklad: Otvorený formát profilu


<flat-profile>
<Resync_On_Reset> Yes </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č <flat-profile>ka prvku obsahuje všetky prvky parametrov, ktoré telefón rozpozná.

Vlastnosti značky prvkov

Pri vytváraní alebo aktualizácii konfiguračného súboru majte na pamäti nasledujúce pravidlá.

  • Formát poskytovania XML a webové rozhranie umožňujú konfiguráciu rovnakých nastavení. Názvy značiek XML a názvy polí vo webovom rozhraní sú podobné, ale líšia sa kvôli obmedzeniam názvu prvkov XML. Napríklad podčiarknutie (_) v konfiguračnom súbore XML namiesto medzier vo webovom používateľskom rozhraní.

  • <flat-profile>Telefón rozpoznáva prvky so správnymi názvami parametrov, ktoré sú zapuzdrené v špeci álnom prvku.

  • Názvy prvkov sú uzavreté v uhlových zátvorkách.

  • Väčšina názvov prvkov je podobná názvom polí vo webovom 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čiarknutie za každú medzeru alebo špeciálne znaky [,], (,) alebo/.

      Príklad: Pr <Resync_On_Reset>vok predstavuje pole Resync pri resetovaní.

    • Každý názov prvku musí byť jedinečný. Vo webovom rozhraní telefónu sa rovnaké polia môžu zobraziť na viacerých webových stránkach, napríklad na stránkach Line, User a Extension. Pridajte [n] k názvu prvku, aby ste označili číslo zobrazené na karte stránky.

      Príklad: Pr <Dial_Plan_1_>vok predstavuje plán vytáčania pre riadok 1.

  • Každá značka otváracieho prvku musí mať zodpovedajúcu značku uzatváracieho prvku. Napríklad:

    
    <flat-profile>
    <Resync_On_Reset> Yes
      </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čky prvkov rozlišujú malé a veľké písmená.

  • Prázdne značky prvkov sú povolené a budú interpretované ako konfigurácia prázdnej hodnoty. Zadajte štítok otváracieho prvku bez zodpovedajúcej značky prvku a vložte medzeru a lomovú lomu dopredu pred držiak uzatváracieho uhla (>). V tomto príklade je pravidlo profilu B prázdne:

    
    <Profile_Rule_B />
    
  • Prázdna značka prvku môže byť použitá na zabránenie prepísaniu akýchkoľvek hodnôt poskytnutých používateľom počas operácie opätovnej synchronizácie. V nasledujúcom príklade sa nastavenia rýchleho vytáčania používateľa nezmenia:

    <flat-profile>
    <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 príslušného 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.

    
    <flat-profile>
    <GPP_A>
      </GPP_A>
    </flat-profile>
    
  • 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 viacnásobné výskyty rovnakej značky parametrov, posledný takýto výskyt prepíše všetky predchádzajúce. Aby sa zabránilo neúmyselnému prepísaniu konfiguračných hodnôt parametra, odporúčame, aby každý profil zadal maximálne jednu inštanciu parametra.

  • Prednosť má posledný spracovaný profil. Ak viacero profilov určuje rovnaký konfiguračný parameter, hodnota druhého profilu má prednosť.

Reťazcové formáty

Tieto vlastnosti sa vzťahujú na formátovanie reťazcov:

  • Komentáre sú povolené prostredníctvom štandardnej syntaxe XML.

    <!-- My comment is typed here -->
  • Vedúci a koncový biely priestor je povolený pre čitateľnosť, ale je odstránený z hodnoty parametra.

  • Nové riadky v rámci hodnoty sa konvertujú na medzery.

  • XML hlavička formulára <? ? > 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

    Úniková sekvencia XML

    & (zosilňovač)

    &

    < (menej ako)

    <

    > (väčšie ako)

    >

    '(apostrof)

    “

    „(dvojitý citát)

    „

    V nasledujúcom príklade sú zadané úniky znakov, ktoré predstavujú symboly väčšie a menšie ako symboly, 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 (Admin Login > advanced > Voice > Ext (n)) rovný (S0 <:18005551212>).

    
    <flat-profile>
     <Dial_Plan_1_>
      (S0 &lt;:18005551212&gt;)
     </Dial_Plan_1_>
    </flat-profile>
  • Prekladajú sa úniky číselných znakov pomocou desatinných a hexadecimálnych hodnôt (s.a. (a.).

  • Firmvér telefónu podporuje iba znaky ASCII.

Kompresia otvoreného profilu

Podporovanou metódou kompresie je algoritmus deflate gzip (RFC1951). Nástroj 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 Open profile generuje hlavičku. Telefón skontroluje hlavičku stiahnutého súboru, aby určil formát súboru.

Ak je napríklad profile.xml platným profilom, akceptuje sa aj súbor profil.xml. gz. Tento typ profilu môže generovať ktorýkoľvek z nasledujúcich príkazov:

  • >gzip profile.xml

    Nahrádza pôvodný súbor komprimovaným súborom.

  • >cat profile.xml | gzip > profil.xml.gz

    Ponechá pôvodný súbor na mieste a vytvorí nový komprimovaný súbor.

Otvorte šifrovanie profilu

Šifrovanie symetrických kľúčov možno použiť na šifrovanie otvoreného konfiguračného profilu bez ohľadu na to, či je súbor komprimovaný alebo nie. Kompresia, ak sa použije, musí byť použitá pred šifrovaním.

Server poskytovania služieb používa HTTPS na spracovanie počiatočného poskytovania telefónu po nasadení. Predšifrovanie konfiguračných profilov offline umožňuje použitie HTTP na následnú resynchronizáciu profilov. Tým sa znižuje zaťaženie servera HTTPS pri rozsiahlych nasadeniach.

Telefón podporuje dva spôsoby šifrovania konfiguračných súborov:

  • Šifrovanie AES-256-CBC

  • Šifrovanie obsahu HTTP založené na RFC 8188 s šifrovaním AES-128-GCM

Kľúč alebo vstupný kľúč (IKM) musí byť vopred poskytnutý do jednotky skôr. Bootstrap tajného kľúča je možné bezpečne dosiahnuť pomocou 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ý je k dispozícii na stiahnutie z rôznych internetových stránok. Podpora 256-bitového šifrovania AES môže vyžadovať opätovnú kompiláciu nástroja na povolenie kódu AES. Firmvér bol testovaný proti verzii openssl-1.1.1d.

V prípade šifrovaného súboru profil očakáva, že súbor bude mať rovnaký formát, aký bol generovaný nasledujúcim príkazom:


# example encryption key = SecretPhrase1234

openssl enc –e –aes-256-cbc –k SecretPhrase1234 –in profile.xml –out profile.cfg

# analogous invocation for a compressed xml file

openssl enc –e –aes-256-cbc –k SecretPhrase1234 –in profile.xml.gz –out profile.cfg

Malé písmená -k predchádza tajnému kľúču, ktorým môže byť ľubovoľná fráza obyčajného textu a ktorý sa používa na generovanie náhodnej 64-bitovej soli. S tajomstvom špecifikovaným argumentom -k odvodí šifrovací nástroj náhodný 128-bitový počiatočný vektor a skutočný 256-bitový šifrovací kľúč.

Ak sa táto forma šifrovania používa v konfiguračnom profile, telefón musí byť informovaný o hodnote tajného kľúča na dešifrovanie súboru. Táto hodnota je zadaná ako kvalifikátor v adrese URL profilu. Syntax je nasledovná s použitím explicitnej adresy URL:


[--key “SecretPhrase1234”] http://prov.telco.com/path/profile.cfg

Táto hodnota je naprogramovaná pomocou jedného z parametrov Profile_Rule.

Niekoľko parametrov poskytovania podlieha internej expanzii makro pred vyhodnotením. Tento krok predhodnotenia poskytuje väčšiu flexibilitu pri ovládaní činností opätovnej synchronizácie a aktualizácie telefónu.

Tieto skupiny parametrov prechádzajú makro rozšírením pred vyhodnotením:

  • Resynkčný spúšťač_*

  • Pravidlo profilu*

  • Log_XXX_MSG

  • Aktualizované_pravidlo

Za určitých podmienok niektoré všeobecné parametre (GPP_*) tiež podliehajú rozšíreniu makra, ako je výslovne uvedené v časti Vol iteľné argumenty opätovnej synchronizácie nižšie.

Počas rozšírenia makra obsah pomenovaných premenných nahrádza výrazy formulára $NAME a $ (NAME). Tieto premenné zahŕňajú všeobecné parametre, niekoľko identifikátorov produktov, určité časovače udalostí a hodnoty stavu poskytovania. Kompletný zoznam nájdete v téme Premenné rozšírenia makra v časti Paramet re poskytovania.

V nasledujúcom príklade sa na vloženie MAC adresy 000E08012345 používa výraz $ (MAU).

Správca zadá: $ (MAU) config.cfg

Výsledné rozšírenie makra pre zariadenie s MAC adresou 000E08012345 je: 000E08012345config.cfg

Ak sa názov makra nerozpozná, zostane nerozšírený. 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áva: $strange$mau.cfg

Výsledné rozšírenie makra pre zariadenie s MAC adresou 000E08012345 je: $Strange000E08012345.cfg

Rozšírenie makra sa nepoužíva rekurzívne. Napríklad $$MAU“ sa rozširuje na $MAU“ ($$ sa rozšíri) a nevedie k MAC adrese.

Obsah špeciálnych parametrov, GPP_SA cez GPP_SD, je mapovaný na makro výrazy $SA až $SD. Tieto parametre sú iba makro rozšírené ako argument možností --key, -- uid a -- pwd v resynchronizačnej adrese URL.

Podmienené výrazy môžu spustiť udalosti opätovnej synchronizácie a vybrať si z alternatívnych adries URL pre operácie opätovnej synchronizácie a aktualizácie.

Podmienené výrazy pozostávajú zo zoznamu porovnaní oddelených oper átorom a. Aby bola podmienka pravdivá, musia byť splnené všetky porovnania.

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

  • Dvojité citované reťazce

Čísla verzií

Verzia softvéru pre Cisco Video Phone 8875 používa tento formát (kde BN je číslo zostavy):

PHONEOS yyyy. 1-0-1-0001 - BN

kde yyyy označuje model telefónu alebo sériu telefónu; 1 je hlavná verzia; 0 je menšia verzia; 1-0001 je mikro verzia; a BN je číslo zostavy.

Porovnávací reťazec musí používať rovnaký formát. V opačnom prípade dôjde k chybe analýzy formátu.

Pri porovnávaní verzie softvéru sa hlavná verzia, menšia verzia a mikro verzia porovnávajú postupne a najľavejšie číslice majú prednosť pred druhými. Ak sú čísla verzií identické, porovnáva sa číslo zostavy.

Príklady platného čísla verzie

PHONEOS-8875.1-0-1-0001-19

Porovnanie

Citované reťazce možno porovnávať pre rovnosť alebo nerovnosť. Aritmeticky možno porovnávať aj celé čísla a čísla verzií. Porovnávacie operátory môžu byť vyjadrené ako symboly alebo ako skratky. Skratky sú vhodné na vyjadrenie stavu v profile otvoreného formátu.

Prevádzkovateľ

Alternatívna Syntax

Popis

Vzťahuje sa na celé číslo a verziu operandov

Vzťahuje sa na citované strunové operandy

=

ekv

rovná sa

Áno

Áno

!=

ne

nie je rovný

Áno

Áno

<

lt

menej ako

Áno

Nie

<=

le

menej alebo rovné

Áno

Nie

>

gt

väčšie ako

Áno

Nie

>=

ge

väčšie alebo rovné

Áno

Nie

AND

a

Áno

Áno

Je dôležité zahrnúť makro premenné do dvojitých úvodzoviek, kde sa očakáva doslovný reťazec. Nerobte tak 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 syntaxe „(expr)?“ ako v tomto príklade pravidla aktualizácie. Nezabudnite nahradiť BN číslom zostavy načítania firmvéru, na ktorý chcete aktualizovať.

($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 syntaxu so zátvorkami.

Pomocou syntaxe štandardnej adresy URL môžete určiť, ako načítať konfiguračné súbory a načítanie firmvéru v parametroch Profile_Rule* a Upgrade_Rule. Syntax je nasledovná:

[schéma://] [server [:port]] filepath

Kde je schéma jednou z týchto hodnôt:

  • tftp

  • Http

  • https

Ak je schéma vynechaná, predpokladá sa tftp. Serverom môže byť názov hostiteľa rozpoznaný DNS alebo číselná adresa IP. Port je cieľové číslo portu UDP alebo TCP. Filepath musí začínať koreňovým adresárom (/); musí to byť absolútna cesta.

Ak server chýba, použije sa server tftp zadaný 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 port UDP 69, http používa port TCP 80, https používa port TCP 443.

Musí byť prítomný priečinok súboru. Nemusí sa nevyhnutne odkazovať na statický súbor, ale môže naznačovať dynamický obsah získaný prostredníctvom CGI.

Rozšírenie makra sa uplatňuje v rámci adries URL. Nasledujú 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í možnosti DHCP 66 nie je prázdna syntax podporovaná pravidlami aktualizácie. Platí len pre pravidlo profilu*.

Šifrovanie obsahu HTTP založené na RFC 8188

Telefón podporuje šifrovanie obsahu HTTP založené na RFC 8188 s šifrovaním AES-128-GCM pre konfiguračné súbory. Pomocou tejto metódy šifrovania môže ľubovoľná entita čítať hlavičky správ HTTP. Užitočné zaťaženie však môžu čítať iba subjekty, ktoré poznajú Vstupný kľúčový materiál (IKM). Keď je telefón vybavený IKM, telefón a poskytujúci server si môžu bezpečne vymieňať konfiguračné súbory a zároveň umožniť 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 drž í IKM v telefóne. Z bezpečnostných dôvodov nie je tento parameter prístupný na webovej stránke správy telefónu. Nie je tiež viditeľný v konfiguračnom súbore telefónu, ku ktorému máte prístup z adresy IP telefónu alebo z konfiguračných zostáv telefónu odoslaných na poskytujúci server.

Ak chcete použiť šifrovanie založené na RFC 8188, uistite sa, že je to nasledovné:

  • Poskytnite telefónu IKM zadaním IKM s parametrom XML IKM_HTTP_Encrypt_Content v konfiguračnom súbore, ktorý sa odošle z poskytovacieho servera do telefónu.

  • Ak sa toto šifrovanie použije na konfiguračné súbory odoslané z poskytovacieho servera do telefónu, uistite sa, že hlavička HTTP kó dovania obsahu v konfiguračnom súbore má aes128gcm.

    Pri absencii tejto hlavičky má prednosť metóda AES-256-CBC. Telefón používa 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 konfiguračné zostavy, ktoré odošle serveru poskytovania služieb, uistite sa, že v pravidle zostavy nie je špecifikovaný ž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 parametroch Profile_Rule*, ktoré sú súhrnne uzavreté hranatými zátvorkami.

Možnosť --key informuje telefónu, že konfiguračný súbor, ktorý prijíma z poskytovacieho servera, je šifrovaný šifrovaním AES-256-CBC, pokiaľ hlavička Con tent-Encoding v súbore neoznačuje šifrovanie aes128gcm. Samotný kľúč je špecifikovaný ako reťazec nasledujúci po termíne --key. Kľúč 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 “my secret phrase”]
[--key a37d2fb9055c1d04883a0745eb0917a4]

Voliteľné argumenty v zátvorke sú rozšírené v makre. Špeciálne parametre, GPP_SA cez GPP_SD, sú makro rozšírené do makro premenných, $SA až $SD, iba ak sa používajú ako argumenty kľúčových možností. Pozrite si tieto príklady:

[--key $SC]
[--key “$SD”]

V profiloch otvoreného formátu musí byť argument na --key rovnaký ako argument k možnosti -k, ktorý je daný openssl.

Možnosti uid a pwd môžu byť použité na zadanie identifikátora používateľa a hesla, ktoré budú odoslané v reakcii na výzvy autentifikácie HTTP Basic a Digest, keď sa požaduje zadaná adresa URL. Voliteľné argumenty v zátvorke sú rozšírené v makre. Špeciálne parametre, GPP_SA cez GPP_SD, sú makro rozšírené do makro premenných, $SA až $SD, iba ak sa používajú ako argumenty kľúčových 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

Potom by sa 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,...} - voľba medzi a, b, c,...

  • Bool — booleova hodnota buď „áno“ alebo „nie“.

  • CADscript—miniscript, ktorý špecifikuje parametre kadencie signálu. Až 127 znakov.

    Syntax: S 1 [; S 2], kde:

    • S i =D i (on i,1 /off i,1 [, on i,2 /off i, 2 [, on i, 3 /off i, 3 [, on i,4 /off i, 4 [, on i,5 /off i ,5 [, on i,6 /off i, 6]]]) a je známy ako sekcia.

    • zapnutie i, j a vypnuté i, j sú trvanie zapnutia/vypnutia segment u v sekundách. i = 1 alebo 2 a j = 1 až 6.

    • D i je celkové trvanie úseku v sekundách.

    Všetky trvania môžu mať až tri desatinné miesta, aby poskytli 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ž do prehrávania celkového trvania.

    Príklad 1:

    
    60(2/4)
    
    Number of Cadence Sections = 1
    Cadence Section 1: Section Length = 60 s
    Number of Segments = 1
    Segment 1: On=2s, Off=4s
    
    Total Ring Length = 60s
    
    

    Príklad 2 - Výrazný prsteň (krátky, krátky, krátky, dlhý):

    
    60(.2/.2,.2/.2,.2/.2,1/4)
    
    Number of Cadence Sections = 1
    Cadence Section 1: Section Length = 60s
    Number of Segments = 4
    Segment 1: On=0.2s, Off=0.2s
    Segment 2: On=0.2s, Off=0.2s
    Segment 3: On=0.2s, Off=0.2s
    Segment 4: On=1.0s, Off=4.0s
    
    Total Ring Length = 60s
    
    
  • DialPlanScript — Syntax skriptu, ktorá sa používa na určenie plánov vytáčania riadkov 1 a riadku 2.

  • Float <n>—hodnota s pohyblivým bodom s až n desatinnými miestami.

  • FQDN - plne kvalifikovaný názov domény. Môže obsahovať až 63 znakov. Príklady sú nasledovné:

    • Sip.cisco.com:5060 alebo 109.12.14. 12:12345

    • Sip.cisco.com alebo 109.12.14.12

  • FreqScript — miniscript, ktorý špecifikuje frekvenčné a úrovňové parametre tónu. Obsahuje až 127 znakov.

    Syntax: F 1 @L 1 [, F 2 @L 2 [, F 3 @L 3 [, F 4 @L 4 [, F 5 @L 5 [, F 6 @L 6]]]], kde:

    • F 1 —F 6 sú frekvencie v Hz (iba nepodpísané celé čísla).

    • L 1 —L 6 sú zodpovedajúce úrovne v dBm (s až jedným desatinným miestom).

    Biele medzery pred a za čiarkou sú povolené, ale neodporúčajú sa.

    Príklad 1 - Tón čakania na hovor:

    
    440@-10
    
    Number of Frequencies = 1
    Frequency 1 = 440 Hz at –10 dBm
    
    

    Príklad 2 - Tón vytáčania:

    
    350@-19,440@-19
    
    Number of Frequencies = 2
    Frequency 1 = 350 Hz at –19 dBm
    Frequency 2 = 440 Hz at –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.

  • UserID — ID používateľa, ako sa zobrazuje na adrese URL; až 63 znakov.

  • Telefón — reťazec telefónneho čísla, napríklad 14081234567, *69, *72, 345678; alebo všeobecná adresa URL, 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, ktoré sú oddelené čiarkou (,). Biely priestor na začiatku každého vzoru sa ignoruje. „?“ 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 — číslo portu TCP/UDP (0-65535). Môže byť zadaný v desatinnom alebo šesťhrannom formáte.

  • ProvisioningRuleSyntax — Syntax skriptu, ktorá sa používa na definovanie pravidiel opätovnej synchronizá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ť zadaný v desatinnom alebo šesťhrannom formáte. Znak „-“ musí predchádzať záporným hodnotám. Znamenie + pred kladnými hodnotami je voliteľné.

  • Hviezdičkové kódy — Aktivačný kód doplnkovej služby, napr. *69. Kód môže obsahovať až 7 znakov.

  • Str <n>—všeobecný reťazec s až n nevyhradených znakov.

  • Čas <n>— Čas trvania v sekundách s až n desatinnými miestami. Ďalšie zadané desatinné miesta sa ignorujú.

  • ToneScript — miniscript, ktorý určuje parametre frekvencie, úrovne a kadencie tónu priebehu hovoru. Skript môže obsahovať až 127 znakov.

    Syntax: FreqScript; Z 1 [; Z 2].

    Sekcia Z 1 je podobná sekcii S 1 v CADScript, s výnimkou toho, že za každým segmentom zapnutia/vypnutia nasleduje parameter frekvenčných komponentov: Z 1 = D 1 (na i,1 /off i, 1 /f i,1 [, na i, 2/off i,2 /f i, 2 [, on i, 3 /off i,3 [, on i, 4 /off i,4 f i, 4 [, zapnuté i, 5/vypnuté i,5/f i ,5 [, zapnuté i, 6/vypnuté i,6/f i,6]]]]]) kde:

    • f i, j = n 1 [+n 2] +n 3 [+n 4 [+n 5 [+n 6]]]].

    • 1 < n k < 6 určuje frekvenčné komponenty vo FreqScript, ktoré sa používajú v tomto segmente.

    Ak sa v segmente použije viac ako jedna frekvenčná zložka, komponenty sa sumarizujú dohromady.

    Príklad 1 - Tón vytáčania:

    
    350@-19,440@-19;10(*/0/1+2)
    
    Number of Frequencies = 2
    Frequency 1 = 350 Hz at –19 dBm
    Frequency 2 = 440 Hz at –19 dBm
    Number of Cadence Sections = 1
    Cadence Section 1: Section Length = 10 s
    Number of Segments = 1
    Segment 1: On=forever, with Frequencies 1 and 2
    
    Total Tone Length = 10s
    
    

    Príklad 2 - Tón koktania:

    
    350@-19,440@-19;2(.1/.1/1+2);10(*/0/1+2)
    
    Number of Frequencies = 2
    Frequency 1 = 350 Hz at –19 dBm
    Frequency 2 = 440 Hz at –19 dBm
    Number of Cadence Sections = 2
    Cadence Section 1: Section Length = 2s
    Number of Segments = 1
    Segment 1: On=0.1s, Off=0.1s with Frequencies 1 and 2
    Cadence Section 2: Section Length = 10s
    Number of Segments = 1
    Segment 1: On=forever, with Frequencies 1 and 2
    
    Total Tone Length = 12s
    
    
  • Uns <n>— Nepodpísaná n-bitová hodnota, kde n = 8, 16 alebo 32. Môže byť zadaný v desatinnom alebo šesťhrannom formáte, napríklad 12 alebo 0x18, pokiaľ sa hodnota zmestí do n bitov.

Zohľadnite tieto:

  • <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é nie sú prítomné v danom profile.
  • Šablóny sa porovnávajú v danom poradí. Vyberie sa prvý, nie najbliž ší zápas. 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á nadobúda účinnosť v telefóne.
  • Špecifikácia parametra s prázdnou hodnotou parametra núti parameter späť na predvolenú hodnotu. Ak chcete namiesto toho zadať prázdny reťazec, použite prázdny reťazec „“ ako hodnotu parametra.
Bol tento článok užitočný?
Bol tento článok užitočný?