- Kezdőlap
- /
- Cikk
Profilbeállítások konfigurálása 9800-as sorozatú és 8875 telefonokhoz (BroadWorks)
Ez a súgócikk a Cisco BroadWorks szolgáltatásban regisztrált Cisco asztali telefonra és 8875 Cisco asztali telefonra vonatkozik. Az ezen az oldalon található információk tartalmazzák a profil újraszinkronizálását, a profil manuális alkalmazását és a konfigurációs szintaxist.
Konfigurálja telefonját a profil újraszinkronizálásához
A telefonprofil újraszinkronizálása TFTP-n keresztül
A telefon több hálózati protokollt 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 biztosítására a privát LAN hálózatokon belül. Bár a TFTP nem ajánlott távoli végpontok telepítéséhez az interneten keresztül, kényelmes lehet kis szervezeteken belüli telepítéshez, házon belüli előkészítéshez, valamint fejlesztéshez és teszteléshez. A következő eljárásban a profil módosításra kerül, miután letöltötte a fájlt egy TFTP-kiszolgálóról.
| 1 |
LAN környezetben csatlakoztassa számítógépét és telefont egy hubhoz, kapcsolóhoz vagy kis routerhez. |
| 2 |
A számítógépen telepítse és aktiválja a TFTP-kiszolgálót. |
| 3 |
Konfigurációs profil létrehozásához használjon szövegszerkesztőt. Annak ellenőrzéséhez, hogy a profilt később biztosították-e a telefonjára, néhány értéket jelölésként állíthatja be. Állítsa például a GPP_A értékét 12345678 értékre, amint azt a következő példa mutatja:
|
| 4 |
Mentse el az XML konfigurációs fájlt a TFTP-kiszolgáló gyökérkönyvtárába. Ellenőrizheti, hogy a TFTP-kiszolgáló megfelelően van-e konfigurálva: kérje a konfigurációs profilfájlt a telefonon kívüli TFTP-kliens használatával. Lehetőleg olyan TFTP-klienst használjon, amely a biztosító kiszolgálótól külön állomáson fut. |
| 5 |
A számítógép böngészőjében nyissa meg az adminisztrációs weboldalt. Tegyük fel például, hogy a telefon IP-címe 192.168.1.100, nyissa meg a következő URL-t a webböngészőben:
|
| 6 |
Válassza a H , és ellenőrizze a GPP_A általános célú paraméterek értékeit a GPP_P segítségével. Ezeknek üreseknek kell lenniük. |
| 7 |
Szinkronizálja újra a teszttelefont azzal a konfigurációs profillal, amelyet a webböngészőben történő újraszinkronizálás URL-jének megnyitásával hozott létre. Példa: Ha a TFTP-kiszolgáló IP-címe 192.168.1.200, a parancsnak hasonlónak kell lennie a következő példához:
Amikor a telefon megkapja ezt a parancsot, a 192.168.1.100 címen lévő eszköz megkéri a |
| 8 |
Ellenőrizze, hogy a paraméter helyesen van-e frissítve. Frissítse az adminisztrációs weboldalt, és lépjen a . A GPP_A paraméternek most tartalmaznia kell az 12345678 értéket. |
Telefonspecifikus profil biztosítása TFTP-kiszolgálón
| 1 |
Szerezze be a telefon MAC-címét a termék címkéjéről. (A MAC-cím a szám, számokat és kisbetűs hatlapszámjegyeket használva, például 000e08aabbcc. |
| 2 |
Példa:
|
| 3 |
Helyezze át az új fájlt a TFTP-kiszolgáló virtuális gyökérkönyvtárába. |
| 4 |
Nyissa meg a telefon adminisztrációs weboldalát. |
| 5 |
Válassza a |
| 6 |
Adja meg a profilfájl elérési útját a Profilszabály mező be. Példa: Tegyük fel, hogy a TFTP-kiszolgáló IP-címe 192.168.1.200, a profilfájl neve pedig
|
| 7 |
Kattintson az Összes módosítás küldése elemre 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 MAC-címére történő kiterjesztésével lekérheti az új fájlt. |
Szinkronizálja újra a telefonprofilt a HTTP GET segítségével
| 1 |
Telepítsen egy HTTP-kiszolgálót a helyi számítógépre vagy más hozzáférhető gazdára. 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 kiszolgáló virtuális gyökérkönyvtárába. |
| 3 |
A kiszolgáló megfelelő telepítésének és a profilfájlhoz való hozzáférés ellenőrzéséhez nyissa meg a profilt egy webböngészővel. |
| 4 |
Módosítsa a teszttelefon profile_szabályát úgy, hogy a TFTP-kiszolgáló helyett a HTTP-kiszolgálóra mutasson, hogy rendszeresen letölthesse a profilját. Ha például feltételezzük, hogy a HTTP-kiszolgáló 192.168.1.300, és a profilfájl neve basic.txt, írja be a következő értéket:
|
| 5 |
Kattintson az Összes módosítás küldése elemre Ez azonnali újraindítást és újraszinkronizálást okoz. |
| 6 |
Figyelje meg a telefon által küldött syslog üzeneteket. Az időszakos reszinkronizálásnak most meg kell szereznie a profilt a HTTP-kiszolgálóról. |
| 7 |
A HTTP-kiszolgáló naplóiban figyelje meg, hogyan jelennek meg a teszttelefont azonosító információk 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óját és a sorozatszámot. |
A telefonprofil automatikus újraszinkronizálása
Egy eszköz rendszeresen újraszinkronizálhatja a biztosító kiszolgálóval annak biztosítása érdekében, hogy a kiszolgálón végrehajtott profilmódosítások elterjedjenek a végponti eszközre (ellentétben a végponthoz történő kifejezett újraszinkronizálási kérelem küldésével).
Ahhoz, hogy a telefon rendszeresen újraszinkronizáljon egy kiszolgálóval, a Profile_Rule paraméter használatával definiálunk egy konfigurációs profil URL-címét, és a Resync_Periodic paraméter használatával definiáljuk az újraszinkronizálási időszakot.
| 1 |
Nyissa meg a telefon adminisztrációs weboldalát. |
| 2 |
Válassza a |
| 3 |
Határozza meg a Profile_Rule paramétert. Ez a példa feltételezi, hogy a TFTP-kiszolgáló IP-címe 192.168.1.200. |
| 4 |
A Resync Periodic mező be írjon be egy kis értéket a teszteléshez, például 30 másodpercet. |
| 5 |
Kattintson az Összes módosítás küldése elemre Az új paraméterbeállításokkal a telefon percenként kétszer szinkronizálódik az URL-ben megadott konfigurációs fájlhoz. |
| 6 |
Figyelje meg a kapott üzeneteket a syslog nyomban. |
| 7 |
Győződjön meg arról, hogy a Resync On Reset mező Igen értékre van állítva.
|
| 8 |
A telefon áramellátása érdekében arra kényszerítheti, hogy újraszinkronizálásra kényszerítse a szolgáltató kiszolgálóval. Ha az újraszinkronizálási művelet bármilyen okból sikertelen, például ha a kiszolgáló nem válaszol, az egység megvár (az újraszinkronizálási hiba újrapróbálkozási késleltetésben konfigurált másodpercek számát), mielőtt újra megpróbálja újra szinkroniz álni. Ha az újraszinkronizálási hiba újrapróbálásának késl eltetése nulla, a telefon nem próbálja meg újraszinkronizálni a sikertelen újraszinkronizálási kísérlet után. |
| 9 |
(Opcionális) Állítsa be az újraszin kronizálási hiba újrapróbálkozási késl eltetés mező értékét kis számra, például 30-ra.
|
| 10 |
Tiltsa le a TFTP-kiszolgálót, és figyelje meg az eredményeket a syslog kimeneten. |
Profil újraszinkronizálási paraméterek
A következő táblázat meghatározza a profil újraszinkronizálási paramétereinek funkci Hozzárendelés lapján. Meghatározza annak a karakterláncnak a szintaxisát is, amelyet a telefon konfigurációs fájljába (cfg.xml) XML kóddal adnak hozzá egy paraméter konfigurálásához.
|
paraméter |
Leírás |
|---|---|
|
Rendelkezés engedélyezése |
Lehetővé teszi vagy megtagadja a konfigurációs profil újraszinkronizálását.
Alapértelmezett: Igen |
|
Szinkronizálás visszaállításkor |
Meghatározza, hogy a telefon újraszinkronizálja-e a konfigurációkat a biztosító kiszolgálóval a bekapcsolás után és minden frissítési kísérlet után.
Alapértelmezett: Igen |
|
Véletlenszerű késleltetés újrat |
Megakadályozza a biztosító kiszolgáló túlterhelését, ha nagyszámú eszköz egyidejűleg bekapcsolódik, és megpróbálja a kezdeti konfigurációt. Ez a késleltetés csak a kezdeti konfigurációs kísérlet esetén érvényes, az eszköz bekapcsolását vagy visszaállítását követően. A paraméter az a maximális időintervallum, amelyet a készülék megvár, mielőtt kapcsolatba lép a biztosító kiszolgálóval. A tényleges késleltetés egy pszeudo-véletlenszerű szám 0 és ezen érték között. Ez a paraméter 20 másodperces egységekben van. Az érvényes érték 0 és 65535 között mozog.
Az alapértelmezett érték 2 (40 másodperc). |
|
Újraszinkronizálás At (HHmm) |
Az idő (HHmm), amelyet a telefon újraszinkronizál a biztosító kiszolgálóval. Ennek a mezőnek egy négyjegyű számnak kell lennie, amely 0000 és 2400 között mozog az idő HHMM formátumban történő jelzéséhez. Például a 0959 a 09:59. jelet jelöli.
Az alapértelmezett érték üres. Ha az érték érvénytelen, a paramétert figyelmen kívül hagyjuk. Ha ez a paraméter érvényes értékkel van beállítva, a Resync Periodic paraméter figyelmen kívül marad. |
|
Véletlenszerű késleltetés esetén újraszin |
Megakadályozza a biztosító kiszolgáló túlterhelését, ha nagyszámú eszköz egyidejűleg bekapcsolódik. Az újraszinkronizálási kérelmek több telefonról történő elárasztásának elkerülése érdekében a telefon újraszinkronizálja az órák és percek, valamint az órák és percek plusz a véletlenszerű késleltetés (hhmm, hhmm+random_delay) közötti tartományban. Például, ha a véletlenszerű késleltetés = (Resync At Random Delay + 30) /60 perc, akkor a másodpercben megadott bemeneti értéket percre konvertáljuk, a következő percre kerekítve a végső random_delay intervallum kiszámításához.
Az érvényes érték 600 és 65535 között mozog. Ha az érték kevesebb, mint 600, akkor a véletlenszerű belső késleltetés 0 és 600 között van. Az alapértelmezett érték 600 másodperc (10 perc). |
|
Időszakos újraszinkronizálás |
A biztosító kiszolgálóval való időszakos újraszinkronizálás közötti időintervallum. A társított újraszinkronizálási időzítő csak a kiszolgálóval való első sikeres szinkronizálás után aktív. Az érvényes formátumok a következők:
Állítsa nullára ezt a paramétert az időszakos újraszinkronizálás letiltásához. Az alapértelmezett érték 3600 másodperc. |
|
Újraszinkronizálási hiba újbóli próbálkozás |
Ha az újraszinkronizálási művelet sikertelen, mert a telefon nem sikerült lekérni egy profilt a kiszolgálóról, vagy a letöltött fájl sérült, vagy belső hiba lép fel, a telefon másodpercben megadott idő elteltével megpróbálja újra szinkronizálni. Az érvényes formátumok a következők:
Ha a késleltetés 0-ra van beállítva, a készülék nem próbálja meg újra szinkronizálni a sikertelen újraszinkronizálási kísérletet követően.
Alapértelmezett: 60,120,240,480,960,1920,3840,7680,15360,30720,61440,86400 |
|
Kényszerített újraszinkronizálási |
Maximális késleltetés (másodpercben), amelyet a telefon megvár az újraszinkronizálás előtt. A készülék nem szinkronizálja újra, amíg az egyik telefonvonal aktív. Mivel az újraszinkronizálás több másodpercet is igénybe vehet, az újraszinkronizálás előtt kívánatos várni, amíg az eszköz hosszabb ideig nem áll készenléti. Ez lehetővé teszi a felhasználó számára, hogy megszakítás nélkül egymást követő hívásokat kezdeményezzen. A készüléknek van egy időzítője, amely akkor kezd visszaszámlálni, amikor az összes vonal üresjárati állapotban van. Ez a paraméter a számláló kezdeti értéke. Az újraszinkronizálási események addig késik, amíg ez a számláló nullára nem csökken. Az érvényes érték 0 és 65535 között mozog.
Az alapértelmezett érték 14 400 másodperc. |
|
Újraszinkronizálás a SIP-ből |
A szolgáltató proxyszerveréről a telefonra küldött SIP NOTIFY eseményen keresztül vezérli az újraszinkronizálási műveletekre vonatkozó kérelmeket. Ha engedélyezve van, a proxy újraszinkronizálást kérhet az eszközre az Esemény: újraszinkronizálás fejlécét tartalmazó SIP NOTIFICATION üzenet küldésével.
Alapértelmezett: Igen |
|
Újraszinkronizálás frissítési kísérlet után |
Bármely frissítés után engedélyezi vagy letiltja az újraszinkronizálási műveletet. Ha az Igen beállí tás van beállítva, a szinkronizálás a firmware-frissítés után aktiválódik.
Alapértelmezett: Igen |
|
Resync Trigger 1 Resync Trigger 2 |
Ha a paraméterek logikai egyenlete FALSE értékre értékeli, akkor az újraszinkronizálás akkor sem indul el, ha a Resyn c On Reset értéke TRUE értékre van állí tva. Csak a közvetlen műveleti URL-en és a SIP-értesítésen keresztül történő újraszinkronizálás figyelmen kívül hagyja ezeket az újraszinkronizálási A paraméterek programozhatók egy feltételes kifejezéssel, amely makróbővítésen megy keresztül. Az érvényes makróbővítményekről lásd: Makróbővítési változók a Param éterek biztosítása alatt.
Alapértelmezett: Üres |
|
Felhasználó konfigurálható újraszinkronizálás |
Lehetővé teszi a felhasználó számára, hogy újraszinkronizálja a telefont a telefon képernyőjének menüjéből. Ha Igen értékre van beállítva, a felhasználó újraszinkronizálhatja a telefon konfigurációját a profilszabály megadásával a telefonról. Ha a Nem értékre van beállí tva, a Profilszabály paraméter nem jelenik meg a telefon képernyőjének menüjében.
Alapértelmezett: Igen |
|
Az újraszinkronizálás sikertelen az FNF-en |
Az újraszinkronizálás általában sikertelennek minősül, ha a kért profil nem érkezik meg a kiszolgálótól. Ez a paraméter felülírja ezt a viselkedést. Ha a Nem értékre van beállí tva, a készülék sikeres újraszinkroniz
Alapértelmezett: Igen |
|
Profil hitelesítési típusa |
Megadja a profilfiók hitelesítéséhez használandó hitelesítő adatokat. A rendelkezésre álló lehetőségek a következők:
Alapértelmezett: Alapvető HTTP-hitel További információt a Profil hitelesítési típusának megadása című témakörben talál: A profil újraszinkronizálására szolgáló telefon megadása részben. |
|
Profil szabály Profil szabály B C profilszabály Profilszabály D |
Minden profilszabály tájékoztatja a telefont arról a forrásról, ahonnan profilt kaphat (konfigurációs fájl). Minden újraszinkronizálási művelet során a telefon sorrendben alkalmazza az összes profilt.
A titkosítási kulcsot opcionálisan kettős idézőjelekkel („) is csatolhatja.
Alapértelmezett: |
|
Használható DHCP opció |
A firmware és a profilok lekéréséhez vesszővel elválasztott DHCP-opciók. Alapértelmezett: 66,160,159,150,60,43,125 |
|
DHCPv6 Használható Opció |
A firmware és a profilok lekéréséhez vesszővel elválasztott DHCP-opciók. Alapértelmezett: 17,160,159 |
Biztosítás a Cisco XML-en keresztül
A telefonokat Cisco XML funkciókon keresztül biztosíthatja.
XML objektumot küldhet a telefonra SIP Notification csomag 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 funkciót az XML objektumon keresztüli biztosítás támogatására:
<CP-xxxx-3PCCExecute>
<ExecuteItem URL=Resync:[profile-rule]/>
</CP-xxxx-3PCCExecute>
Miután a telefon megkapta az XML objektumot, letölti a biztosítási fájlt a [profile-rule] webhelyről. Ez a szabály makrókat használ az XML-szolgáltatások alkalmazás fejlesztésének egyszerűsítésére.
URL-felbontás makróbővítéssel
A kiszolgálón több profillal rendelkező alkönyvtárak kényelmes módszert nyújtanak nagyszámú telepített eszköz kezelésére. A profil URL-je a következőket tartalmazhatja:
-
Rendelkezési kiszolgálónév vagy kifejezett IP-cím. Ha a profil név szerint azonosítja a biztosítási kiszolgálót, a telefon DNS-keresést hajt végre a név megoldására.
-
Nem szabványos kiszolgálóport, amelyet az URL-ben a szerver nevét követő szabványos szintax:port használatával adnak meg. -
A kiszolgáló virtuális gyökérkönyvtárának alkönyvtára, ahol a profil tárolódik, szabványos URL-jelöléssel megadva és makróbővítéssel kezelve.
Például a következő Profile_Rule kéri a /cisco/config kiszolgáló alkönyvtárában található profilfájlt ($pn.cfg) a prov.telco .com hoston futó TFTP-kiszolgálótól, amely a 6900-as porton lévő kapcsolatot hallgat:
<Profile_Rule>
tftp://prov.telco.com:6900/cisco/config/$PN.cfg
</Profile_Rule>
Az egyes telefonok profilja általános célú paraméterben azonosítható, amelynek értéke egy közös profilszabályban hivatkozik a makróbővítés használatával.
Tegyük fel például, hogy a GPP_B Dj6Lmp23Q néven van definiálva.
A Profile_Rule értéke a következő:
tftp://prov.telco.com/cisco/$B/$MA.cfg
Az eszköz újraszinkronizálásakor és a makrók kibővítésekor a 000e08012345 MAC-címmel rendelkező telefon a következő URL-en kéri az eszköz MAC-címét tartalmazó névvel rendelkező profilt:
tftp://prov.telco.com/cisco/Dj6Lmp23Q/000e08012345.cfg
Adja meg a profilhitelesítési típust
A profilhitelesítés lehetővé teszi a telefonfelhasználók számára, hogy újraszinkronizálják a biztosítási profilt a telefonra. Hitelesítési információkra van szükség, amikor a telefon először próbálja újraszinkronizálni és letölteni a konfigurációs fájlt, és HTTP vagy HTTPS 401 hitelesítési hibát kap. Ha engedélyezi ezt a funkciót, a Profilfiók beállí tási képernyője jelenik meg a telefonon a következő helyzetekben:
-
Amikor a HTTP vagy a HTTPs 401 hitelesítési hiba jelentkezik a telefon újraindítása után az első 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 Profilfiók beállí tási képernyője hiányzik vagy figyelmen kívül hagyja, a felhasználó a telefon képernyő menüjén vagy a Setup programbillentyűn keresztül is elérheti a beállí tási képernyőt, amely csak akkor jelenik meg, ha a telefonon egyetlen sor sem regisztrálva van.
Ha letiltja a funkciót, a Profilfiók beállí tási képernyője nem jelenik meg a telefonon.
A Profilszabály mezőben szereplő felhasználónév és jelszó nagyobb prioritással rendelkezik, mint a profilfiók.
-
Ha a Profilszab ály mezőben helyes URL-t ad meg felhasználónév és jelszó nélkül, a telefonnak hitelesítésre vagy összesítésre van szüksége a profil újraszinkronizálásához. A megfelelő profilfiókkal a hitelesítés megy végbe. Helytelen profilfiók esetén a hitelesítés sikertelen.
-
Ha a Profilszab ály mezőben helyes URL-t ad meg helyes felhasználónévvel és jelszóval, a telefon hitelesítésre vagy összesítésre van szüksége 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ésre vagy összesítésre van szüksége 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-címet 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ési típust a telefon adminisztrációs weboldalán adhatja meg.
| 1 |
Nyissa meg a telefon adminisztrációs weboldalát. |
| 2 |
Válassza a |
| 3 |
A Kon figurációs profil szakaszban állítsa be a Profilhitelesítési típus paramétert a profilfiók hitelesítéséhez használandó hitelesítő adatok megadásához. Ezt a paramétert a telefonkonfigurációs XML fájlban (cfg.xml) konfigurálhatja egy karakter lánc megadásával ebben a formátumban:
Opciók:
Alapértelmezett: Alapvető HTTP-hitel |
| 4 |
Kattintson az Összes módosítás küldése elemre |
Kézzel alkalmazzon profilt a telefonra
Töltse le a konfigurációs fájlt a telefonra egy TFTP szerverről
Végezze el ezeket a lépéseket a konfigurációs fájl letöltéséhez a PC-n lévő TFTP-kiszolgálóalkalmazásra.
| 1 |
Csatlakoztassa számítógépét a telefon LAN-portjához. |
| 2 |
Futtasson egy TFTP-kiszolgáló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ő legyen 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:
Példa:
|
Töltse le a konfigurációs fájlt a telefonra a cURL segítségével
Végezze el ezeket a lépéseket a konfiguráció telefonra letöltéséhez a cURL használatával. Ez a parancssori eszköz URL szintaxissal történő adatok továbbítására szolgál. A cURL letöltéséhez látogasson el:
https://curl.haxx.se/download.html
Javasoljuk, hogy ne használja a cURL használatát a konfiguráció telefonon történő közzétételéhez, mert a felhasználónév és a jelszó rögzíthető a cURL használata közben.
| 1 |
Csatlakoztassa számítógépét a telefon LAN-portjához. |
| 2 |
Töltse le a konfigurációs fájlt a telefonra a következő cURL parancs megadásával:
|
Hivatkozások a profilkonfigurációhoz
A telefon XML formátumban fogadja el a konfigurációkat.
Az ebben a szakaszban szereplő példák XML-szintaxissal rendelkező konfigurációs profilokat használnak.
Konfigurációs profilformátumok
A konfigurációs profil meghatározza a telefon paraméterértékeit.
A konfigurációs profil XML-formátum szabványos XML-szerzői eszközöket használ a paraméterek és értékek összeállításához.
Minden telefonnak más funkciókészlete van, és ezért más paraméterkészlete van.
Nyissa meg a profilformátumot
A nyílt formátumú profil XML-szerű szintaxissal rendelkező szövegfájl az elemek hierarchiájában, elemattribútumokkal és értékekkel. Ez a formátum lehetővé teszi a szabványos eszközök használatát a konfigurációs fájl létrehozásához. Az XML-konfigurációs fájl továbbítható a szolgáltató kiszolgálóról a telefonra egy újraszinkronizálási művelet során, bináris objektumként történő összeállítás nélkül.
A telefon elfogadhatja a szabványos eszközök által generált konfigurációs formátumokat. Ez a funkció megkönnyíti a meglévő adatbázisokból konfigurációs profilokat generáló háttérszolgáltató kiszolgáló szoftver fejlesztését.
A konfigurációs profilban szereplő bizalmas információk védelme érdekében a biztosító kiszolgáló továbbítja az XML-konfigurációs fájlt a telefonhoz egy TLS által biztosított csatornán keresztül. Opcionálisan a fájl tömöríthető a gzip deflate 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ú HTTP-tartalom titkosítás AES-128-GCM titkosítással
A konfigurációs fájl tartalmazhatja ezeket az összetevőket:
-
Elemcímkék
-
Attribútumok
-
Paraméterek
-
Formázási funkciók
-
XML megjegyzések
Példa: Nyissa meg a profilformátumot
<flat-profile>
<Resync_On_Reset> Yes </Resync_On_Reset>
<Resync_Periodic> 7200 </Resync_Periodic>
<Profile_Rule> tftp://prov.telco.com:6900/cisco/config/CP_xxxx_MPP.cfg</Profile_Rule>
</flat-profile>
Az <flat-profile>elemcímke tartalmazza az összes paraméterelemet, 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-biztosítá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ímkénevek és a mezők nevei a webes felhasználói felületen hasonlóak, de az XML-elemnév korlátozásai miatt eltérőek. Például aláhúzza (_) az XML konfigurációs fájlban a webes felhasználói felületen lévő szóközök helyett.
-
<flat-profile>A telefon felismeri a megfelelő paraméternevekkel rendelkező elemeket, amelyek a speciális
elemben vannak beágyazva. -
Az elemnevek szögzárójelben vannak ellátva.
-
A legtöbb elemnév hasonló a telefon Web UI mezőnevéhez, a következő módosításokkal:
-
Az elemnevek nem tartalmazhatnak szóközöket vagy speciális karaktereket.
Ha az elem nevét a webmező nevéből szeretné levezetni, helyettesítsen aláhúzást minden szóközt vagy a[,],(,)vagy/speciális karaktereket.Példa: Az <Resync_On_Reset>elem a Resync On Reset mezőt jelöli.
-
Minden elem nevének egyedinek kell lennie. A telefon webes felhasználói felületében ugyanazok a mezők megjelenhetnek több weboldalon, például a Vonal, a Felhasználó és a Bővítmény oldalakon. Az elem nevé
hez csatolja a [n]értéket az oldal lapon megjelenő szám megjelöléséhez.Példa: Az
<Dial_Plan_1_>elem az 1. sor tárcsázási tervét jelöli.
-
-
Minden nyitó elemcímkének megfelelő záróelemcímkével kell rendelkeznie. Például:
<flat-profile> <Resync_On_Reset> Yes </Resync_On_Reset> <Resync_Periodic> 7200 </Resync_Periodic> <Profile_Rule>tftp://prov.telco.com: 6900/cisco/config/CP_xxxx_MPP.cfg </Profile_Rule> </flat-profile> -
Az elemcímkék kis- és nagybetűket érzékenyek.
-
Az üres elemcímkék megengedettek, és úgy fogják értelmezni, hogy az üres értéket konfigurálják. Írja be a nyitóelem címkét megfelelő elemcímke nélkül, és helyezze be egy szóközt és egy előre jelző vágójelet a zárószögtartó elé (>). Ebben a példában a B profilszabály üres:
<Profile_Rule_B /> -
Egy üres elemcímke segítségével megakadályozhatja a felhasználó által megadott értékek felülírását az újraszinkronizálási művelet során. A következő példában a felhasználói gyorshívó beállítások változatlanok:
<flat-profile> <Speed_Dial_2_Name ua="rw"/> <Speed_Dial_2_Number ua="rw"/> <Speed_Dial_3_Name ua="rw"/> <Speed_Dial_3_Number ua="rw"/> <Speed_Dial_4_Name ua="rw"/> <Speed_Dial_4_Number ua="rw"/> <Speed_Dial_5_Name ua="rw"/> <Speed_Dial_5_Number ua="rw"/> <Speed_Dial_6_Name ua="rw"/> <Speed_Dial_6_Number ua="rw"/> <Speed_Dial_7_Name ua="rw"/> <Speed_Dial_7_Number ua="rw"/> <Speed_Dial_8_Name ua="rw"/> <Speed_Dial_8_Number ua="rw"/> <Speed_Dial_9_Name ua="rw"/> <Speed_Dial_9_Number ua="rw"/> </flat-profile> -
Üres értékkel állítsa be a megfelelő paramétert egy üres karakterláncra. Adjon meg egy nyitó és záró elemet anélkül, hogy közöttük nincs érték. A következő példában a GPP_A paraméter üres karakterláncra van beállítva.
<flat-profile> <GPP_A> </GPP_A> </flat-profile> -
A fel nem ismert elemneveket figyelmen kívül hagyják.
Paraméter tulajdonságok
Ezek a tulajdonságok a paraméterekre vonatkoznak:
A profil által nem meghatározott paraméterek változatlanok maradnak a telefonban.
A fel nem ismert paramétereket figyelmen kívül hagyják.
Ha a Megnyitott formátumú profil ugyanazon paramétercímke több előfordulását tartalmazza, akkor az utolsó ilyen előfordulás felülírja a korábbi eseményeket. A paraméterek konfigurációs értékeinek véletlen felülírásának elkerülése érdekében javasoljuk, hogy minden profil adja meg legfeljebb egy paraméter példányát.
Az utolsó feldolgozott profil elsőbbséget élvez. Ha több profil adja meg ugyanazt a konfigurációs paramétert, akkor az utóbbi profil értéke elsőbbséget élvez.
Karakterlánc formátumok
Ezek a tulajdonságok vonatkoznak a karakterláncok formázására:
A megjegyzések szabványos XML szintaxissal engedélyezettek.
<!-- My comment is typed here -->A vezető és a hátsó fehér szóköz olvashatóság érdekében megengedett, de eltávolításra kerül a paraméter értékéből.
Az értéken belüli új sorok szóközökké konvertálódnak.
Az űrlap XML fejléce
<? ? > megengedett, de a telefon figyelmen kívül hagyja.Speciális karakterek megadásához használja az alapvető XML-karakter meneküléseket, amint azt az alábbi táblázat mutatja.
Különleges karakter
XML menekülési sorozat
& (ampersand)
&
< (kevesebb, mint)
<
> (nagyobb, mint)
>
'(aposztróf)
”
” (kettős idézet)
„
A következő példában a tárcsázási alapszabályban megkövetelt nagyobb, mint kisebb szimbólumokat jelölik meg a karaktereket. Ez a példa olyan információs gyorsvonal-tárcsázási tervet határoz meg, amely a <Dial_Plan_1_>paramétert (S0 <:18005551212>) értékkel állítja be.
<flat-profile> <Dial_Plan_1_> (S0 <:18005551212>) </Dial_Plan_1_> </flat-profile>A numerikus karakterszögeket decimális és hexadecimális értékekkel (s.a.
(és.) lefordítják.A telefon firmware csak az ASCII karaktereket támogatja.
Nyissa meg a profiltömörítést
A támogatott tömörítési módszer a gzip deflate algoritmus (RFC1951). A gzip segédprogram és az ugyanazt az algoritmust megvalósító tömörítési könyvtár (zlib) elérhető az internetes oldalakon.
A tömörítés azonosításához a telefon azt várja, hogy a tömörített fájl tartalmazzon egy gzip-kompatibilis fejlécet. A gzip segédprogram meghívása az eredeti Open profilon generálja a fejlécet. A telefon megvizsgálja a letöltött fájl fejlécét a fájlformátum meghatározásához.
Ha például a profile.xml érvényes profil, akkor a profile.xml. gz fájl is elfogadásra kerül. Az alábbi parancsok bármelyike generálhatja ezt a profiltípust:
-
>gzip profile.xmlAz eredeti fájlt tömörített fájllal helyettesíti.
-
>cat profile.xml | gzip > profile.xml.gzAz eredeti fájlt a helyén hagyja, és új tömörített fájlt hoz létre.
Nyissa meg a profiltitkosítást
A szimmetrikus kulcs-titkosítás felhaszná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. A tömörítést, ha alkalmazzák, a titkosítás előtt kell alkalmazni.
A rendelkezésre bocsátó kiszolgáló HTTPS-t használ a telefon kezdeti rendelkezésre bocsátásának kezelésére a telepítés után. A konfigurációs profilok offline előzetes titkosítása lehetővé teszi a HTTP használatát a profilok későbbi újraszinkronizálásához. Ez csökkenti a HTTPS-kiszolgáló terhelését nagyszabású telepítések esetén.
A telefon két titkosítási módszert támogat a konfigurációs fájlok számára:
-
AES-256-CBC titkosítás
-
RFC 8188 alapú HTTP-tartalom titkosítása AES-128-GCM titkosítással
A kulcsot vagy a bemeneti kulcsokat (IKM) előzetesen be kell helyezni az egységbe egy korábbi időpontban. A titkos kulcs Bootstrap biztonságosan megvalósítható a HTTPS használatával.
A konfigurációs fájl neve nem igényel meghatározott formátumot, de az 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 az AES-256-CBC titkosítást a konfigurációs fájlokhoz.
A különböző internetes oldalakról letölthető OpenSSL titkosítási eszköz képes végrehajtani a titkosítást. A 256 bites AES titkosítás támogatásához szükség lehet az eszköz újraö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ében a profil azt várja, hogy a fájl ugyanolyan formátumú legyen, mint amelyet a következő parancs generál:
# example encryption key = SecretPhrase1234
openssl enc –e –aes-256-cbc –k SecretPhrase1234 –in profile.xml –out profile.cfg
# analogous invocation for a compressed xml file
openssl enc –e –aes-256-cbc –k SecretPhrase1234 –in profile.xml.gz –out profile.cfg
A titkos kulcsot kisbetűs -k előzi meg, amely bármilyen egyszerű szöveges kifejezés lehet, és amelyet véletlenszerű 64 bites só létrehozására használnak. A -k argumentum által megadott titkokkal a titkosítási eszköz véletlenszerű 128 bites kezdeti vektort és a tényleges 256 bites titkosítási kulcsot hoz létre.
Ha a titkosítás ezt a formáját egy konfigurációs profilon használják, 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ő, kifejezett URL használatával:
[--key “SecretPhrase1234”] http://prov.telco.com/path/profile.cfg
Ezt az értéket a Profile_Rule egyik paraméter használatával programozzák.
Számos rendelkezésre bocsátási paraméter belsőleg makrobővítésen megy keresztül az értékelés előtt. Ez az előértékelési lépés nagyobb rugalmasságot biztosít a telefon újraszinkronizálási és frissítési tevékenységeinek vezérlésében.
Ezek a paramétercsoportok az értékelés előtt makrobővítésen mennek keresztül:
-
Resync_Trigger_*
-
Profil_szabályzat*
-
Log_XXX_MSG
-
Frissítése_szabály
Bizonyos körülmények között egyes általános célú paraméterek (GPP_*) szintén makróbővítésen mennek keresztül, amint azt az alábbi Opcionális újraszinkronizálási argumentumok szakasz kifejezetten jelzi.
A makróbővítés során a megnevezett változók tartalma helyettesíti a $NAME és a $ (NAME) űrlap 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 biztosítási állapotértékeket. A teljes listát a Makróbővítési változók című témakörökben talál a Paramé terek biztosítása területen.
A következő példában a $ (MAU) kifejezés a 000E08012345 MAC-cím beillesztésére szolgál.
A rendszergazda a következőt ír ja be: $ (MAU) config.cfg
A 000E08012345 MAC-címmel rendelkező eszköz makróbővítése a következő: 000E08012345config.cfg
Ha egy makrónév nem ismer fel, az nem bővíthető. Például a STRANGE nevet nem ismerik fel érvényes makrónévként, míg a MAU érvényes makrónévként ismerik fel.
Az adminisztrátor ezt írja be: $strange $mau.cfg
A 000E08012345 MAC-című eszköz makróbővítése a következő: $Strange000E08012345.cfg
A makróbővítés nem alkalmazható rekurzív módon. Például a $$MAU” $MAU-ra bővül (a $$ kibővül), és nem eredményezi a MAC-címet.
A speciális célú paraméterek tartalma, a GPP_SA-tól a GPP_SD között a $SA-tól $SD makrókifejezésekhez kerül leképezésre. Ezeket a paramétereket csak a --key, -- uid és -- pwd opciók argumentumként kiterjesztik az újraszinkronizáló URL-ben.
A feltételes kifejezések újraszinkronizálási eseményeket válthatnak ki, és alternatív URL-ek közül választhatnak az újraszinkronizálási és frissítési műveletek
A feltételes kifejezések összehasonlítások listájából állnak, amelyeket az és az operátor választ el. Minden összehasonlításnak teljesülnie kell ahhoz, hogy a feltétel igaz legyen.
Minden összehasonlítás a következő három típusú literál egyikére vonatkozhat:
-
Egész értékek
-
Szoftver vagy hardver verziószámok
-
Kettős idézetű karakterláncok
Verziószámok
A Cisco Video Phone 8875 szoftververziója ezt a formátumot használja (ahol a BN a Build Number):
PHONEOS yyyy. 1-0-1-0001 - BN
ahol a yyyy a telefon modelljét vagy telefonsorozatát jelzi; 1 a fő verzió; 0 a kisebb verzió; 1-0001 a mikro verzió; és BN a build száma.
Az összehasonlító karakterláncnak ugyanazt a formátumot kell használnia. Ellenkező esetben formátum elemzési hiba lép fel.
A szoftververzió összehasonlításakor a fő verziót, a kisebb verziót és a mikroverziót sorrendben hasonlítják össze, és a bal oldali számjegyek elsőbbséget élveznek az utóbbiakkal szemben. Ha a verziószámok azonosak, összehasonlítjuk az összeállítási számot.
Példák az érvényes verziószámra
PHONEOS-8875.1-0-1-0001-19
Összehasonlítás
Az idézett karakterláncok összehasonlíthatók egyenlőség vagy egyenlőtlenség szempontjából. Az egész számok és a verziószámok aritmetikusan is összehasonlíthatók. Az összehasonlító operátorok szimbólumokként vagy rövidítésekként fejezhetők ki. A betűszavak kényelmesek a feltétel kifejezésére Nyílt formátumú profilban.
|
Üzemeltető |
Alternatív szintaxis |
Leírás |
Teljes és verzióoperandokra alkalmazható |
Idézett karakterláncoperandokra alkalmazható |
|---|---|---|---|---|
|
= |
egyenlő |
egyenlő |
Igen |
Igen |
|
!= |
ne |
nem egyenlő |
Igen |
Igen |
|
< |
lt |
kevesebb, mint |
Igen |
Nem |
|
<= |
le |
kevesebb vagy egyenlő |
Igen |
Nem |
|
> |
gt |
Nagyobb, mint |
Igen |
Nem |
|
>= |
ge |
nagyobb vagy egyenlő |
Igen |
Nem |
|
AND |
|
és |
Igen |
Igen |
Fontos, hogy a makróváltozókat kettős idézőjelekbe helyezzük, ahol karakterlánc szó elvárható. Ne tegye ezt ott, ahol szám vagy verziószám várható.
Ha a Profile_Rule* és Upgrade_Rule paraméterek kontextusában használják, a feltételes kifejezéseket a „(expr)?” szintaxisba kell mellékelni mint ebben a frissítési szabálypéldában. Ne felejtse el helyet tesíteni a BN-t a firmware betöltésének összeállítási számával, amelyre frissíteni szeretne.
($SWVER ne PHONEOS-8875.1-0-1-0001-19)? http://ps.tell.com/sw/PHONEOS-8875.1-0-1-0001-BN.loads
Ne használja az előző szintaxist zárójelekkel a Resync_Trigger_* paraméterek konfigurálásához.
A Szabványos URL-szintaxissal megadhatja, hogyan lehet letölteni a konfigurációs fájlokat és a firmware-betöltéseket a Profile_Rule* és az Upgrade_Rule paraméterekben. A szintaxis a következő:
[séma://] [szerver [:port]] fájlnév
Ahol a rendszer az alábbi értékek egyike:
-
tftp
-
Http
-
https
Ha a sé mát ki hagyják, akkor feltételezzük a tftp-t. A kiszolgáló lehet DNS-felismert hostnév vagy numerikus IP-cím. A port a célállomás UDP vagy TCP portszáma. A fájlkönyvtárnak a gyökérkönyvtárral kell kezdődnie (/); abszolút elérési útvonalnak kell lennie.
Ha a kiszolgál ó hiányzik, akkor a DHCP-n keresztül megadott tftp kiszolgálót használjuk (66. opció).
A frissítési szabályok esetén meg kell adni a kiszolgálót.
Ha hiányzik a port, akkor a megadott séma szabványos portját használják. A Tftp UDP portot használja a 69-es, a http a 80-as TCP portot, a https a 443-as TCP portot használ.
Egy fájlűrlapnak jelen kell lennie. Nem feltétlenül kell statikus fájlra hivatkoznia, de jelezheti a CGI-n keresztül kapott dinamikus tartalmat.
A makróbővítés az URL-eken belül érvényes. Az alábbiakban példákat mutatunk az é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
A DHCP 66. opció használatakor az üres szintaxist nem támogatják a frissítési szabályok. Kizárólag a Profile Szabályzatban* vonatkozik.
RFC 8188 alapú HTTP-tartalom titkosítás
A telefon támogatja az RFC 8188 alapú HTTP-tartalom titkosítását AES-128-GCM titkosítással a konfigurációs fájlokhoz. Ezzel a titkosítási módszerrel bármely entitás elolvashatja a HTTP üzenet fejlécét. Azonban csak azok az entitások tudják olvasni a hasznos teherbírást, amelyek ismerik a bemeneti kulcsanyagot (IKM). Ha a telefon IKM-vel van ellátva, a telefon és a biztosító kiszolgáló biztonságosan cserélheti a konfigurációs fájlokat, miközben lehetővé teszi harmadik féltől származó hálózati elemek számára, hogy az üzenetfejléceket elemzési és felügyeleti célokra használják.
Az IKM_HTTP_Encrypt_Content XML konfigurációs paraméter tartja az IKM-et a telefonon. Biztonsági okokból ez a paraméter nem érhető el a telefon adminisztrációs weboldalán. A telefon konfigurációs fájljában sem látható, amelyhez a telefon IP-címéről vagy a telefon konfigurációs jelentéseiből érhető el, amelyet a biztosító kiszolgálónak küldtek.
Ha az RFC 8188 alapú titkosítást szeretné használni, ellenőrizze a következőket:
-
Adja meg a telefont az IKM-vel úgy, hogy megadja az IKM-et az
IKM_HTTP_Encrypt_ContentXML paraméterrel a konfigurációs fájlban, amelyet a biztosító kiszolgálóról a telefonra küldött konfigurációs fájlban. -
Ha ezt a titkosítást a biztosító kiszolgálóról a telefonra küldött konfigurációs fájlokra alkalmazza, győződjön meg arról, hogy a konfigurációs fájl tartalom kódoló HTT P-fejlécében aes128gcm legyen.
Ennek a fejlécnek hiányában az AES-256-CBC módszer elsőbbséget kap. A telefon akkor alkalmazza az AES-256-CBC dekódolást, ha egy AES-256-CBC kulcs van jelen egy profilszabályban, függetlenül az IKM-től.
-
Ha azt szeretné, hogy a telefon alkalmazza ezt a titkosítást azokra a konfigurációs jelentésekre, amelyeket a szolgáltató kiszolgálónak küld, győződjön meg arról, hogy nincs-e AES-256-CBC kulcs megadva a jelentési szabályban.
Opcionális újraszinkronizáló argumentumok
Az opcionális argumentumok, a kul cs, az uid és a pwd megelőzhetnek a Profile_Rule* paraméterekben megadott URL-eket, amelyeket együttesen négyzet alakú zárójellel zárnak be.
A
Maga a kulcs karakterláncként van megadva a --key opció azt mondja a telefonnak, hogy a konfigurációs fájl, amelyet a biztosító kiszolgálótól kap, AES-256-CBC titkosítással van titkosítva, kivéve, ha a fájl tartalomkódolási fejléce aes128gcm titkosítást jelez.--key kifejezést követő. A kulcs opcionálisan dupla idézőjelekkel („) zárható. A telefon a kulcsot használja a konfigurációs fájl visszafejtéséhez.
Használati példák
[--key VerySecretValue]
[--key “my secret phrase”]
[--key a37d2fb9055c1d04883a0745eb0917a4]
A zárójellel ellátott opcionális argumentumok makróval bővítve vannak. A speciális célú paraméterek, a GPP_SA-tól a GPP_SD-ig terjedő makróváltozókra, $SA-tól $SD-ig terjedő makróváltozókra bővülnek, csak akkor, ha azokat kulcsopció-argumentumként használják. Lásd ezeket a példákat:
[--key $SC]
[--key “$SD”]
Nyitott formátumú profilokban a --key argumentumának meg kell egyeznie az openssl -k opció argumentumával.
Az uid és a pwd beállítások segítségével megadhatja azt a felhasználói azonosítót és jelszót, amelyet a HTTP Basic és Digest hitelesítési kihívásokra válaszul küldünk, amikor a megadott URL-t kérjük. A zárójellel ellátott opcionális argumentumok makróval bővítve vannak. A speciális célú paraméterek, a GPP_SA-tól a GPP_SD-ig terjedő makróváltozókra, $SA-tól $SD-ig terjedő makróváltozókra bővülnek, csak akkor, ha azokat kulcsopció-argumentumként használják. Lásd ezeket a példákat:
GPP_SA = MyUserID
GPP_SB = MySecretPassword
[--uid $SA --pwd $SB] https://provisioning_server_url/path_to_your_config/your_config.xml
Ezután a következőkre bővülne:
[--uid myUserID --pwdMySecretPassword] https://provisioning_server_url/path_to_your_config/your_config.xml
Adattípusok
Ezeket az adattípusokat a konfigurációs profil paraméterekkel használják:
-
{a, b, c,...} - A választás a, b, c,... között
-
Bool — „igen” vagy „nem” logikai értéke.
-
CADscript - miniszkriptum, amely meghatározza a jel ritmusparamétereit. Legfeljebb 127 karakter.
Szintaxis: S 1 [; S 2], ahol:
-
S i =D i (on i,1 /off i,1 [, i,2 /off i, 2 [, i, 3 /off i,3 [, i, 4 /off i, 4 [, i,5 /off i ,5 [, on i,6 /off i, 6]]]), és szakasz néven ismert.
-
az i, j és ki i, j kapcsolása egy szeg mens be- és kikapcsolási időtartama másodpercekben. i = 1 vagy 2, és j = 1 és 6 között.
-
D i a szakasz teljes időtartama másodpercekben.
Minden időtartam legfeljebb három tizedesjegyű lehet, hogy 1 ms felbontást biztosítson. Az „*” helyettesítő karakter végtelen időtartamot jelent. A szakaszon belüli szegmenseket sorrendben játsszuk le, és a teljes időtartam lejátszásáig ismételjük meg.
1. példa:
60(2/4) Number of Cadence Sections = 1 Cadence Section 1: Section Length = 60 s Number of Segments = 1 Segment 1: On=2s, Off=4s Total Ring Length = 60s2. példa - Megkülönböztető gyűrű (rövid, rövid, rövid, hosszú):
60(.2/.2,.2/.2,.2/.2,1/4) Number of Cadence Sections = 1 Cadence Section 1: Section Length = 60s Number of Segments = 4 Segment 1: On=0.2s, Off=0.2s Segment 2: On=0.2s, Off=0.2s Segment 3: On=0.2s, Off=0.2s Segment 4: On=1.0s, Off=4.0s Total Ring Length = 60s -
-
DialPlanScript — Script-szintaxis, amely az 1. és a 2. sor tárcsázási terveinek megadására szolgál.
-
Float <n>— lebegőpontos érték, legfeljebb n tizedesjegyű.
-
FQDN - Teljesen minősített domain né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 - miniszkrét, amely meghatározza a hang frekvencia- és szintparamétereit. Legfeljebb 127 karaktert tartalmaz.
Szintaxis: F 1 @L 1 [, F 2 @L 2 [, F 3 @L 3 [, F 4 @L 4 [, F 5 @L 5 [, F 6 @L 6]]]]], ahol:
-
Az F 1 —F 6 frekvencia Hz-ben (csak aláírás nélküli egész számok).
-
Az L 1 —L 6 megfelelő szintek dBm-ben (legfeljebb egy tizedesjegygel).
Fehér szóközök a vessző előtt és után megengedettek, de nem ajánlottak.
1. példa: Hívásváróhang:
440@-10 Number of Frequencies = 1 Frequency 1 = 440 Hz at –10 dBm2. példa - Tárcsázási hang:
350@-19,440@-19 Number of Frequencies = 2 Frequency 1 = 350 Hz at –19 dBm Frequency 2 = 440 Hz at –19 dBm -
-
IP— Érvényes IPv4 cím 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 azonosító, ahogyan az URL-ben jelenik meg; legfeljebb 63 karakter.
-
Telefon - 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 - telefonszám-sablon. Minden sablon tartalmazhat egy vagy több mintát, amelyeket vessző (,) választ el. Az egyes minták elején lévő fehér helyet figyelmen kívül hagyjuk. „?” és az „*” helyettesítő karaktereket jelöli. Szó szerinti ábrázoláshoz használja a %xx értéket. Például %2a jelöli: *. A sablon legfeljebb 39 karaktert tartalmazhat. Példák: „1408*, 1510*”, „1408123???? , 555? 1.”.
-
Port — TCP/UDP Port száma (0-65535). Decimális vagy hex formátumban adható meg.
-
ProvisioningRulesyntax — parancsszintaxis, amely a konfiguráció újraszinkronizálására és a firmware-frissítési szabályok meghatározására szolgál.
-
PWRLevel — dBm-ben kifejezett teljesítményszint egy tizedesjegygel, például —13,5 vagy 1,5 (dBm).
-
RSCTMPLT — a SIP válasz állapotkódjának sablonja, például „404, 5*”, „61?” , „407, 408, 487, 481”. Legfeljebb 39 karaktert tartalmazhat.
-
Sig <n>— Aláírt n-bites érték. Decimális vagy hex formátumban adható meg. A „-” jelnek meg kell előznie a negatív értékeket. A pozitív értékek előtti + jel nem kötelező.
-
Csillagkódok — Aktiválási kód egy kiegészítő szolgáltatáshoz, például *69. A kód legfeljebb 7 karaktert tartalmazhat.
-
Str <n>—Általános karakterlánc, legfeljebb n nem fenntartott karakterrel.
-
Idő <n>— Az idő időtartama másodpercben, legfeljebb n tizedesjegygel. Az extra megadott tizedesjegyeket figyelmen kívül hagyjuk.
-
ToneScript — miniszkriptum, amely meghatározza a hívás előrehaladási hangjának frekvenciáját, szintjét és ritmusparamétereit. A szkript legfeljebb 127 karaktert tartalmazhat.
Szintaxis: FreqScript; Z 1 [; Z 2].
A Z 1 szakasz hasonló a CADScript S 1 szakaszához, azzal a különbséggel, hogy minden be- és kikapcsolási szegmenst egy frekvenciakomponensek paramétere követ: Z 1 = D 1 (i, 1 /off i,1 /f i,1 [, i, 2 /off i,2 /f i, 2 [, on i, 3 /off i,4 f i, 4 [, i ,5 /kikapcsolás i,5 /f i,5 [, i, 6 /kikapcsolás i, 6/f i,6]]]]]) ahol:
-
f i, j = n 1 [+n 2] +n 3 [+n 4 [+n 5 [+n 6]]]].
-
Az 1 < n k < 6 meghatározza a FreqScript azon frekvenciakomponenseit, amelyeket az adott szegmensben használnak.
Ha egy szegmensben egynél több frekvenciakomponenst használnak, akkor az összetevőket összegezzük.
1. példa: Tárcsázási hang:
350@-19,440@-19;10(*/0/1+2) Number of Frequencies = 2 Frequency 1 = 350 Hz at –19 dBm Frequency 2 = 440 Hz at –19 dBm Number of Cadence Sections = 1 Cadence Section 1: Section Length = 10 s Number of Segments = 1 Segment 1: On=forever, with Frequencies 1 and 2 Total Tone Length = 10s2. példa - Dadogási hang:
350@-19,440@-19;2(.1/.1/1+2);10(*/0/1+2) Number of Frequencies = 2 Frequency 1 = 350 Hz at –19 dBm Frequency 2 = 440 Hz at –19 dBm Number of Cadence Sections = 2 Cadence Section 1: Section Length = 2s Number of Segments = 1 Segment 1: On=0.1s, Off=0.1s with Frequencies 1 and 2 Cadence Section 2: Section Length = 10s Number of Segments = 1 Segment 1: On=forever, with Frequencies 1 and 2 Total Tone Length = 12s -
-
Uns <n>— Aláírás nélküli n-bites érték, ahol n = 8, 16 vagy 32. Decimális vagy hex formátumban adható meg, például 12 vagy 0x18, mindaddig, amíg az érték n bitbe illeszkedik.
Tartsa figyelembe ezeket:
- <Par Name>egy konfigurációs paraméter nevét jelöli. Egy profilban a megfelelő címke úgy alakul ki, hogy a szóköz helyét „_” aláhúzással helyettesíti, például a Par _Name.
- Az üres alapértelmezett érték mező egy üres karakterláncot jelent < „” >.
- A telefon továbbra is használja az utoljára konfigurált értékeket azokhoz a címkékhez, amelyek nem jelennek meg egy adott profilban.
- A sablonokat a megadott sorrendben hasonlítják össze. Az első, nem a legközelebbi mér kőzés kerül kiválasztásra. A paraméter nevének pontosan meg kell egyeznie.
- Ha egy paraméter egynél több definíciója van megadva egy profilban, akkor a fájl utolsó ilyen definíciója az, amely a telefonban lép hatályba.
- Az üres paraméterértékkel rendelkező paraméterspecifikáció visszaállítja a paramétert az alapértelmezett értékére. Egy üres karakterlánc megadásához használja a paraméterértékként az üres „” karakterláncot.