A telefon konfigurálása a profilok szinkronizálásához

A telefon profiljának újraszinkronizálása TFTP-n keresztül

A telefon több hálózati protokollt is támogat a konfigurációs profilok lekéréséhez. A legalapabb profil átviteli protokoll a TFTP (RFC1350). A TFTP-t leggyakrabban a magán LAN hálózatokban használt hálózati eszközök szolgáltatására használatos. Bár nem javasolják távoli végpontok telepítésére az interneten, a TFTP kis szervezetknél, házon belüli előzetes szolgáltatáshoz, fejlesztéshez és teszteléshez kényelmes megoldás lehet. Az alábbi eljárásban a profil azután lesz módosítva, hogy a fájlt letöltötték egy TFTP szerverről.

1

LAN-környezetben csatlakoztassa a számítógépet és a telefont egy hubhoz, switch-hez vagy kis routerhez.

2

A számítógépen telepítsen és aktiváljon egy TFTP-szervert.

3

Egy szövegszerkesztővel hozzon létre egy konfigurációs profilt.

Ha később ellenőrizni szeretné, hogy a profil a telefonra került-e, akkor néhány értéket jelölésként állíthat be. Állítsa például a GPP_A értékét 12345678-ra, ahogyan az a következő példában látható:
<flat-profile>
  <GPP_A> 12345678
  </GPP_A>
</flat-profile>
4

Mentse az XML konfigurációs fájlt a TFTP-szerver gyökérkönyvtárába.

Ellenőrizheti, hogy a TFTP-szerver megfelelően van-e konfigurálva: kérje le a konfigurációs profilfájlt a telefontól eltérő TFTP-ügyfél segítségével. Lehetőleg olyan TFTP klienst használjon, ami nem a szolgáltató szerver kiszolgálón fut.

5

Nyissa meg a számítógép webböngészőjében az adminisztrációs weboldalt. Tegyük fel például, hogy a telefon IP-címe 192.168.1.100, és nyissa meg a következő URL-t a webböngészőben:

http://192.168.1.100/admin/advanced
6

Válassza ki a Hang > Ellátás lapot, és ellenőrizze a GPP_A-GPP_P általános célú paraméterek értékeit. Ezeknek üresnek kell lenniük.

7

Szinkronizálja újra a teszttelefont a létrehozott konfigurációs profillal az újraszinkronizálási URL webböngészőben történő megnyitásával.

Példa:

Ha a TFTP szerver IP címe 192.168.1.200, a parancsnak hasonlítania kell az alábbi példára:

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

Amikor a telefon megkapja ezt a parancsot, a 192.168.1.100 címen lévő készülék lekéri a basic.txt konfigurációs profilfájlt a 192.168.1.200 IP-címen lévő TFTP-szerverről. A telefon elemzi a letöltött fájlt és frissíti a GPP_A paramétert az 12345678 értékkel.

8

Ellenőrizze, hogy a paraméter helyesen lett-e frissítve. Frissítse az adminisztrációs weboldalt, és lépjen a Hang > Ellátás.

A GPP_A paraméternek mostantól az 12345678 értéket kell tartalmaznia.

Telefon-specifikus profil létrehozása egy TFTP-szerveren
1

A telefon MAC címének lekérdezése a termék címkéjéről. (A MAC-cím a szám, számok és kisbetűs hexadecimális számjegyek használatával, például 000e08aabbcc.

2

Nevezze át a konfigurációs fájlt CP-xxxx macaddress.cfg-re (az xxxx-et a modellszámmal, a macaddress-t pedig a telefon MAC-címével helyettesítve).

Példa:

CP-8875 000e08aabbcc.cfg

3

Helyezze át az új fájlt a TFTP-szerver virtuális gyökérkönyvtárába.

4

Lépjen be a telefon adminisztrációs weboldalára.

5

Válassza ki a Hang > Ellátás lehetőséget.

6

Adja meg a profilfájl elérési útvonalát a Profilszabály mezőben.

Példa: Tegyük fel, hogy a TFTP-szerver IP-címe 192.168.1.200, a profilfájl neve pedig 

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

Kattintson az Összes változás elküldése lehetőségre. Ez azonnali újraindulást és szinkronizálást okoz.

A következő újraszinkronizáláskor a telefon a $MA makró kiterjesztés kibontásával kéri le az új fájlt a MAC címére.

A telefonprofil újraszinkronizálása HTTP GET segítségével
1

Telepítsen egy HTTP-szervert a helyi számítógépre vagy más elérhető állomáson.

A nyílt forráskódú Apache szerver letölthető az internetről.

2

Töltse fel a konfigurációs profilfájlt a telepített szerver virtuális gyökérkönyvtárába.

3

A szerver megfelelő telepítésének és a profilfájlhoz való hozzáférésnek az ellenőrzéséhez nyissa meg a profilt egy webböngészővel.

4

Módosítsa a teszt telefon Profile_Rule szabályát, hogy a HTTP szerverre mutasson a TFTP szerver helyett, azaz rendszeres időközönként töltse le a profilt.

Ha például a HTTP-szerver a 192.168.1.300 címen található, és a profil fájlneve basic.txt, adja meg a következő értéket:

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

Kattintson az Összes változás elküldése lehetőségre. Ez azonnali újraindulást és szinkronizálást okoz.

6

Figyeljük meg a telefon által küldött syslog üzeneteket. A rendszeres időközönként indított újraszinkronizálás most a HTTP szerverről szerzi be a profilt.

7

A HTTP szerver naplókban figyeljük meg, hogy a teszt telefont azonosító információ hogyan jelenik meg a felhasználó ügynökök naplójában.

Ez az információ tartalmazza a gyártó, terméknév, aktuális förmver verzió és termék sorozatszám adatokat.

A telefonprofil automatikus újraszinkronizálása

Egy készülék rendszeresen tud újraszinkronizálni a szolgáltató szerverre, biztosítandó, hogy a szerveren végzett profil módosítások a végpont eszközön is érvénybe léptek (ahelyett, hogy egy explicit újraszinkronizálási kérést küldene a végpontra).

Ahhoz, hogy a telefon rendszeres időközönként újraszinkronizáljon a szerveren egy konfigurációs profil URL-t kell meghatározni a Profile_Rule paraméterrel, és egy újraszinkronizálási időtartamot kell meghatározni a Resync_Periodic paraméterrel.

1

Lépjen be a telefon adminisztrációs weboldalára.

2

Válassza ki a Hang > Ellátás lehetőséget.

3

Határozza meg a Profile_Rule paramétert. Ez a példa azt feltételezi, hogy a TFTP szerver IP címe 192.168.1.200.

4

Az Újraszinkronizálás időtartam mezőben adjon meg egy kis értéket a teszteléshez, például 30 másodpercet.

5

Kattintson az Összes módosítás benyújtása elemre.

Az új paraméter beállításokkal a telefon percenként kétszer szinkronizál újra az URL által meghatározott konfigurációs fájlra.

6

Figyelje meg a syslog-nyomkövetés üzeneteit.

7

Ellenőrizze, hogy az Újraszinkronizálás visszaállításkor mező beállítása Igen.

<Resync_On_Reset>Igen</Resync_On_Reset>
8

Végezzen egy teljes kikapcsolás és bekapcsolás ciklust a telefonon, hogy kikényszerítse az újraszinkronizálást a szolgáltató szerverrel.

Ha az újraszinkronizálási művelet sikertelen valamilyen oknál fogva, például a szerver nem válaszol, a készülék várakozik (az Újraszinkronizálás hiba ismételt próbálkozás késleltetés elemben meghatározott másodpercen át), mielőtt ismét megkísérli az újraszinkronizálást. Ha az Újraszinkronizálás hiba ismételt próbálkozás késleltetés nulla, a telefon nem próbál meg újraszinkronizálni egy sikertelen kísérlet után.

9

(Opcionális) Állítsa be az Újraszinkronizálás hiba ismételt próbálkozás késleltetés mező értékét egy kis számra, például 30.

<Resync_Error_Retry_Delay>30</Resync_Error_Retry_Retry_Delay>
10

Kapcsolja ki a TFTP szervert, és nézze meg az eredményeket a syslog kimenetben.

Profil-újraszinkronizálási paraméterek

A következő táblázat a Konfigurációs profil szakasz alatt található profil-újraszinkronizálási paraméterek funkcióját és használatát határozza meg a Voice > Provisioning fül alatt a telefon weboldalán. Meghatározza továbbá a telefon konfigurációs fájljába (cfg.xml) a paraméter konfigurálásához XML-kóddal hozzáadott karakterlánc szintaxisát.

1. táblázat Profil-újraszinkronizálási paraméterek

Paraméter

Leírás

Szolgáltatás engedélyezés

Engedélyezi vagy megtagadja a konfigurációs profilok újraszinkronizálási műveleteit.

  • A telefon XML konfigurációs fájljában (cfg.xml) adjon meg egy karakterláncot ebben a formátumban.

    <Provision_Enable ua="na">Igen</Provision_Enable>

  • A telefon weblapján állítsa ezt a mezőt Igen értékre az újra szinkronizálási műveletek engedélyezéséhez, vagy Nem értékre az újraszinkronizálási műveletek blokkolásához.

Alapértelmezett: igen

Újraszinkron visszaállítás után

Meghatározza, hogy a telefon a bekapcsolás után és minden frissítési kísérlet után újra szinkronizálja-e a konfigurációkat az ellátási szerverrel.

  • A telefon XML konfigurációs fájljában (cfg.xml) adjon meg egy karakterláncot ebben a formátumban.

    <Resync_On_Reset ua="na">Igen</Resync_On_Reset>

  • A telefon weboldalán állítsa ezt a mezőt Igen értékre, ha engedélyezni kívánja az újraszinkronizálást bekapcsoláskor vagy alaphelyzetbe állításkor, vagy Nem értékre, ha blokkolni kívánja az újraszinkronizálást bekapcsoláskor vagy alaphelyzetbe állításkor.

Alapértelmezett: igen

Újraszinkron random késleltetés

Megakadályozza az ellátási szerver túlterhelését, amikor nagyszámú eszköz egyszerre kapcsol be és próbálkozik a kezdeti konfigurációval. Ez a késleltetés csak az eszköz bekapcsolását vagy alaphelyzetbe állítását követő első konfigurációs kísérletnél érvényes.

A paraméter az a maximális időintervallum, amelyet az eszköz vár a kapcsolatfelvétel előtt az ellátási szerverrel. A tényleges késleltetés egy 0 és ez az érték közötti álvéletlen szám.

Ez a paraméter 20 másodperces egységben van megadva.

Az érvényes értéktartomány 0 és 65535 között van.

  • A telefon XML konfigurációs fájljában (cfg.xml) adjon meg egy karakterláncot ebben a formátumban.

    <Resync_Random_Delay ua="na">2</Resync_Random_Delay>

  • A telefon weblapján adja meg, hogy a telefon bekapcsolás vagy alaphelyzetbe állítás után hány egység (20 másodperc) késleltesse az újraszinkronizálást.

Az alapértelmezett érték 2 (40 másodperc).

Újraszinkronizálás ekkor (ÓÓpp)

Az az időpont (HHmm), amikor a telefon újraszinkronizál az ellátási szerverrel.

A mező értékének egy négyjegyű számnak kell lennie 0000 és 2400 között, amely az időt jelzi ki ÓÓpp formátumban. Például a 0959 09:59-et jelöl.

  • A telefon XML konfigurációs fájljában (cfg.xml) adjon meg egy karakterláncot ebben a formátumban.

    <Resync_At__HHmm_ ua="na">0959</Resync_At__HHmm_>

  • A telefon weblapján adja meg az újraszinkronizálás megkezdésének időpontját HHMM formátumban.

Az alapértelmezett érték üres. Ha az érték érvénytelen, a paramétert nem veszi figyelembe. Ha ez a paraméter érvényes értékkel van beállítva, a Resync Periodic paramétert figyelmen kívül hagyja.

Újraszinkron random késleltetésnél

Megakadályozza az ellátási szerver túlterhelését, amikor nagyszámú eszköz egyszerre kapcsol be.

Elkerülendő, hogy az újraszinkronizálási kérések elárasszák a szervert több telefonról, a telefon órában és percben megadott tartományban szinkronizál újra, amelyhez hozzáadódik a random késleltetés (óópp, óópp+random_delay). Például ha a véletlen késleltetés = (Resync At Random Delay + 30)/60 perc, a másodpercben megadott bemeneti értéket percekre konvertáljuk, és a következő percre kerekítjük felfelé a végső random_delay intervallum kiszámításához.

  • A telefon XML konfigurációs fájljában (cfg.xml) adjon meg egy karakterláncot ebben a formátumban.

    <Resync_At_Random_Delay ua="na">600</Resync_At_Random_Delay>

  • A telefon weboldalán adja meg az időtartamot másodpercekben.

Az érvényes értéktartomány 600 és 65535 között van.

Ha az érték kisebb, mint 600, akkor a véletlenszerű késleltetés belső értéke 0 és 600 között van.

Az alapértelmezett érték 600 másodperc (10 perc).

Újraszinkron időszakos

Az ellátási szerverrel történő időszakos újraszinkronizálás közötti időintervallum. A hozzá tartozó újraszinkron időzítő csak a szerverrel történt első sikeres szinkronizálás után aktív.

Az érvényes formátumok a következők:

  • Egy egész szám

    Példa: A 3000 megadott érték azt jelzi, hogy a következő újraszinkronizálás 3000 másodperc múlva esedékes.

  • Több egész szám

    Példa: A 600,1200,300 megadott érték azt jelzi, hogy az első újraszinkronizálás 600 másodperc múlva lesz esedékes, a második 1200 másodperccel az első után, a harmadik pedig 300 másodperccel a második után.

  • Egy időtartomány

    Például a 2400 + 30 megadott érték azt jelenti, hogy a következő újraszinkronizálás egy sikeres újraszinkronizálás után 2400 - 2430 másodperccel lesz esedékes.

  • A telefon XML konfigurációs fájljában (cfg.xml) adjon meg egy karakterláncot ebben a formátumban.

    <Resync_Periodic ua="na">3600</Resync_Periodic>

  • A telefon weboldalán adja meg az időtartamot másodpercekben.

Ha a paraméter beállítása nulla, kikapcsolja az időszakos újraszinkronizálást.

Az alapértelmezett érték 3600 másodperc.

Újraszinkron hiba újrapróbálkozás késleltetés

Ha az újraszinkronizálási művelet sikertelen, mert a telefon nem tudott lekérni egy profilt a szerverről, vagy a letöltött fájl sérült, vagy belső hiba lépett fel, a telefon másodpercekben megadott idő elteltével újra megpróbálja az újraszinkronizálást.

Az érvényes formátumok a következők:

  • Egy egész szám

    Példa: A 300 megadott érték azt jelzi, hogy a következő újraszinkronizálás 300 másodperc múlva esedékes.

  • Több egész szám

    Példa: A 600,1200,300 megadott érték azt jelenti, hogy az első újrapróbálkozás az első sikertelen kísérlet után 600 másodperccel lesz esedékes, a második 1200 másodperccel az első sikertelen újrapróbálkozás után, a harmadik pedig 300 másodperccel a második sikertelen újrapróbálkozás után.

  • Egy időtartomány

    Például egy beviteli 2400 + 30 azt jelzi, hogy a következő újrapróbálkozás között 2400 és 2430 másodperc után resync hiba fordul elő.

Ha a késleltetés értéke 0, a készülék nem próbál meg ismét szinkronizálni a sikertelen újraszinkron kísérlet után.

  • A telefon XML konfigurációs fájljában (cfg.xml) adjon meg egy karakterláncot ebben a formátumban.

    <Resync_Error_Retry_Delay ua="na">60,120,240,480,960,1920,3840,7680,15360,30720,61440,86400</Resync_Error_Retry_Delay>

  • A telefon weboldalán adja meg az időtartamot másodpercekben.

Alapértelmezett: 60,120,240,480,960,1920,3840,7680,15360,30720,61440,86400

Kikényszerített újraszinkron késleltetés

Az a maximális késleltetés (másodpercben) ameddig a telefon vár az újraszinkronizálás elvégzésével.

A készülék mindaddig nem szinkronizál újra, ha valamelyik telefonvonal aktív. Mivel az újraszinkronizálás több másodpercig is eltarthat, az újraszinkronizálás előtt célszerű megvárni, hogy a készülék hosszabb ideig legyen tétlen. Így a felhasználó megszakítás nélkül kezdeményezhet hívásokat egymás után.

A készüléken van egy időzítő, ami megkezdi a visszaszámlálást, amint minden vonal tétlen nem lesz. Ez a paraméter az időzítő legelső beállított értéke. Az újraszinkronizálási események mindaddig késleltetve vannak, amíg a számláló a nullára nem ér.

Az érvényes értéktartomány 0 és 65535 között van.

  • A telefon XML konfigurációs fájljában (cfg.xml) adjon meg egy karakterláncot ebben a formátumban.

    <Forced_Resync_Delay ua="na">14400</Forced_Resync_Delay>

  • A telefon weboldalán adja meg az időtartamot másodpercekben.

Az alapértelmezett érték 14,400 másodperc.

Újraszinkronizálás SIP-ről

A szolgáltató proxyszerverétől a telefonra küldött SIP NOTIFY eseményen keresztül vezérli az újraszinkronizálási műveletekre irányuló kérelmeket. Ha engedélyezve van, a proxy az Event: resync fejlécet tartalmazó SIP NOTIFY üzenet elküldésével kérheti az eszköznek az újraszinkronizálást.

  • A telefon XML konfigurációs fájljában (cfg.xml) adjon meg egy karakterláncot ebben a formátumban.

    <Resync_From_SIP ua="na">Igen</Resync_From_SIP>

  • Atelefon weboldalán válassza az Igen lehetőséget a funkció engedélyezéséhez, vagy a Nem lehetőséget a letiltáshoz.

Alapértelmezett: igen

Újraszinkron frissítési kísérlet után

Engedélyezi vagy kikapcsolja az újraszinkron műveletet a frissítések után. Ha az Igen lehetőséget választja, a szinkronizálás a firmware frissítése után indul el.

  • A telefon XML konfigurációs fájljában (cfg.xml) adjon meg egy karakterláncot ebben a formátumban.

    <Resync_After_Upgrade_Attempt ua="na">Igen</Resync_After_Upgrade_Attempt>

  • A telefon weboldalán válassza az Igen lehetőséget a firmware-frissítés utáni újraszinkronizálás elindításához, vagy a Nem lehetőséget az újraszinkronizálás mellőzéséhez.

Alapértelmezett: igen

Resync Trigger 1

Resync Trigger 2

Ha az ezekben a paraméterekben szereplő logikai egyenlet FALSE értékű, akkor az újraszinkronizálás nem indul el, még akkor sem, ha az Újraszinkronizálás alaphelyzetkor értéke TRUE. Csak a közvetlen műveleti URL-en és a SIP-értesítésen keresztüli újraszinkronizálás hagyja figyelmen kívül ezeket az újraszinkronizálási kiváltó okokat.

A paramétereket egy feltételes kifejezéssel lehet programozni, amely makróbővítésen megy keresztül. Az érvényes makróbővítésekről a Kiépítési paraméterek alatt található Makróbővítési változók című témakörben olvashat .

  • A telefon XML konfigurációs fájljában (cfg.xml) adjon meg egy karakterláncot ebben a formátumban.

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

    <Resync_Trigger_2 ua="na"/>

  • A telefon weboldalán adja meg a kiváltókat.

Alapértelmezett: Üres

Felhasználó által konfigurált újraszinkron

Lehetővé teszi a felhasználó számára a telefon újraszinkronizálását a telefon képernyőmenüjéből. Ha a beállítás Igen értékű, a felhasználó a telefonkonfigurációt a profilszabály telefonról történő megadásával szinkronizálhatja újra. Ha Nem értékre van állítva, a Profilszabály paraméter nem jelenik meg a telefon képernyőmenüjében.

  • A telefon XML konfigurációs fájljában (cfg.xml) adjon meg egy karakterláncot ebben a formátumban.

    <User_Configurable_Resync ua="na">Igen</User_Configurable_Resync>

  • A telefon weblapján válassza az Igen lehetőséget a Profilszabály paraméter megjelenítéséhez a telefon menüjében, vagy válassza a Nem lehetőséget a paraméter elrejtéséhez.

Alapértelmezett: igen

Újraszinkron sikertelen FNF-en

Egy újraszinkronizálás akkor sikertelen általában, ha a lekért profil nem érkezik meg a szerverről. Ez a paraméter felülírja ezt a viselkedést. Ha a Nem értékre van állítva, az eszköz sikeres újraszinkronizálásként fogadja el a szervertől érkező nem található fájl választ.

  • A telefon XML konfigurációs fájljában (cfg.xml) adjon meg egy karakterláncot ebben a formátumban.

    <Resync_Fails_On_FNF ua="na">Igen</Resync_Fails_On_FNF>

  • A telefon weboldalán válassza az Igen lehetőséget, ha a nem található fájl választ sikertelen újraszinkronizálásnak szeretné tekinteni, vagy válassza a Nem lehetőséget, ha a nem található fájl választ sikeres újraszinkronizálásnak szeretné tekinteni.

Alapértelmezett: igen

Profil hitelesítési típus

Megadja a profilfiók hitelesítéséhez használandó hitelesítő adatokat. A rendelkezésre álló lehetőségek a következők:

  • Letiltva: Letiltja a profilfiók funkciót. Ha ez a funkció ki van kapcsolva, a Profil fiókbeállítása menü nem jelenik meg a telefon képernyőjén.

  • Alapvető HTTP-hitelesítés: A HTTP bejelentkezési adatok a profilfiók hitelesítésére szolgálnak.

  • XSI hitelesítés: Az XSI bejelentkezési hitelesítő adatok vagy az XSI SIP hitelesítő adatok a profilfiók hitelesítésére szolgálnak. A hitelesítési hitelesítő adatok a telefon XSI-hitelesítési típusától függnek:

    • Ha a telefon XSI-hitelesítési típusa Bejelentkezési hitelesítő adatokra van állítva, akkor az XSI bejelentkezési hitelesítő adatokat használja.

    • Ha a telefon XSI-hitelesítési típusa SIP-hitelesítési adatokra van állítva, akkor az XSI SIP-hitelesítési adatokat használja.

  • A telefon XML konfigurációs fájljában (cfg.xml) adjon meg egy karakterláncot ebben a formátumban.

    <Profile_Authentication_Type ua="na">Basic Http Authentication</Profile_Authentication_Type>

  • A telefon weblapján válassza ki a telefon listájából a profilok újraszinkronizálásának hitelesítésére szolgáló opciót.

Alapértelmezett: Alapvető HTTP-hitelesítés

További információt A telefon megadása a profil újraszinkronizálásához szakaszban található Profilhitelesítési típus megadása című témakörben talál.

Profilszabály

B profilszabály

C profilszabály

D profilszabály

Minden profilszabály tájékoztatja a telefont, hogy mlyen forrásból szerezhet be profilt (konfigurációs fájlt). Minden újraszinkronizálási művelete során a telefon felhasznál minden profilt a sorrend betartásával.

A konfigurációs fájlokra AES-256-CBC titkosítás alkalmazása esetén, adja meg a titkosítási kulcsot a --kulcs kulcsszóval az alábbiak szerint:

[--key <titkosítási kulcs>]

A kulcsot tetszés szerint lehet tenni idézőjelek (") közé.

  • A telefon XML konfigurációs fájljában (cfg.xml) adjon meg egy karakterláncot ebben a formátumban.

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

    <Profile_Rule_B ua="na"/>

    <Profile_Rule_C ua="na"/>

    <Profile_Rule_D ua="na"/>

  • A telefon weboldalán adja meg a profilszabályt.

Alapértelmezett érték: /$PSN.xml

Alkalmazandó DHCP opció

Förmver és profil lekéréséhez vesszővel elválasztott DHCP opciókat használnak.

Alapértelmezett: 66,160,159,150,60,43,125

DHCPv6 opció használata

Förmver és profil lekéréséhez vesszővel elválasztott DHCP opciókat használnak.

Alapértelmezett: 17,160,159

Ellátás a Cisco XML segítségével

A telefonokat a Cisco XML-funkciók segítségével is elláthatja.

XML-objektumot küldhet a telefonhoz SIP Notify csomaggal vagy HTTP Post segítségével a telefon CGI-felületére: http://PhoneIPAddress/CGI/Execute.

A CP-xxxx-3PCC kiterjeszti a Cisco XML jellemzőt a szolgáltatás támogatására egy XML objektumon keresztül:

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

Miután a telefon fogadja az XML objektumot, letölti a szolgáltatás fájlt a [profile-rule] szabályból. Ez a szabály az XML szolgáltatás alkalmazás fejlesztésének egyszerűsítésére használ makrókat.

URL felbontás makrókibontással

A szerveren több profilt tartalmazó alkönyvtárakkal kényelmesen lehet kezelni akár nagyszámú telepített készüléket is. A profil URL tartalmazhat:

  • Szolgáltató szerver nevet vagy egy explicit IP címet. Ha a profil a szolgáltató szervert név szerint azonosítja, a telefon egy DNS keresést végez a név feloldására.

  • Egy nem standard szerver port, amelyet az URL-ben határoznak meg a standard :port szintaxissal, amelyet a szerver neve követ.

  • A szerver virtuális gyökérkönyvtárának alkönyvtára, ahol a profil el van tárolva, amelyet egy makró kiterjesztéssel kezelt standard URL határoz meg.

Például a következő Profile_Rule a profil fájlt kéri le ($PN.cfg) a /cisco/config szerver alkönyvtárban a TFTP szerveren, amely a prov.telco.com kiszolgálón fut, és a 6900-as porton ellenőrzi a csatlakozást: 

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

Minden egyes telefon profilja azonosítható egy általános célú paraméterben, ahol az érték makró kiterjesztéssel egy általános profilszabályra hivatkozik.

Például tegyük fel, hogy a GPP_B értéke Dj6Lmp23Q.

A Profile_Rule értéke:

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

Amikor a készülék újraszinkronizál és a makrók kiterjesztése megtörténik, a 000e08012345 MAC címmel rendelkező telefon lekéri a profilt azzal a névvel, amely tartalmazza a készülék MAC címét az alábbi URL-en:

tftp://prov.telco.com/cisco/Dj6Lmp23Q/000e08012345.cfg
A profil hitelesítési típusának megadása

A profilhitelesítés lehetővé teszi a telefonfelhasználók számára, hogy a telefonra újraszinkronizálják az ellátási profilt. A hitelesítési információkra akkor van szükség, amikor a telefon először próbál újraszinkronizálni és letölteni a konfigurációs fájlt, és HTTP vagy HTTPS 401 hitelesítési hibaüzenetet kap. Ha engedélyezi ezt a funkciót, a Profil fiókbeállítása képernyő jelenik meg a telefonon a következő helyzetekben:

  • Ha a telefon újraindítása után a HTTP vagy HTTPs 401 hitelesítési hiba lép fel az első alkalommal történő rendelkezésre bocsátás során

  • Ha a profilfiók felhasználóneve és jelszava üres

  • Ha nincs felhasználónév és jelszó a profilszabályban

Ha a Profil fiókbeállítása képernyő kimarad vagy figyelmen kívül hagyja, a felhasználó a telefon képernyőmenüjén keresztül vagy a Beállítás lágygombon keresztül is elérheti a beállítási képernyőt, amely csak akkor jelenik meg, ha a telefonon nincs vonal regisztrálva.

Ha letiltja a funkciót, a Profil fiókbeállítása képernyő nem jelenik meg a telefonon.

A Profilszabály mezőben megadott felhasználónév és jelszó magasabb prioritású, mint a profilfiók.

  • Ha a Profilszabály mezőben felhasználónév és jelszó nélkül ad meg egy helyes URL-t, a telefon hitelesítést vagy digestet kér a profil újraszinkronizálásához. A megfelelő profilfiókkal a hitelesítés sikerül. Helytelen profilfiók esetén a hitelesítés sikertelen.

  • Ha a Profilszabály mezőben helyes URL-t ad meg a helyes felhasználónévvel és jelszóval, a telefon hitelesítést vagy digestet kér a profil újraszinkronizálásához. A profilfiókot nem használják a telefon újraszinkronizálásához. A bejelentkezés sikeres.

  • Ha a Profilszabály mezőben helyes URL-t ad meg helytelen felhasználónévvel és jelszóval, a telefon hitelesítést vagy kivonatot kér a profil újraszinkronizálásához. A profilfiókot nem használják a telefon újraszinkronizálásához. A bejelentkezés mindig sikertelen.

  • Ha helytelen URL-t ad meg a Profilszabály mezőben, a bejelentkezés mindig sikertelen.

A telefon konfigurációs fájljában található paramétereket XML (cfg.xml) kóddal is konfigurálhatja.

A profilhitelesítés típusát a telefon adminisztrációs weboldalán adhatja meg.

1

Lépjen be a telefon adminisztrációs weboldalára.

2

Válassza ki a Hang > Ellátás lehetőséget.

3

A Konfigurációs profil szakaszban állítsa be a Profilhitelesítés típusa paramétert a profilfiók hitelesítéséhez használandó hitelesítő adatok megadásához.

Ezt a paramétert a telefon konfigurációs XML-fájljában (cfg.xml) konfigurálhatja egy ilyen formátumú karakterlánc megadásával:

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

Lehetőségek:

  • Letiltva: Ha ez a funkció le van tiltva, a Profil fiókbeállítása menü nem jelenik meg a telefon képernyőjén.

  • Alapvető HTTP-hitelesítés: A HTTP bejelentkezési adatok a profilfiók hitelesítésére szolgálnak.

  • XSI hitelesítés: Az XSI bejelentkezési hitelesítő adatok vagy az XSI SIP hitelesítő adatok a profilfiók hitelesítésére szolgálnak. A hitelesítési adatok a telefon XSI-hitelesítési típusától függnek:

    Ha a telefon XSI-hitelesítési típusa Bejelentkezési hitelesítő adatokra van állítva, akkor az XSI bejelentkezési hitelesítő adatokat használja.

    Ha a telefon XSI-hitelesítési típusa SIP-hitelesítési adatokra van állítva, akkor az XSI SIP-hitelesítési adatokat használja.

Alapértelmezett: Alapvető HTTP-hitelesítés

4

Kattintson az Összes változás elküldése lehetőségre.

Profil manuális alkalmazása a telefonra

A konfigurációs fájl letöltése a telefonra egy TFTP-szerverről

Kövesse a lépéseket és töltse le a konfigurációs fájlt egy TFTP szerver alkalmazásra a helyi PC-n.

1

Csatlakoztassa a számítógépet a telefon LAN-portjához.

2

Futtasson egy TFTP-szerver alkalmazást a számítógépen, és győződjön meg arról, hogy a konfigurációs fájl elérhető a TFTP gyökérkönyvtárában.

3

Egy web böngészőben adja meg a telefon LAN IP címét, a számítógép IP címét, a fájlnevet és a bejelentkezéshez szükséges adatokat. Használja ezt a formátumot:

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

Példa: 

http://192.168.15.1/admin/resync?tftp://192.168.15.100/my_config.xml&xuser=admin&xpassword=admin
A konfigurációs fájl letöltése a telefonra a cURL segítségével

Végezze el az alábbi lépéseket a konfigurációs fájl letöltéséhez a telefonra cURL használatával. Ezzel a parancssor eszközzel küldhet adatot URL szintaxissal. A cURL letöltéséhez látogasson el ide:

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

Javasoljuk, hogy ne használja a cURL-t a konfiguráció telefonra való felviteléhez, mert a cURL használata során a felhasználónév és a jelszó rögzítésre kerülhet.

1

Csatlakoztassa a számítógépet a telefon LAN-portjához.

2

Töltse le a konfigurációs fájlt a telefonra az alábbi cURL parancs megadásával:

curl -d @my_config.xml "http://192.168.15.1/admin/config.xml&xuser=admin&xpassword=admin"

Konfigurációs profilok

A telefon XML formátumú konfigurációkat fogad el.

Az ebben a szakaszban szereplő példák XML-szintaxisú konfigurációs profilokat használnak.

Konfigurációs profilformátumok

A konfigurációs profil határozza meg a telefon paraméter értékeit.

A konfigurációs profil XML formátuma standard XML szerzői eszközöket használ a paraméterek és értékek összeállításához.

Csak UTF-8 karakterkészlet támogatott. Ha egy szerkesztőben módosítja a profilt, ne változtasson a kódolási formátumon; ellenkező esetben a telefon nem ismeri fel a fájlt.

Minden telefon más-más jellemzőkkel bír, ezért más-más paraméterei is vannak.

Nyitott profilformátum

A nyílt formátumú profil egy szövegfájl XML-szerű szintaxissal egy elem hierarchiában, elem attribútumokkal és értékekkel. Ehhez a formátumhoz és a konfigurációs fájl létrehozásához használhat standard eszközöket. Az XML konfigurációs fájl az újraszinkronizálási művelet során bináris objektumként történő összeállítás nélkül is elküldhető az ellátási szerverről a telefonra.

A telefon standard eszközzel létrehozott konfigurációs formátumokat képes fogadni. Ez a funkció megkönnyíti a meglévő adatbázisokból konfigurációs profilt előállító back-end szolgáltatási szerver szoftver fejlesztését.

A konfigurációs profilban lévő bizalmas információk védelme érdekében az ellátási szerver az XML konfigurációs fájlt TLS által védett csatornán keresztül juttatja el a telefonhoz. Opcionálisan a fájl tömöríthető a gzip lapos algoritmus (RFC1951) használatával.

A fájl az alábbi titkosítási módszerek egyikével titkosítható:

  • AES-256-CBC titkosítás

  • RFC-8188 alapú tartalom HTTP-titkosítás az AES-128-GCM titkosítás

Egy konfigurációs fájl az alábbi komponenseket tartalmazhatja:

  • Elem címkék

  • Attribútumok

  • Paraméterek

  • Formázási elemek

  • XML megjegyzések

Példa: Nyílt profilformátum

<flat-profile><Resync_On_Reset> Igen </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>

A <flat-profile> elemcímke minden olyan paraméterelemet tartalmaz, amelyet a telefon felismer.

Elemcímke tulajdonságai

A konfigurációs fájl létrehozásakor vagy frissítésekor tartsa szem előtt a következő szabályokat.

  • Az XML szolgáltatási formátum és a Web UI lehetővé teszi azonos beállítások konfigurálását. Az XML-tagok és a mezők nevei a webes felhasználói felületen hasonlóak, de az XML-elemnév korlátozások miatt eltérnek egymástól. Például aláhúzások ( _ ) az XML konfigurációs fájlban a szóközök helyett a webes felhasználói felületen.

  • A telefon felismeri a megfelelő paraméternevekkel rendelkező elemeket, amelyek a speciális <flat-profile> elembe vannak foglalva.

  • Az elemnevek szögletes zárójelben szerepelnek.

  • A legtöbb elem neve hasonló a telefon webes felhasználói felületének mezőneveihez, a következő módosításokkal:

    • Az elemnevekben szerepelhet helyköz vagy speciális karakter. Ha az elem nevét a webes mező nevéből szeretné levezetni, minden szóköz vagy a [, ], (, ) vagy /speciális karakterek helyett egy aláhúzással helyettesítsen.

      Példa: A <Resync_On_Reset> elem a Resync On Reset mezőt jelöli.

    • Minden elemnévnek egyedinek kell lennie. A telefon webes felhasználói felületén ugyanazok a mezők több weboldalon is megjelenhetnek, például a vonal, a felhasználó és a mellék oldalakon. Fűzze hozzá az [n] attribútumot az elem nevéhez, jelölve az oldal tabulátoron megjelenő számot.

      Példa: A <Dial_Plan_1_> elem az 1. vonal tárcsázási tervét jelenti.

  • Minden nyitócímkéhez egy megfelelő zárócímke tartozik. Például:

    <flat-profile><Resync_On_Reset> Igen</Resync_On_Reset><Resync_Periodic> 7200</Resync_Periodic><Profile_Rule>tftp://prov.telco.com: 6900/cisco/config/CP_xxxx_MPP.cfg</Profile_Rule></flat-profil>

  • Az elemcímkék kisbetű/nagybetű érzékenyek.

  • Az üres elemcímkék megengedettek, és úgy lesznek értelmezve, hogy az érték konfigurációja üres. Adja mg a nyitócímkét hozzárendelt elemcímke nélkül, majd illesszen be egy helyközt és egy előredöntött elválasztójelet a szögletes zárójel lezárása előtt (>). Ebben a példában a B profilszabály üres:

    <Profil_Rule_B />

  • Üres elemcímke használatával megakadályozható a felhasználó által beírt értékek felülírása egy újraszinkronizáló művelet során. Az alábbi példában a felhasználó gyorstárcsázó beállításai változatlanok maradnak:

    <flat-profil><Speed_Dial_2_Name ua="rw"/><Speed_Dial_2_Number ua="rw"/><Speed_Dial_3_Name ua="rw"/><Speed_Dial_3_Number ua="rw"/><Speed_Dial_4_Name ua="rw"/><Speed_Dial_4_Number ua="rw"/><Speed_Dial_5_Name ua="rw"/><Speed_Dial_5_Number ua="rw"/><Speed_Dial_6_Name ua="rw"/><Speed_Dial_6_Number ua="rw"/><Speed_Dial_7_Name ua="rw"/><Speed_Dial_7_Number ua="rw"/><Speed_Dial_8_Name ua="rw"/><Speed_Dial_8_Number ua="rw"/><Speed_Dial_9_Name ua="rw"/><Speed_Dial_9_Number ua="rw"/></flat-profile>

  • Használjon üres értéket a megfelelő paraméter üres stringre való állításához. Adjon meg egy nyitócímkét és egy zárócímkét, de ne írjon közéjük értéket. Az alábbi példában a GPP_A paraméter egy üres stringre van állítva.

    <flat-profil><GPP_A>  </GPP_A></flat-profil>

  • A nem felismert elemnevek figyelmen kívül lesznek hagyva.

Paraméter-tulajdonságok

Ezek a tulajdonságok vonatkoznak a paraméterekre:

  • Minden olyan paraméter, amit nem határoz meg egy profil, változatlan marad a telefonon.

  • A nem felismert paraméterek figyelmen kívül lesznek hagyva.

  • Ha a Nyílt formátumú profil ugyanannak a paraméter címkének több előfordulását tartalmazza, az utolsó ilyen előfordulás felülírja a korábbiakat. A paraméterek konfigurációs értékeinek nem szándékos felülírását elkerülendő, javasoljuk, hogy minden profil legfeljebb egy paraméter előfordulást határozzon meg.

  • Az utoljára feldolgozott profil kerül előre. Ha több profil határozza meg ugyanazt a konfigurációs paramétert, a későbbi profil értéke kerül előre.

Stringformátumok

Ezek a tulajdonságok vonatkoznak a stringek formázására:

  • A megjegyzések standard XML szintaxisként megengedettek.

    <!-- A megjegyzés itt van begépelve..>

  • A bevezető és követő helyköz karakterek használata engedélyezett a jobb olvashatóság miatt, de nem szerepelnek a paraméter értékekben.

  • Az értéket tartalmazó új sorok helyközzé konvertálódnak.

  • Egy XML fejléc a következő formában: <? ?> megengedett, de a telefon figyelmen kívül hagyja.

  • Speciális karakter beviteléhez használjon alap XML karakter megkerülést, az alábbi táblázat szerint.

    Speciális karakter

    XML megkerülési sorrend

    & (ampersand)

    &amp;

    < (kisebb mint)

    &lt;

    > (nagyobb mint)

    &gt;

    ’ (aposztróf)

    &apos;

    " (dupla idézőjel)

    &quot;

    Az alábbi példában karakter megkerülés szerepel a nagyobb mint és kisebb mint szimbólumok helyett - amelyekre egy tárcsázási terv szabályban van szükség. Ez a példa egy információs forródrótvonal tárcsázási tervét határozza meg, amely beállítja a <Dial_Plan_1_> paramétert (Admin bejelentkezés > Speciális > Hang > Mellék (n)) egyenlő (S0 <:18005551212>).

    <flat-profil> <Dial_Plan_1_> (S0 &lt;:18005551212&gt;) </Dial_Plan_1_></flat-profil>

  • A számkarakterek escape-jei decimális és hexadecimális értékekkel (s.a. &#40; és &#x2e;) lefordításra kerülnek.

  • A telefon förmvere csak ASCII karaktereket támogat.

Nyílt profilú (XML) tömörítés és titkosítás

A nyílt konfigurációs profil összecsomagolható a szolgáltató szerver hálózati terhelésének csökkentése érdekében. A profil titkosítható, így a bizalmas információ megvédhető. A csomagolás nem szükséges, de a titkosítást meg kell előznie.

Nyitott profilú tömörítés

A támogatott tömörítési módszer a gzip lapos algoritmus (RFC1951). A gzip segédprogram és a tömörítési könyvtár, amely ugyanazt az algoritmust (zlib) használja az interneten elérhető.

A tömörítés azonosításához a telefon egy gzip kompatibilis fejlécet vár a tömörített fájlban. A gzip segédprogram meghivatkozása az eredeti Nyílt profilon hozza létre a fejlécet. A telefon megvizsgálja a letöltött fájl fejlécet a fájlformátum meghatározásához.

Például, ha a profile.xml egy érvényes profil, a profile.xml.gz is elfogadható. Az alábbi parancsok mindegyike le tudja generálni ezt a profiltípust:

  • >gzip profile.xml

    Lecseréli az eredeti fájlt a tömörített fájlra.

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

    Az eredeti fájlt a helyén hagyja, és új tömörített fájlt hoz létre.

Nyílt profilú titkosítás

A szimmetrikus kulcstitkosítás használható egy Nyílt konfigurációs profil titkosításához, függetlenül attól, hogy a fájl tömörítve van-e vagy sem. Ha a tömörítés használható, a titkosítás előtt kell megtörténnie.

A szerver szolgáltatása HTTPS protokollt használ a telefon legelső szolgáltatásához telepítés után. A konfigurációs profilok előzetes offline titkosítása lehetővé teszi a HTTP használatát a profilok későbbi újraszinkronizálásához. Ez a funkció csökkenti a HTTPS szerver terhelését nagyszabású munka esetén.

A telefon a konfigurációs fájlok kétféle titkosítási módszerét támogatja:

  • AES-256-CBC titkosítás

  • RFC 8188-alapú HTTP tartalom titkosítás AES-128-GCM cipher használatával

A kulcsot vagy Input Keying Materialt (IKM) már korábban meg kell adni a készüléknek. A titkos kulcs bootstrap HTTPS protokollal szerezhető be biztonságosan.

A konfigurációs fájl neve nem igényel meghatározott formátumot, de a .cfg kiterjesztéssel végződő fájlnév általában konfigurációs profilt jelez.

AES-256-CBC titkosítás

A telefon támogatja a konfigurációs fájlok AES-256-CBC titkosítását.

A különböző internetes oldalakról letölthető OpenSSL titkosítási eszköz végezheti el a titkosítást. A 256-bites AES titkosítás támogatás kérheti az eszköz ismételt összerakását az AES kód engedélyezéséhez. A firmware-t openssl-1.1.1d verzióval teszteltük.

Titkosított fájl esetén a profil azt várja, hogy a fájl formátuma ugyanaz legyen, mint a következő paranccsal generált formátum:

 # példa titkosítási kulcs = SecretPhrase1234 openssl enc –e –aes-256-cbc –k SecretPhrase1234 –in profile.xml –out profile.cfg # analóg meghívás tömörített XML fájlhoz openSSL enc –e –aes-256-cbc –k SecretPhrase1234 –in profile.xml.gz –out profile.cfg

A titkos kulcsot, amely lehet sima szöveges kifejezés, egy kisbetűs -k előzi meg, ugyanez használható random 64-bites salt létrehozásához is. Amint a titkosítást meghatározta a -k argumentum,a titkosítási eszköz egy random 128-bites kezdővektort és az aktuális 256-bites titkosítási kulcsot deriválja.

Amikor ilyen titkosítást használunk egy konfigurációs profilon, a telefonnak el kell juttatni a titkos kulcs értékét a fájl titkosításának feloldásához. Az értéket minősítőként határozzák meg a profil URL-ben. A szintaxis a következő, explicit URL használatával:

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

Ez az érték a Profile_Rule paraméterek egyikének használatával programozható.

Makrókibontás

Több szolgáltatási paraméter is belső makró kiterjesztésen esik át az értékelés előtt. Az előzetes értékelési lépés nagyobb rugalmasságot biztosít a telefon újraszinkronizálási és frissítési tevékenységeiben.

Ezek a paramétercsoportok esnek át makró kiterjesztésen az értékelés előtt:

  • Resync_Trigger_*

  • Profile_Rule*

  • Log_xxx_Msg

  • Upgrade_Rule

Bizonyos körülmények között egyes általános célú paraméterek (GPP_*) makróbővítésen is átesnek, amint azt az alábbi Választható újraszinkronizálási argumentumok szakasz kifejezetten jelzi.

Makró kiterjesztés során a megnevezett változók tartalma felváltja az $NAME és $(NAME) űrlapok kifejezéseit. A változók lehetnek általános célú paraméterek, termék azonosítók, esemény időzítők és szolgáltatási állapot értékek. A teljes listát a Kiépítési paraméterek alatt található Makróbővítési változók című témakörben találja.

Az alábbi példában az $(MAU) kifejezést használjuk a 000E08012345 MAC cím beillesztésére.

A rendszergazda beírja az $(MAU)config.cfg értéket.

Az eredményül kapott makró kiterjesztés a 000E08012345 MAC címmel rendelkező eszközre: 000E08012345config.cfg

Ha a makrót nem ismeri fel, nem lesz kiterjesztve. Például a STRANGE név nem egy felismert makrónév, a MAU viszont egy felismert és érvényes makrónév.

A rendszergazda beírja az $STRANGE$MAU.cfg értéket.

Az eredményül kapott makró kiterjesztés a 000E08012345 MAC címmel rendelkező eszközre: $STRANGE000E08012345.cfg

A makró kiterjesztés nem lesz ismételten alkalmazva. Például az $$MAU" kiterjesztése $MAU" (az $$ lesz kiterjesztve) és nem ad MAC címet.

A speciális célú paraméterek tartalma, így a GPP_SA - GPP_SD paraméterek le lesznek képezve $SA - $SD makró kifejezésekre. Ezeken a paramétereken csak akkor van makró kiterjesztés, ha a --key , --uid, és --pwd beállítások egy újraszinkron URL-ben szerepelnek.

Feltételes kifejezések

A feltételes kifejezések újraszinkronizálási eseményeket indíthatnak el, és alternatív URL-ekből választhatnak újraszinkronizálási és frissítési műveleteket.

A feltételes kifejezések összehasonlítási listákból állnak, amelyeket és operátor választ el egymástól. Minden összehasonlításnál igaznak kell lennie a feltételnek.

Minden összehasonlítás az alábbi három típusú kifejezésre vonatkozhat:

  • Egész szám érték

  • Szoftver vagy hardver verziószám

  • Dupla idézőjeles string

Verziószám

A Cisco videótelefon 8875 szoftververziója ezt a formátumot használja (ahol a BN a Build Number, azaz az építési szám):

PHONEOSyyyy.1-0-1-0001-BN

ahol yyyy a telefon modelljét vagy sorozatát jelöli; 1 a főverzió; 0 a mellékverzió; 1-0001 a mikroverzió; és BN a buildszám.

Az összehasonlító stringnek ugyanezt a formátumot kell használnia. Ellenkező esetben elemzési hiba keletkezhet.

A szoftververzió összehasonlításakor a fő-, a mellék- és a mikroverzió egymás után kerül összehasonlításra, és a balra lévő számjegyek elsőbbséget élveznek az utóbbiakkal szemben. Ha a verziószámok megegyeznek, akkor a buildszámot kell összehasonlítani.

Példák érvényes verziószámra

PHONEOS-8875.1-0-1-0001-19

Összehasonlítás

Az idézőjelbe tett stringek azonosságra vagy különbözőségre hasonlíthatók össze. Az egész számok és a verziószámok aritmetikusan is összehasonlíthatók. Az összehasonlító operátorok szimbólumként vagy rövidítésként fejezhetők ki. A rövidítések Nyílt formátumú profilok feltételének kifejezésében hasznosak.

Operátor

Alternatív szintaxis

Leírás

Alkalmazható egész szám és verzió operátorokhoz

Alkalmazható idézőjeles string operátorokhoz

=

eq

egyenlő

Van

Van

!=

ne

nem egyenlő

Van

Van

<

lt

kisebb mint

Van

Nem

<=

le

kisebb mint vagy egyenlő

Van

Nem

>

gt

nagyobb mint

Van

Nem

>=

ge

nagyobb mint vagy egyenlő

Van

Nem

ÉS

és

Van

Van

Fontos, hogy a makró változókat dupla idézőjelbe kell tenni ott, ahol string az elvárt. Ne tegye ezt ott, ahol számot vagy verziószámot várnak.

Amikor Profile_Rule* és Upgrade_Rule paraméter kontextusban használja, a feltételes kifejezéseket a szintaxisban kell szerepeltetni "(expr)?" mint a frissítési szabály példában. Ne feledje, hogy a BN helyébe a frissítendő firmware-betöltés buildszámát írja.

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

Ne használjon zárójeles megelőző szintaxist a Resync_Trigger_* paraméterek konfigurálásához.

URL szintaxis

Használjon standard URL szintaxist a konfigurációs fájlok fogadásának meghatározására, majd a firmware betölti a Profile_Rule* és Upgrade_Rule paramétereket. A szintaxis a következő:

[ scheme:// ] [ server [:port]] filepath

Ahol a scheme az alábbi két érték valamelyike:

  • tftp

  • HTTP protokoll

  • HTTPS

Ha a scheme ki van hagyva, a tftp-t feltételezi. A szerver lehet DNS-el felismert hosztnév vagy numerikus IP cím. A port a cél UDP vagy TCP portszám. A fájl útvonalnak a gyökérkönyvtárral kell kezdődnie (/); abszolút útvonalnak kell lennie.

Ha a server hiányzik, a DHCP (66-os opció) kapcsolaton meghatározott tftp szerver lesz használva.

A frissítés szabályokhoz a szervert meg kell határozni.

Ha a port hiányzik, a meghatározott séma standard portja lesz használva. A tftp a 69-es UDP portot, a http a 80-as TCP portot, a https a 443-as TCP portot használja.

Fájl elérési útnak lennie kell. Nem kell feltétlenül statikus fájlra mutatnia, jelölhet CGI-n keresztül kapott dinamikus tartalmat is.

A makró kiterjesztés URL-n belül érvényes. Az alábbi példák valid URL-k:

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

Amikor 66-os DHCP opciót használ, az üres szintaxist nem támogatják a frissítési szabályok. Csak a Profile_Rule* paraméterhez használható.

RFC 8188-alapú HTTP tartalom titkosítás

A telefon támogatja a konfigurációs fájlok AES-128-GCM cipheres HTTP RFC 8188-alapú HTTP tartalom-titkosítását. A titkosítási módszerrel bármely entitás elolvashatja a HTTP-fejléceket. Az entitások azonban csak az IKM ismeretében férhetnek hozzá a tényleges tartalomhoz (payload). Amikor a telefon megkapja az IKM-et, a telefon és a hálózatlétesítési kiszolgáló biztonságosan cserélhetnek konfigurációs fájlokat, ugyanakkor lehetővé teszi a harmadik féltől származó hálózati elemek számára, hogy elemzési és megfigyelési célokra használják az üzenet-fejléceket.

Az XML konfigurációs paraméter IKM_HTTP_Encrypt_Content tartja az IKM-et a telefonon. Biztonsági okokból ez a paraméter nem érhető el a telefon-felügyeleti weblapon. Nem átható a telefon konfigurációs fájljában sem, amelyhez a telefon IP-címe ismeretében vagy a telefon hálózatlétesítési kiszolgálóra küldött konfigurációs jelentéseiből lehet hozzáférni.

Ha szeretné használni az RFC 8188-alapú titkosításról, gyõzõdjön meg a következõkrõl:

  • A a hálózatlétesítési kiszolgálóról a telefonra küldött konfigurációs fájl IKM_HTTP_Encrypt_Content XML-paramétere IKM-re állításával IKM-et ad a telefonnak.

  • Ha ezt a titkosítást a konfigurációs szerverről a telefonra küldött konfigurációs fájlokra alkalmazzák, győződjön meg arról, hogy a konfigurációs fájl Content-Encoding HTTP fejlécében szerepel a következő: aes128gcm.

    Ezen fejléc hiányában az AES-256-CBC módszer kap elsőbbséget. Ha van AES-256-CBC kulcs, a telefon az AES-256-CBC visszafejtést használja, függetlenül az IKM-től.

  • Ha azt szeretné, hogy a telefon ezt a titkosítást alkalmazza a hálózatlétesítési kiszolgálóra küldött konfigurációs jelentések esetén, győződjön meg arról, hogy nincs a jelentésszabályban megadva AES-256-CBC kulcs.

Választható újraszinkronizálási argumentumok

A Profile_Rule* paraméterekben megadott URL-ek elé választható argumentumok, a key, az uid és a pwd állhatnak, amelyeket együttesen szögletes zárójelbe kell helyezni.

kulcs

A --key opció azt közli a telefonnal, hogy a konfigurációs fájl, amelyet a rendelkezésre bocsátási szervertól kap, AES-256-CBC titkosítással van titkosítva, kivéve, ha a fájl Content-Encoding fejléce a következőt jelzi: aes128gcm titkosítás. A kulcsot egy string és az azt követő--key kifejezés határozza meg. A kulcsot tetszés szerint lehet tenni idézőjelek (") közé. A telefon használ a kulcs a konfigurációs fájl visszafejtésére.

Példák a használatra
[--key VerySecretValue][--key “my secret phrase”][--key a37d2fb9055c1d04883a0745eb0917a4]

A zárójelben lévő opcionális argumentumok makróval bővítettek. A speciális célú paraméterek , így a GPP_SA - GPP_SD paraméterek makróval bővített makró változók $SA és $SD között, amikor kulcs opció argumentumként vannak használva. Lásd az alábbi példákat:

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

Nyílt formátumú profilokban a --kulcs argumentumnak ugyanannak kell lennie, mint a -k beállítás argumentuma, amit az openssl mezőben adnak meg.

uid és pwd

Az uid és pwd beállításokkal megadható a megadott URL megadásakor a HTTP Basic és Digest hitelesítési kihívásokra válaszul küldött felhasználói azonosító és jelszó. A zárójelben lévő opcionális argumentumok makróval bővítettek. A speciális célú paraméterek , így a GPP_SA - GPP_SD paraméterek makróval bővített makró változók $SA és $SD között, amikor kulcs opció argumentumként vannak használva. Lásd az alábbi példákat:

GPP_SA = Saját felhasználói azonosító GPP_SB = Titkos jelszó

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

a bővítmény megjelenítése:

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

Adattípusok

Ezek az adattípusok használatosak a konfigurációs profil paraméterekkel:

  • {a,b,c,…}—Választható a, b, c, …

  • Bool—Boolean érték, ami "igen" vagy "nem" lehet.

  • CadScript—Egy miniscript, ami a jel ütem paraméterét határozza meg. Legfeljebb 127 karakter

    Szintaxis: S1[;S2], ahol:

    • Si=Di(bei,1/kii,1[,bei,2/kii,2[,bei,3/kii,3[,bei,4/kii,4[,bei,5/kii,5[,bei,6/kii,6]]]]]) és ez egy szakasz.

    • bei,j és kii,j a be/ki időtartam másodopercben egy szegmensben. i = 1 vagy 2, és j = 1 - 6.

    • Di a szakasz teljes időtartama másodpercben.

    Minden időtartamban legfeljebb három tizedeshely lehet, ami 1ms felbontást jelent. A "*" szabad karakter korlátlan időtartamot jelöl. A szakaszon belüli szegmensek sorrendben vannak lejátszva, és addig ismétlődnek, amíg a teljes időtartam le nem telik.

    1. példa:

     60(2/4) pedálfordulatszakaszok száma = 1 Pedálfordulat 1. szakasz: szakaszhossz = 60 s szegmensek száma = 1 1. szegmens: be = 2 mp, ki = 4 s teljes gyűrűhossz = 60s

    2. példa—Megkülönböztető csengés (rövid,rövid,rövid,hosszú):

     60(.2/.2,.2/.2,.2/.2,1/4) Pedálfordulatszakaszok száma = 1 Pedálfordulat 1. szakasz: Szakasz hossza = 60s Szegmensek száma = 4 1. szegmens: Be=0,2s, Ki=0,2s 2. szegmens: Be=0,2s, Ki=0,2s 3. szegmens: Be=0,2s, Ki=0,2s 4. szegmens: Be=1,0s, Ki=4,0s Teljes gyűrűhossz = 60s

  • DialPlanScript—Script szintaxis, ami az 1-es vonal és a2-es vonal tárcsázási tervét határozza meg.

  • Float<n>—Egy lebegő pontérték n tizedeshellyel.

  • FQDN-Teljesen minősített tartománynév. Legfeljebb 63 karaktert tartalmazhat. Nézzük az alábbi példákat:

    • sip.Cisco.com:5060 vagy 109.12.14.12:12345

    • sip.Cisco.com or 109.12.14.12

  • FreqScript—Egy miniscript, ami egy tónus frekvencia és jel paraméterét határozza meg. Legfeljebb 127 karakter lehet.

    Szintaxis: F1@L1[,F2@L2[,F3@L3[,F4@L4[,F5@L5[,F6@L6]]]]], ahol:

    • F1–F6 a frekvencia Hz-ben (csak nem aláírt egész szám).

    • L1–L6 a vonatkozó szint dBm-ben (legfeljebb egy tizedeshelyig).

    Helyköz megengedett a vessző előtt és után, de nem ajánlott.

    1. példa—Hívásvárakoztatás hang:

     440@-10 Frekvenciák száma = 1 Frekvencia 1 = 440 Hz –10 dBm-nél

    2. példa—Tárcsázási hang:

     350@-19,440@-19 Frekvenciák száma = 2 Frekvencia 1 = 350 Hz –19 dBm-nél Frekvencia 2 = 440 Hz –19 dBm-nél

  • IP- Érvényes IPv4-cím x.x.x.x.x formájában, ahol x 0 és 255 között van. Példa: 10.1.2.100.

  • UserID—Felhasználói azonsító, ahogy az URL-ben megjelenik; legfeljebb 63 karakter.

  • Phone—Egy telefonszám string, például 14081234567, *69, *72, 345678; vagy egy generikus URL, például 1234@10.10.10.100:5068 vagy jsmith@Cisco.com. A string legfeljebb 39 karaktert tartalmazhat.

  • PhTmplt—Egy telefonszám sablon. A sablonok egy vagy több, vesszővel (,) elválasztott mintát tartalmazhatnak. A minták elején a helyköz figyelmen kívül lesz hagyva. A "?" és "*" szabad karaktereket jelölnek. Szó szerinti reprezentációhoz használja a%xx kifejezést. Például, a %2a jelent *-ot. A sablon legfeljebb 39 karaktert tartalmazhat. Példák: "1408*, 1510*", "1408123????, 555?1.".

  • Port—TCP/UDP Portszám (0-65535). Decimális vagy hex formátumban adható meg.

  • ProvisioningRuleSyntax—Script szintaxis, ami a konfigurációs újraszinkron és förmver frissítés szabályokat határozza meg..

  • PwrLevel—Erősségszint dBm-ben kifejezve, egy tizedeshellyel, például –13.5 vagy 1.5 (dBm).

  • RscTmplt-A SIP-válaszállapotkód sablonja, például "404, 5*", "61?", "407, 408, 487, 481". Legfeljebb 39 karaktert tartalmazhat.

  • Sig<n>—Aláírt n-bit érték. Decimális vagy hex formátumban adható meg. A "-" jel negatív értékek előtt áll. A + jel a pozitív értékek előtt opcionális.

  • Star Codes—Egy kiegészítő szolgáltatás aktivációs kódja, például *69. A kód legfeljebb 7 karaktert tartalmazhat.

  • Str<n>—Egy általános string n nem fenntartott karakterrel.

  • Time<n>—Időtartam másodpercben, legfeljebb n tizedeshellyel. Az extra meghatározott tizedeshelyek figyelmen kívül lesznek hagyva.

  • ToneScript—Egy miniscript, ami egy hívás folyamat hang frekvencia, szint és ütem paramétereit határozza meg. A script legfeljebb 127 karaktert tartalmazhat.

    Szintaxis: FreqScript;Z1[;Z2].

    A Z1 szakasz hasonló az S1 szakaszhoz egy CadScriptben, azzal a kivátellel, hogy minden be/ki szegmenst egy frekvencia komponens paraméter követ: Z1 = D1(bei,1/kii,1/fi,1[,bei,2/kii,2/fi,2 [,bei,3/kii,3/fi,3 [,bei,4/kii,4/fi,4 [,bei,5/kii,5/fi,5 [,bei,6/kii,6/fi,6]]]]]) ahol:

    • fi,j = n1[+n2]+n3[+n4[+n5[+n6]]]]].

    • 1 < nk < 6 határozza meg a frekvencia komponenseket a szegmensben használt FreqScriptben.

    Ha egynél több frekvencia szegmenst használ a scriptben, a komponensek összeadódnak.

    1. példa—Tárcsázás hang:

     350@-19,440@-19; 10(*/0/1+2) Frekvenciák száma = 2 Frekvencia 1 = 350 Hz –19 dBm-nél 2. frekvencia = 440 Hz –19 dBm-nél Pedálfordulatszakaszok száma = 1 Pedálfordulat 1. szakasz: Szakasz hossza = 10 s Szegmensek száma = 1 1. szegmens: Be=örökké, 1. és 2. frekvenciával Teljes hanghossz = 10s

    2. példa—Stutter hang:

     350@-19,440@-19; 2(.1/.1/1+2); 10(*/0/1+2) Frekvenciák száma = 2 1. frekvencia = 350 Hz –19 dBm-nél 2. frekvencia = 440 Hz –19 dBm-nél Pedálfordulatszakaszok száma = 2 Pedálfordulat 1. szakasz: Szakasz hossza = 2s Szegmensek száma = 1 1. szegmens: Be = 0,1 mp, Ki = 0,1 mp 1 és 2 frekvenciával Pedálfordulat 2. szakasz: Szakasz hossza = 10s Szegmensek száma = 1 1. szegmens: Be=örökké, 1-es és 2-es frekvenciával Teljes hanghossz = 12s

  • Uns<n>- Előjel nélküli n-bites érték, ahol n = 8, 16 vagy 32. Megadható decimális vagy hexa formátumban, például 12 vagy 0x18, amennyiben az érték n bitbe fér bele.

Az alábbiakat vegye figyelembe:

  • <Par Name> egy konfigurációs paraméter nevét jelenti. Egy profilban a megfelelő címke úgy jön létre, hogy a szóközt egy "_" aláhúzással helyettesítjük, például Par_Name.
  • Egy üres alapértelmezett érték üres stringet jelöl < "" >.
  • A telefon az utoljára konfigurált értékeket fogja használni az adott profilban nem szereplő címkékhez.
  • A sablonokat a megadott sorrendben hasonlítja össze. Az első nem a legközelebbi egyezés van kiválasztva. A paraméter nevének pontosan egyeznie kell.
  • Ha egy paraméterhez egynél több meghatározás van megadva egy profilban, a fájlban az utolsó meghatározás lesz érvényes a telefonon.
  • Egy üres paraméter értékkel rendelkező paraméter specifikáció kényszeríti ki az alapértelmezett értéket. Ha üres stringet szeretne helyette meghatározni, használja az üres string "" értéket a paraméter értéknek.