A telefon konfigurálása a profil újraszinkronizáláshoz

A telefonprofil ú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 legalapvetőbb profilátviteli protokoll a TFTP (RFC1350). A TFTP-t széles körben használják hálózati eszközök privát LAN hálózatokon belüli biztosítására. Bár nem ajánlott távoli végpontok telepítésére az interneten, a TFTP kényelmes lehet kis szervezeteken belüli telepítéshez, házon belüli előzetes szolgáltatáshoz, fejlesztéshez és teszteléshez. A következő eljárásban a profil a fájl TFTP szerverről történő letöltését követően módosul.

1

LAN környezetben csatlakoztassa a számítógépet és a telefont egy hubhoz, kapcsolóhoz vagy kisméretű routerhez.

2

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

3

Konfigurációs profil létrehozásához használjon szövegszerkesztőt.

Ha ellenőrizni szeretné, hogy a profil később lett-e kiosztva a telefonhoz, beállíthat néhány értéket jelölésként. Például állítsa be a GPP A értékét_12345678-ra, amint az a következő példában látható:
 <flat-profile>   <GPP_A> 12345678   A> </flat-profile>
_
4

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

Ellenőrizheti, hogy a TFTP szerver megfelelően van-e konfigurálva: kérje meg a konfigurációs profil fájlt a telefontól eltérő TFTP kliens használatával. Lehetőleg olyan TFTP klienst használjon, amely nem a szolgáltató szerveren fut.

5

Nyissa meg a számítógép webböngészőjében az adminisztráció weblapot. Például tegyük fel, hogy a telefon IP címe 192.168.1.100, nyissa meg az alábbi URL-t a böngészőben:


http://192.168.1.100/admin/advanced
6

Válassza a Hang > Szolgáltatás fület, és ellenőrizze az általános célú GPP_A – GPP_P paraméterek értékeit. Ezeknek üresnek kell lenniük.

7

Szinkronizálja újra a teszt telefont a konfigurációs profilra az újraszinkronizálási URL megnyitásával egy webböngészőben.

Példa:

Ha a TFTP szerver IP címe 192.168.1.200, a parancsnak hasonlónak kell lennie az alábbi példához:


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

Amikor a telefon ezt a parancsot kapja, a 192.168.1.100 címen lévő eszköz lekéri a basic.txt konfigurációs profilfájlt a TFTP szerverről a 192.168.1.200 IP címen. A telefon ezután 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 megfelelően frissült-e. Frissítse az adminisztrációs weblapot, és lépjen a Hang > Beüzemeléselemre.

A GPP_A paraméternek most 12345678 értéket kell tartalmaznia.

Telefonspecifikus profil beállítása TFTP szerveren
1

Szerezze be a telefon MAC címét a termék címkéjéről. (A MAC cím a szám, amely számokat és kisbetűs hex jegyeket használ, például 000e08aabbcc.

2

Nevezze át a konfigurációs fájlt CP-xxxx macaddress.cfg fájlra (az xxxx helyére a modellszámot, a macaddress helyére pedig a telefon MAC-címét).

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 a Hang  > Szolgáltatás lehetőséget.

6

Adja meg a profilfájl útvonalát a Profilszabály mezőben.

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

 <Profile_szabály> tftp://192.168.1.200/CP-8875$MA.cfg szabály>
rofile_
7

Kattintson az Összes módosítás elküldése lehetőségre. Ez azonnali újraindítást és újraszinkronizálást okoz.

Amikor a következő újraszinkronizálás megtörténik, a telefon a $MA makró kifejezés kiterjesztésével kéri le az új fájlt a MAC címére.

Telefonprofil újraszinkronizálása HTTP GET-vel
1

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

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

2

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

3

A szerver megfelelő telepítésének és a profilfájl elérésének ellenőrzéséhez nyissa meg a profilt egy webböngészővel.

4

Módosítsa a teszt telefon Profile_szabályát, hogy a HTTP szerverre mutasson a TFTP szerver helyett, így rendszeresen letöltheti a profilját.

Például tegyük fel, hogy a HTTP szerver 192.168.1.300, és a profil fájlneve basic.txt, adja meg a következő értéket:

<Profile_szabály> http://192.168.1.200/basic.txt szabály>
rofile_
5

Kattintson az Összes módosítás elküldése lehetőségre. Ez azonnali újraindítást és újraszinkronizálást okoz.

6

Figyelje meg a telefon által küldött syslog üzeneteket. A rendszeres újraszinkronizálásnak most meg kell szereznie a profilt a HTTP szerverről.

7

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

Ennek az információnak tartalmaznia kell a gyártót, a termék nevét, az aktuális firmware-verziót és a sorozatszámot.

A telefonprofil automatikus újraszinkronizálása

Egy eszköz rendszeresen tud újraszinkronizálni a szolgáltató szerverre, így biztosítva, hogy a szerveren végrehajtott profil változtatások továbbterjedjenek a végponti eszközre (ahelyett, hogy kifejezett újraszinkronizálási kérést küldene a végpontra).

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

1

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

2

Válassza a Hang  > Szolgáltatá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őszakos 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 elküldése lehetőségre.

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 az eredményül kapott üzeneteket a syslog követésben.

7

Győződjön meg arról, hogy az Újraszinkron alaphelyzetbe állítás mező értéke Igen.

 <Resync_On_alaphelyzetbe állítás>IgenOn_alaphelyzetbe állítás>
esync_
8

Kapcsolja ki a telefont, hogy kényszerítse az újraszinkronizálást a szolgáltató szerverrel.

Ha az újraszinkronizálási művelet bármilyen okból sikertelen, például ha a kiszolgáló nem válaszol, a készülék vár (az Újraszinkronizálási hiba újrapróbálkozási késleltetés opcióban konfigurált másodpercen keresztül), mielőtt megkísérli újra az újraszinkronizálást. Ha az Újraszinkronizálási hiba újrapróbálkozási késleltetés nulla, a telefon nem próbál meg újraszinkronizálni egy sikertelen újraszinkronizálási kísérlet után.

9

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

 <Resync_Error_Retry_késleltetés>30Error_Retry_késleltetés>
esync_
10

Tiltsa le a TFTP szervert, és figyelje meg az eredményeket a syslog kimenetben.

Profil újraszinkronizálási paraméterek

Az alábbi táblázat határozza meg a profil újraszinkronizálási paraméterek funkcióját és használatát a Konfigurációs profil szakaszban a telefon weboldalán a Hang > Szolgáltatás lapon. Meghatározza annak a karakterláncnak a szintaxisát is, amelyet a telefon konfigurációs fájljához (cfg.xml) adtak hozzá XML kóddal a paraméter konfigurálásához.

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

Paraméter

Leírás

Beüzemelés engedélyezése

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

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

    <Provision_Enable ua="na">IgenEnable>rovision_

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

Alapértelmezett: Igen

Újraszinkron alaphelyzetbe állításkor

Meghatározza, hogy a telefon újraszinkronizálja-e a konfigurációkat a szolgáltató szerverrel a bekapcsolás és az egyes frissítési kísérletek után.

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

    <Resync_On_Reset ua="na">IgenOn_Reset>esync_

  • A telefon weboldalán állítsa ezt a mezőt Igen értékre a bekapcsoláskor vagy visszaállításkor történő újraszinkronizálás engedélyezéséhez, vagy Nem a bekapcsoláskor vagy visszaállításkor történő újraszinkronizálás letiltásához.

Alapértelmezett: Igen

Újraszinkron random késleltetés

Megakadályozza a szolgáltató szerver túlterhelését, amikor egyszerre nagy számú eszköz kapcsol be, és megkísérli a kezdeti konfigurációt. Ez a késleltetés csak az eszköz bekapcsolását vagy visszaállítását követő kezdeti konfigurációs kísérletre vonatkozik.

A paraméter az a maximális időtartam, ameddig a készülék várakozik, mielőtt kapcsolatba lép a szolgáltató szerverrel. A tényleges késleltetés egy pszeudo-véletlenszám 0 és ezen érték között.

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

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

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

    <Resync_Random_késleltetés ua="na">2Random_késleltetés>esync_

  • A telefon weboldalán adja meg azoknak az egységeknek a számát (20 másodperc), amelyekhez a telefon késleltetheti az újraszinkronizálást a bekapcsolás vagy az alaphelyzetbe állítás után.

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

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

Az az idő (ÓÓpp), ameddig a telefon újraszinkronizál a szolgáltató szerverrel.

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

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

    <Resync_At__HHmm_ ua="na">0959At__HHmm_>esync_

  • A telefon weboldalánadja meg az újraszinkronizálás időpontját ÓÓ formátumban.

Az alapértelmezett érték üres. Ha az érték érvénytelen, a paramétert a rendszer figyelmen kívül hagyja. Ha a paraméter értéke érvényes, a Resync Periodic paraméter figyelmen kívül lesz hagyva.

Újraszinkronizálás random késleltetésnél

Megakadályozza a szolgáltató szerver túlterhelését, amikor egyszerre nagy számú eszköz kapcsol be.

Hogy elkerülje az újraszinkronizálási kérések elárasztását a szerverre több telefonról, a telefon az órák és percek közötti tartományban szinkronizál újra, és a percek és a random késleltetés (óó, ópp+random_delay) mellett. Például, ha a véletlen késleltetés = (Újraszinkron random késleltetésnél + 30)/60 perc, a másodpercben megadott bemeneti értéket átszámolja percekre, felkerekíti a következő percre, hogy kiszámítsa az utolsó random_delay intervallumot.

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

    <Resync_At_Random_Delay ua="na">600At_Random_Delay>esync_

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

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

Ha az érték kisebb mint 600, 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).

Időszakos újraszinkronizálás

A szolgáltató szerverrel való időszakos újraszinkronizálás közötti időintervallum. A társított újraszinkronizálási időzítő csak a szerverrel való 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 é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 bemenet 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 jelzi, hogy a következő újraszinkronizálás egy sikeres újraszinkronizálás után 2400 és 2430 másodperccel lesz esedékes.

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

    <Resync_Periodic ua="na">3600Periodic>esync_

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

Az időszakos újraszinkronizálás letiltásához állítsa a paraméter értékét nullára.

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

Újraszinkronizálási 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 megpróbál újraszinkronizálni a másodpercben megadott idő elteltével.

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

  • Egy egész szám

    Példa: A 300 érték azt jelzi, hogy az újraszinkronizálás következő próbálkozása 300 másodperc múlva esedékes.

  • Több egész szám

    Példa: A 600 1200 300 érték azt jelzi, hogy az első újrapróbálkozás a hiba után 600 másodperccel lesz esedékes, a második 1200 másodperccel az első újrapróbálkozás sikertelensége után, a harmadik pedig 300 másodperccel a második újrapróbálkozás sikertelensége után.

  • Egy időtartomány

    Például a 2400+30 megadott érték azt jelzi, hogy a következő újrapróbálkozás egy sikertelen újraszinkronizálás után 2400 és 2430 másodperccel lesz esedékes.

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

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

    <Resync_Error_Retry_késleltetés ua="na">60,120,240,480,960,1920,3840,7680,15360,30720,61440,86400Error_Retry_késleltetés>esync_

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

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

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

Az újraszinkronizálás végrehajtása előtt a telefon maximális késleltetése (másodpercben).

A készülék nem szinkronizál újra, amíg az egyik telefonvonal aktív. Mivel az újraszinkronizálás több másodpercig is eltarthat, az újraszinkronizálás előtt célszerű megvárni, amíg a készülék hosszabb ideig tétlen marad. Ez lehetővé teszi a felhasználó számára, hogy megszakítás nélkül hívásokat kezdeményezzen egymás után.

Az eszközön van egy időzítő, amely elkezd visszaszámlálni, amikor az összes vonal tétlen lesz. Ez a paraméter a számláló kezdeti értéke. Az újraszinkronizálási események addig késleltetve vannak, amíg a számláló nullára nem csökken.

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

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

    <Forced_Resync_késleltetés ua="na">14400Resync_késleltetés>orced_

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

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

Újraszinkronizálás SIP-ről

Az újraszinkronizálási műveletekre vonatkozó kéréseket vezérli a szolgáltató proxy szerveréről a telefonra küldött SIP NOTIFY eseményen keresztül. Ha engedélyezve van, a proxy kérhet újraszinkronizálást egy SIP NOTIFY üzenet küldésével, amely tartalmazza az Eseményt: újraszinkronizálja a fejlécet az eszközre.

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

    <Resync_From_SIP ua="na">IgenFrom_SIP>esync_

  • A telefon weboldalán válassza az Igen lehetőséget a funkció engedélyezéséhez, vagy a Nem lehetőséget a funkció kikapcsolásához.

Alapértelmezett: Igen

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

Engedélyezi vagy letiltja az újraszinkronizálási műveletet a frissítés után. Ha az Igen beállítás van bejelölve, a szinkronizálás a firmware frissítése után indul el.

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

    <Resync_After_Upgrade_Attempt ua="na">IgenAfter_Upgrade_Attempt>esync_

  • A telefon weboldalán válassza az Igen lehetőséget, ha förmver frissítés után szeretne újraszinkronizálni, vagy a Nem lehetőséget, ha nem szeretne újraszinkronizálni.

Alapértelmezett: Igen

Újraszinkron trigger 1

Újraszinkron trigger 2

Ha ezekben a paraméterekben a logikai egyenlet értéke FALSE, az újraszinkronizálás nem indul el, még akkor sem, ha az Újraszinkron alaphelyzetbe állítás értéke TRUE. Csak a közvetlen művelet URL-en és SIP értesítésen keresztüli újraszinkronizálás hagyja figyelmen kívül ezeket az újraszinkronizálási triggereket.

A paraméterek programozhatók makró kiterjesztésen átesett feltételes kifejezéssel. Az érvényes makró kiterjesztéseket lásd Makró kiterjesztési változók a Szolgáltatási paraméterek alatt.

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

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

    <Resync_Trigger_2 ua="na"/>

  • A telefon weboldalán adja meg az indítókat.

Alapértelmezett: Üres

Felhasználó által konfigurálható újraszinkronizálás

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, a felhasználó a profilszabály telefonról történő megadásával újraszinkronizálhatja a telefon konfigurációját. Ha a beállítás Nem, a Profilszabály paraméter nem jelenik meg a telefon képernyő menüjében.

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

    <User_Configurable_Resync ua="na">IgenConfigurable_Resync>ser_

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

Alapértelmezett: Igen

Az újraszinkronizálás sikertelen FNF-en

Egy újraszinkronizálás általában sikertelen, ha a kért profil nem érkezik meg a szerverről. Ez a paraméter felülírja a viselkedést. Ha a beállítás Nem, a készülék sikeres újraszinkronizálásként fogadja el a fájl-nem-található választ a szerverről.

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

    <Resync_Fails_On_FNF ua="na">IgenFails_On_FNF>esync_

  • A telefon weboldalán válassza az Igen lehetőséget, ha a file-not-found választ sikertelen újraszinkronizálásként szeretné elfogadni, vagy válassza a Nem lehetőséget, ha a file-not-found választ sikeres újraszinkronizálásként szeretné elfogadni.

Alapértelmezett: Igen

Profilhitelesítés típusa

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

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

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

  • XSI-hitelesítés: A profilfiók hitelesítéséhez XSI bejelentkezési hitelesítő adatokat vagy XSI SIP hitelesítő adatokat használunk. A hitelesítési adatok a telefon XSI hitelesítési típusától függenek:

    • Amikor a telefon XSI hitelesítési típusa a Bejelentkezési azonosító adatok értékre van állítva, a rendszer az XSI bejelentkezési azonosító adatokat használja.

    • Amikor a telefon XSI hitelesítési típusaSIP hitelesítő adatokra van beállítva, az XSI SIP hitelesítő adatokat használja a rendszer.

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

    <Profile_Authentication_Type ua="na">Alapszintű Http-hitelesítésAuthentication_Type>rofile_

  • A telefon weboldalán válasszon egy lehetőséget a telefon listájából a profil újraszinkronizálásának hitelesítéséhez.

Alapértelmezett: Alapszintű HTTP hitelesítés

További információkért lásd: A profil hitelesítési típusának megadása a Telefon megadása a profil újraszinkronizálásához.

Profilszabály

B profilszabály

C profilszabály

D profilszabály

Minden profilszabály tájékoztatja a telefont arról a forrásról, amelyből profilt (konfigurációs fájlt) lehet szerezni. Minden újraszinkronizálási művelet során a telefon az összes profilt alkalmazza a sorrendben.

Ha AES-256-CBC titkosítást alkalmaz a konfigurációs fájlokra, adja meg a titkosítási kulcsot a --key kulcsszóval az alábbiak szerint:

[--kulcs ]

A titkosítási kulcsot opcionálisan mellékelheti idézőjelben (") is.

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

    <Profile_szabály ua="na">/$PSN.xmlszabály>rofile_

    <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: /$PSN.xml

DHCP-beállítás használata

A firmware és a profilok lekéréséhez vesszővel elválasztott DHCP opciókat használnak.

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

DHCPv6-beállítás használata

A firmware és a profilok lekéréséhez vesszővel elválasztott DHCP opciókat használnak.

Alapértelmezett: 17,160,159

Szolgáltatás Cisco XML-en keresztül

A telefonok Cisco XML funkciókon keresztül üzemelhetők be.

Egy SIP értesítési csomaggal vagy a telefon CGI felületére küldött HTTP Postával küldhet egy XML objektumot a telefonra: http://PhoneIPAddress/CGI/Execute.

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

 <CP-xxxx-3PCCExecute> <ExecuteItem URL=Újraszinkronizálás:[profile-rule]/> </CP-xxxx-3PCCExecute>

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

URL-felbontás makró kiterjesztéssel

A szerveren több profillal rendelkező alkönyvtárak kényelmes módszert kínálnak nagyszámú telepített eszköz kezelésére. A profil URL-címe a következőket tartalmazhatja:

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

  • Egy nem szabványos kiszolgáló port, amelyet az URL-ben a kiszolgáló neve utáni standard :port szintaxissal határoznak meg.

  • A szerver virtuális gyökérkönyvtárának alkönyvtára, ahol a profilt tárolják, amelyet standard URL-jelöléssel határoznak meg és makró kiterjesztéssel kezelnek.

Például a következő Profile_szabály kéri a profilfájlt ($PN.cfg) a /cisco/config szerver alkönyvtárban a prov.telco.com kiszolgálón futó TFTP szerverről, amely a 6900-as porton keres kapcsolatot: 

 <Profile_szabály> tftp://prov.telco.com:6900/cisco/config/$PN.cfg szabály>
rofile_

Az egyes telefonok profilja egy általános célú paraméterben azonosítható, ahol az érték makró kiterjesztéssel egy közös profilszabályon belül hivatkozik.

Tegyük fel például, hogy a GPP_B meghatározása Dj6Lmp23Q.

A Profile_szabály értéke:

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

Amikor a készülék újraszinkronizál és a makrók ki vannak bontva, 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 profilhitelesítés típusának megadása

A profilhitelesítés lehetővé teszi a telefon felhasználói számára, hogy újraszinkronizálják a szolgáltatási profilt a telefonon. Hitelesítési információk szükségesek, amíg a telefon első alkalommal megpróbál újraszinkronizálni és letölteni a konfigurációs fájlt, és HTTP vagy HTTPS 401 hitelesítési hibát kap. Amikor engedélyezi ezt a funkciót, a telefonon megjelenik a Profilfiók beállítása képernyő a következő helyzetekben:

  • Amikor a telefon újraindítása után HTTP vagy HTTPs 401 hitelesítési hiba lép fel az első szolgáltatá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 hiányzik vagy figyelmen kívül hagyja a Profilfiók beállítása képernyő, a felhasználó a telefon képernyő menüjében vagy a Beállítás funkciógombon keresztül is elérheti a beállítási képernyőt, amely csak akkor jelenik meg, ha a telefonon nincs regisztrálva vonal.

Amikor letiltja a funkciót, a Profilfiók beállítása képernyő nem jelenik meg a telefonon.

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

  • Ha felhasználónév és jelszó nélkül ad meg egy helyes URL-t a Profilszabály mezőben, a telefonnak hitelesítésre vagy kivonatolásra van szüksége a profil újraszinkronizálásához. A megfelelő profilfiókkal halad a hitelesítés. Helytelen profilfiókkal sikertelen a hitelesítés.

  • Ha a Profilszabály mezőben helyes URL-t ad meg a helyes felhasználónévvel és jelszóval, a telefonnak hitelesítés vagy kivonatolás szükséges a profil újraszinkronizálásához. A profilfiók nem használható a telefon újraszinkronizálására. A bejelentkezés sikeres.

  • Ha a Profilszabály mezőben helyes URL-t ad meg helytelen felhasználónévvel és jelszóval, a telefonnak hitelesítés vagy kivonatolás szükséges a profil újraszinkronizálásához. A profilfiók nem használható a telefon újraszinkronizálására. 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 lévő 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 a Hang > Szolgáltatáslehető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) úgy konfigurálhatja, hogy a következő formátumú karakterláncot adja meg:

<Profile_Authentication_Type ua="na">LetiltvaAuthentication_Type>
rofile_

Beállítások:

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

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

  • XSI-hitelesítés: A profilfiók hitelesítéséhez XSI bejelentkezési hitelesítő adatokat vagy XSI SIP hitelesítő adatokat használunk. A hitelesítési adatok a telefon XSI hitelesítési típusától függenek:

    Amikor a telefon XSI hitelesítési típusa a Bejelentkezési azonosító adatok értékre van állítva, a rendszer az XSI bejelentkezési azonosító adatokat használja.

    Amikor a telefon XSI hitelesítési típusaSIP hitelesítő adatokra van beállítva, az XSI SIP hitelesítő adatokat használja a rendszer.

Alapértelmezett: Alapszintű HTTP hitelesítés

4

Kattintson az Összes módosítás elküldése lehetőségre.

Profil manuális alkalmazása a telefonra

Töltse le a konfigurációs fájlt a telefonra egy TFTP szerverről

A következő lépéseket követve töltse le a konfigurációs fájlt egy TFTP szerver alkalmazásba a PC-re.

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 ellenőrizze, hogy a konfigurációs fájl elérhető-e a TFTP gyökérkönyvtárban.

3

A webbö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ési hitelesítő adatokat. Használja ezt a formátumot:

http://<WAN_IP_cím>/admin/resync?tftp://<PC_IP_cím>/<file_name>&xuser=admin&xpassword=

Példa: 

http://192.168.15.1/admin/resync?tftp://192.168.15.100/my_config.xml&xuser=admin&xpassword=admin
Töltse le a konfigurációs fájlt a telefonra cURL segítségével

Az alábbi lépéseket követve töltse le a konfigurációt a telefonra cURL használatával. Ez a parancssori eszköz az adatok URL szintaxissal történő átvitelére szolgál. A cURL letöltéséhez látogasson el a következő oldalra:

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

Javasoljuk, hogy ne használja a cURL-t a konfiguráció telefonon való közzétételéhez, mert előfordulhat, hogy a felhasználónév és a jelszó rögzítésre kerül a cURL használata során.

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 elfogadja a konfigurációkat XML formátumban.

Az ebben a szakaszban található példák konfigurációs profilokat használnak XML szintaxissal.

Konfigurációs profil formá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 az UTF-8 karakterkészlet támogatott. Ha egy szerkesztőben módosítja a profilt, ne változtassa meg a kódolási formátumot; ellenkező esetben a telefon nem ismeri fel a fájlt.

Minden telefon más-más funkciókészlettel rendelkezik, ezért más-más paraméterkészlettel.

Nyílt profilformátum

A nyílt formátumú profil egy szövegfájl XML-szerű szintaxissal az elemek hierarchiájában, elem attribútumokkal és értékekkel. Ez a formátum lehetővé teszi, hogy szabványos eszközöket használjon a konfigurációs fájl létrehozásához. Egy XML konfigurációs fájl elküldhető a szolgáltató szerverről a telefonra az újraszinkronizálási művelet során, bináris objektumként való fordítás nélkül.

A telefon standard eszközök által generált konfigurációs formátumokat képes elfogadni. Ez a funkció megkönnyíti a meglévő adatbázisokból konfigurációs profilokat előállító back-end szolgáltató szerver szoftver fejlesztését.

A konfigurációs profil bizalmas információinak védelme érdekében a szolgáltató szerver az XML konfigurációs fájlt a telefonra egy TLS által biztosított csatornán keresztül küldi. Opcionálisan a fájl tömöríthető a gzip lapos algoritmus (RFC ) 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ú HTTP tartalom titkosítás AES-128-GCM cipherrel

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

  • Elemcímkék

  • Attribútumok

  • Paraméterek

  • Formázási funkciók

  • XML megjegyzések

Példa: Nyílt profilformátum

 <lapos profil> <Resync_vagyn_Alaphelyzetbe állítás> Igen vagyn_Alaphelyzetbe állítás> <Resync_Időszakos> 7200 Időszakos> <Profile_Szabály> tftp://prov.telco.com:6900/cisco/config/CP_xxxx_MPP.cfgSzabály> </lapos profil>
esync_esync_rofile_

A(z) elemcímke tartalmazza a telefon által felismert összes paraméterelemet.

Elemcímke tulajdonságai

A konfigurációs fájl létrehozásakor vagy frissítésekor tartsa szem előtt az alábbi szabályokat.

  • Az XML szolgáltatási formátum és a webes felhasználói felület lehetővé teszi ugyanazon beállítások konfigurálását. Az XML címke nevei és a mezőnevek a Web UI-ban hasonlóak, de az XML elem név korlátozásai miatt különböznek. Például aláhúzás ( _ ) az XML konfigurációs fájlban a Web UI felületén lévő szóközök helyett.

  • A telefon felismeri a megfelelő paraméter nevekkel rendelkező elemeket, amelyek a speciális elemben vannak.

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

  • A legtöbb elemnév hasonló a telefon webes felhasználói felületén található mezőnevekhez, a következő módosításokkal:

    • Az elemnevek nem tartalmazhatnak szóközöket és speciális karaktereket. Az elemnév webmező nevéből való származtatásához cserélje ki az aláhúzást minden szóköz vagy speciális karakter [, ], (, ), vagy / esetén.

      Példa: A <Resync_On_Reset> elem az Újraszinkron alaphelyzetbe állítás 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á a következőt az elem nevéhez: [n] az oldal fülön megjelenő szám jelzéséhez.

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

  • Minden nyitócímkének egyező zárócímkével kell rendelkeznie. Például:

      <Resync_On_Alaphelyzetbe állítás> Igen On_Alaphelyzetbe állítás> <Resync_Periodic> 7200 Periodic> <Profile_szabály>tftp://prov.telco.com:esync_esync_ 6900/cisco/config/CP_xxxx_MPP.cfg szabály>
    rofile_

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

  • Az üres elemcímkék engedélyezettek, és úgy lesznek értelmezve, hogy az érték konfigurálása üres. Adja meg a nyitóelemcímkét megfelelő elemcímke nélkül, és illesszen be egy szóközt és egy előrehajló perjelet a bezárási szögkeret (>) elé. Ebben a példában a B profilszabály üres:

     <Profile_Rule_B />

  • Üres elemcímke használható arra, hogy megakadályozza a felhasználó által megadott értékek felülírását újraszinkronizálási művelet során. Az alábbi példában a felhasználó gyorshívási beállításai változatlanok maradnak:

     <Speed_d)ial_2._Név ua="rw"/> <Speed_d)ial_2._Szám ua="rw"/> <Speed_d)ial_3._Név ua="rw"/> <Speed_d)ial_3._Szám ua="rw"/> <Speed_d)ial_4._Név ua="rw"/> <Speed_d)ial_4._Szám ua="rw"/> <Speed_d)ial_5._Név ua="rw"/> <Speed_d)ial_5._Szám ua="rw"/> <Speed_d)ial_6._Név ua="rw"/> <Speed_d)ial_6._Szám ua="rw"/> <Speed_d)ial_7._Név ua="rw"/> <Speed_d)ial_7._Szám ua="rw"/> <Speed_d)ial_8._Név ua="rw"/> <Speed_d)ial_8._Szám ua="rw"/> <Speed_d)ial_9._Név ua="rw"/> <Speed_d)ial_9._Szám ua="rw"/>

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

     <lapos profil> <GPP_A>   A> </lapos profil>
    _

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

Paraméter tulajdonságok

Ezek a tulajdonságok vonatkoznak a paraméterekre:

  • A profil által nem meghatározott paraméterek változatlanok maradnak a telefonon.

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

  • Ha a Nyílt formátumú profil ugyanannak a paramétercímkének több előfordulását tartalmazza, az utolsó ilyen előfordulás felülírja a korábbit. A paraméter konfigurációs értékeinek nem szándékos felülírásának elkerülése érdekében javasoljuk, hogy minden profil legfeljebb egy paraméterpéldányt határozzon meg.

  • Az utolsó feldolgozott profil elsőbbséget élvez. Ha több profil határozza meg ugyanazt a konfigurációs paramétert, az utóbbi profil értéke élvez elsőbbséget.

Karakterláncformátumok

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

  • A megjegyzések szabványos XML szintaxissal engedélyezettek.

  • A bevezető és záró szóköz megengedett az olvashatóság számára, de eltávolításra kerül a paraméter értékből.

  • Egy értéket tartalmazó új sorok szóközökké konvertálódnak.

  • A(z) <? ?> űrlap XML-fejléce engedélyezett, de a telefon figyelmen kívül hagyja.

  • Speciális karakterek beírásához használjon alap XML karakter megkerülést, az alábbi táblázatban foglaltak szerint.

    Speciális karakter

    XML megkerülési sorrend

    & (nagybetűs)

    &

    < (kisebb, mint)

    <

    > (nagyobb mint)

    >

    (aposztróf)

    '

    ” (kettős idézet)

    "

    Az alábbi példában karakter megkerülés van megadva a nagyobb mint és kisebb mint szimbólumok megjelenítéséhez, amelyek egy tárcsázási terv szabályban szükségesek. Ez a példa definiál egy információs forródrót tárcsázási tervet, amely a <Dial_P-értéklan_1. rész_> paraméter (Rendszergazdai bejelentkezés >> speciális >> Hang >> Mellék (n)) egyenlő (S0 ).

     <lapos profil> <Dial_Plan_1_> (S0 ) Plan_1_> </lapos profil>
    ial_

  • Numerikus karakterek megkerülése decimális és hexadecimális értékekkel (s.a. A(z) ( és .) le van fordítva.

  • A telefon firmware csak az ASCII karaktereket támogatja.

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

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

Nyílt profiltömörítés

A támogatott tömörítési módszer a gzip lapos algoritmus (RFC ). A gzip segédprogram és a tömörítési könyvtár, amely ugyanazt az algoritmust (zlib) hajtja végre, elérhető az internetes oldalakon.

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

Ha például a profile.xml egy érvényes profil, akkor a profile.xml.gz fájl is elfogadható. Az alábbi parancsok valamelyike generálhatja ezt a profiltípust:

  • >gzip profile.xml

    Lecseréli az eredeti fájlt 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 profiltitkosítás

Szimmetrikus kulcstitkosítás használható egy nyitott konfigurációs profil titkosítására, függetlenül attól, hogy a fájl tömörítve van-e vagy sem. Ha alkalmazott, a tömörítést a titkosítás előtt kell alkalmazni.

A szolgáltató szerver HTTPS protokollt használ a telefon telepítés utáni kezdeti szolgáltatásának kezelésére. Az offline előtitkosítási konfigurációs profilok lehetővé teszik a HTTP használatát a profilok újraszinkronizálására. Ez csökkenti a HTTPS szerver terhelését nagyszabású telepítések esetén.

A telefon kétféle titkosítási módszert támogat a konfigurációs fájlok esetében:

  • AES-256-CBC titkosítás

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

A kulcsot vagy az Input Keying Material (IKM) korábban meg kell adni a készüléknek. A titkos kulcs bootstrap HTTPS használatával biztonságosan elvégezhető.

A konfigurációs fájl nevéhez nincs szükség speciális formátumra, de a .cfg kiterjesztéssel végződő fájlnév általában konfigurációs profilt jelöl.

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ához szükség lehet az eszköz újbóli összeállítására az AES kód engedélyezéséhez. A firmware-t az 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 megegyezik a következő parancs által generált formátummal:

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

Egy kisbetűs -k megelőzi a titkos kulcsot, amely lehet bármilyen egyszerű szöveges kifejezés, és amely random 64 bites só előállítására szolgál. A titkosítási eszköz a -k argumentummal meghatározott titkosítással egy random 128-bites kezdővektort és a tényleges 256-bites titkosítási kulcsot hoz létre.

Amikor ezt a titkosítási módot használják egy konfigurációs profilon, a telefont tájékoztatni kell a titkos kulcs értékéről a fájl visszafejtéséhez. Ez az érték minősítőként van megadva a profil URL-jében. A szintaxis a következő, egy explicit URL használatával:

 [--kulcs “SecretPhrase 1234”] http://prov.telco.com/path/profile.cfg

Ez az érték a Profile_Rule egyik paraméterével programozható.

Makró kiterjesztés

Számos szolgáltatási paraméter belső makró kiterjesztésen esik át az értékelés előtt. Ez 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égeinek szabályozásában.

Ezek a paramétercsoportok az értékelés előtt makró kiterjesztésen mennek keresztül:

  • Resync_Trigger_*

  • Profile_szabály*

  • Log_xxx_Msg

  • Upgrade_szabály

Bizonyos feltételek mellett néhány általános célú paraméter (GPP_*) is makró kiterjesztésen esik át, amint azt az alábbi Opcionális újraszinkronizálási argumentumok című rész kifejezetten jelzi.

Makró kiterjesztés során a megnevezett változók tartalma felváltja az $NAME és $(NAME) űrlapok kifejezéseit. Ezek a változók magukban foglalják az általános célú paramétereket, több termékazonosítót, bizonyos eseményidőzítőket és a szolgáltatási állapot értékeket. A teljes listát lásd a Makró kiterjesztő változók című témakörben a Szolgáltatási paraméterek alatt.

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

A rendszergazda a következőt írja be: $(MAU)config.cfg

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

Ha a makrónevet nem ismeri fel a rendszer, nem lesz kiterjesztve. Például a STRANGE név nem ismerhető fel érvényes makrónévként, a MAU viszont érvényes makrónévként.

A rendszergazda a következőt írja be: $STRANGE$MAU.cfg

Az eredményül kapott makró kiterjesztés a 000E08012345 MAC-címmel rendelkező eszközhöz: $STRANGE 002E08012345.cfg

A makró kiterjesztés nem alkalmazható rekurzívan. Például az $$MAU” kiterjesztése $MAU” (az $$ ki van bontva), és nem ad MAC címet.

A speciális célú paraméterek tartalma, a GPP_SA - GPP_SD, az $SA - $SD makró kifejezésekhez van hozzárendelve. Ezek a paraméterek csak makró kiterjesztéssel vannak ellátva az újraszinkronizálási URL-ben a --key , --uid és --pwd opciók argumentumaként.

Feltételes kifejezések

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

A feltételes kifejezések összehasonlítások listájából állnak, melyeket és operátor választ el egymástól. Minden összehasonlításnak teljesülnie kell ahhoz, hogy a feltétel igaz legyen.

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

  • Egész szám

  • Szoftver vagy hardver verziószámok

  • Dupla idézőjeles stringek

Verziószámok

A Cisco 8875-ös videotelefon szoftververziója ezt a formátumot használja (ahol a BN a Build Szám):

PHONEOSéééé.1-0-1-0001-BN

ahol éééé a telefonmodellt vagy telefonsorozatot jelöli; 1 a fő verzió; 0 a kisebb verzió; 1-0001 a mikroverzió; és BN a gyártási szám.

Az összehasonlító karakterláncnak ugyanazt a formátumot kell használnia. Ellenkező esetben a formátum feldolgozási hiba eredménye.

A szoftververzió összehasonlításakor a nagyobb verziót, a kisebb verziót és a mikro verziót egymás után hasonlítjuk össze, és a bal szélső számjegyek elsőbbséget élveznek az utóbbiakkal szemben. Ha a verziószámok azonosak, a build számát hasonlítja össze.

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

phoneos-8875.1-0-1-0001-19

Összehasonlítás

Az idézőjeles stringek egyenlőségre vagy egyenlőtlensé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 betűszavak kényelmesen kifejezik a feltételt egy Nyílt formátumú profilban.

Operátor

Alternatív szintaxis

Leírás

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

Alkalmazható idézőjeles string operátorokra

=

egyenlő

egyenlő:

Igen

Igen

!=

nem egyenlő

nem egyenlő:

Igen

Igen

<

kisebb, mint

kevesebb, mint

Igen

Nem

<=

kisebb vagy egyenlő

kisebb vagy egyenlő

Igen

Nem

>

nagyobb, mint

nagyobb, mint

Igen

Nem

>=

nagyobb vagy egyenlő

nagyobb vagy egyenlő

Igen

Nem

ÉS

és

Igen

Igen

Fontos, hogy a makró változókat dupla idézőjelbe csatolni, ahol string literálra van szükség. Ne tegye ezt ott, ahol szám vagy verziószám várható.

A Profile_Rule* és Upgrade_Rule paraméterek kontextusában történő használatakor a feltételes kifejezéseket a "(kifejezés)?" szintaxisban kell szerepeltetni, mint ebben a frissítési szabály példában. Ne felejtse el lecserélni a BN -t a firmware-terhelés építési számával, hogy frissítse.

($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 előző szintaxist az Resync_Trigger_* paraméterek konfigurálásához.

URL szintaxis

A Standard URL szintaxis határozza meg a konfigurációs fájlok lekérésének módját a Profile_Rule* és az Upgrade_Rule paraméterekben. A szintaxis a következő:

[ scheme:// ] [ kiszolgáló [:port]] fájlútvonal

Ahol a séma az alábbi értékek egyike:

  • tftp-t

  • http

  • https

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

Ha a kiszolgáló hiányzik, a DHCP-n keresztül megadott tftp-kiszolgálót (66-os opció) használja a rendszer.

A frissítési szabályokhoz meg kell adni a kiszolgálót.

Ha a port hiányzik, a megadott séma standard portját használja a rendszer. A tftp a 69-es UDP portot, a http a 80-as TCP portot, a https a 443-as TCP portot használja.

A fájlútvonalnak jelen kell lennie. Nem kell feltétlenül statikus fájlra hivatkoznia, de jelezheti a CGI-n keresztül kapott dinamikus tartalmat.

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

 /$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 Profilszabályra* vonatkozik.

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

A telefon támogatja az RFC 8188-alapú HTTP tartalom titkosítást AES-128-GCM cipheréssel a konfigurációs fájlok esetében. Ezzel a titkosítási módszerrel bármely entitás elolvashatja a HTTP üzenet fejléceit. Azonban csak az IKM (Input Keying Material) ismerő entitások olvashatják el a hasznos adatokat. Amikor a telefon rendelkezik az IKM-mel, a telefon és a szolgáltató szerver biztonságosan kicserélheti a konfigurációs fájlokat, miközben lehetővé teszi a harmadik féltől származó hálózati elemek számára az üzenet fejlécek analitikai és megfigyelési célokra történő használatát.

Az IKM_HTTP_Encrypt_Tartalom XML konfigurációs paraméter tárolja az IKM-et a telefonon. Biztonsági okokból ez a paraméter nem érhető el a telefon adminisztrációs weboldalán. Nem látható a telefon konfigurációs fájljában sem, amelyet a telefon IP-címéből vagy a telefon hálózatlétesítési kiszolgálóra küldött konfigurációs jelentéseiből lehet elérni.

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

  • A telefon IKM-mel való ellátása az IKM XML paraméter megadásával Ikm-ben_http: / /www.php.net_E-mail címncrypt_Tartalom a szolgáltató szerverről a telefonra küldött konfigurációs fájlban.

  • Ha ezt a titkosítást alkalmazza a szolgáltató szerverről a telefonra küldött konfigurációs fájlokra, győződjön meg arról, hogy a konfigurációs fájl Tartalom-kódolás HTTP fejlécében aes 002gcm van.

    E fejléc hiányában az AES-256-CBC módszer kap elsőbbséget. Ha egy profilszabályban AES-256-CBC kulcs van, a telefon az AES-256-CBC visszafejtést alkalmazza, az IKM-től függetlenü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ésekre, győződjön meg arról, hogy nincs megadva AES-256-CBC kulcs a jelentésszabályban.

Opcionális újraszinkron argumentumok

Az opcionális argumentumok, kulcs, uid és pwd előzhetik meg a Profile_Rule* paraméterekben megadott URL-eket, amelyeket szögletes zárójelek határoznak meg.

Kulcs

A --key beállítás közli a telefonnal, hogy a szolgáltató szerverről kapott konfigurációs fájl AES-256-CBC titkosítással van titkosítva, kivéve, ha a Content-Encoding fejlécben aes 002gcm titkosítást jelez. A kulcsot egy karakterláncként kell megadni, amely a --key kifejezést követi. A kulcsot opcionálisan idézőjelbe (") is lehet zárni. A telefon a kulcsot használja a konfigurációs fájl visszafejtéséhez.

Használati példák
 [--key VerySecretValue] [--key “saját titkos kifejezés”] [--key a37d2fb9055c1d04883a0745eb0917a4]

A zárójelben szereplő opcionális argumentumok makróval bővítve vannak. A speciális célú paraméterek, a GPP_SA - GPP_SD makró kiterjesztésű makró változók, $SA - $SD között, csak akkor, ha kulcsopció argumentumként használják őket. Lásd az alábbi példákat:

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

Nyílt formátumú profilokban a --key argumentumnak meg kell egyeznie az -k beállítás argumentumával, amely az openssl-hez van megadva.

uid és pwd

Az UID és a pwd beállítások segítségével megadható, hogy a megadott URL kérésekor a HTTP Basic és Kivonatoló hitelesítési kihívásokra válaszul milyen felhasználói azonosítót és jelszót kell küldeni. A zárójelben szereplő opcionális argumentumok makróval bővítve vannak. A speciális célú paraméterek, a GPP_SA - GPP_SD makró kiterjesztésű makró változók, $SA - $SD között, csak akkor, ha kulcsopció argumentumként használják őket. Lásd az alábbi példákat:

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

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

bontja ki a következőt:

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

Adattípusok

Ezeket az adattípusokat használják a konfigurációs profil paraméterekkel:

  • {a,b,c, 002}—Választás a, b, c, -ból

  • Bool—Boolean értéke vagy „igen” vagy „nem”.

  • CadScript—Egy miniscript, amely egy jel ütem paramétereit határozza meg. Legfeljebb 127 karakter.

    Szintaxis: S1[;S2], ahol:

    • Si. sz.=di. sz.(bekapcsolva)i,1/kii,1[,oni,2/kii,2[,oni,3/kii,3[,oni,4/kii,4[,oni,5/kii,5[,oni,6/kii,6]]]]), és ez egy szakasz.

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

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

    Minden időtartamhoz legfeljebb három tizedeshely tartozhat, hogy 1 ms felbontást biztosítson. A "*" helyettesítő karakter korlátlan időtartamot jelöl. A szakaszon belüli szegmensek sorrendben kerülnek lejátszásra, és addig ismétlődnek, amíg a teljes időtartam le nem játszódik.

    1. példa:

     60(2/4) Ütem szakaszok száma = 1 Ütem szakasz 1: Szakasz hossza = 60 s Szegmensek száma = 1 1 Szegmens: Be=2 s, Ki=4 s Teljes csengőhossz = 60 s

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

     60(.2/.2,.2/.2,.2/.2,.1/4) Ütem szakaszok száma = 1 Ütem szakasz 1: Szakasz hossza = 60s Szegmensek száma = 4 1. szegmens: Be=0,2 s, Ki=0,2 s 2. szegmens: Be=0,2 s, Ki=0,2 s 3. szegmens: Be=0,2 s, Ki=0,2 s 4. szegmens: Be=1,0s, Ki=4,0s Teljes csengőhossz = 60s

  • DialPlanScript—Script szintaxis, amely az 1. és 2. vonal tárcsázási tervek megadására szolgál.

  • Lebegőpontos—Lebegőpontos érték legfeljebb n tizedeshellyel.

  • FQDN—Teljesen minősített tartománynév. Legfeljebb 63 karaktert tartalmazhat. Példák a következők:

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

    • sip.Cisco.com vagy 109.12.14.12

  • FreqScript—Egy miniscript, amely egy hang frekvencia és szint paramétereit határozza meg. Legfeljebb 127 karaktert tartalmaz.

    Szintaxis: F. rész1. rész@l1. rész[,f2.@l2.[,f3.@l3.[,f4.@l4.[,f5.@l5.[,f6.@l6.]]]]], ahol:

    • Az F1–F6 frekvencia Hz-ben (csak aláíratlan egész számok).

    • L1–L6 a megfelelő szintek dBm-ben (legfeljebb egy tizedeshelyig).

    Fehér szóközök a vessző előtt és után megengedettek, de nem javasoltak.

    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árcsahang:

     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 formátumban, ahol x 0 és 255 között van. Példa: 10.1.2.100.

  • UserID—Felhasználói azonosító az URL-ben megjelenő formában; legfeljebb 63 karakter.

  • Phone—Telefonszám karakterlánc, például 14081234567, *69, *72, 345678; vagy általános URL, például 1234@10.10.10.100:5068 vagy jsmith@Cisco.com. A karakterlánc legfeljebb 39 karaktert tartalmazhat.

  • PhTmplt—Egy telefonszámsablon. Minden sablon egy vagy több, vesszővel (,) elválasztott mintát tartalmazhat. Az egyes minták elején levő szóközök figyelmen kívül lesznek hagyva. A "?" és a "*" helyettesítő karaktereket jelöl. A szó szoros értelmében a %xx. For example, %2a jelöli a * karaktert. A sablon legfeljebb 39 karaktert tartalmazhat. Példák: “1408*, 1510*”, “1408123????, 555?1.”.

  • Port—TCP/UDP portszám (0-65535). Megadható decimális vagy hexadecimális formátumban.

  • ProvisioningRuleSyntax—Script szintaxis, amely a konfiguráció újraszinkronizálási és förmver frissítési szabályok meghatározására használatos.

  • PwrLevel—Teljesítményszint dBm-ben kifejezve egy tizedeshellyel, például –13,5 vagy 1,5 (dBm).

  • RscTmplt—SIP válaszállapot kód sablon, például „404, 5*”, „61?”, „407, 408, 487, 481”. Legfeljebb 39 karaktert tartalmazhat.

  • Sig—Aláírt n-bites érték. Megadható decimális vagy hexadecimális formátumban. A „-” jelnek negatív értékeket kell megelőznie. A + jel a pozitív értékek előtt opcionális.

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

  • STR—Legfeljebb n nem lefoglalt karaktert tartalmazó általános karakterlánc.

  • Idő—Az időtartam másodpercben, legfeljebb n tizedeshellyel. Az extra megadott tizedeshelyek figyelmen kívül lesznek hagyva.

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

    Szintaxis: FreqScript;Z1[;Z2].

    A Z1 szakasz hasonló az S1 szakaszhoz egy CadScript-ben, azzal a kivétellel, hogy minden be/ki szegmenst egy frekvencia komponens paraméter követ: Kategória: Labdarúgás1. rész = d1. rész(bekapcsolva)i,1/kii,1/fi,1[,oni,2/kii,2/fi,2 [,oni,3/kii,3/fi,3 [,oni,4/kii,4/fi,4 [,oni,5/kii,5/fi,5 [,oni,6/kii,6/fi,6]]]]) ahol:

    • F. részi,j = n1. rész[+n]2.]+n3.[+n]4.[+n]5.[+n]6.]]]].

    • 1 < nk < 6 határozza meg az adott szegmensben használt FreqScript frekvencia komponenseket.

    Ha egy szegmensben egynél több frekvenciakomponenst használ, a komponensek összegzésre kerülnek.

    1. példa—Tárcsahang:

     350@-19,440@-19;10(*/0/1+2) Frekvenciák száma = 2 Frekvencia 1 = 350 Hz -19 dBm Frekvencia 2 = 440 Hz -19 dBm Cadence szakaszok száma = 1 Cadence szakasz 1: Szakasz hossza = 10 s Szegmensek száma = 1 1 Szegmens: Be=mindörökké, az 1. és 2. frekvenciák teljes hanghossza = 10 mp

    2. példa—Felugró hang:

     350@-19,440@-19;2(.1/.1/1+2);10(*/0/1+2) Frekvenciák száma = 2 Frekvencia 1 = 350 Hz -19 dBm Frekvencia 2 = 440 Hz -19 dBm Cadence szakaszok száma = 2 Cadence szakasz 1: Szakasz hossza = 2 s Szegmensek száma = 1 1 Szegmens: Be=0.1s, Ki=0.1s az 1. és 2. frekvenciájú ütem 2. szakaszával: Szakasz hossza = 10 s Szegmensek száma = 1 1 Szegmens: Be=mindörökké, az 1. és 2. frekvenciák Teljes hanghossz = 12 mp

  • Uns—Nem aláírt n-bites érték, ahol n = 8, 16 vagy 32. Megadható decimális vagy hexadecimális formátumban, például 12 vagy 0x18, feltéve, hogy az érték n bitbe illeszthető.

Tartsa szem előtt a következőket:

  • A egy konfigurációs paraméter nevét jelöli. A profilban a megfelelő címkét úgy alakítja ki, hogy a teret aláhúzással „_” helyettesíti, például Par_Név.
  • Az üres alapértelmezett érték mező üres karakterláncot jelent < “” >.
  • A telefon továbbra is az utoljára konfigurált értékeket használja azoknál a címkéknél, amelyek nincsenek jelen egy adott profilban.
  • 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.
  • Az üres paraméter értékkel rendelkező paraméter specifikáció visszaállítja a paramétert az alapértelmezett értékre. Ha üres stringet szeretne megadni helyette, használja az üres stringet "" paraméterértékként.