- Kezdőlap
- /
- Cikk
Telefonok profilbeállításainak konfigurálása
Ebben a cikkbenEz a súgócikk a Cisco BroadWorks szolgáltatásban regisztrált Cisco telefonokkal foglalkozik. Az ezen a lapon található információk közé tartozik a profil újraszinkronizálása, a profil manuális alkalmazása és a konfigurációs szintaxis.
A telefon konfigurálása a profilok szinkronizálásához
A telefon több hálózati protokollt is támogat a konfigurációs profilok lekéréséhez. A legalapabb profil átviteli protokoll a TFTP (RFC1350). A TFTP-t leggyakrabban a magán LAN hálózatokban használt hálózati eszközök szolgáltatására használatos. Bár nem javasolják távoli végpontok telepítésére az interneten, a TFTP kis szervezetknél, házon belüli előzetes szolgáltatáshoz, fejlesztéshez és teszteléshez kényelmes megoldás lehet. Az alábbi eljárásban a profil azután lesz módosítva, hogy a fájlt letöltötték egy TFTP szerverről.
| 1 |
LAN-környezetben csatlakoztassa a számítógépet és a telefont egy hubhoz, switch-hez vagy kis routerhez. |
| 2 |
A számítógépen telepítsen és aktiváljon egy TFTP-szervert. |
| 3 |
Egy szövegszerkesztővel hozzon létre egy konfigurációs profilt. Ha később ellenőrizni szeretné, hogy a profil a telefonra került-e, akkor néhány értéket jelölésként állíthat be. Állítsa például a GPP_A értékét 12345678-ra, ahogyan az a következő példában látható:
|
| 4 |
Mentse az XML konfigurációs fájlt a TFTP-szerver gyökérkönyvtárába. Ellenőrizheti, hogy a TFTP-szerver megfelelően van-e konfigurálva: kérje le a konfigurációs profilfájlt a telefontól eltérő TFTP-ügyfél segítségével. Lehetőleg olyan TFTP klienst használjon, ami nem a szolgáltató szerver kiszolgálón fut. |
| 5 |
Nyissa meg a számítógép webböngészőjében az adminisztrációs weboldalt. Tegyük fel például, hogy a telefon IP-címe 192.168.1.100, és nyissa meg a következő URL-t a webböngészőben: |
| 6 |
Válassza ki a lapot, és ellenőrizze a GPP_A-GPP_P általános célú paraméterek értékeit. Ezeknek üresnek kell lenniük. |
| 7 |
Szinkronizálja újra a teszttelefont a létrehozott konfigurációs profillal az újraszinkronizálási URL webböngészőben történő megnyitásával. Példa: Ha a TFTP szerver IP címe 192.168.1.200, a parancsnak hasonlítania kell az alábbi példára: Amikor a telefon megkapja ezt a parancsot, a 192.168.1.100 címen lévő készülék lekéri a |
| 8 |
Ellenőrizze, hogy a paraméter helyesen lett-e frissítve. Frissítse az adminisztrációs weboldalt, és lépjen a . A GPP_A paraméternek mostantól az 12345678 értéket kell tartalmaznia. |
| 1 |
A telefon MAC címének lekérdezése a termék címkéjéről. (A MAC-cím a szám, számok és kisbetűs hexadecimális számjegyek használatával, például 000e08aabbcc. |
| 2 |
Nevezze át a konfigurációs fájlt Példa:
|
| 3 |
Helyezze át az új fájlt a TFTP-szerver virtuális gyökérkönyvtárába. |
| 4 |
Lépjen be a telefon adminisztrációs weboldalára. |
| 5 |
Válassza ki a lehetőséget. |
| 6 |
Adja meg a profilfájl elérési útvonalát a Profilszabály mezőben. Példa: Tegyük fel, hogy a TFTP-szerver IP-címe 192.168.1.200, a profilfájl neve pedig |
| 7 |
Kattintson az Összes változás elküldése lehetőségre. Ez azonnali újraindulást és szinkronizálást okoz. A következő újraszinkronizáláskor a telefon a $MA makró kiterjesztés kibontásával kéri le az új fájlt a MAC címére. |
| 1 |
Telepítsen egy HTTP-szervert a helyi számítógépre vagy más elérhető állomáson. A nyílt forráskódú Apache szerver letölthető az internetről. |
| 2 |
Töltse fel a konfigurációs profilfájlt a telepített szerver virtuális gyökérkönyvtárába. |
| 3 |
A szerver megfelelő telepítésének és a profilfájlhoz való hozzáférésnek az ellenőrzéséhez nyissa meg a profilt egy webböngészővel. |
| 4 |
Módosítsa a teszt telefon Profile_Rule szabályát, hogy a HTTP szerverre mutasson a TFTP szerver helyett, azaz rendszeres időközönként töltse le a profilt. Ha például a HTTP-szerver a 192.168.1.300 címen található, és a profil fájlneve basic.txt, adja meg a következő értéket: |
| 5 |
Kattintson az Összes változás elküldése lehetőségre. Ez azonnali újraindulást és szinkronizálást okoz. |
| 6 |
Figyeljük meg a telefon által küldött syslog üzeneteket. A rendszeres időközönként indított újraszinkronizálás most a HTTP szerverről szerzi be a profilt. |
| 7 |
A HTTP szerver naplókban figyeljük meg, hogy a teszt telefont azonosító információ hogyan jelenik meg a felhasználó ügynökök naplójában. Ez az információ tartalmazza a gyártó, terméknév, aktuális förmver verzió és termék sorozatszám adatokat. |
Egy készülék rendszeresen tud újraszinkronizálni a szolgáltató szerverre, biztosítandó, hogy a szerveren végzett profil módosítások a végpont eszközön is érvénybe léptek (ahelyett, hogy egy explicit újraszinkronizálási kérést küldene a végpontra).
Ahhoz, hogy a telefon rendszeres időközönként újraszinkronizáljon a szerveren egy konfigurációs profil URL-t kell meghatározni a Profile_Rule paraméterrel, és egy újraszinkronizálási időtartamot kell meghatározni a Resync_Periodic paraméterrel.
| 1 |
Lépjen be a telefon adminisztrációs weboldalára. |
| 2 |
Válassza ki a lehetőséget. |
| 3 |
Határozza meg a Profile_Rule paramétert. Ez a példa azt feltételezi, hogy a TFTP szerver IP címe 192.168.1.200. |
| 4 |
Az Újraszinkronizálás időtartam mezőben adjon meg egy kis értéket a teszteléshez, például 30 másodpercet. |
| 5 |
Kattintson az Összes módosítás benyújtása elemre. Az új paraméter beállításokkal a telefon percenként kétszer szinkronizál újra az URL által meghatározott konfigurációs fájlra. |
| 6 |
Figyelje meg a syslog-nyomkövetés üzeneteit. |
| 7 |
Ellenőrizze, hogy az Újraszinkronizálás visszaállításkor mező beállítása Igen. |
| 8 |
Végezzen egy teljes kikapcsolás és bekapcsolás ciklust a telefonon, hogy kikényszerítse az újraszinkronizálást a szolgáltató szerverrel. Ha az újraszinkronizálási művelet sikertelen valamilyen oknál fogva, például a szerver nem válaszol, a készülék várakozik (az Újraszinkronizálás hiba ismételt próbálkozás késleltetés elemben meghatározott másodpercen át), mielőtt ismét megkísérli az újraszinkronizálást. Ha az Újraszinkronizálás hiba ismételt próbálkozás késleltetés nulla, a telefon nem próbál meg újraszinkronizálni egy sikertelen kísérlet után. |
| 9 |
(Opcionális) Állítsa be az Újraszinkronizálás hiba ismételt próbálkozás késleltetés mező értékét egy kis számra, például 30. |
| 10 |
Kapcsolja ki a TFTP szervert, és nézze meg az eredményeket a syslog kimenetben. |
A következő táblázat a Konfigurációs profil szakasz alatt található profil-újraszinkronizálási paraméterek funkcióját és használatát határozza meg a fül alatt a telefon weboldalán. Meghatározza továbbá a telefon konfigurációs fájljába (cfg.xml) a paraméter konfigurálásához XML-kóddal hozzáadott karakterlánc szintaxisát.
A telefonokat a Cisco XML-funkciók segítségével is elláthatja.
XML-objektumot küldhet a telefonhoz SIP Notify csomaggal vagy HTTP Post segítségével a telefon CGI-felületére: http://PhoneIPAddress/CGI/Execute.
A CP-xxxx-3PCC kiterjeszti a Cisco XML jellemzőt a szolgáltatás támogatására egy XML objektumon keresztül:
<CP-xxxx-3PCCExecute> <ExecuteItem URL=Resync:[profile-rule]/></CP-xxxx-3PCCExecute>Miután a telefon fogadja az XML objektumot, letölti a szolgáltatás fájlt a [profile-rule] szabályból. Ez a szabály az XML szolgáltatás alkalmazás fejlesztésének egyszerűsítésére használ makrókat.
A szerveren több profilt tartalmazó alkönyvtárakkal kényelmesen lehet kezelni akár nagyszámú telepített készüléket is. A profil URL tartalmazhat:
-
Szolgáltató szerver nevet vagy egy explicit IP címet. Ha a profil a szolgáltató szervert név szerint azonosítja, a telefon egy DNS keresést végez a név feloldására.
-
Egy nem standard szerver port, amelyet az URL-ben határoznak meg a standard
:portszintaxissal, amelyet a szerver neve követ. -
A szerver virtuális gyökérkönyvtárának alkönyvtára, ahol a profil el van tárolva, amelyet egy makró kiterjesztéssel kezelt standard URL határoz meg.
Például a következő Profile_Rule a profil fájlt kéri le ($PN.cfg) a /cisco/config szerver alkönyvtárban a TFTP szerveren, amely a prov.telco.com kiszolgálón fut, és a 6900-as porton ellenőrzi a csatlakozást:
<Profile_Rule>
tftp://prov.telco.com:6900/cisco/config/$PN.cfg
</Profile_Rule>Minden egyes telefon profilja azonosítható egy általános célú paraméterben, ahol az érték makró kiterjesztéssel egy általános profilszabályra hivatkozik.
Például tegyük fel, hogy a GPP_B értéke Dj6Lmp23Q.
A Profile_Rule értéke:
tftp://prov.telco.com/cisco/$B/$MA.cfgAmikor a készülék újraszinkronizál és a makrók kiterjesztése megtörténik, a 000e08012345 MAC címmel rendelkező telefon lekéri a profilt azzal a névvel, amely tartalmazza a készülék MAC címét az alábbi URL-en:
tftp://prov.telco.com/cisco/Dj6Lmp23Q/000e08012345.cfgA profilhitelesítés lehetővé teszi a telefonfelhasználók számára, hogy a telefonra újraszinkronizálják az ellátási profilt. A hitelesítési információkra akkor van szükség, amikor a telefon először próbál újraszinkronizálni és letölteni a konfigurációs fájlt, és HTTP vagy HTTPS 401 hitelesítési hibaüzenetet kap. Ha engedélyezi ezt a funkciót, a Profil fiókbeállítása képernyő jelenik meg a telefonon a következő helyzetekben:
-
Ha a telefon újraindítása után a HTTP vagy HTTPs 401 hitelesítési hiba lép fel az első alkalommal történő rendelkezésre bocsátás során
-
Ha a profilfiók felhasználóneve és jelszava üres
-
Ha nincs felhasználónév és jelszó a profilszabályban
Ha a Profil fiókbeállítása képernyő kimarad vagy figyelmen kívül hagyja, a felhasználó a telefon képernyőmenüjén keresztül vagy a Beállítás lágygombon keresztül is elérheti a beállítási képernyőt, amely csak akkor jelenik meg, ha a telefonon nincs vonal regisztrálva.
Ha letiltja a funkciót, a Profil fiókbeállítása képernyő nem jelenik meg a telefonon.
A Profilszabály mezőben megadott felhasználónév és jelszó magasabb prioritású, mint a profilfiók.
-
Ha a Profilszabály mezőben felhasználónév és jelszó nélkül ad meg egy helyes URL-t, a telefon hitelesítést vagy digestet kér a profil újraszinkronizálásához. A megfelelő profilfiókkal a hitelesítés sikerül. Helytelen profilfiók esetén a hitelesítés sikertelen.
-
Ha a Profilszabály mezőben helyes URL-t ad meg a helyes felhasználónévvel és jelszóval, a telefon hitelesítést vagy digestet kér a profil újraszinkronizálásához. A profilfiókot nem használják a telefon újraszinkronizálásához. A bejelentkezés sikeres.
-
Ha a Profilszabály mezőben helyes URL-t ad meg helytelen felhasználónévvel és jelszóval, a telefon hitelesítést vagy kivonatot kér a profil újraszinkronizálásához. A profilfiókot nem használják a telefon újraszinkronizálásához. A bejelentkezés mindig sikertelen.
-
Ha helytelen URL-t ad meg a Profilszabály mezőben, a bejelentkezés mindig sikertelen.
A telefon konfigurációs fájljában található paramétereket XML (cfg.xml) kóddal is konfigurálhatja.
A profilhitelesítés típusát a telefon adminisztrációs weboldalán adhatja meg.
| 1 |
Lépjen be a telefon adminisztrációs weboldalára. |
| 2 |
Válassza ki a lehetőséget. |
| 3 |
A Konfigurációs profil szakaszban állítsa be a Profilhitelesítés típusa paramétert a profilfiók hitelesítéséhez használandó hitelesítő adatok megadásához. Ezt a paramétert a telefon konfigurációs XML-fájljában (cfg.xml) konfigurálhatja egy ilyen formátumú karakterlánc megadásával: Lehetőségek:
Alapértelmezett: Alapvető HTTP-hitelesítés |
| 4 |
Kattintson az Összes változás elküldése lehetőségre. |
Profil manuális alkalmazása a telefonra
Kövesse a lépéseket és töltse le a konfigurációs fájlt egy TFTP szerver alkalmazásra a helyi PC-n.
| 1 |
Csatlakoztassa a számítógépet a telefon LAN-portjához. |
| 2 |
Futtasson egy TFTP-szerver alkalmazást a számítógépen, és győződjön meg arról, hogy a konfigurációs fájl elérhető a TFTP gyökérkönyvtárában. |
| 3 |
Egy web böngészőben adja meg a telefon LAN IP címét, a számítógép IP címét, a fájlnevet és a bejelentkezéshez szükséges adatokat. Használja ezt a formátumot: Példa: |
Végezze el az alábbi lépéseket a konfigurációs fájl letöltéséhez a telefonra cURL használatával. Ezzel a parancssor eszközzel küldhet adatot URL szintaxissal. A cURL letöltéséhez látogasson el ide:
https://curl.haxx.se/download.html
Javasoljuk, hogy ne használja a cURL-t a konfiguráció telefonra való felviteléhez, mert a cURL használata során a felhasználónév és a jelszó rögzítésre kerülhet.
| 1 |
Csatlakoztassa a számítógépet a telefon LAN-portjához. |
| 2 |
Töltse le a konfigurációs fájlt a telefonra az alábbi cURL parancs megadásával: |
Konfigurációs profilok
A telefon XML formátumú konfigurációkat fogad el.
Az ebben a szakaszban szereplő példák XML-szintaxisú konfigurációs profilokat használnak.
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.
Minden telefon más-más jellemzőkkel bír, ezért más-más paraméterei is vannak.
Nyitott profilformátum
A nyílt formátumú profil egy szövegfájl XML-szerű szintaxissal egy elem hierarchiában, elem attribútumokkal és értékekkel. Ehhez a formátumhoz és a konfigurációs fájl létrehozásához használhat standard eszközöket. Az XML konfigurációs fájl az újraszinkronizálási művelet során bináris objektumként történő összeállítás nélkül is elküldhető az ellátási szerverről a telefonra.
A telefon standard eszközzel létrehozott konfigurációs formátumokat képes fogadni. Ez a funkció megkönnyíti a meglévő adatbázisokból konfigurációs profilt előállító back-end szolgáltatási szerver szoftver fejlesztését.
A konfigurációs profilban lévő bizalmas információk védelme érdekében az ellátási szerver az XML konfigurációs fájlt TLS által védett csatornán keresztül juttatja el a telefonhoz. Opcionálisan a fájl tömöríthető a gzip lapos algoritmus (RFC1951) használatával.
A fájl az alábbi titkosítási módszerek egyikével titkosítható:
-
AES-256-CBC titkosítás
-
RFC-8188 alapú tartalom HTTP-titkosítás az AES-128-GCM titkosítás
Egy konfigurációs fájl az alábbi komponenseket tartalmazhatja:
-
Elem címkék
-
Attribútumok
-
Paraméterek
-
Formázási elemek
-
XML megjegyzések
Példa: Nyílt profilformátum
<flat-profile><Resync_On_Reset> Igen </Resync_On_Reset><Resync_Periodic> 7200 </Resync_Periodic><Profile_Rule> tftp://prov.telco.com:6900/cisco/config/CP_xxxx_MPP.cfg</Profile_Rule></flat-profile>A <flat-profile> elemcímke minden olyan paraméterelemet tartalmaz, amelyet a telefon felismer.
Elemcímke tulajdonságai
A konfigurációs fájl létrehozásakor vagy frissítésekor tartsa szem előtt a következő szabályokat.
-
Az XML szolgáltatási formátum és a Web UI lehetővé teszi azonos beállítások konfigurálását. Az XML-tagok és a mezők nevei a webes felhasználói felületen hasonlóak, de az XML-elemnév korlátozások miatt eltérnek egymástól. Például aláhúzások ( _ ) az XML konfigurációs fájlban a szóközök helyett a webes felhasználói felületen.
-
A telefon felismeri a megfelelő paraméternevekkel rendelkező elemeket, amelyek a speciális
<flat-profile>elembe vannak foglalva. -
Az elemnevek szögletes zárójelben szerepelnek.
-
A legtöbb elem neve hasonló a telefon webes felhasználói felületének mezőneveihez, a következő módosításokkal:
-
Az elemnevekben szerepelhet helyköz vagy speciális karakter. Ha az elem nevét a webes mező nevéből szeretné levezetni, minden szóköz vagy a
[,],(,)vagy/speciális karakterek helyett egy aláhúzással helyettesítsen.Példa: A <Resync_On_Reset> elem a Resync On Reset mezőt jelöli.
-
Minden elemnévnek egyedinek kell lennie. A telefon webes felhasználói felületén ugyanazok a mezők több weboldalon is megjelenhetnek, például a vonal, a felhasználó és a mellék oldalakon. Fűzze hozzá az
[n]attribútumot az elem nevéhez, jelölve az oldal tabulátoron megjelenő számot.Példa: A
<Dial_Plan_1_>elem az 1. vonal tárcsázási tervét jelenti.
-
-
Minden nyitócímkéhez egy megfelelő zárócímke tartozik. Például:
<flat-profile><Resync_On_Reset> Igen</Resync_On_Reset><Resync_Periodic> 7200</Resync_Periodic><Profile_Rule>tftp://prov.telco.com: 6900/cisco/config/CP_xxxx_MPP.cfg</Profile_Rule></flat-profil> -
Az elemcímkék kisbetű/nagybetű érzékenyek.
-
Az üres elemcímkék megengedettek, és úgy lesznek értelmezve, hogy az érték konfigurációja üres. Adja mg a nyitócímkét hozzárendelt elemcímke nélkül, majd illesszen be egy helyközt és egy előredöntött elválasztójelet a szögletes zárójel lezárása előtt (>). Ebben a példában a B profilszabály üres:
<Profil_Rule_B /> -
Üres elemcímke használatával megakadályozható a felhasználó által beírt értékek felülírása egy újraszinkronizáló művelet során. Az alábbi példában a felhasználó gyorstárcsázó beállításai változatlanok maradnak:
<flat-profil><Speed_Dial_2_Name ua="rw"/><Speed_Dial_2_Number ua="rw"/><Speed_Dial_3_Name ua="rw"/><Speed_Dial_3_Number ua="rw"/><Speed_Dial_4_Name ua="rw"/><Speed_Dial_4_Number ua="rw"/><Speed_Dial_5_Name ua="rw"/><Speed_Dial_5_Number ua="rw"/><Speed_Dial_6_Name ua="rw"/><Speed_Dial_6_Number ua="rw"/><Speed_Dial_7_Name ua="rw"/><Speed_Dial_7_Number ua="rw"/><Speed_Dial_8_Name ua="rw"/><Speed_Dial_8_Number ua="rw"/><Speed_Dial_9_Name ua="rw"/><Speed_Dial_9_Number ua="rw"/></flat-profile> -
Használjon üres értéket a megfelelő paraméter üres stringre való állításához. Adjon meg egy nyitócímkét és egy zárócímkét, de ne írjon közéjük értéket. Az alábbi példában a GPP_A paraméter egy üres stringre van állítva.
<flat-profil><GPP_A> </GPP_A></flat-profil> -
A nem felismert elemnevek figyelmen kívül lesznek hagyva.
Paraméter-tulajdonságok
Ezek a tulajdonságok vonatkoznak a paraméterekre:
Minden olyan paraméter, amit nem határoz meg egy profil, változatlan marad a telefonon.
A nem felismert paraméterek figyelmen kívül lesznek hagyva.
Ha a Nyílt formátumú profil ugyanannak a paraméter címkének több előfordulását tartalmazza, az utolsó ilyen előfordulás felülírja a korábbiakat. A paraméterek konfigurációs értékeinek nem szándékos felülírását elkerülendő, javasoljuk, hogy minden profil legfeljebb egy paraméter előfordulást határozzon meg.
Az utoljára feldolgozott profil kerül előre. Ha több profil határozza meg ugyanazt a konfigurációs paramétert, a későbbi profil értéke kerül előre.
Stringformátumok
Ezek a tulajdonságok vonatkoznak a stringek formázására:
A megjegyzések standard XML szintaxisként megengedettek.
<!-- A megjegyzés itt van begépelve..>A bevezető és követő helyköz karakterek használata engedélyezett a jobb olvashatóság miatt, de nem szerepelnek a paraméter értékekben.
Az értéket tartalmazó új sorok helyközzé konvertálódnak.
Egy XML fejléc a következő formában:
<? ?>megengedett, de a telefon figyelmen kívül hagyja.Speciális karakter beviteléhez használjon alap XML karakter megkerülést, az alábbi táblázat szerint.
Speciális karakter
XML megkerülési sorrend
& (ampersand)
&
< (kisebb mint)
<
> (nagyobb mint)
>
’ (aposztróf)
'
" (dupla idézőjel)
"
Az alábbi példában karakter megkerülés szerepel a nagyobb mint és kisebb mint szimbólumok helyett - amelyekre egy tárcsázási terv szabályban van szükség. Ez a példa egy információs forródrótvonal tárcsázási tervét határozza meg, amely beállítja a <Dial_Plan_1_> paramétert () egyenlő (S0 <:18005551212>).
<flat-profil> <Dial_Plan_1_> (S0 <:18005551212>) </Dial_Plan_1_></flat-profil>A számkarakterek escape-jei decimális és hexadecimális értékekkel (s.a.
(és.) lefordításra kerülnek.A telefon förmvere csak ASCII karaktereket támogat.
A nyílt konfigurációs profil összecsomagolható a szolgáltató szerver hálózati terhelésének csökkentése érdekében. A profil titkosítható, így a bizalmas információ megvédhető. A csomagolás nem szükséges, de a titkosítást meg kell előznie.
Nyitott profilú tömörítés
A támogatott tömörítési módszer a gzip lapos algoritmus (RFC1951). A gzip segédprogram és a tömörítési könyvtár, amely ugyanazt az algoritmust (zlib) használja az interneten elérhető.
A tömörítés azonosításához a telefon egy gzip kompatibilis fejlécet vár a tömörített fájlban. A gzip segédprogram meghivatkozása az eredeti Nyílt profilon hozza létre a fejlécet. A telefon megvizsgálja a letöltött fájl fejlécet a fájlformátum meghatározásához.
Például, ha a profile.xml egy érvényes profil, a profile.xml.gz is elfogadható. Az alábbi parancsok mindegyike le tudja generálni ezt a profiltípust:
-
>gzip profile.xmlLecseréli az eredeti fájlt a tömörített fájlra.
-
>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.
Nyílt profilú titkosítás
A szimmetrikus kulcstitkosítás használható egy Nyílt konfigurációs profil titkosításához, függetlenül attól, hogy a fájl tömörítve van-e vagy sem. Ha a tömörítés használható, a titkosítás előtt kell megtörténnie.
A szerver szolgáltatása HTTPS protokollt használ a telefon legelső szolgáltatásához telepítés után. A konfigurációs profilok előzetes offline titkosítása lehetővé teszi a HTTP használatát a profilok későbbi újraszinkronizálásához. Ez a funkció csökkenti a HTTPS szerver terhelését nagyszabású munka esetén.
A telefon a konfigurációs fájlok kétféle titkosítási módszerét támogatja:
-
AES-256-CBC titkosítás
-
RFC 8188-alapú HTTP tartalom titkosítás AES-128-GCM cipher használatával
A kulcsot vagy Input Keying Materialt (IKM) már korábban meg kell adni a készüléknek. A titkos kulcs bootstrap HTTPS protokollal szerezhető be biztonságosan.
A konfigurációs fájl neve nem igényel meghatározott formátumot, de a .cfg kiterjesztéssel végződő fájlnév általában konfigurációs profilt jelez.
AES-256-CBC titkosítás
A telefon támogatja a konfigurációs fájlok AES-256-CBC titkosítását.
A különböző internetes oldalakról letölthető OpenSSL titkosítási eszköz végezheti el a titkosítást. A 256-bites AES titkosítás támogatás kérheti az eszköz ismételt összerakását az AES kód engedélyezéséhez. A firmware-t openssl-1.1.1d verzióval teszteltük.
Titkosított fájl esetén a profil azt várja, hogy a fájl formátuma ugyanaz legyen, mint a következő paranccsal generált formátum:
# példa titkosítási kulcs = SecretPhrase1234 openssl enc –e –aes-256-cbc –k SecretPhrase1234 –in profile.xml –out profile.cfg # analóg meghívás tömörített XML fájlhoz openSSL enc –e –aes-256-cbc –k SecretPhrase1234 –in profile.xml.gz –out profile.cfg A titkos kulcsot, amely lehet sima szöveges kifejezés, egy kisbetűs -k előzi meg, ugyanez használható random 64-bites salt létrehozásához is. Amint a titkosítást meghatározta a -k argumentum,a titkosítási eszköz egy random 128-bites kezdővektort és az aktuális 256-bites titkosítási kulcsot deriválja.
Amikor ilyen titkosítást használunk egy konfigurációs profilon, a telefonnak el kell juttatni a titkos kulcs értékét a fájl titkosításának feloldásához. Az értéket minősítőként határozzák meg a profil URL-ben. A szintaxis a következő, explicit URL használatával:
[--key "SecretPhrase1234"] http://prov.telco.com/path/profile.cfgEz az érték a Profile_Rule paraméterek egyikének használatával programozható.
Makrókibontás
Több szolgáltatási paraméter is belső makró kiterjesztésen esik át az értékelés előtt. Az előzetes értékelési lépés nagyobb rugalmasságot biztosít a telefon újraszinkronizálási és frissítési tevékenységeiben.
Ezek a paramétercsoportok esnek át makró kiterjesztésen az értékelés előtt:
-
Resync_Trigger_*
-
Profile_Rule*
-
Log_xxx_Msg
-
Upgrade_Rule
Bizonyos körülmények között egyes általános célú paraméterek (GPP_*) makróbővítésen is átesnek, amint azt az alábbi Választható újraszinkronizálási argumentumok szakasz kifejezetten jelzi.
Makró kiterjesztés során a megnevezett változók tartalma felváltja az $NAME és $(NAME) űrlapok kifejezéseit. A változók lehetnek általános célú paraméterek, termék azonosítók, esemény időzítők és szolgáltatási állapot értékek. A teljes listát a Kiépítési paraméterek alatt található Makróbővítési változók című témakörben találja.
Az alábbi példában az $(MAU) kifejezést használjuk a 000E08012345 MAC cím beillesztésére.
A rendszergazda beírja az $(MAU)config.cfg értéket.
Az eredményül kapott makró kiterjesztés a 000E08012345 MAC címmel rendelkező eszközre: 000E08012345config.cfg
Ha a makrót nem ismeri fel, nem lesz kiterjesztve. Például a STRANGE név nem egy felismert makrónév, a MAU viszont egy felismert és érvényes makrónév.
A rendszergazda beírja az $STRANGE$MAU.cfg értéket.
Az eredményül kapott makró kiterjesztés a 000E08012345 MAC címmel rendelkező eszközre: $STRANGE000E08012345.cfg
A makró kiterjesztés nem lesz ismételten alkalmazva. Például az $$MAU" kiterjesztése $MAU" (az $$ lesz kiterjesztve) és nem ad MAC címet.
A speciális célú paraméterek tartalma, így a GPP_SA - GPP_SD paraméterek le lesznek képezve $SA - $SD makró kifejezésekre. Ezeken a paramétereken csak akkor van makró kiterjesztés, ha a --key , --uid, és --pwd beállítások egy újraszinkron URL-ben szerepelnek.
Feltételes kifejezések
A feltételes kifejezések újraszinkronizálási eseményeket indíthatnak el, és alternatív URL-ekből választhatnak újraszinkronizálási és frissítési műveleteket.
A feltételes kifejezések összehasonlítási listákból állnak, amelyeket és operátor választ el egymástól. Minden összehasonlításnál igaznak kell lennie a feltételnek.
Minden összehasonlítás az alábbi három típusú kifejezésre vonatkozhat:
-
Egész szám érték
-
Szoftver vagy hardver verziószám
-
Dupla idézőjeles string
Verziószám
A Cisco videótelefon 8875 szoftververziója ezt a formátumot használja (ahol a BN a Build Number, azaz az építési szám):
PHONEOSyyyy.1-0-1-0001-BN
ahol yyyy a telefon modelljét vagy sorozatát jelöli; 1 a főverzió; 0 a mellékverzió; 1-0001 a mikroverzió; és BN a buildszám.
Az összehasonlító stringnek ugyanezt a formátumot kell használnia. Ellenkező esetben elemzési hiba keletkezhet.
A szoftververzió összehasonlításakor a fő-, a mellék- és a mikroverzió egymás után kerül összehasonlításra, és a balra lévő számjegyek elsőbbséget élveznek az utóbbiakkal szemben. Ha a verziószámok megegyeznek, akkor a buildszámot kell összehasonlítani.
Példák érvényes verziószámra
PHONEOS-8875.1-0-1-0001-19
Összehasonlítás
Az idézőjelbe tett stringek azonosságra vagy különbözőségre hasonlíthatók össze. Az egész számok és a verziószámok aritmetikusan is összehasonlíthatók. Az összehasonlító operátorok szimbólumként vagy rövidítésként fejezhetők ki. A rövidítések Nyílt formátumú profilok feltételének kifejezésében hasznosak.
|
Operátor |
Alternatív szintaxis |
Leírás |
Alkalmazható egész szám és verzió operátorokhoz |
Alkalmazható idézőjeles string operátorokhoz |
|---|---|---|---|---|
|
= |
eq |
egyenlő |
Van |
Van |
|
!= |
ne |
nem egyenlő |
Van |
Van |
|
< |
lt |
kisebb mint |
Van |
Nem |
|
<= |
le |
kisebb mint vagy egyenlő |
Van |
Nem |
|
> |
gt |
nagyobb mint |
Van |
Nem |
|
>= |
ge |
nagyobb mint vagy egyenlő |
Van |
Nem |
|
ÉS |
|
és |
Van |
Van |
Fontos, hogy a makró változókat dupla idézőjelbe kell tenni ott, ahol string az elvárt. Ne tegye ezt ott, ahol számot vagy verziószámot várnak.
Amikor Profile_Rule* és Upgrade_Rule paraméter kontextusban használja, a feltételes kifejezéseket a szintaxisban kell szerepeltetni "(expr)?" mint a frissítési szabály példában. Ne feledje, hogy a BN helyébe a frissítendő firmware-betöltés buildszámát írja.
($SWVER ne PHONEOS-8875.1-0-1-0001-19)? http://ps.tell.com/sw/PHONEOS-8875.1-0-1-0001-BN.loadsNe használjon zárójeles megelőző szintaxist a Resync_Trigger_* paraméterek konfigurálásához.
URL szintaxis
Használjon standard URL szintaxist a konfigurációs fájlok fogadásának meghatározására, majd a firmware betölti a Profile_Rule* és Upgrade_Rule paramétereket. A szintaxis a következő:
[ scheme:// ] [ server [:port]] filepath
Ahol a scheme az alábbi két érték valamelyike:
-
tftp
-
HTTP protokoll
-
HTTPS
Ha a scheme ki van hagyva, a tftp-t feltételezi. A szerver lehet DNS-el felismert hosztnév vagy numerikus IP cím. A port a cél UDP vagy TCP portszám. A fájl útvonalnak a gyökérkönyvtárral kell kezdődnie (/); abszolút útvonalnak kell lennie.
Ha a server hiányzik, a DHCP (66-os opció) kapcsolaton meghatározott tftp szerver lesz használva.
A frissítés szabályokhoz a szervert meg kell határozni.
Ha a port hiányzik, a meghatározott séma standard portja lesz használva. A tftp a 69-es UDP portot, a http a 80-as TCP portot, a https a 443-as TCP portot használja.
Fájl elérési útnak lennie kell. Nem kell feltétlenül statikus fájlra mutatnia, jelölhet CGI-n keresztül kapott dinamikus tartalmat is.
A makró kiterjesztés URL-n belül érvényes. Az alábbi példák valid URL-k:
/$MA.cfg /cisco/cfg.xml 192.168.1.130/profiles/init.cfg tftp://prov.call.com/cpe/cisco$MA.cfg http://neptune.speak.net:8080/prov/$D/$E.cfg https://secure.me.com/profile?Linksys Amikor 66-os DHCP opciót használ, az üres szintaxist nem támogatják a frissítési szabályok. Csak a Profile_Rule* paraméterhez használható.
RFC 8188-alapú HTTP tartalom titkosítás
A telefon támogatja a konfigurációs fájlok AES-128-GCM cipheres HTTP RFC 8188-alapú HTTP tartalom-titkosítását. A titkosítási módszerrel bármely entitás elolvashatja a HTTP-fejléceket. Az entitások azonban csak az IKM ismeretében férhetnek hozzá a tényleges tartalomhoz (payload). Amikor a telefon megkapja az IKM-et, a telefon és a hálózatlétesítési kiszolgáló biztonságosan cserélhetnek konfigurációs fájlokat, ugyanakkor lehetővé teszi a harmadik féltől származó hálózati elemek számára, hogy elemzési és megfigyelési célokra használják az üzenet-fejléceket.
Az XML konfigurációs paraméter IKM_HTTP_Encrypt_Content tartja az IKM-et a telefonon. Biztonsági okokból ez a paraméter nem érhető el a telefon-felügyeleti weblapon. Nem átható a telefon konfigurációs fájljában sem, amelyhez a telefon IP-címe ismeretében vagy a telefon hálózatlétesítési kiszolgálóra küldött konfigurációs jelentéseiből lehet hozzáférni.
Ha szeretné használni az RFC 8188-alapú titkosításról, gyõzõdjön meg a következõkrõl:
-
A a hálózatlétesítési kiszolgálóról a telefonra küldött konfigurációs fájl
IKM_HTTP_Encrypt_ContentXML-paramétere IKM-re állításával IKM-et ad a telefonnak. -
Ha ezt a titkosítást a konfigurációs szerverről a telefonra küldött konfigurációs fájlokra alkalmazzák, győződjön meg arról, hogy a konfigurációs fájl Content-Encoding HTTP fejlécében szerepel a következő:
aes128gcm
.Ezen fejléc hiányában az AES-256-CBC módszer kap elsőbbséget. Ha van AES-256-CBC kulcs, a telefon az AES-256-CBC visszafejtést használja, függetlenül az IKM-től.
-
Ha azt szeretné, hogy a telefon ezt a titkosítást alkalmazza a hálózatlétesítési kiszolgálóra küldött konfigurációs jelentések esetén, győződjön meg arról, hogy nincs a jelentésszabályban megadva AES-256-CBC kulcs.
Választható újraszinkronizálási argumentumok
A Profile_Rule* paraméterekben megadott URL-ek elé választható argumentumok, a key, az uid és a pwd állhatnak, amelyeket együttesen szögletes zárójelbe kell helyezni.
kulcs
A --key opció azt közli a telefonnal, hogy a konfigurációs fájl, amelyet a rendelkezésre bocsátási szervertól kap, AES-256-CBC titkosítással van titkosítva, kivéve, ha a fájl Content-Encoding fejléce a következőt jelzi: aes128gcm
titkosítás. A kulcsot egy string és az azt követő--key kifejezés határozza meg. A kulcsot tetszés szerint lehet tenni idézőjelek (") közé. A telefon használ a kulcs a konfigurációs fájl visszafejtésére.
Példák a használatra
[--key VerySecretValue][--key “my secret phrase”][--key a37d2fb9055c1d04883a0745eb0917a4]A zárójelben lévő opcionális argumentumok makróval bővítettek. A speciális célú paraméterek , így a GPP_SA - GPP_SD paraméterek makróval bővített makró változók $SA és $SD között, amikor kulcs opció argumentumként vannak használva. Lásd az alábbi példákat:
[--key $SC][--key “$SD”]Nyílt formátumú profilokban a --kulcs argumentumnak ugyanannak kell lennie, mint a -k beállítás argumentuma, amit az openssl mezőben adnak meg.
uid és pwd
Az uid és pwd beállításokkal megadható a megadott URL megadásakor a HTTP Basic és Digest hitelesítési kihívásokra válaszul küldött felhasználói azonosító és jelszó. A zárójelben lévő opcionális argumentumok makróval bővítettek. A speciális célú paraméterek , így a GPP_SA - GPP_SD paraméterek makróval bővített makró változók $SA és $SD között, amikor kulcs opció argumentumként vannak használva. Lásd az alábbi példákat:
GPP_SA = Saját felhasználói azonosító GPP_SB = Titkos jelszó [--uid $SA --pwd $SB] https://provisioning_server_url/path_to_your_config/your_config.xml
a bővítmény megjelenítése:
[--uid MyUserID --pwdMySecretPassword] https://provisioning_server_url/path_to_your_config/your_config.xml
Ezek az adattípusok használatosak a konfigurációs profil paraméterekkel:
-
{a,b,c,…}—Választható a, b, c, …
-
Bool—Boolean érték, ami "igen" vagy "nem" lehet.
-
CadScript—Egy miniscript, ami a jel ütem paraméterét határozza meg. Legfeljebb 127 karakter
Szintaxis: S1[;S2], ahol:
-
Si=Di(bei,1/kii,1[,bei,2/kii,2[,bei,3/kii,3[,bei,4/kii,4[,bei,5/kii,5[,bei,6/kii,6]]]]]) és ez egy szakasz.
-
bei,j és kii,j a be/ki időtartam másodopercben egy szegmensben. i = 1 vagy 2, és j = 1 - 6.
-
Di a szakasz teljes időtartama másodpercben.
Minden időtartamban legfeljebb három tizedeshely lehet, ami 1ms felbontást jelent. A "*" szabad karakter korlátlan időtartamot jelöl. A szakaszon belüli szegmensek sorrendben vannak lejátszva, és addig ismétlődnek, amíg a teljes időtartam le nem telik.
1. példa:
60(2/4) pedálfordulatszakaszok száma = 1 Pedálfordulat 1. szakasz: szakaszhossz = 60 s szegmensek száma = 1 1. szegmens: be = 2 mp, ki = 4 s teljes gyűrűhossz = 60s2. példa—Megkülönböztető csengés (rövid,rövid,rövid,hosszú):
60(.2/.2,.2/.2,.2/.2,1/4) Pedálfordulatszakaszok száma = 1 Pedálfordulat 1. szakasz: Szakasz hossza = 60s Szegmensek száma = 4 1. szegmens: Be=0,2s, Ki=0,2s 2. szegmens: Be=0,2s, Ki=0,2s 3. szegmens: Be=0,2s, Ki=0,2s 4. szegmens: Be=1,0s, Ki=4,0s Teljes gyűrűhossz = 60s -
-
DialPlanScript—Script szintaxis, ami az 1-es vonal és a2-es vonal tárcsázási tervét határozza meg.
-
Float<n>—Egy lebegő pontérték n tizedeshellyel.
-
FQDN-Teljesen minősített tartománynév. Legfeljebb 63 karaktert tartalmazhat. Nézzük az alábbi példákat:
sip.Cisco.com:5060 vagy 109.12.14.12:12345
sip.Cisco.com or 109.12.14.12
-
FreqScript—Egy miniscript, ami egy tónus frekvencia és jel paraméterét határozza meg. Legfeljebb 127 karakter lehet.
Szintaxis: F1@L1[,F2@L2[,F3@L3[,F4@L4[,F5@L5[,F6@L6]]]]], ahol:
-
F1–F6 a frekvencia Hz-ben (csak nem aláírt egész szám).
-
L1–L6 a vonatkozó szint dBm-ben (legfeljebb egy tizedeshelyig).
Helyköz megengedett a vessző előtt és után, de nem ajánlott.
1. példa—Hívásvárakoztatás hang:
440@-10 Frekvenciák száma = 1 Frekvencia 1 = 440 Hz –10 dBm-nél2. példa—Tárcsázási hang:
350@-19,440@-19 Frekvenciák száma = 2 Frekvencia 1 = 350 Hz –19 dBm-nél Frekvencia 2 = 440 Hz –19 dBm-nél -
-
IP- Érvényes IPv4-cím x.x.x.x.x formájában, ahol x 0 és 255 között van. Példa: 10.1.2.100.
-
UserID—Felhasználói azonsító, ahogy az URL-ben megjelenik; legfeljebb 63 karakter.
-
Phone—Egy telefonszám string, például 14081234567, *69, *72, 345678; vagy egy generikus URL, például 1234@10.10.10.100:5068 vagy jsmith@Cisco.com. A string legfeljebb 39 karaktert tartalmazhat.
-
PhTmplt—Egy telefonszám sablon. A sablonok egy vagy több, vesszővel (,) elválasztott mintát tartalmazhatnak. A minták elején a helyköz figyelmen kívül lesz hagyva. A "?" és "*" szabad karaktereket jelölnek. Szó szerinti reprezentációhoz használja a%xx kifejezést. Például, a %2a jelent *-ot. A sablon legfeljebb 39 karaktert tartalmazhat. Példák: "1408*, 1510*", "1408123????, 555?1.".
-
Port—TCP/UDP Portszám (0-65535). Decimális vagy hex formátumban adható meg.
-
ProvisioningRuleSyntax—Script szintaxis, ami a konfigurációs újraszinkron és förmver frissítés szabályokat határozza meg..
-
PwrLevel—Erősségszint dBm-ben kifejezve, egy tizedeshellyel, például –13.5 vagy 1.5 (dBm).
-
RscTmplt-A SIP-válaszállapotkód sablonja, például "404, 5*", "61?", "407, 408, 487, 481". Legfeljebb 39 karaktert tartalmazhat.
-
Sig<n>—Aláírt n-bit érték. Decimális vagy hex formátumban adható meg. A "-" jel negatív értékek előtt áll. A + jel a pozitív értékek előtt opcionális.
-
Star Codes—Egy kiegészítő szolgáltatás aktivációs kódja, például *69. A kód legfeljebb 7 karaktert tartalmazhat.
-
Str<n>—Egy általános string n nem fenntartott karakterrel.
-
Time<n>—Időtartam másodpercben, legfeljebb n tizedeshellyel. Az extra meghatározott tizedeshelyek figyelmen kívül lesznek hagyva.
-
ToneScript—Egy miniscript, ami egy hívás folyamat hang frekvencia, szint és ütem paramétereit határozza meg. A script legfeljebb 127 karaktert tartalmazhat.
Szintaxis: FreqScript;Z1[;Z2].
A Z1 szakasz hasonló az S1 szakaszhoz egy CadScriptben, azzal a kivátellel, hogy minden be/ki szegmenst egy frekvencia komponens paraméter követ: Z1 = D1(bei,1/kii,1/fi,1[,bei,2/kii,2/fi,2 [,bei,3/kii,3/fi,3 [,bei,4/kii,4/fi,4 [,bei,5/kii,5/fi,5 [,bei,6/kii,6/fi,6]]]]]) ahol:
-
fi,j = n1[+n2]+n3[+n4[+n5[+n6]]]]].
-
1 < nk < 6 határozza meg a frekvencia komponenseket a szegmensben használt FreqScriptben.
Ha egynél több frekvencia szegmenst használ a scriptben, a komponensek összeadódnak.
1. példa—Tárcsázás hang:
350@-19,440@-19; 10(*/0/1+2) Frekvenciák száma = 2 Frekvencia 1 = 350 Hz –19 dBm-nél 2. frekvencia = 440 Hz –19 dBm-nél Pedálfordulatszakaszok száma = 1 Pedálfordulat 1. szakasz: Szakasz hossza = 10 s Szegmensek száma = 1 1. szegmens: Be=örökké, 1. és 2. frekvenciával Teljes hanghossz = 10s2. példa—Stutter hang:
350@-19,440@-19; 2(.1/.1/1+2); 10(*/0/1+2) Frekvenciák száma = 2 1. frekvencia = 350 Hz –19 dBm-nél 2. frekvencia = 440 Hz –19 dBm-nél Pedálfordulatszakaszok száma = 2 Pedálfordulat 1. szakasz: Szakasz hossza = 2s Szegmensek száma = 1 1. szegmens: Be = 0,1 mp, Ki = 0,1 mp 1 és 2 frekvenciával Pedálfordulat 2. szakasz: Szakasz hossza = 10s Szegmensek száma = 1 1. szegmens: Be=örökké, 1-es és 2-es frekvenciával Teljes hanghossz = 12s -
-
Uns<n>- Előjel nélküli n-bites érték, ahol n = 8, 16 vagy 32. Megadható decimális vagy hexa formátumban, például 12 vagy 0x18, amennyiben az érték n bitbe fér bele.
Az alábbiakat vegye figyelembe:
- <Par Name> egy konfigurációs paraméter nevét jelenti. Egy profilban a megfelelő címke úgy jön létre, hogy a szóközt egy "_" aláhúzással helyettesítjük, például Par_Name.
- Egy üres alapértelmezett érték üres stringet jelöl < "" >.
- A telefon az utoljára konfigurált értékeket fogja használni az adott profilban nem szereplő címkékhez.
- A sablonokat a megadott sorrendben hasonlítja össze. Az első nem a legközelebbi egyezés van kiválasztva. A paraméter nevének pontosan egyeznie kell.
- Ha egy paraméterhez egynél több meghatározás van megadva egy profilban, a fájlban az utolsó meghatározás lesz érvényes a telefonon.
- Egy üres paraméter értékkel rendelkező paraméter specifikáció kényszeríti ki az alapértelmezett értéket. Ha üres stringet szeretne helyette meghatározni, használja az üres string "" értéket a paraméter értéknek.
