Configurați setările profilului pentru telefoanele din seria 9800 și 8875 (BroadWorks)

Configurați-vă telefonul pentru resincronizarea profilului

Resincronizați profilul telefonului prin TFTP

Telefonul acceptă mai multe protocoale de rețea pentru preluarea profilurilor de configurare. Cel mai de bază protocol de transfer de profil este TFTP (RFC1350). TFTP este utilizat pe scară largă pentru furnizarea dispozitivelor de rețea în rețelele LAN private. Deși nu este recomandat pentru implementarea punctelor finale la distanță pe Internet, TFTP poate fi convenabil pentru implementarea în cadrul organizațiilor mici, pentru preaprovizionarea internă și pentru dezvoltare și testare. În procedura următoare, un profil este modificat după descărcarea unui fișier de pe un server TFTP.

1	Într-un mediu LAN, conectați computerul și telefonul la un hub, comutator sau router mic.
2	Pe computer, instalați și activați un server TFTP.
3	Utilizați un editor de text pentru a crea un profil de configurare. Pentru a verifica dacă profilul a fost furnizat mai târziu telefonului dvs., puteți seta unele dintre valori ca mărci. De exemplu, setați valoarea pentru GPP_A la 12345678 așa cum se arată în exemplul următor: `<flat-profile>  <GPP_A> 12345678  </GPP_A> </flat-profile>`
4	Salvați fișierul de configurare XML în directorul rădăcină al serverului TFTP. Puteți verifica dacă serverul TFTP este configurat corect: solicitați fișierul profilului de configurare utilizând un client TFTP altul decât telefonul. De preferință, utilizați un client TFTP care rulează pe o gazdă separată de serverul de provizionare.
5	În browserul web de pe computer, deschideți pagina web de administrare. De exemplu, să presupunem că adresa IP a telefonului este 192.168.1.100, deschideți următoarea adresă URL în browserul dvs. web: `http://192.168.1.100/admin/advanced`
6	Selectați fila Voice > Provisioning și inspectați valorile parametrilor de uz general GPP_A prin GPP_P. Acestea ar trebui să fie goale.
7	Resincronizați telefonul de testare la profilul de configurare pe care l-ați creat deschizând adresa URL de resincronizare într-un browser web. Exemplu: Dacă adresa IP a serverului TFTP este 192.168.1.200, comanda ar trebui să fie similară cu următorul exemplu: `http://192.168.1.100/admin/resync?tftp://192.168.1.200/basic.txt` Când telefonul primește această comandă, dispozitivul de la adresa 192.168.1.100 solicită fișierul de profil de configurare `basic.txt` de la serverul TFTP la adresa IP 192.168.1.200. Telefonul analizează apoi fișierul descărcat și actualizează parametrul GPP_A cu valoarea 12345678.
8	Verificați dacă parametrul a fost actualizat corect. Reîmprospătați pagina web de administrare și accesați Voice > Provisioning. Parametrul GPP_A ar trebui să conțină acum valoarea 12345678.

Furnizarea unui profil specific telefonului pe un server TFTP

1	Obțineți adresa MAC a telefonului de pe eticheta produsului său. (Adresa MAC este numărul, folosind numere și cifre hexagonale minuscule, de exemplu, 000e08aabbcc.
2	Redenumiți fișierul de configurare `în CP-xxxx macaddress.cfg` (înlocuind `xxxx` cu numărul modelului și `macaddress cu adresa` MAC a telefonului). Exemplu: `CP-8875 000e08aabbcc.cfg`
3	Mutați noul fișier în directorul rădăcină virtual al serverului TFTP.
4	Accesați pagina web de administrare a telefonului.
5	Selectați Vo ce > A provizionare.
6	Introduceţi calea fişierului de profil în câmpul Regulă profil. Exemplu: Să presupunem că adresa IP a serverului TFTP este 192.168.1.200 și numele fișierului de profil este `<Profile_Rule> tftp://192.168.1.200/CP-8875$MA.cfg </Profile_Rule>`
7	Faceți clic pe Trimiteți toate modificările. Acest lucru determină o repornire imediată și o resincronizare. Când are loc următoarea resincronizare, telefonul preia noul fișier prin extinderea expresiei macro $MA în adresa MAC.

Resincronizați profilul telefonului cu HTTP GET

1	Instalați un server HTTP pe computerul local sau pe altă gazdă accesibilă. Serverul open source Apache poate fi descărcat de pe internet.
2	Încărcați fișierul profilului de configurare în directorul rădăcină virtual al serverului instalat.
3	Pentru a verifica instalarea corectă a serverului și accesul la fișierul de profil, deschideți profilul cu un browser web.
4	Modificați regula Profile_a telefonului de testare pentru a indica serverul HTTP în locul serverului TFTP, astfel încât să descărcați periodic profilul acestuia. De exemplu, presupunând că serverul HTTP este la 192.168.1.300 și numele fișierului profilului este basic.txt, introduceți următoarea valoare: `<Profile_Rule> http://192.168.1.200/basic.txt </Profile_Rule>`
5	Faceți clic pe Trimiteți toate modificările. Acest lucru determină o repornire imediată și o resincronizare.
6	Observați mesajele syslog pe care le trimite telefonul. Resincronizările periodice ar trebui acum să obțină profilul de pe serverul HTTP.
7	În jurnalele serverului HTTP, observați modul în care informațiile care identifică telefonul de testare apar în jurnalul agenților utilizatori. Aceste informații ar trebui să includă producătorul, numele produsului, versiunea curentă a firmware-ului și numărul de serie.

Resincronizați automat profilul telefonului

Un dispozitiv poate resincona periodic cu serverul de aprovizionare pentru a se asigura că orice modificări de profil făcute pe server sunt propagate către dispozitivul final (spre deosebire de trimiterea unei cereri explicite de resincronizare către punctul final).

Pentru a determina resetarea periodică a telefonului cu un server, o adresă URL a profilului de configurare este definită utilizând parametrul Profile_Rule, iar o perioadă de resincronizare este definită utilizând parametrul Resync_Periodic.

1	Accesați pagina web de administrare a telefonului.
2	Selectați Vo ce > A provizionare.
3	Definiți parametrul Profile_Rule. Acest exemplu presupune o adresă IP a serverului TFTP de 192.168.1.200.
4	În câmpul Resincronizare periodică, introduceți o valoare mică pentru testare, cum ar fi 30 de secunde.
5	Faceți clic pe Trimiteți toate modificările. Cu noile setări ale parametrilor, telefonul se resincronizează de două ori pe minut cu fișierul de configurare pe care îl specifică adresa URL.
6	Observați mesajele rezultate în urmărirea syslog.
7	Asigurați-vă că câmpul Resincronizare la resetare este setat la Da. `<Resync_On_Reset>Yes</Resync_On_Reset>`
8	Porniți telefonul pentru a-l forța să se resincronizeze cu serverul de aprovizionare. Dacă operația de resincronizare eșuează din orice motiv, cum ar fi dacă serverul nu răspunde, unitatea așteaptă (pentru numărul de secunde configurat în Resync Error Retry Delay) înainte de a încerca să resincronizeze din nou. Dacă întârzierea de reîncercare a erorii de resincronizare este zero, telefonul nu încearcă să resincronizeze după o încercare de resincronizare eșuată.
9	(Opțional) Setați valoarea câmpului Resincronizare Error Retry Delay la un număr mic, cum ar fi 30. `<Resync_Error_Retry_Delay>30</Resync_Error_Retry_Delay>`
10	Dezactivați serverul TFTP și observați rezultatele în ieșirea syslog.

Parametrii de resincronizare a profilului

Următorul tabel definește funcția și utilizarea parametrilor de resincronizare a profilului în secțiunea Profil de configurare din fila Voice > Provisioning din pagina web a telefonului. De asemenea, definește sintaxa șirului care este adăugat în fișierul de configurare a telefonului (cfg.xml) cu cod XML pentru a configura un parametru.

Tabelul 1. Parametrii de resincronizare a profilului
Parametru	Descriere
Activare provizionare	Permite sau refuză acțiunile de resincronizare a profilului de configurare. În fișierul de configurare a telefonului (cfg.xml) cu XML, introduceți un șir în acest format: `<Provision_Enable ua="na">Da</Provision_Enable>` Pe pagina web a telefonului, setați acest câmp la Da pentru a permite acțiunile de resincronizare sau Nu pentru a bloca acțiunile de resincronizare. Implicit: Da
Resincronizare la resetare	Specifică dacă telefonul resincronizează configurațiile cu serverul de aprovizionare după pornire și după fiecare încercare de actualizare. În fișierul de configurare a telefonului (cfg.xml) cu XML, introduceți un șir în acest format: `<Resync_On_Reset ua="na">Da</Resync_On_Reset>` Pe pagina web a telefonului, setați acest câmp la Da pentru a permite resincronizarea la pornire sau resetare sau Nu pentru a bloca resincron izarea la pornire sau resetare. Implicit: Da
Resincronizați întârzierea aleatorie	Previne supraîncărcarea serverului de aprovizionare atunci când un număr mare de dispozitive pornesc simultan și încearcă configurarea inițială. Această întârziere este eficientă numai la încercarea inițială de configurare, după pornirea sau resetarea dispozitivului. Parametrul este intervalul maxim de timp pe care dispozitivul îl așteaptă înainte de a intra în contact cu serverul de aprovizionare. Întârzierea reală este un număr pseudo-aleatoriu între 0 și această valoare. Acest parametru este în unități de 20 de secunde. Valoarea valabilă variază între 0 și 65535. În fișierul de configurare a telefonului (cfg.xml) cu XML, introduceți un șir în acest format: `<Resync_Random_Delay ua="na">2</Resync_Random_Delay>` Pe pagina web a telefonului, specificați numărul de unități (20 de secunde) pentru ca telefonul să întârzie resincronizarea după pornire sau resetare. Valoarea implicită este 2 (40 secunde).
Resincronizare la (HHmm)	Timpul (HHmm) pe care telefonul îl resincronizează cu serverul de aprovizionare. Valoarea pentru acest câmp trebuie să fie un număr de patru cifre cuprins între 0000 și 2400 pentru a indica ora în format HHmm. De exemplu, 0959 indică 09:59. În fișierul de configurare a telefonului (cfg.xml) cu XML, introduceți un șir în acest format: `<Resync_At__HHmm_ ua="na">0959</Resync_At__HHmm_>` Pe pagina web a telefonului, specificați ora în format HHMM pentru ca telefonul să înceapă resincronizarea. Valoarea implicită este goală. Dacă valoarea este nevalidă, parametrul este ignorat. Dacă acest parametru este setat cu o valoare validă, parametrul Resync Periodic este ignorat.
Resincronizare la întârziere aleatorie	Previne supraîncărcarea serverului de aprovizionare atunci când un număr mare de dispozitive pornesc simultan. Pentru a evita inundarea cererilor de resincronizare către server de la mai multe telefoane, telefonul se resincronizează în intervalul dintre ore și minute, iar orele și minutele plus întârzierea aleatorie (hhmm, hhmm+random_delay). De exemplu, dacă întârzierea aleatorie = (Resincronizare la întârziere aleatorie + 30) /60 minute, valoarea de intrare în secunde este convertită în minute, rotunjind până la minutul următor pentru a calcula intervalul final random_delay. În fișierul de configurare a telefonului (cfg.xml) cu XML, introduceți un șir în acest format: `<Resync_At_Random_Delay ua="na">600</Resync_At_Random_Delay>` Pe pagina web a telefonului, specificați perioada de timp în secunde. Valoarea valabilă variază între 600 și 65535. Dacă valoarea este mai mică de 600, întârzierea internă aleatorie este cuprinsă între 0 și 600. Valoarea implicită este de 600 de secunde (10 minute).
Resincronizare periodică	Intervalul de timp dintre resincronizarea periodică cu serverul de aprovizionare. Temporizatorul de resincronizare asociat este activ numai după prima sincronizare reușită cu serverul. Formatele valide sunt următoarele: Un întreg Exemplu: O intrare de `3000` indică faptul că următoarea resincronizare are loc în 3000 de secunde. Numere întregi multiple Exemplu: O intrare de `600,1200.300` indică faptul că prima resincronizare are loc în 600 de secunde, a doua resincronizare are loc în 1200 de secunde după prima, iar a treia resincronizare are loc în 300 de secunde după a doua. Un interval de timp Exemplu, o intrare de `2400+30` indică faptul că următoarea resincronizare are loc între 2400 și 2430 de secunde după o resincronizare reușită. În fișierul de configurare a telefonului (cfg.xml) cu XML, introduceți un șir în acest format: `<Resync_Periodic ua="na">3600</Resync_Periodic>` Pe pagina web a telefonului, specificați perioada de timp în secunde. Setați acest parametru la zero pentru a dezactiva resincronizarea periodică. Valoarea implicită este de 3600 secunde.
Eroare de resincronizare Întârziere reîncercare	Dacă o operație de resincronizare eșuează deoarece telefonul nu a putut prelua un profil de pe server sau fișierul descărcat este corupt sau apare o eroare internă, telefonul încearcă să resincronizeze din nou după un timp specificat în secunde. Formatele valide sunt următoarele: Un întreg Exemplu: O intrare de `300` indică faptul că următoarea reîncercare pentru resincronizare are loc în 300 de secunde. Numere întregi multiple Exemplu: O intrare de `600,1200.300` indică faptul că prima reîncercare are loc în 600 de secunde după eșec, a doua reîncercare are loc în 1200 de secunde după eșecul primei reîncercări, iar a treia reîncercare are loc în 300 de secunde după eșecul celei de-a doua reîncercări. Un interval de timp De exemplu, o intrare de `2400+30` indică faptul că următoarea reîncercare are loc între 2400 și 2430 de secunde după o eroare de resincronizare. Dacă întârzierea este setată la 0, dispozitivul nu încearcă să resincronizeze din nou după o încercare de resincronizare eșuată. În fișierul de configurare a telefonului (cfg.xml) cu XML, introduceți un șir în acest format: `<Resync_Error_Retry_Delay ua="na">60,120,240,480,960,1920,3840,7680,15360,30720,61440,8640.8640.86400</Resync_Error_Retry_Delay>` Pe pagina web a telefonului, specificați perioada de timp în secunde. Implicit: 60,120,240,480,960,1920,3840,7680,15360,30720,61440,86400
Întârziere de resincronizare forțată	Întârzierea maximă (în secunde) pe care telefonul așteaptă înainte de a efectua o resincronizare. Dispozitivul nu se resincronizează în timp ce una dintre liniile sale telefonice este activă. Deoarece o resincronizare poate dura câteva secunde, este de dorit să așteptați până când dispozitivul a fost inactiv pentru o perioadă lungă de timp înainte de resincronizare. Acest lucru permite unui utilizator să efectueze apeluri succesiv fără întrerupere. Dispozitivul are un cronometru care începe să numere în jos atunci când toate liniile sale devin inactive. Acest parametru este valoarea inițială a contorului. Evenimentele de resincronizare sunt întârziate până când acest contor scade la zero. Valoarea valabilă variază între 0 și 65535. În fișierul de configurare a telefonului (cfg.xml) cu XML, introduceți un șir în acest format: `<Forced_Resync_Delay ua="na">14400</Forced_Resync_Delay>` Pe pagina web a telefonului, specificați perioada de timp în secunde. Valoarea implicită este de 14.400 de secunde.
Resincronizați de la SIP	Controlează solicitările de operațiuni de resincronizare printr-un eveniment SIP NOTIFY trimis de la serverul proxy al furnizorului de servicii către telefon. Dacă este activat, proxy-ul poate solicita o resincronizare trimițând un mesaj SIP NOTIFY care conține antetul Event: resync către dispozitiv. În fișierul de configurare a telefonului (cfg.xml) cu XML, introduceți un șir în acest format: `<Resync_From_SIP ua="na">Da</Resync_From_SIP>` Pe pagina web a telefonului, selectați Da pentru a activa această caracteristică sau Nu pentru a o dezactiva. Implicit: Da
Resincronizare după încercarea de actualizare	Activează sau dezactivează operația de resincronizare după orice actualizare. Dacă este selectat Da, sincronizarea este declanșată după o actualizare a firmware-ului. În fișierul de configurare a telefonului (cfg.xml) cu XML, introduceți un șir în acest format: `<Resync_After_Upgrade_Attempt ua="na">Da</Resync_After_Upgrade_Attempt>` Pe pagina web a telefonului, selectați Da pentru a declanșa resincronizarea după o actualizare de firmware sau Nu pentru a nu resinc roniza. Implicit: Da
Resincronizare Trigger 1 Resincronizare Trigger 2	Dacă ecuația logică din acești parametri se evaluează la FALSE, resincronizarea nu este declanșată chiar și atunci când Resync On Reset este setat la TRUE. Numai resincronizarea prin adresa URL de acțiune directă și notificarea SIP ignoră aceste declanșatoare de resincronizare. Parametrii pot fi programați cu o expresie condiționată care suferă expansiune macro. Pentru extinderile macrocomenzilor valide, consultați Variabile de expansiune macro sub Paramet rii de furnizare. În fișierul de configurare a telefonului (cfg.xml) cu XML, introduceți un șir în acest format: `<Resync_Trigger_1 ua="na">$ UPGTMR gt 300 și $ PRVTMR ge 600</Resync_Trigger_1>` `<Resync_Trigger_2 ua="na"/>` Pe pagina web a telefonului, specificați declanșatoarele. Implicit: necompletat
Resincronizare configurabilă de utilizator	Permite unui utilizator să resincronizeze telefonul din meniul ecranului telefonului. Când este setat la Da, un utilizator poate resincona configurația telefonului introducând regula profilului de pe telefon. Când este setat la Nu, parametrul Regulă profil nu este afișat în meniul ecranului telefonului. În fișierul de configurare a telefonului (cfg.xml) cu XML, introduceți un șir în acest format: `<User_Configurable_Resync ua="na">Da</User_Configurable_Resync>` Pe pagina web a telefonului, selectați Da pentru a afișa parametrul Regulă profil în meniul telefonului sau selectați Nu pentru a ascunde acest parametru. Implicit: Da
Resincronizarea eșuează pe FNF	O resincronizare este considerată de obicei nereușită dacă un profil solicitat nu este primit de la server. Acest parametru suprascrie acest comportament. Când este setat la Nu, dispozitivul acceptă un răspuns de fișier care nu `a fost găsit de` la server ca o resincronizare reușită. În fișierul de configurare a telefonului (cfg.xml) cu XML, introduceți un șir în acest format: `<Resync_Fails_On_FNF ua="na">Da</Resync_Fails_On_FNF>` Pe pagina web a telefonului, selectați Da pentru a considera un răspuns de fișier ne `găsit ca o resincronizare` nereușită sau selectați Nu pentru a lua un răspuns de fișier negăsit ca o resincronizare reușită`.` Implicit: Da
Tip de autentificare profil	Specifică acreditările de utilizat pentru autentificarea contului de profil. Op țiunile disponibile sunt: Dezactiv at: Dezactivează caracteristica contului de profil. Când această caracteristică este dezactivată, meniul de configurare a contului de profil nu se afișează pe ecranul telefonului. Autentificare HTTP de bază: acreditările de conectare HTTP sunt utilizate pentru autentificarea contului de profil. Autentificare XSI: acreditările de conectare XSI sau acreditările XSI SIP sunt utilizate pentru autentificarea contului de profil. Acreditările de autentificare depind de tipul de autentificare XSI pentru telefon: Când tipul de autentificare XSI pentru telefon este setat la Acreditări de con ectare, se utilizează acreditările de conectare XSI. Când tipul de autentificare XSI pentru telefon este setat la Acreditări SIP, se utilizează ac reditările XSI SIP. În fișierul de configurare a telefonului (cfg.xml) cu XML, introduceți un șir în acest format: `<Profile_Authentication_Type ua="na">Autentificare Http de bază</Profile_Authentication_Type>` Pe pagina web a telefonului, selectați o opțiune din listă pentru ca telefonul să autentifice resincronizarea profilului. Implicit: Autentificare HTTP de bază Pentru mai multe informații, consultați Specificarea tipului de autentificare a profilului sub Specificarea telefonului pentru resincronizarea profilului.
Regula profilului Regula profilului B Regula profilului C Regula profilului D	Fiecare regulă de profil informează telefonul despre o sursă din care să obțină un profil (fișier de configurare). În timpul fiecărei operații de resincronizare, telefonul aplică toate profilurile în ordine. `Dacă aplicați criptarea AES-256-CBC fișierelor de configurare, specificați cheia de criptare cu cuvântul cheie --key după cum urmează:` `[--cheie]` <encryption key> Puteți introduce cheia de criptare în ghilimele duble („) opțional. În fișierul de configurare a telefonului (cfg.xml) cu XML, introduceți un șir în acest format: `<Profile_Rule ua="na">/$psn.xml</Profile_Rule>` `<Profile_Rule_B ua="na"/>` `<Profile_Rule_C ua="na"/>` `<Profile_Rule_D ua="na"/>` Pe pagina web a telefonului, specificați regula profilului. Implicit: `/$psn.xml`
Opțiunea DHCP de utilizat	Opțiuni DHCP, delimitate prin virgule, utilizate pentru a prelua firmware-ul și profilurile. Implicit: 66,160,159,150,60,43,125
Opțiunea DHCPv6 de utilizat	Opțiuni DHCP, delimitate prin virgule, utilizate pentru a prelua firmware-ul și profilurile. Implicit: 17,160,159

Furnizarea prin Cisco XML

Puteți furniza telefoane prin funcțiile Cisco XML.

Puteți trimite un obiect XML la telefon printr-un pachet SIP Notify sau un Post HTTP la interfața CGI a telefonului: http://PhoneIPAddress/CGI/Execute.

CP-xxxx-3PCC extinde caracteristica Cisco XML pentru a sprijini furnizarea printr-un obiect XML:


<CP-xxxx-3PCCExecute>
        <ExecuteItem URL=Resync:[profile-rule]/>
</CP-xxxx-3PCCExecute>

După ce telefonul primește obiectul XML, acesta descarcă fișierul de provizionare din [profile-rule]. Această regulă utilizează macrocomenzi pentru a simplifica dezvoltarea aplicației de servicii XML.

Rezoluție URL cu expansiune macro

Subdirectoarele cu mai multe profiluri pe server oferă o metodă convenabilă pentru gestionarea unui număr mare de dispozitive implementate. Adresa URL a profilului poate conține:

Un nume de server de furnizare sau o adresă IP explicită. Dacă profilul identifică serverul de furnizare după nume, telefonul efectuează o căutare DNS pentru a rezolva numele.
Un port de server nestandard care este specificat în adresa URL utilizând sintax:port standard după numele serverului.
Subdirectorul directorului rădăcină virtual al serverului în care este stocat profilul, specificat prin utilizarea notației URL standard și gestionat prin expansiune macro.

De exemplu, următoarea Profile_Rule solicită fișierul de profil ($PN.cfg), în subdirectorul serverului /cisco/config, de la serverul TFTP care rulează pe host prov.telco .com ascultând o conexiune la portul 6900:


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

Un profil pentru fiecare telefon poate fi identificat într-un parametru de uz general, cu valoarea sa menționată într-o regulă comună de profil utilizând expansiunea macro.

De exemplu, să presupunem că GPP_B este definit ca Dj6Lmp23Q.

Profile_Rule are valoarea:


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

Când dispozitivul se resincronizează și macrocomenzile sunt extinse, telefonul cu o adresă MAC de 000e08012345 solicită profilul cu numele care conține adresa MAC a dispozitivului la următoarea adresă URL:


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

Specificați tipul de autentificare a profilului

Autentificarea profilului permite utilizatorilor de telefon să resincronizeze profilul de aprovizionare pe telefon. Informațiile de autentificare sunt necesare în timp ce telefonul încearcă să resincronizeze și să descarce fișierul de configurare pentru prima dată și primește o eroare de autentificare HTTP sau HTTPS 401. Când activaţi această caracteristică, ecranul de configurare a contului de profil este afişat pe telefon pentru următoarele situaţii:

Când apare eroarea de autentificare HTTP sau HTTPs 401 în timpul furnizării pentru prima dată după repornirea telefonului
Când numele de utilizator și parola contului de profil sunt goale
Când nu există nume de utilizator și parolă în regula profilului

Dacă ecranul de configurare a contului de profil este ratat sau ignorat, utilizatorul poate accesa ecranul de configurare și prin meniul ecranului telefonului sau prin tasta soft Setare, care se afișează numai atunci când nu este înregistrată nicio linie de pe telefon.

Când dezactivați caracteristica, ecranul de configurare a contului de profil nu se afișează pe telefon.

Numele de utilizator și parola din câmpul Regula profil ului au o prioritate mai mare decât contul de profil.

Când furnizați o adresă URL corectă în câmpul Regula profil ului fără nume de utilizator și parolă, telefonul necesită autentificare sau digerare pentru a resincroniza profilul. Cu contul de profil corect, autentificarea trece. Cu un cont de profil incorect, autentificarea eșuează.
Când furnizați o adresă URL corectă în câmpul Regula profil ului cu un nume de utilizator și o parolă corecte, telefonul necesită autentificare sau digerare pentru a resincroniza profilul. Contul de profil nu este utilizat pentru resincronizarea telefonului. Conectarea este reușită.
Când furnizați o adresă URL corectă în câmpul Regula profilului cu un nume de utilizator și o parolă incorecte, telefonul necesită autentificare sau digerare pentru a resincroniza profilul. Contul de profil nu este utilizat pentru resincronizarea telefonului. Conectarea eșuează întotdeauna.
Când furnizați o adresă URL incorectă în câmpul Regula profil ului, conectarea eșuează întotdeauna.

De asemenea, puteți configura parametrii din fișierul de configurare a telefonului cu codul XML (cfg.xml).

Puteți specifica tipul de autentificare a profilului din pagina web de administrare a telefonului.

1	Accesați pagina web de administrare a telefonului.
2	Selectați Vo ce > A provizionare.
3	În secțiunea Profil de configurare, setați parametrul Tip de autentificare profil pentru a specifica acreditările de utilizat pentru autentificarea contului de profil. Puteți configura acest parametru în fișierul XML de configurare a telefonului (cfg.xml) introducând un șir în acest format: `<Profile_Authentication_Type ua="na">Disabled</Profile_Authentication_Type>` Opțiuni: Dezactiv at: dezactivează funcția contului de profil.Când această caracteristică este dezactivată, meniul Configurare cont profil nu se afișează pe ecranul telefonului. Autentificare HTTP de bază: acreditările de conectare HTTP sunt utilizate pentru autentificarea contului de profil. Autentificare XSI: acreditările de conectare XSI sau acreditările XSI SIP sunt utilizate pentru autentificarea contului de profil. Acreditările de autentificare depind de tipul de autentificare XSI pentru telefon: Când tipul de autentificare XSI pentru telefon este setat la Acreditări de conectare, se utilizează acreditările de conectare XSI. Când tipul de autentificare XSI pentru telefon este setat la Acreditări SIP, se utilizează acreditările XSI SIP. Implicit: Autentificare HTTP de bază
4	Faceți clic pe Trimiteți toate modificările.

Aplicarea manuală a unui profil pe telefon

Descărcați fișierul de configurare pe telefon de pe un server TFTP

Finalizați acești pași pentru a descărca fișierul de configurare într-o aplicație server TFTP de pe PC.

1	Conectați computerul la portul LAN al telefonului.
2	Rulați o aplicație de server TFTP pe computer și asigurați-vă că fișierul de configurare este disponibil în directorul rădăcină TFTP.
3	Într-un browser web, introduceți adresa IP LAN a telefonului, adresa IP a computerului, numele fișierului și acreditările de conectare. Utilizați acest format: `http://<WAN_IP_Address>/admin/resync?tftp://<PC_IP_Address>/<file_name>&xuser=admin&xpassword=<password>` Exemplu: `http://192.168.15.1/admin/resync?tftp://192.168.15.100/my_config.xml&xuser=admin&xpassword=admin`

Descărcați fișierul de configurare la telefon cu cURL

Finalizați acești pași pentru a descărca configurația pe telefon utilizând cURL. Acest instrument de linie de comandă este utilizat pentru a transfera date cu o sintaxă URL. Pentru a descărca cURL, vizitați:

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

Vă recomandăm să nu utilizați cURL pentru a posta configurația pe telefon, deoarece numele de utilizator și parola ar putea fi capturate în timp ce utilizați cURL.

1	Conectați computerul la portul LAN al telefonului.
2	Descărcați fișierul de configurare la telefon introducând următoarea comandă cURL: `curl –d @my_config.xml “http://192.168.15.1/admin/config.xml&xuser=admin&xpassword=admin”`

Referințe pentru configurarea profilului

Telefonul acceptă configurații în format XML.

Exemplele din această secțiune utilizează profiluri de configurare cu sintaxă XML.

Formate de profil de configurare

Profilul de configurare definește valorile parametrilor pentru telefon.

Formatul XML al profilului de configurare utilizează instrumente standard de creare XML pentru a compila parametrii și valorile.

Numai setul de caractere UTF-8 este acceptat. Dacă modificați profilul într-un editor, nu modificați formatul de codare; în caz contrar, telefonul nu poate recunoaște fișierul.

Fiecare telefon are un set de caracteristici diferit și, prin urmare, un set diferit de parametri.

Deschideți formatul profilului

Profilul format deschis este un fișier text cu sintaxă asemănătoare XML într-o ierarhie de elemente, cu atribute și valori ale elementelor. Acest format vă permite să utilizați instrumente standard pentru a crea fișierul de configurare. Un fișier de configurare XML poate fi trimis de la serverul de provizionare la telefon în timpul unei operațiuni de resincronizare, fără compilare ca obiect binar.

Telefonul poate accepta formate de configurare pe care le generează instrumentele standard. Această caracteristică facilitează dezvoltarea software-ului serverului de furnizare back-end care generează profiluri de configurare din bazele de date existente.

Pentru a proteja informațiile confidențiale din profilul de configurare, serverul de furnizare livrează fișierul de configurare XML către telefon printr-un canal securizat de TLS. Opțional, fișierul poate fi comprimat utilizând algoritmul gzip deflate (RFC1951).

Fișierul poate fi criptat cu una dintre aceste metode de criptare:

Criptare AES-256-CBC
Criptare de conținut HTTP bazată pe RFC-8188 cu cifrare AES-128-GCM

Un fișier de configurare poate include aceste componente:

Etichetele elementului
Atribute
Parametrii
Caracteristici de formatare
Comentarii XML

Exemplu: Deschideți formatul profilului


<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>

<flat-profile>Eticheta elementului cuprinde toate elementele parametrilor pe care telefonul le recunoaște.

Proprietățile etichetei elementului

Rețineți următoarele reguli atunci când creați sau actualizați fișierul de configurare.

Formatul de furnizare XML și interfața Web permit configurarea acelorași setări. Numele etichetelor XML și numele câmpurilor din interfața de utilizare Web sunt similare, dar variază din cauza restricțiilor privind numele elementelor XML. De exemplu, subliniază (_) în fișierul de configurare XML în loc de spații pe interfața Web.

<flat-profile>Telefonul recunoaște elemente cu nume proprii de parametri care sunt încapsulate în elementul special.

Numele elementelor sunt închise între paranteze unghiulare.

Cele mai multe nume de elemente sunt similare cu numele câmpurilor de pe interfața Web a telefonului, cu următoarele modificări:

Numele elementelor nu pot include spații sau caractere speciale. Pentru a obține numele elementului din numele câmpului web, înlocuiți o subliniere pentru fiecare spațiu sau caracterele speciale [,], (,) sau/.

Exemplu: <Resync_On_Reset>Elementul reprezintă câmpul Resincronizare la resetare.

Fiecare nume de element trebuie să fie unic. În interfața Web a telefonului, aceleași câmpuri pot apărea pe mai multe pagini web, cum ar fi paginile Linie, Utilizator și Extensie. Adăugați [n] la numele elementului pentru a indica numărul afișat în fila pagină.

Exemplu: <Dial_Plan_1_>Elementul reprezintă planul de apel are pentru linia 1.

Fiecare etichetă de element de deschidere trebuie să aibă o etichetă de element de închidere potrivită. De exemplu:

<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>

Etichetele elementelor sunt sensibile la majuscule.

Etichetele elementelor goale sunt permise și vor fi interpretate ca configurând valoarea pentru a fi goală. Introduceţi eticheta elementului de deschidere fără o etichetă de element corespunzătoare şi introduceţi un spaţiu şi o oblică înainte de paranteza unghiului de închidere (>). În acest exemplu, regula profilului B este goală:

<Profile_Rule_B />

O etichetă de element gol poate fi utilizată pentru a preveni suprascrierea oricăror valori furnizate de utilizator în timpul unei operații de resincronizare. În exemplul următor, setările de apelare rapidă a utilizatorului sunt neschimbate:

<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>

Utilizați o valoare goală pentru a seta parametrul corespunzător la un șir gol. Introduceți un element de deschidere și închidere fără nicio valoare între ele. În exemplul următor, parametrul GPP_A este setat la un șir gol.

<flat-profile> <GPP_A> </GPP_A> </flat-profile>

Numele elementelor nerecunoscute sunt ignorate.

Proprietățile parametrilor

Aceste proprietăți se aplică parametrilor:
Orice parametri care nu sunt specificați de un profil sunt lăsați neschimbați în telefon.
Parametrii nerecunoscuți sunt ignorați.
Dacă profilul Format deschis conține mai multe apariții ale aceleiași etichete de parametru, ultima astfel de apariție le înlocuiește pe cele anterioare. Pentru a evita suprascrierea accidentală a valorilor de configurare pentru un parametru, recomandăm ca fiecare profil să specifice cel mult o instanță a unui parametru.
Ultimul profil procesat are prioritate. Dacă mai multe profiluri specifică același parametru de configurare, valoarea celui din urmă profil are prioritate.

Formate de șir

Aceste proprietăți se aplică formatării șirurilor de caractere:
Comentariile sunt permise prin sintaxa XML standard.

Spațiul alb inițial și final este permis pentru lizibilitate, dar este eliminat din valoarea parametrului.
Liniile noi dintr-o valoare sunt convertite în spații.
Un antet XML al formularului <? ? > este permis, dar telefonul îl ignoră.
Pentru a introduce caractere speciale, utilizaţi caracterele de bază ale caracterelor XML, după cum se arată în tabelul următor.
Caracterul special
Secvență de evacuare XML
& (ampersand)
&
< (mai puțin decât)
<
> (mai mare decât)
>
'(apostrof)
'
” (citat dublu)
„
În exemplul următor, scările de caractere sunt introduse pentru a reprezenta simbolurile mai mari decât și mai mici decât care sunt necesare într-o regulă de plan de apelare. Acest exemplu definește un plan de apelare pentru linia telefonică de informații care setează <Dial_Plan_1_>parametrul (Admin Login > avans at> Voice > Ext (n)) egal cu (S0 <:18005551212>).
<flat-profile> <Dial_Plan_1_> (S0 <:18005551212>) </Dial_Plan_1_> </flat-profile>
Escapele de caractere numerice, folosind valori zecimale și hexazecimale (s.a. (și.), sunt traduse.
Firmware-ul telefonului acceptă numai caractere ASCII.

Caracterul special	Secvență de evacuare XML
& (ampersand)	&
< (mai puțin decât)	<
> (mai mare decât)	>
'(apostrof)	'
” (citat dublu)	„

Compresia profilului deschis

Metoda de compresie acceptată este algoritmul gzip deflate (RFC1951). Utilitarul gzip și biblioteca de compresie care implementează același algoritm (zlib) sunt disponibile de pe site-urile de Internet.

Pentru a identifica compresia, telefonul se așteaptă ca fișierul comprimat să conțină un antet compatibil gzip. Invocarea utilitarului gzip pe profilul Open original generează antetul. Telefonul inspectează antetul fișierului descărcat pentru a determina formatul fișierului.

De exemplu, dacă profile.xml este un profil valid, fișierul profil.xml. gz este de asemenea acceptat. Oricare dintre următoarele comenzi poate genera acest tip de profil:

> gzip profile.xml

Înlocuiește fișierul original cu fișier comprimat.

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

Lasă fișierul original în loc și produce un nou fișier comprimat.

Deschideți criptarea profilului

Criptarea cheii simetrice poate fi utilizată pentru a cripta un profil de configurare deschis, indiferent dacă fișierul este comprimat sau nu. Compresia, dacă este aplicată, trebuie aplicată înainte de criptare.

Serverul de provizionare utilizează HTTPS pentru a gestiona furnizarea inițială a telefonului după implementare. Pre-criptarea profilurilor de configurare offline permite utilizarea HTTP pentru resincronizarea profilurilor ulterior. Acest lucru reduce sarcina pe serverul HTTPS în implementări pe scară largă.

Telefonul acceptă două metode de criptare pentru fișierele de configurare:

Criptare AES-256-CBC

Criptare de conținut HTTP bazată pe RFC 8188 cu cifrare AES-128-GCM

Cheia sau materialul de introducere a cheilor (IKM) trebuie să fie prealocate în unitate la un moment anterior. Bootstrap-ul cheii secrete poate fi realizat în siguranță folosind HTTPS.

Numele fișierului de configurare nu necesită un anumit format, dar un nume de fișier care se termină cu extensia .cfg indică în mod normal un profil de configurare.

Criptare AES-256-CBC

Telefonul acceptă criptarea AES-256-CBC pentru fișierele de configurare.

Instrumentul de criptare OpenSSL, disponibil pentru descărcare de pe diverse site-uri de internet, poate efectua criptarea. Suportul pentru criptarea AES pe 256 de biți poate necesita recompilarea instrumentului pentru a activa codul AES. Firmware-ul a fost testat împotriva versiunii openssl-1.1.1d.

Pentru un fișier criptat, profilul se așteaptă ca fișierul să aibă același format ca cel generat de următoarea comandă:

# 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

O minusculă -k precede cheia secretă, care poate fi orice frază de text simplu și care este utilizată pentru a genera o sare aleatorie pe 64 de biți. Cu secretul specificat de argumentul -k, instrumentul de criptare derivă un vector inițial aleatoriu pe 128 de biți și cheia de criptare reală de 256 de biți.

Când această formă de criptare este utilizată pe un profil de configurare, telefonul trebuie informat despre valoarea cheii secrete pentru a decripta fișierul. Această valoare este specificată ca calificator în adresa URL a profilului. Sintaxa este următoarea, folosind o adresă URL explicită:

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

Această valoare este programată utilizând unul dintre parametrii Profile_Rule.

Mai mulți parametri de provizionare sunt supuși expansiunii macro intern înainte de a fi evaluați. Acest pas de preevaluare oferă o mai mare flexibilitate în controlul activităților de resincronizare și actualizare a telefonului.

Aceste grupuri de parametri suferă expansiune macro înainte de evaluare:

Resincronizare_declanșator_*

Regula profilului*

Log_XXX_MSG

Actualizare_Regula

În anumite condiții, unii parametri de uz general (GPP_*) suferă, de asemenea, expansiune macro, așa cum este indicat în mod explicit în secțiunea Argumente de resincronizare opționale de mai jos.

În timpul expansiunii macro, conținutul variabilelor numite înlocuiește expresiile formularului $NAME și $ (NAME). Aceste variabile includ parametri de uz general, mai mulți identificatori de produs, anumite temporizatoare de evenimente și valori ale stării de furnizare. Pentru o listă completă, consultați Variabile de expansiune macro sub Parametrii de furnizare.

În exemplul următor, expresia $ (MAU) este utilizată pentru a insera adresa MAC 000E08012345.

Administratorul introduce: $ (MAU) config.cfg

Extinderea macro rezultată pentru un dispozitiv cu adresa MAC 000E08012345 este: 000E08012345config.cfg

Dacă un nume de macrocomandă nu este recunoscut, acesta rămâne neextins. De exemplu, numele STRANGE nu este recunoscut ca un nume de macro valid, în timp ce MAU este recunoscut ca un nume valid de macrocomandă.

Administratorul introduce: $strange$mau.cfg

Extinderea macro rezultată pentru un dispozitiv cu adresa MAC 000E08012345 este: $ strange000E08012345.cfg

Expansiunea macro nu este aplicată recursiv. De exemplu, $ $ MAU” se extinde în $ MAU” ($$ este extins) și nu are ca rezultat adresa MAC.

Conținutul parametrilor de scop special, GPP_SA până la GPP_SD, este mapat la expresiile macro $SA până la $SD. Acești parametri sunt doar macro extinși ca argument al opțiunilor --key, -- uid și --pwd într-o adresă URL de resincronizare.

Expresiile condiționale pot declanșa evenimente de resincronizare și pot selecta dintre adresele URL alternative pentru operațiunile de resincronizare și actualizare.

Expresiile condiționale constau dintr-o listă de comparații, separate de operatorul și. Toate comparațiile trebuie îndeplinite pentru ca condiția să fie adevărată.

Fiecare comparație se poate referi la unul dintre următoarele trei tipuri de literale:

Valori întregi

Numere de versiuni software sau hardware

Șiruri de caractere duble

Numere de versiune

Versiunea software pentru Cisco Video Phone 8875 utilizează acest format (unde BN este numărul de construcție):

PHONEOS aa aa. 1-0-1-0001 - NL

unde yyyy indică modelul telefonului sau seria de telefon; 1 este versiunea majoră; 0 este versiunea minoră; 1-0001 este versiunea micro; și BN este numărul de construcție.

Șirul de comparație trebuie să utilizeze același format. În caz contrar, rezultă o eroare de analiză a formatului.

Când se compară versiunea software, versiunea majoră, versiunea minoră și versiunea micro sunt comparate în secvență, iar cifrele din stânga au prioritate față de cele din urmă. Când numerele de versiune sunt identice, numărul de compilare este comparat.

Exemple de număr de versiune valid

PHONEOS-8875.1-0-1-0001-19

Comparație

Șirurile citate pot fi comparate pentru egalitate sau inegalitate. Numerele întregi și numerele de versiune pot fi, de asemenea, comparate aritmetic. Operatorii de comparație pot fi exprimați ca simboluri sau ca acronime. Acronimele sunt convenabile pentru exprimarea condiției într-un profil format deschis.

Operator

Sintaxă alternativă

Descriere

Aplicabil operandelor întregi și versiunii

Aplicabil operandelor de șir citate

=

eq

egal cu

da

da

!=

no

nu este egal cu

da

da

<

lt

mai puțin decât

da

Nu

<=

le

mai mică sau egală cu

da

Nu

>

gt

mai mare decât

da

Nu

>=

ge

mai mare sau egal cu

da

Nu

AND

și

da

da

Este important să includeți variabilele macro în ghilimele duble acolo unde este de așteptat un șir literal. Nu faceți acest lucru acolo unde este așteptat un număr sau un număr de versiune.

Atunci când sunt utilizate în contextul parametrilor Profile_Rule* și Upgrade_Rule, expresiile condiționale trebuie să fie incluse în sintaxa „(expr)?” ca în acest exemplu de regulă de actualizare. Nu uitați să înlocuiți BN cu numărul de compilare al încărcării firmware-ului la care să faceți upgrade.

($SWVER ne PHONEOS-8875.1-0-1-0001-19)? http://ps.tell.com/sw/PHONEOS-8875.1-0-1-0001-BN.loads

Nu utilizați sintaxa precedentă cu paranteze pentru a configura parametrii Resync_Trigger_*.

Operator	Sintaxă alternativă	Descriere	Aplicabil operandelor întregi și versiunii	Aplicabil operandelor de șir citate
=	eq	egal cu	da	da
!=	no	nu este egal cu	da	da
<	lt	mai puțin decât	da	Nu
<=	le	mai mică sau egală cu	da	Nu
>	gt	mai mare decât	da	Nu
>=	ge	mai mare sau egal cu	da	Nu
AND		și	da	da

Utilizați sintaxa URL standard pentru a specifica modul de preluare a fișierelor de configurare și a încărcărilor de firmware în parametrii Profile_Rule* și, respectiv, Upgrade_Rule. Sintaxa este următoarea:

[schema://] [server [:port]] cale de fișier

În cazul în care schema este una dintre aceste valori:

tftp

http

https

Dacă schema este omisă, se presupune tftp. Serverul poate fi un nume de gazdă recunoscut de DNS sau o adresă IP numerică. Portul este numărul portului UDP sau TCP de destinație. Calea de fișiere trebuie să înceapă cu directorul rădăcină (/); trebuie să fie o cale absolută.

Dacă serverul lipsește, se utilizează serverul tftp specificat prin DHCP (opțiunea 66).

Pentru regulile de actualizare, serverul trebuie specificat.

Dacă portul lipsește, se utilizează portul standard pentru schema specificată. Tftp folosește portul UDP 69, http folosește portul TCP 80, https folosește portul TCP 443.

Trebuie să fie prezentă o cale de fișiere. Nu trebuie să se refere neapărat la un fișier static, dar poate indica conținut dinamic obținut prin CGI.

Extinderea macro se aplică în URL-uri. Următoarele sunt exemple de adrese URL valide:

/$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

Când utilizați opțiunea DHCP 66, sintaxa goală nu este acceptată de regulile de actualizare. Se aplică numai pentru regula profilului*.

Criptarea conținutului HTTP bazată pe RFC 8188

Telefonul acceptă criptarea conținutului HTTP bazată pe RFC 8188 cu cifrare AES-128-GCM pentru fișierele de configurare. Cu această metodă de criptare, orice entitate poate citi anteturile mesajelor HTTP. Cu toate acestea, numai entitățile care cunosc materialul de introducere a cheilor (IKM) pot citi sarcina utilă. Când telefonul este furnizat cu IKM, telefonul și serverul de furnizare pot face schimb de fișiere de configurare în siguranță, permițând în același timp elementelor de rețea terțe să utilizeze anteturile mesajelor în scopuri analitice și de monitorizare.

Parametrul de configurare XML IKM_HTTP_EncryptContent deține IKM pe telefon. Din motive de securitate, acest parametru nu este accesibil pe pagina web de administrare a telefonului. De asemenea, nu este vizibil în fișierul de configurare al telefonului, pe care îl puteți accesa de pe adresa IP a telefonului sau din rapoartele de configurare ale telefonului trimise către serverul de aprovizionare.

Dacă doriţi să utilizaţi criptarea bazată pe RFC 8188, asiguraţi-vă următoarele:

Furnizați telefonul cu IKM specificând IKM cu parametrul XML IKM_HTTP_EncryptContent în fișierul de configurare care este trimis de la serverul de aprovizionare la telefon.

Dacă această criptare este aplicată fișierelor de configurare trimise de la serverul de aprovizionare către telefon, asigurați-vă că antetul HTTP de codificare a conținutului din fișierul de configurare are aes128gcm.

În absența acestui antet, metoda AES-256-CBC are prioritate. Telefonul aplică decriptarea AES-256-CBC dacă o cheie AES-256-CBC este prezentă într-o regulă de profil, indiferent de IKM.

Dacă doriți ca telefonul să aplice această criptare la rapoartele de configurare pe care le trimite către serverul de aprovizionare, asigurați-vă că nu există nicio cheie AES-256-CBC specificată în regula raportului.

Argumente opționale de resincronizare

Argumentele opționale, key, uid și pwd, pot preceda adresele URL introduse în parametrii Profile_Rule*, cuprinse colectiv de paranteze pătrate.

cheie
uid și pwd

Opțiunea --key spune telefonului că fișierul de configurare pe care îl primește de la serverul de aprovizionare este criptat cu criptare AES-256-CBC, cu excepția cazului în care antetul Content-Encoding din fișier indică criptarea aes128gcm. Cheia însăși este specificată ca un șir după termenul --key. Cheia poate fi inclusă în ghilimele duble („) opțional. Telefonul folosește cheia pentru a decripta fișierul de configurare.

Exemple de utilizare

[--key VerySecretValue] [--key “my secret phrase”] [--key a37d2fb9055c1d04883a0745eb0917a4]

Argumentele opționale paranteze sunt extinse macro. Parametrii de scop special, GPP_SA până la GPP_SD, sunt extinși macro în variabile macro, $SA până la $SD, numai atunci când sunt folosiți ca argumente de opțiune cheie. Vedeți aceste exemple:

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

În profilurile de format deschis, argumentul pentru --key trebuie să fie același cu argumentul opțiunii -k care este dat openssl.

Opțiunile uid și pwd pot fi utilizate pentru a specifica userID-ul și parola care vor fi trimise ca răspuns la provocările de autentificare HTTP Basic și Digest atunci când este solicitată adresa URL specificată. Argumentele opționale paranteze sunt extinse macro. Parametrii de scop special, GPP_SA până la GPP_SD, sunt extinși macro în variabile macro, $SA până la $SD, numai atunci când sunt folosiți ca argumente de opțiune cheie. Vedeți aceste exemple:

GPP_SA = MyUserID GPP_SB = MySecretPassword

[--uid $SA --pwd $SB] https://provisioning_server_url/path_to_your_config/your_config.xml

se va extinde apoi la:

[--uid MyUserId --pwdMySecretPassword] https://provisioning_server_url/path_to_your_config/your_config.xml

Tipuri de date

Aceste tipuri de date sunt utilizate cu parametrii profilului de configurare:

{a, b, c,...} - O alegere între a, b, c,...

Bool—Valoarea booleană a „da” sau „nu”.

CADScript — un miniscript care specifică parametrii de cadență ai unui semnal. Până la 127 de caractere.

Sintaxă: S ₁ [; S ₂], unde:

_{_{_{_{S _i =D _i (pe _{i,1 /off i,1} [, pe _{i,2/off i,} _{2 [, pe i,} 3 /off _i, _{3 [, pe i,4 /off i,} _{4 [, pe _{i,5 /off i} ,5 [, pe i} ,6 /off _i ,6]]]]) și este cunoscută sub numele de secțiune.}}}}

pe _{i, j} și off _{i, j} sunt durata de pornire/oprire în secunde a unui segment. i = 1 sau 2 și j = 1 până la 6.

D _i este durata totală a secțiunii în secunde.

Toate duratele pot avea până la trei zecimale pentru a oferi o rezoluție de 1 ms. Caracterul wildcard „*” înseamnă durată infinită. Segmentele dintr-o secțiune sunt redate în ordine și repetate până la redarea duratei totale.

Exemplul 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

Exemplul 2 - Inel distinctiv (scurt, scurt, scurt, lung):

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 — sintaxă de scriptare care este utilizată pentru a specifica planurile de apelare Linia 1 și Linia 2.

Float <n>—O valoare în virgulă mobilă cu până la n zecimale.

FQDN — Nume de domeniu complet calificat. Poate conține până la 63 de caractere. Exemplele sunt următoarele:
sip.cisco.com:5060 sau 109.12.14. 12:12345
Sip.cisco.com sau 109.12.14.12

FreqScript — un miniscript care specifică parametrii de frecvență și nivel ai unui ton. Conține până la 127 de caractere.

Sintaxă: F ₁ _{@L 1} [, F ₂ _{@L 2} [, F ₃ _{@L 3} [, F ₄ _{@L 4} [, F ₅ _{@L 5} [, F ₆ _{@L 6}]]]], unde:

F ₁ —F ₆ sunt frecvențe în Hz (numai numere întregi nesemnate).

L ₁ —L ₆ sunt niveluri corespunzătoare în dBm (cu până la o zecimală).

Spațiile albe înainte și după virgulă sunt permise, dar nu sunt recomandate.

Exemplul 1 — Tonul de așteptare a apelului:

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

Exemplul 2 — Ton de apelare:

350@-19,440@-19 Number of Frequencies = 2 Frequency 1 = 350 Hz at –19 dBm Frequency 2 = 440 Hz at –19 dBm

IP- Adresă IPv4 validă sub forma x.x.x.x, unde x este între 0 și 255. Exemplu: 10.1.2.100.

UserID — ID utilizator așa cum apare într-o adresă URL; până la 63 de caractere.

Telefon — Un șir de numere de telefon, cum ar fi 14081234567, *69, *72, 345678; sau o adresă URL generică, cum ar fi 1234 @10 .10.10. 100:5068 sau jsmith@Cisco.com. Șirul poate conține până la 39 de caractere.

PHTMPLT — un șablon de număr de telefon. Fiecare șablon poate conține unul sau mai multe modele care sunt separate printr-o virgulă (,). Spațiul alb de la începutul fiecărui model este ignorat. „?” iar „*” reprezintă caractere wildcard. Pentru a reprezenta literal, utilizați% xx. De exemplu, %2a reprezintă*. Șablonul poate conține până la 39 de caractere. Exemple: „1408*, 1510*”, „1408123???? , 555? 1.”.

Port — Numărul portului TCP/UDP (0-65535). Poate fi specificat în format zecimal sau hex.

ProvisioningRuleSyntax — sintaxă de scriptare care este utilizată pentru a defini regulile de resincronizare a configurației și actualizarea firmware-ului.

PWRLevel — nivel de putere exprimat în dBm cu o zecimală, cum ar fi —13,5 sau 1,5 (dBm).

RSCTMPLT — un șablon de cod de stare a răspunsului SIP, cum ar fi „404, 5*”, „61?” , „407, 408, 487, 481”. Poate conține până la 39 de caractere.

Sig <n>—Valoare semnată pe n-biți. Poate fi specificat în format zecimal sau hex. Un semn „-” trebuie să precede valorile negative. Semnul + înainte de valorile pozitive este opțional.

Coduri stelare — Cod de activare pentru un serviciu suplimentar, cum ar fi *69. Codul poate conține până la 7 caractere.

Str <n>—Un șir generic cu până la n caractere neconservate.

Timp <n>- Durata timpului în secunde, cu până la n zecimale. Zecimalele suplimentare specificate sunt ignorate.

ToneScript — un miniscript care specifică parametrii de frecvență, nivel și cadență ai unui ton de progres al apelului. Scriptul poate conține până la 127 de caractere.

Sintaxă: FreqScript; Z ₁ [; Z ₂].

_{_{_{_{_{_{_{_{Secțiunea Z ₁ este similară cu secțiunea S ₁ dintr-un CADScript, cu excepția faptului că fiecare segment de pornire/oprire este urmat de un parametru al componentelor de frecvență: Z _{1 = D 1 (pe i,1} _{/off i, ₁ /f i,1 [, pe i,} 2/off _i, 2 /f i, _{2 [, pe _i, 3/off i, 3 /f i,} _{3 [, pe _{i,4 /off i,} 4 /f _i, 4 [, pe i,5 /off i} ,5 /f i,5 [, pe _i ,6 /off _i ,6 /f}}}}}}}} _i,6]]]]] unde:

f _{i, j} = n ₁ [+n ₂] +n ₃ [+n ₄ [+n ₅ [+n ₆]]]].

1 < n _k < 6 specifică componentele de frecvență din FreqScript care sunt utilizate în acel segment.

Dacă se utilizează mai multe componente de frecvență într-un segment, componentele sunt însumate împreună.

Exemplul 1 — Ton de apelare:

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

Exemplul 2 - Ton de bâlbâială:

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>— Valoare n-bit nesemnată, unde n = 8, 16 sau 32. Poate fi specificat în format zecimal sau hex, cum ar fi 12 sau 0x18, atâta timp cât valoarea se poate încadra în n biți.

Țineți cont de acestea:

<Par Name>reprezintă un nume de parametru de configurare. Într-un profil, eticheta corespunzătoare este formată prin înlocuirea spațiului cu o subliniere „_”, cum ar fi Par _Name.
Un câmp de valoare implicită gol implică un șir gol < „” >.
Telefonul continuă să utilizeze ultimele valori configurate pentru etichetele care nu sunt prezente într-un profil dat.
Șabloanele sunt comparate în ordinea dată. Primul meci, nu cel mai apropiat, este selectat. Numele parametrului trebuie să se potrivească exact.
Dacă într-un profil este dată mai mult de o definiție pentru un parametru, ultima astfel de definiție din fișier este cea care intră în vigoare în telefon.
O specificație a parametrului cu o valoare a parametrului gol forțează parametrul să revină la valoarea implicită. Pentru a specifica în schimb un șir gol, utilizați șirul gol „” ca valoare a parametrului.

Cisco AI Assistant

Mulțumim pentru feedback.