Konfigurace telefonu pro resynchronizaci profilu

Telefon podporuje více síťových protokolů k načítání konfiguračních profilů. Nejzákladnějším protokolem pro přenos profilu je TFTP (RFC1350). Protokol TFTP se široce využívá ke zřizování síťových zařízení v rámci privátních sítí LAN. Ačkoliv se protokol TFTP nedoporučuje pro nasazování vzdálených koncových bodů přes internet, může být praktický pro nasazování v malých organizacích pro předběžné zřizování na pracovišti a pro vývoj a testování. V následujícím postupu je upraven profil po stažení souboru ze serveru TFTP.

1

V prostředí LAN připojte počítač a telefon k rozbočovači, přepínači nebo malému směrovači.

2

V počítači nainstalujte a aktivujte server TFTP.

3

Profil konfigurace vytvořte pomocí textového editoru.

Chcete-li ověřit, zda byl profil pro váš telefon později zřízen, můžete nastavit některé hodnoty jako značky. Například nastavte hodnotu pro GPP_A na 12345678, jak je uvedeno v následujícím příkladu:
 <flat-profile>   <GPP_A> 12345678   A> </flat-profile> 
_
4

Uložte konfigurační soubor XML do kořenového adresáře serveru TFTP.

Můžete ověřit, zda je server TFTP správně nakonfigurován: vyžádejte si soubor profilu konfigurace pomocí jiného klienta TFTP, než je telefon. Ideálně použijte klienta TFTP, který je spuštěn na jiném hostiteli než zřizovací server.

5

Ve webovém prohlížeči v počítači otevřete webovou stránku správy. Pokud je například adresa IP telefonu 192.168.1.100, otevřete ve webovém prohlížeči následující adresu URL:


http://192.168.1.100/admin/advanced

6

Vyberte kartu Hlas > Zřizování a zkontrolujte hodnoty obecných parametrů GPP_A až GPP_P. Měly by být prázdné.

7

Zkušební telefon resynchronizujte s profilem konfigurace, který jste vytvořili otevřením adresy URL resynchronizace ve webovém prohlížeči.

Příklad:

Pokud je adresa IP serveru TFTP 192.168.1.200, příkaz by měl vypadat nějak takto:


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

Když telefon tento příkaz obdrží, zařízení na adrese 192.168.1.100 požádá server TFTP na adrese 192.168.1.200 o soubor profilu konfigurace basic.txt . Telefon poté analyzuje stažený soubor a aktualizuje parametr GPP_A na hodnotu 12345678.

8

Ověřte, že byl parametr správně aktualizován. Obnovte webovou stránku správy a přejděte na Hlas > Zřizování.

Parametr GPP_A by nyní měl obsahovat hodnotu 12345678.

1

Získejte z produktového štítku adresu MAC telefonu. (Adresa MAC je číslo z číslic a malých šestnáctkových čísel, například 000e08aabbcc.

2

Přejmenujte konfigurační soubor na CP-xxxx macaddress.cfg (nahradíte xxxx číslem modelu a macaddress adresou MAC telefonu).

Příklad:

CP-8875 000e08aabbcc.cfg

3

Nový soubor přesuňte do virtuálního kořenového adresáře serveru TFTP.

4

Přejděte na webovou stránku správy telefonu.

5

Vyberte Hlas  > Zřizování.

6

Do pole Pravidlo profilu zadejte cestu souboru profilu.

Příklad: Předpokládejme, že adresa IP serveru TFTP je 192.168.1.200 a že název souboru profilu je

 <Profile_pravidlo> tftp://192.168.1.200/CP-8875$MA.cfg pravidlo> 
rofile_
7

Klikněte na možnost Odeslat všechny změny. To způsobí okamžité restartování a resynchronizaci.

Když dojde k další resynchronizaci, telefon načte nový soubor rozšířením výrazu makra $MA na adresu MAC telefonu.

1

Nainstalujte server HTTP na místní počítač nebo jiného přístupného hostitele.

Z internetu je možné stáhnout svobodný server Apache.

2

Soubor profilu konfigurace nahrajte do virtuálního kořenového adresáře nainstalovaného serveru.

3

Chcete-li ověřit správnou instalaci serveru a přístup k souboru profilu, otevřete profil ve webovém prohlížeči.

4

Upravte pravidlo Profile_testovacího telefonu tak, aby místo serveru TFTP mířilo na server HTTP, aby se profil stahoval pravidelně.

Pokud je server HTTP například 192.168.1.300 a název souboru profilu je basic.txt, zadejte následující hodnotu:

<Profile_pravidlo> http://192.168.1.200/basic.txt pravidlo>
rofile_
5

Klikněte na možnost Odeslat všechny změny. To způsobí okamžité restartování a resynchronizaci.

6

Podívejte se na zprávy syslog, které telefon odesílá. Při pravidelných resynchronizacích by nyní mělo docházet k získávání profilu ze serveru HTTP.

7

V protokolech serveru HTTP sledujte, jak se v protokolu uživatelských agentů objevují údaje identifikující testovací telefon.

Součástí těchto údajů by měl být výrobce, název produktu, aktuální verze firmwaru a sériové číslo.

Zařízení se může se zřizovacím serverem pravidelně resynchronizovat, aby se zajistilo, že se všechny změny profilu provedené na serveru dostanou do koncového zařízení (místo odeslání explicitního požadavku na resynchronizaci koncovému bodu).

Aby se telefon pravidelně resynchronizoval se serverem, pomocí parametru Profile_Pravidlo je definována adresa URL konfiguračního profilu a pomocí parametru Resync_Periodic je definován interval resynchronizace.

1

Přejděte na webovou stránku správy telefonu.

2

Vyberte Hlas  > Zřizování.

3

Definujte parametrrofile_Pravidlo P. V tomto příkladu se předpokládá, že adresa IP serveru TFTP je 192.168.1.200.

4

Do pole Pravidelná resynchronizace zadejte pro testování malou hodnotu, např. 30 sekund.

5

Klikněte na možnost Odeslat všechny změny.

S novým nastavením parametru se telefon s konfiguračním souborem určeným adresou URL resynchronizuje dvakrát za minutu.

6

Podívejte se na výsledné zprávy ve sledování syslog.

7

Ujistěte se, že je pole Resynchronizace při resetování nastaveno na hodnotu Ano.

 <Resync_On_Reset>AnoOn_Reset> 
esync_
8

Telefon restartujte, aby se resynchronizoval se zřizovacím serverem.

Pokud se resynchronizace z jakéhokoli důvodu nezdaří, například když server neodpovídá, jednotka počká (počet sekund nakonfigurovaný v parametru Prodleva opakování chyby resynchronizace), než se znovu pokusí o resynchronizaci. Pokud je prodleva opakování po chybě resynchronizace nulová, telefon se po neúspěšném pokusu o resynchronizaci nepokouší resynchronizaci.

9

(Volitelné) Nastavte hodnotu pole Prodleva opakování po chybě resynchronizace na malé číslo, například 30.

 <Resync_Error_Retry_Prodleva>30Error_Retry_Prodleva> 
esync_
10

Deaktivujte server TFTP a sledujte výsledky na výstupu syslog.

V následující tabulce je definována funkce a použití parametrů resynchronizace profilu v části Profil konfigurace na webové stránce telefonu na kartě Hlas > Zřizování . Definuje také syntaxi řetězce, který je za účelem konfigurace parametru přidán do konfiguračního souboru telefonu (cfg.xml) s kódem XML.

Tabulka 1. Parametry resynchronizace profilu

Parametr

Popis

Povolit zřizování

Povolí nebo zakáže akce resynchronizace profilu konfigurace.

  • V konfiguračním souboru telefonu (cfg.xml) s XML zadejte řetězec v tomto formátu:

    <Provision_Enable ua="na">AnoEnable>rovision_
  • Na webové stránce telefonu nastavte v tomto poli hodnotu Ano , pokud chcete povolit akce resynchronizace, nebo Ne , pokud chcete akce resynchronizace blokovat.

Výchozí: Ano

Resynchronizace při resetování

Určuje, zda telefon po spuštění a po každém pokusu o upgrade resynchronizuje konfigurace se zřizovacím serverem.

  • V konfiguračním souboru telefonu (cfg.xml) s XML zadejte řetězec v tomto formátu:

    <Resync_On_Reset ua="na">AnoOn_Reset>esync_
  • Na webové stránce telefonu nastavte v tomto poli hodnotu Ano , chcete-li povolit resynchronizaci při spuštění nebo resetování, nebo Ne , chcete-li resynchronizaci při spuštění nebo resetování zablokovat.

Výchozí: Ano

Náhodná prodleva resynchronizace

Brání přetížení zřizovacího serveru, když se najednou spustí velký počet zařízení a pokusí se o úvodní konfiguraci. Toto zpoždění je účinné pouze při počátečním pokusu o konfiguraci, po zapnutí nebo resetování zařízení.

Parametr je maximální časový interval, po který zařízení čeká před navázáním kontaktu se zřizovacím serverem. Skutečná prodleva je pseudonáhodné číslo v rozmezí 0 až této hodnoty.

Tento parametr je v jednotkách po 20 sekundách.

Rozsah platných hodnot 0 až 65 535.

  • V konfiguračním souboru telefonu (cfg.xml) s XML zadejte řetězec v tomto formátu:

    <Resync_Random_Prodleva ua="na">2Random_Prodleva>esync_
  • Na webové stránce telefonu zadejte počet jednotek (20 sekund), po jejichž uplynutí může telefon po spuštění nebo resetování odložit resynchronizaci.

Výchozí hodnota je 2 (40 sekund).

Resynchronizace v (HHmm)

Čas (HHmm), kdy se telefon se zřizovacím serverem resynchronizuje.

Hodnota tohoto pole musí být čtyřmístné číslo v rozmezí 0000 až 2 400 pro indikaci času ve formátu HHmm. Například 0959 znamená 09:59.

  • V konfiguračním souboru telefonu (cfg.xml) s XML zadejte řetězec v tomto formátu:

    <Resync_At__HHmm_ ua="na">0959At__HHmm_>esync_
  • Na webové stránce telefonu zadejte čas ve formátu HHMM, po který má telefon zahájit resynchronizaci.

Výchozí hodnota je prázdná. Pokud je hodnota neplatná, parametr se ignoruje. Pokud je tento parametr nastaven na platnou hodnotu, je parametr Pravidelná resynchronizace ignorován.

Resynchronizace po náhodné prodlevě

Brání přetížení zřizovacího serveru, když se najednou zapne velký počet zařízení.

Aby se zabránilo zaplavení serveru požadavky na resynchronizaci z více telefonů, telefon se resynchronizuje v rozsahu hodin a minut a hodin a minut plus náhodná prodleva (hhmm, hhmm+random_delay). Pokud je například náhodná prodleva = (resynchronizace po náhodné prodlevě + 30)/60 minut, pro výpočet konečného intervalu je vstupní hodnota v sekundách převedena na minuty a zaokrouhlena na následující random_delay minutu.

  • V konfiguračním souboru telefonu (cfg.xml) s XML zadejte řetězec v tomto formátu:

    <Resync_At_Random_Zpoždění ua="na">600At_Random_Zpoždění>esync_
  • Na webové stránce telefonu zadejte časové období v sekundách.

Rozsah platných hodnot je 600 až 6 5535.

Pokud je hodnota nižší než 600, je interní náhodná prodleva mezi 0 a 600.

Výchozí hodnota je 600 sekund (10 minut).

Pravidelná resynchronizace

Časový interval mezi pravidelnou resynchronizací se zřizovacím serverem. Přiřazený časovač resynchronizace je aktivní až po první úspěšné synchronizaci se serverem.

Platné formáty jsou následující:

  • Celé číslo

    Příklad: Vstup 3000 značí, že další resynchronizace proběhne za 3 000 sekund.

  • Více celých čísel

    Příklad: Vstup 600 1200 300 znamená, že první resynchronizace nastane za 600 sekund, druhá resynchronizace za 1 200 sekund po první a třetí resynchronizace za 300 sekund po druhé.

  • Časový rozsah

    Příklad: Vstup 2400+30 znamená, že další resynchronizace nastane za 2 400 až 2 430 sekund po úspěšné resynchronizaci.

  • V konfiguračním souboru telefonu (cfg.xml) s XML zadejte řetězec v tomto formátu:

    <Resync_Pravidelné ua="na">3600Pravidelné>esync_
  • Na webové stránce telefonu zadejte časové období v sekundách.

Pokud chcete pravidelnou resynchronizaci zakázat, nastavte tento parametr na nulu.

Výchozí hodnota je 3 600 sekund.

Prodleva opakování po chybě resynchronizace

Pokud se resynchronizace nezdaří, protože telefon nemohl ze serveru načíst profil, stažený soubor je poškozený nebo došlo k interní chybě, telefon se po době v sekundách pokusí provést resynchronizaci znovu.

Platné formáty jsou následující:

  • Celé číslo

    Příklad: Vstup 300 znamená, že další pokus o resynchronizaci proběhne za 300 sekund.

  • Více celých čísel

    Příklad: Vstup 600 1200 300 znamená, že první pokus o opakování proběhne za 600 sekund po selhání, druhý pokus za 1 200 sekund po selhání prvního pokusu a třetí pokus za 300 sekund po selhání druhého pokusu.

  • Časový rozsah

    Příklad: Vstup 2400+30 znamená, že další pokus proběhne za 2 400 až 2 430 sekund po selhání resynchronizace.

Pokud je prodleva nastavena na 0, zařízení se po neúspěšném pokusu o resynchronizaci nepokusí ji provést znovu.

  • V konfiguračním souboru telefonu (cfg.xml) s XML zadejte řetězec v tomto formátu:

    <Resync_Error_Retry_Zpoždění ua="na">60,120,240,480,960,1920,3840,7680,15360,30720,61440,86400Error_Retry_Zpoždění>esync_
  • Na webové stránce telefonu zadejte časové období v sekundách.

Výchozí: 60,120,240,480,960,1920,3840,7680,15360,30720,61440,86400

Prodleva nucené resynchronizace

Maximální prodleva (v sekundách), po kterou telefon čeká, než provede resynchronizaci.

Zařízení neprovede resynchronizaci, když je některá telefonní linka aktivní. Protože resynchronizace může trvat několik sekund, je před resynchronizací žádoucí počkat, než je zařízení po určitou dobu nečinné. Díky tomu může uživatel bez přerušení provádět více hovorů po sobě.

Zařízení má časovač, který začíná odpočet od chvíle, kdy jsou všechny linky nečinné. Tento parametr je počáteční hodnota čítače. Události resynchronizace jsou odloženy, dokud tento čítač neklesne na nulu.

Rozsah platných hodnot 0 až 65 535.

  • V konfiguračním souboru telefonu (cfg.xml) s XML zadejte řetězec v tomto formátu:

    <Forced_Resync_Prodleva ua="na">14400Resync_Prodleva>orced_
  • Na webové stránce telefonu zadejte časové období v sekundách.

Výchozí hodnota je 14 400 sekund.

Resynchronizace ze SIP

Ovládá požadavky na operace resynchronizace prostřednictvím události SIP NOTIFY odeslané do telefonu ze serveru proxy poskytovatele služeb. Pokud je tato možnost povolena, server proxy může požádat o resynchronizaci odesláním zprávy SIP NOTIFY, která obsahuje Událost: hlavička resynchronizace se zařízením.

  • V konfiguračním souboru telefonu (cfg.xml) s XML zadejte řetězec v tomto formátu:

    <Resync_From_SIP ua="na">AnoFrom_SIP>esync_
  • Na webové stránce telefonu vyberte možnost Ano , chcete-li tuto funkci povolit, nebo vyberte možnost Ne , chcete-li ji vypnout.

Výchozí: Ano

Resynchronizace po pokusu o upgrade

Zapíná a vypíná operaci resynchronizace po provedení upgradu. Pokud je vybrána možnost Ano , synchronizace se po upgradu firmwaru spustí.

  • V konfiguračním souboru telefonu (cfg.xml) s XML zadejte řetězec v tomto formátu:

    <Resync_After_Upgrade_Pokus ua="na">AnoAfter_Upgrade_Pokus>esync_
  • Na webové stránce telefonu vyberte možnost Ano , chcete-li resynchronizaci po upgradu firmwaru spustit. Chcete-li resynchronizaci ukončit, vyberte možnost Ne .

Výchozí: Ano

Spouštěč resynchronizace 1

Spouštěč resynchronizace 2

Pokud je logická rovnice v těchto parametrech vyhodnocena jako FALSE, resynchronizace se nespustí, ani když je možnost Resynchronizace při resetování nastavena na TRUE. Tyto spouštěče resynchronizace ignoruje pouze resynchronizace prostřednictvím adresy URL přímé akce a protokolu SIP Notify.

Parametry lze naprogramovat pomocí podmíněného výrazu, který prochází rozšířením makra. Platná rozšíření maker naleznete v části Proměnné rozšíření maker v části Parametry zřizování.

  • V konfiguračním souboru telefonu (cfg.xml) s XML zadejte řetězec v tomto formátu:

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

    <Resync_Trigger_2 ua="na"/>

  • Na webové stránce telefonu určete spouštěče.

Výchozí: Prázdné

Uživatelsky konfigurovatelná resynchronizace

Umožňuje uživateli resynchronizovat telefon z nabídky obrazovky telefonu. Pokud je nastavena možnost Ano, uživatel může znovu synchronizovat konfiguraci telefonu zadáním pravidla profilu z telefonu. Pokud je hodnota Ne, parametr Pravidlo profilu se v nabídce na obrazovce telefonu nezobrazí.

  • V konfiguračním souboru telefonu (cfg.xml) s XML zadejte řetězec v tomto formátu:

    <User_Configurable_Resync ua="na">AnoConfigurable_Resync>ser_

  • Na webové stránce telefonu vyberte možnost Ano , chcete-li zobrazit parametr Pravidlo profilu v nabídce telefonu, nebo vyberte možnost Ne , chcete-li tento parametr skrýt.

Výchozí: Ano

Resynchronizace se nezdaří při FNF

Resynchronizace se obvykle považuje za neúspěšnou, pokud není ze serveru přijat vyžádaný profil. Tento parametr toto chování přepíše. Když je parametr nastaven na hodnotu Ne, zařízení přijme odpověď od serveru file-not-found jako úspěšnou resynchronizaci.

  • V konfiguračním souboru telefonu (cfg.xml) s XML zadejte řetězec v tomto formátu:

    <Resync_Fails_On_FNF ua="na">AnoFails_On_FNF>esync_
  • Na webové stránce telefonu vyberte možnost Ano , chcete-li přijmout odpověď file-not-found jako neúspěšnou resynchronizaci, nebo vyberte možnost Ne , chcete-li přijmout odpověď file-not-found jako úspěšnou resynchronizaci.

Výchozí: Ano

Typ ověření profilu

Určuje přihlašovací údaje, které se mají použít pro ověřování účtu profilu. K dispozici jsou tyto možnosti:

  • Zakázáno: Zakáže funkci účtu profilu. Pokud je tato funkce zakázána, na obrazovce telefonu se nezobrazí nabídka Nastavení účtu profilu .

  • Základní ověřování HTTP: Přihlašovací údaje HTTP se používají k ověření účtu profilu.

  • Ověření XSI: Přihlašovací údaje XSI nebo přihlašovací údaje XSI SIP se používají k ověření účtu profilu. Přihlašovací údaje závisí na typu ověřování XSI pro telefon:

    • Pokud je typ ověřování XSI pro telefon nastaven na přihlašovací údaje, používají se přihlašovací údaje XSI.

    • Pokud je typ ověřování XSI pro telefon nastaven na přihlašovací údaje SIP, používají se přihlašovací údaje SIP XSI.

  • V konfiguračním souboru telefonu (cfg.xml) s XML zadejte řetězec v tomto formátu:

    <Profile_Authentication_Type ua="na">Základní Ověřování HttpAuthentication_Type>rofile_
  • Na webové stránce telefonu vyberte v seznamu možnost, pomocí které telefon ověří resynchronizaci profilu.

Výchozí: Základní ověřování HTTP

Další informace najdete v tématu Určení typu ověřování profilu v části Zadání telefonu pro resynchronizaci profilu.

Pravidlo profilu

Pravidlo profilu B

Pravidlo profilu C

Pravidlo profilu D

Každé pravidlo profilu informuje telefon o zdroji, ze kterého lze získat profil (konfigurační soubor). Během každé resynchronizace telefon postupně použije všechny profily.

Pokud používáte na konfigurační soubory šifrování AES-256-CBC, zadejte následujícím způsobem šifrovací klíč s klíčovým slovem --key :

[--klíč ]

Šifrovací klíč může být volitelně ve dvojitých uvozovkách (").

  • V konfiguračním souboru telefonu (cfg.xml) s XML zadejte řetězec v tomto formátu:

    <Profile_Pravidlo ua="na">/$PSN.xmlPravidlo>rofile_

    <Profile_Rule_B ua="na"/>

    <Profile_Rule_C ua="na"/>

    <Profile_Rule_D ua="na"/>

  • Na webové stránce telefonu zadejte pravidlo profilu.

Výchozí nastavení: /$PSN.xml

Použití možnosti DHCP

Možnosti DHCP oddělené čárkami používané k načtení firmwaru a profilů.

Výchozí: 66,160,159,150,60,43,125

Použití možnost DHCPv6

Možnosti DHCP oddělené čárkami používané k načtení firmwaru a profilů.

Výchozí: 17,160,159

Telefony můžete zřizovat pomocí funkcí Cisco XML.

Do telefonu můžete prostřednictvím paketů oznámení SIP nebo metodou HTTP Post na rozhraní CGI telefonu poslat objekt XML: http://PhoneIPAddress/CGI/Execute.

CP-xxxx-3PCC rozšiřuje funkci Cisco XML k podpoře zřizování prostřednictvím objektu XML:

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

Poté, co telefon obdrží objekt XML, stáhne zřizovací soubor z [profile-rule]. Toto pravidlo využívá makra ke zjednodušení vývoje aplikace služeb XML.

Podsložky s více profily na serveru představují praktickou metodu správy velkého počtu nasazených zařízení. Adresa URL profilu může obsahovat:

  • název zřizovacího serveru nebo explicitní adresu IP. Pokud profil identifikuje zřizovací server podle názvu, telefon k analýze názvu provede vyhledávání v serveru DNS.

  • Nestandardní port serveru, který je zadán v adrese URL pomocí standardní syntaxe :port za názvem serveru.

  • Podadresář virtuálního kořenového adresáře serveru, kde je profil uložen, zadaný pomocí standardní notace adresy URL a spravovaný rozšířením makra.

Následující pravidlo Profile_například žádá soubor profilu ($PN.cfg) v podadresáři serveru /cisco/config ze serveru TFTP, který je spuštěný na hostiteli prov.telco.com a očekává připojení na portu 6900:

 <Profile_pravidlo> tftp://prov.telco.com:6900/cisco/config/$PN.cfg pravidlo> 
rofile_

Profil lze u každého telefonu identifikovat pomocí obecného parametru, na jehož hodnotu se odkáže v obecném pravidle profilu pomocí rozšíření makra.

Předpokládejme například, že GPP_B je definována jako Dj6Lmp23Q.

Pravidlo Profile_má hodnotu:

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

Když se zařízení resynchronizuje a makra jsou rozšířena, telefon s adresou MAC 000e08012345 si vyžádá profil s názvem, který obsahuje adresu MAC zařízení na následující adrese URL:

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

Ověření profilu umožňuje uživatelům telefonu resynchronizovat zřizovací profil s telefonem. Informace o ověření jsou požadovány, když se telefon poprvé pokusí resynchronizovat a stáhnout konfigurační soubor a dojde k chybě ověření HTTP nebo HTTPS 401. Když tuto funkci povolíte, zobrazí se na telefonu obrazovka Nastavení účtu profilu v následujících situacích:

  • Když při prvním zřizování po restartování telefonu dojde k chybě ověřování HTTP nebo HTTP 401

  • Když jsou uživatelské jméno a heslo účtu profilu prázdné

  • Pokud v pravidle profilu není žádné uživatelské jméno a heslo

Pokud je obrazovka Nastavení účtu profilu vynechána nebo ignorována, uživatel může přejít na obrazovku nastavení také prostřednictvím nabídky obrazovky telefonu nebo softwarového tlačítka Nastavení , které se zobrazí pouze v případě, že není v telefonu zaregistrována žádná linka.

Když tuto funkci zakážete, v telefonu se nezobrazí obrazovka Nastavení účtu profilu .

Uživatelské jméno a heslo v poli Pravidlo profilu mají vyšší prioritu než účet profilu.

  • Pokud v poli Pravidlo profilu zadáte správnou adresu URL bez uživatelského jména a hesla, telefon k resynchronizaci profilu vyžaduje ověření nebo digest. Při správném účtu profilu ověření přejde. Při nesprávném profilu účtu se ověřování nezdaří.

  • Pokud v poli Pravidlo profilu zadáte správnou adresu URL se správným uživatelským jménem a heslem, telefon k resynchronizaci profilu vyžaduje ověření nebo digest. Účet profilu se nepoužívá k resynchronizaci telefonu. Přihlášení proběhlo úspěšně.

  • Pokud v poli Pravidlo profilu zadáte správnou adresu URL s nesprávným uživatelským jménem a heslem, telefon k resynchronizaci profilu vyžaduje ověření nebo digest. Účet profilu se nepoužívá k resynchronizaci telefonu. Přihlášení se vždy nezdaří.

  • Pokud v poli Pravidlo profilu zadáte nesprávnou adresu URL, přihlášení vždy selže.

Parametry v konfiguračním souboru telefonu můžete konfigurovat také pomocí kódu XML (cfg.xml).

Typ ověřování profilu můžete zadat na webové stránce pro správu telefonu.

1

Přejděte na webovou stránku správy telefonu.

2

Vyberte Hlas > Zřizování.

3

V části Profil konfigurace nastavte parametr Typ ověření profilu a zadejte pověření, která se mají použít pro ověřování účtu profilu.

Tento parametr lze nakonfigurovat v konfiguračním souboru XML telefonu (cfg.xml) zadáním řetězce v tomto formátu:

<Profile_Authentication_Type ua="na">ZakázánoAuthentication_Type>
rofile_

Možnosti:

  • Zakázáno: Zakáže funkci účtu profilu. Pokud je tato funkce zakázána, nezobrazí se na obrazovce telefonu nabídka Nastavení účtu profilu .

  • Základní ověřování HTTP: Přihlašovací údaje HTTP se používají k ověření účtu profilu.

  • Ověření XSI: Přihlašovací údaje XSI nebo přihlašovací údaje XSI SIP se používají k ověření účtu profilu. Přihlašovací údaje závisí na typu ověřování XSI pro telefon:

    Pokud je typ ověřování XSI pro telefon nastaven na přihlašovací údaje, používají se přihlašovací údaje XSI.

    Pokud je typ ověřování XSI pro telefon nastaven na přihlašovací údaje SIP, používají se přihlašovací údaje SIP XSI.

Výchozí: Základní ověřování HTTP

4

Klikněte na možnost Odeslat všechny změny.

Ruční použití profilu na váš telefon

Ke stažení konfiguračního souboru do aplikace serveru TFTP v počítači proveďte následující kroky.

1

Připojte počítač k portu LAN telefonu.

2

V počítači spusťte aplikaci serveru TFTP a ujistěte se, že konfigurační soubor je dostupný v kořenovém adresáři TFTP.

3

Ve webovém prohlížeči zadejte adresu IP telefonu v síti LAN, adresu IP počítače, název souboru a přihlašovací údaje. Použijte tento formát:

http://<IP_adresa_WAN>/admin/resync?tftp://<IP_adresa_PC>/<file_name>&xuser=admin&xpassword=

Příklad:

http://192.168.15.1/admin/resync?tftp://192.168.15.100/my_config.xml&xuser=admin&xpassword=admin

Ke stažení konfigurace do telefonu pomocí příkazu cURL proveďte následující postup. Tento nástroj pro příkazové řádky se používá k přenosu dat pomocí syntaxe adresy URL. Nástroj cURL si můžete stáhnout na adrese:

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

Doporučujeme, abyste příkaz cURL nepoužívali k odesílání konfigurace do telefonu, protože uživatelské jméno a heslo mohou být při použití protokolu cURL zachyceny.

1

Připojte počítač k portu LAN telefonu.

2

Zadáním následujícího příkazu cURL do telefonu stáhněte konfigurační soubor:

curl –d @my_config.xml“http://192.168.15.1/admin/config.xml&xuser=admin&xpassword=admin”

Profily konfigurace

Telefon přijímá konfigurace ve formátu XML.

V příkladech v této části jsou využity profily se syntaxí XML.

Konfigurační profil definuje hodnoty parametrů telefonu.

Formát XML konfiguračního profilu ke kompilaci parametrů a hodnot využívá standardní nástroje vytváření XML.

Je podporována pouze znaková sada UTF-8. Pokud upravíte profil v editoru, neměňte formát kódování; jinak telefon soubor nerozpozná.

Každý telefon má jinou sadu funkcí, a tudíž i jinou sadu parametrů.

Otevřít formát profilu

Profil otevřeného formátu je textový soubor se syntaxí podobou XML, hierarchií elementů a atributy a hodnotami elementů. Tento formát umožňuje vytvářet konfigurační soubor pomocí standardních nástrojů. Konfigurační soubor XML může být během operace resynchronizace odeslán ze zřizovacího serveru na telefon, a to bez kompilace jako binárního objektu.

Telefon může přijímat formáty konfigurace, které standardní nástroje generují. Tato funkce usnadňuje vývoj back-endového softwaru zřizovacího serveru, který generuje profily konfigurace ze stávajících databází.

Na ochranu důvěrných údajů v profilu konfigurace zřizovací server poskytuje telefonu konfigurační soubor XML prostřednictvím kanálu zabezpečeného protokolem TLS. Soubor lze volitelně komprimovat pomocí algoritmu gzip (RFC1951).

Soubor lze zašifrovat pomocí jedné z těchto metod šifrování:

  • Šifrování AES-256-CBC

  • Šifrování AES-128-GCM obsahu pro protokol HTTP pomocí metody RFC 8188

Konfigurační soubor může obsahovat tyto komponenty:

  • Značky elementů

  • Atributy

  • Parametry

  • Formátovací funkce

  • Komentáře XML

Příklad: Otevřít formát profilu

 <flat-profile> <Resync_On_Reset> Ano On_Reset> <Resync_Periodic> 7200 Periodic> <Profile_Pravidlo> tftp://prov.telco.com:6900/cisco/config/CP_xxxx_MPP.cfgPravidlo> </flat-profile> 
esync_esync_rofile_

Značka elementu obsahuje všechny prvky parametru, které telefon rozpozná.

Vlastnosti značky elementu

Při vytváření nebo aktualizaci konfiguračního souboru pamatujte na následující pravidla.

  • Formát zřizování XML a webové uživatelské rozhraní umožňují konfiguraci stejného nastavení. Názvy značek XML a názvy polí ve webovém uživatelském rozhraní jsou podobné, ale kvůli omezením na název elementu XML se liší. Například podtržítka ( _ ) v konfiguračním souboru XML namísto mezer ve webovém uživatelském rozhraní.

  • Telefon rozpozná prvky s příslušnými názvy parametrů, které jsou zapouzdřeny ve speciálním prvku .

  • Názvy elementů se uzavírají do hranatých závorek.

  • Většina názvů elementů je podobná názvům polí ve webovém uživatelském rozhraní telefonu s následujícími úpravami:

    • Názvy elementů nesmějí obsahovat mezery ani speciální znaky. Při odvozování názvu elementu z názvu webového pole nahraďte každou mezeru a speciální znaky [, ], (, ) nebo / podtržítky.

      Příklad: Prvek <Resync_On_Reset> představuje pole Resynchronizace při resetování .

    • Každý název elementu musí být jedinečný. Ve webovém uživatelském rozhraní telefonu se stejná pole mohou zobrazovat na více webových stránkách, například Linka, Uživatel a Linka. K názvu prvku připojte [n] , což značí číslo, které se zobrazuje na kartě stránky.

      Příklad: Prvek <Dial_Plan_1_> představuje pro linku 1 plán vytáčení .

  • Každá otevírací značka elementu musí mít odpovídající uzavírací značku elementu. Například:

      <Resync_On_Reset> Ano On_Reset> <Resync_Periodic> 7200 Periodic> <Profile_Rule>tftp://prov.telco.com:esync_esync_ 6900/cisco/config/CP_xxxx_MPP.cfg Pravidlo>  
    rofile_
  • U značek elementů záleží na velikosti písmen.

  • Prázdné značky elementů jsou povoleny a interpretují se tak, že hodnota je nakonfigurována jako prázdná. Zadejte otevírací značku elementu bez odpovídající značky elementu a před koncovou špičatou závodu (>) vložte mezeru a lomítko. V tomto příkladu je hodnota Profile Rule B prázdná:

     <Profile_Rule_B /> 
  • Prázdnou značku elementu lze použít k zabránění přepsání uživatelem zadaných hodnot během operace resynchronizace. V následujícím příkladu zůstávají uživatelská nastavení rychlé volby beze změny:

     <Speed_D.ial_2_Název ua="rw"/> <Speed_D.ial_2_Číslo ua="rw"/> <Speed_D.ial_3_Název ua="rw"/> <Speed_D.ial_3_Číslo ua="rw"/> <Speed_D.ial_4_Název ua="rw"/> <Speed_D.ial_4_Číslo ua="rw"/> <Speed_D.ial_5_Název ua="rw"/> <Speed_D.ial_5_Číslo ua="rw"/> <Speed_D.ial_6_Název ua="rw"/> <Speed_D.ial_6_Číslo ua="rw"/> <Speed_D.ial_7_Název ua="rw"/> <Speed_D.ial_7_Číslo ua="rw"/> <Speed_D.ial_8_Název ua="rw"/> <Speed_D.ial_8_Číslo ua="rw"/> <Speed_D.ial_9_Název ua="rw"/> <Speed_D.ial_9_Číslo ua="rw"/>  
  • Pokud chcete příslušný parametr nastavit na prázdný řetězec, použijte prázdnou hodnotu. Zadejte otevírací a koncový prvek bez jakékoli hodnoty mezi nimi. V následujícím příkladu je parametr GPP_A nastaven na prázdný řetězec.

     <plochý profil> <GPP_A>   A> </plochý profil> 
    _
  • Nerozpoznané názvy elementů jsou ignorovány.

Vlastnosti parametru

Parametry mají tyto vlastnosti:

  • Všechny parametry, které nejsou zadány v profilu, zůstávají v telefonu beze změny.

  • Nerozpoznané parametry jsou ignorovány.

  • Pokud profil otevřeného formátu obsahuje více výskytů stejné značky parametru, poslední takový výskyt má přednost před předcházejícími. Abyste předešli nechtěnému přepsání hodnot konfigurace parametru, doporučujeme, aby byla v každém profilu zadána maximálně jedna instance parametru.

  • Poslední zpracovaný profil má přednost. Pokud má více profilů stejný parametr konfigurace, hodnota toho pozdějšího má přednost.

Formáty řetězců

Při formátování řetězců platí tyto vlastnosti:

  • Komentáře jsou povoleny pomocí standardní syntaxe XML.

  • Bílé znaky na začátku a na konci jsou kvůli čitelnosti povoleny, ale z hodnoty parametru jsou odstraněny.

  • Nové řádky v rámci hodnoty jsou převedeny na mezery.

  • Záhlaví XML ve tvaru <? ?> je povoleno, ale telefon jej ignoruje.

  • Chcete-li zadat speciální znaky, použijte základní kódy znaků XML, jak jsou uvedeny v následující tabulce.

    Speciální znak

    Úniková sekvence XML

    & (ampersand)

    &

    < (menší než)

    <

    > (větší než)

    >

    " (apostrof)

    '

    “ (dvojitá citace)

    "

    V následujícím příkladu jsou zadány kódy znaků reprezentující symboly větší než a menší než, které jsou vyžadovány pravidlem plánu číslování. V tomto příkladu je definován informační plán vytáčení horké linky, který nastavuje parametr <Dial_Plan_1_> (Přihlášení správce > pokročilé > Hlas > Linka (n)) na hodnotu (S0 ).

     <plochý profil> <Dial_Plan_1_> (S0 ) Plan_1_> </plochý profil>
    ial_
  • Kódy s číselnými znaky v desítkových nebo šestnáctkových hodnotách (např. ( a .) jsou přeloženy

  • Firmware telefonu podporuje pouze znaky ASCII.

Za účelem snížení síťové zátěže na zřizovací server můžete otevřený konfigurační profil komprimovat. Profil lze také na ochranu důvěrných informací zašifrovat. Komprese není vyžadována, ale musí být provedena před šifrováním.

Komprese otevřeného profilu

Podporovanou metodou komprese je algoritmus gzip (RFC1951). Nástroj gzip a komprimační knihovna, která implementuje stejný algoritmus (zlib), jsou k dispozici na internetu.

Pro rozpoznání komprese telefon očekává, že komprimovaný soubor bude obsahovat hlavičku kompatibilní s nástrojem gzip. Hlavička je vygenerována zavoláním nástroje gzip na původní otevřený profil. Telefon se podívá do záhlaví staženého souboru, aby určil jeho formát.

Pokud je například profile.xml platný profil, bude přijat také soubor profile.xml.gz . Tento typ profilu může vygenerovat kterýkoli z následujících příkazů:

  • > Soubor profilu.xml gzip

    Nahradí původní soubor komprimovaným souborem.

  • >profil.xml | gzip > profil.xml.gz

    Ponechá původní soubor na místě a vytvoří nový komprimovaný soubor.

Šifrování otevřeného profilu

Bez ohledu na to, zda je soubor komprimovaný, lze šifrování symetrickým klíčem použít k šifrování otevřeného profilu konfigurace. Je-li použita komprese, je nutno ji provést před šifrováním.

Zřizovací server využívá k provedení počátečního zřízení telefonu po nasazení protokol HTTPS. Předběžné zašifrování profilů konfigurace offline umožňuje k následné resynchronizaci profilů použít protokol HTTP. Tím se snižuje zátěž serveru HTTPS v nasazeních s velkým měřítkem.

Telefon podporuje dvě metody šifrování konfiguračních souborů:

  • Šifrování AES-256-CBC

  • Šifrování AES-128-GCM obsahu pro protokol HTTP pomocí metody RFC 8188

Je nutné pro jednotku předem zřídit klíč nebo materiál IKM (Input Keying Material). Samozavedení tajného klíče lze bezpečně provést pomocí protokolu HTTPS.

Název konfiguračního souboru nevyžaduje konkrétní formát, ale název souboru, který končí příponou .cfg , obvykle označuje profil konfigurace.

Šifrování AES-256-CBC

Telefon podporuje šifrování AES-256-CBC pro konfigurační soubory.

Šifrování může provést nástroj pro šifrování OpenSSL, který je k dispozici na různých webech na internetu. Podpora 256bitového šifrování AES může k povolení kódu AES vyžadovat překompilování nástroje. Firmware byl testován s verzí openssl-1.1.1d.

U zašifrovaného souboru profil očekává, že soubor bude mít stejný formát jako při vygenerování následujícím příkazem:

 # příklad šifrovacího klíče = SecretPhrase1234 openssl enc –e –aes-256-cbc –k SecretPhrase1234 –in profile.xml –out profile.cfg # analogové volání pro komprimovaný soubor xml openssl enc –e –aes-256-cbc –k SecretPhrase1234 –in profile.xml.gz –out profile.cfg 

Malé -k před tajným klíčem, což může být libovolný textový výraz, který se používá k vygenerování náhodného 64bitového řetězce. Z tajného řetězce definovaného v argumentu -k šifrovací nástroj odvodí náhodný 128bitový úvodní vektor a nakonec 256bitový šifrovací klíč.

Když se tato podoba šifrování použije na profil konfigurace, telefon musí být pro dešifrování souboru informován o hodnotě tajného klíče. Tato hodnota je zadána jako kvalifikátor v adrese URL profilu. Syntaxe je za použití explicitní adresy URL tato:

 [--klíč „SecretPhrase1234“] http://prov.telco.com/path/profile.cfg 

Tato hodnota je naprogramována pomocí jednoho z parametrů Profile_Rule .

Rozšíření makra

Několik parametrů zřizování prochází před vyhodnocením rozšířením makra. Tento krok předběžného vyhodnocení poskytuje větší flexibilitu při řízení činností resynchronizace telefonu a upgradu.

Rozšíření makra před vyhodnocením procházejí těmito parametry:

  • Resync_Trigger_*

  • Pravidlo rofile_P*

  • Log_xxx_Msg

  • Upgrade_pravidlo

Za určitých podmínek rozšíření makra podléhají také obecné parametry (GPP_*), jak je explicitně uvedeno v části Volitelné argumenty resynchronizace níže.

Při rozšíření makra se obsah pojmenovaných proměnných nahradí výrazy v podobě $JMENO a $(JMENO). Mezi tyto proměnné patří obecné parametry, několik identifikátorů produktů, některé časovače událostí a hodnoty stavu zřizování. Úplný seznam najdete v tématu Proměnné rozšíření makra v části Parametry zřizování.

V následujícím příkladu se výraz $(MAU) používá k zadání adresy MAC 000E08012345.

Správce zadá: $(MAU)config.cfg

Výsledné rozšíření makra pro zařízení s adresou MAC 000E08012345 je: 000E08012345config.cfg

Pokud název makra není rozpoznán, zůstává nerozšířený. Například název STRANGE není rozpoznán jako platný název makra a název MAU je rozpoznán jako platný název makra.

Správce Zadá: $STRANGE$MAU.cfg

Výsledné rozšíření makra pro zařízení s adresou MAC 000E08012345 je: $STRANGE E08012345.cfg

Rozšíření makra se neprovádí rekurzivně. Například „$$MAU” se rozšíří na „$MAU” ($$ se rozšíří) a výsledkem není adresa MAC.

Obsah parametrů pro zvláštní účel, GPP_SA až GPP_SD, je mapován na výrazy makra $SA až $SD. Tyto parametry jsou jako makro rozšíření pouze jako argument možností --key , --uid a --pwd v adrese URL resynchronizace.

Podmíněné výrazy

Podmíněné výrazy mohou spouštět událost resynchronizace a vybírat z alternativních adres URL pro operace resynchronizace a upgradu.

Podmíněné výrazy se skládají ze seznamu srovnání oddělených operátorem a operátorem. Aby byla podmínka platná, musí být všechna srovnání pravdivá.

Každé srovnání se může týkat jednoho z těchto tří typů literálů:

  • Celočíselné hodnoty

  • Čísla verzí softwaru nebo hardwaru

  • Řetězce v dvojitých uvozovkách

Čísla verzí

Verze softwaru pro Cisco Video Phone 8875 používá tento formát (kde BN je číslo sestavení):

Telefonrrrr.1-0-1-0001-BN

kde rrrr označuje model nebo řadu telefonů; 1 je hlavní verze, 0 je menší verze, 1–0001 je mikroverze a BN je číslo sestavení.

Řetězec ve srovnání musí mít stejný formát. Jinak dojde k chybě analýzy formátu.

Při srovnávání verze softwaru jsou postupně srovnávány hlavní verze, menší verze a mikroverze a nejlevější číslice mají přednost před těmi nejlevější. Pokud jsou čísla verzí shodná, je porovnáno číslo sestavení.

Příklady platného čísla verze

telefonní systémy 8875.1-0-1-0001-19

Srovnání

U řetězců v uvozovkách je možné srovnávat rovnost a nerovnost. Celá čísla a čísla verzí lze také srovnávat aritmeticky. Operátory srovnání lze vyjádřit jako symboly nebo zkratky. Zkratky jsou praktický způsob vyjádření podmínky v profilu otevřeného formátu.

Obsluha

Alternativní syntaxe

Popis

Použitelné na operandy celého čísla a verze

Použitelné na operandy řetězců v uvozovkách

=

rovno

rovná se

Ano

Ano

!=

ne

nerovná se

Ano

Ano

<

lt

menší než

Ano

Ne

<=

le

menší nebo roven

Ano

Ne

>

gt

větší než

Ano

Ne

>=

ge

větší než nebo roven

Ano

Ne

A

a

Ano

Ano

Tam, kde je očekáván řetězcový literál, je důležité proměnné makra uzavírat do dvojitých uvozovek. To nedělejte tam, kde je očekáváno číslo nebo číslo verze.

Při použití v kontextu parametrů Profile_Rule* a Upgrade_ musí být podmíněné výrazy uzavřeny v syntaxi “(vyraz)?” jako v tomto příkladu pravidla upgradu. Nezapomeňte nahradit číslo BN číslem sestavení firmwaru, na který chcete upgradovat.

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

Uvedenou syntaxi se závorkami nepoužívejte ke konfiguraci parametrů Resync_Trigger_*.

Syntaxe adresy URL

K zadání způsobu načítání konfiguračních souborů a firmwaru do parametrů Profile_Rule* a Upgrade_Rule použijte standardní syntaxi adresy URL. Syntaxe je následující:

[ scheme:// ] [ cesta k souboru serveru [:port]]

Kde je schéma jednou z těchto hodnot:

  • tftp

  • http

  • https

Při vynechání schématu se předpokládá tftp. Server může být název hostitele rozpoznaný serverem DNS nebo číselná adresa IP. Port je číslo cílového portu UDP nebo TCP. Cesta k souboru musí začínat kořenovým adresářem (/) a musí se jednat o absolutní cestu.

Pokud chybí server , používá se server tftp určený prostřednictvím DHCP (možnost 66).

U pravidel upgradu musí být server zadán.

Pokud chybí port , použije se standardní port pro zadaný protokol. Protokol TFTP využívá port UDP 69, protokol HTTP využívá port TCP 80, protokol HTTPS využívá port TCP 443.

Cesta k souboru musí být přítomna. Nemusí nutně odkazovat na statický soubor, ale může indikovat dynamický obsah získaný prostřednictvím CGI.

V rámci adres URL platí rozšíření maker. Toto jsou příklady platných adres URL:

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

Při použití možnosti DHCP 66 není u pravidel upgradu podporována prázdná syntax. Platí pouze pro pravidlo profilu*.

Šifrování obsahu pro protokol HTTP pomocí metody RFC 8188

Telefon podporuje šifrování obsahu protokolu HTTP na základě metody RFC 8188 s šifrováním AES-128-GCM pro konfigurační soubory. Pomocí této metody šifrování může jakákoli entita číst záhlaví zpráv HTTP. Datovou část však mohou číst pouze entity, které mají k dispozici data IKM (Input Keying Material). Když jsou pro telefon zřízena data IKM, mezi telefonem a zřizovacím serverem lze bezpečně přenášet konfigurační soubory a současně je možné, aby síťové prvky třetí strany používaly záhlaví zpráv pro účely analýz a monitorování.

Konfigurační parametr XML IKM_HTTP_Encrypt_Content uchovává v telefonu IKM. Z bezpečnostních důvodů není tento parametr přístupný na webové stránce správy telefonu. Také se nezobrazuje v konfiguračním souboru telefonu, ke kterému máte přístup z adresy IP telefonu nebo ze sestav konfigurace telefonu odeslaných na zřizovací server.

Pokud chcete používat šifrování podle metody RFC 8188, je nutné splnit následující podmínky:

  • Zřiďte pro telefon data IKM zadáním IKM s parametrem XML IKM_HTTP_Encrypt_Obsah v konfiguračním souboru, který je do telefonu odesílán ze zřizovacího serveru.

  • Pokud toto šifrování použijete na konfigurační soubory odesílané ze zřizovacího serveru do telefonu, záhlaví HTTP Content-Encoding v konfiguračním souboru musí obsahovat aes192 gcm.

    Pokud toto záhlaví bude chybět, přednost bude dána metodě AES-256-CBC. Telefon použije dešifrování AES-256-CBC, pokud je v pravidle profilu klíč AES-256-CBC (bez ohledu na data IKM).

  • Pokud chcete, aby telefon použil toto šifrování na sestavy konfigurace odesílané na zřizovací server, v pravidle sestav nesmí být žádný klíč AES-256-CBC.

Volitelné argumenty resynchronizace

Volitelné argumenty, key, uid a pwd mohou být uvedeny společně uzavřené do hranatých závorek před adresami URL zadanými v parametrech Profile_Rule* .

klávesa

Možnost --key informuje telefon, že konfigurační soubor přijatý ze zřizovacího serveru je šifrován pomocí šifrování AES-256-CBC, pokud není v záhlaví Content-Encoding v souboru uvedeno šifrování aes ⦅_ph_36⦆ gcm . Vlastní klíč je zadán za výrazem --key ve formě řetězce. Klíč může být volitelně ve dvojitých uvozovkách ("). Telefon použije tento klíč k dešifrování konfiguračního souboru.

Příklady použití
 [--key VerySecretValue] [--key „moje tajná fráze“] [--key a37d2fb9055c1d04883a0745eb0917a4] 

Volitelné argumenty v závorkách se rozbalí makrem. Parametry pro zvláštní účel, GPP_SA až GPP_SD, se rozšiřují makrem na proměnné makra $SA až $SD, jen když se používají jako argumenty možnosti key. Viz tyto příklady:

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

V profilech otevřeného formátu musí být argument parametru --key stejný jako argument možnosti -k , která je předána příkazu openssl.

uid a pwd

Možnosti uid a pwd lze použít k zadání ID uživatele a hesla, které se odešlou jako odpověď na požadavky ověřování HTTP Basic a Digest, když je zadaná adresa URL požadována. Volitelné argumenty v závorkách se rozbalí makrem. Parametry pro zvláštní účel, GPP_SA až GPP_SD, se rozšiřují makrem na proměnné makra $SA až $SD, jen když se používají jako argumenty možnosti key. Viz tyto příklady:

GPP_SA = MojeUživatelskéID GPP_SB = MéHeslo 

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

se rozšíří na:

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

V parametrech profilu konfigurace se používají tyto datové typy:

  • {a,b,c,…} – volba mezi a, b, c,–

  • Bool – Logická hodnota „ano“ nebo „ne“.

  • CadScript – Miniskript, který určuje parametry kadence signálu. Až 127 znaků.

    Syntaxe: S1[;S2], kde:

    • Si=Di(oni,1/offi,1[,oni,2/offi,2[,oni,3/offi,3[,oni,4/offi,4[,oni,5/offi,5[,oni,6/offi,6]]]]) a označuje se jako část.

    • oni,j a offi,j jsou doba trvání zapnutí/vypnutí segmentu v sekundách. i = 1 nebo 2 a j = 1 až 6.

    • Di je celková doba trvání části v sekundách.

    Všechny doby trvání mohou mít až tři desetinná místa, aby se dalo dosáhnout rozlišení 1 ms. Zástupný znak „*“ znamená nekonečnou dobu trvání. Segmenty v části se přehrávají v daném pořadí a opakují se, dokud není dosaženo celkové doby přehrávání.

    Příklad 1:

     60(2/4) Počet sekcí kadence = 1 Oddíl 1 kadence: Délka sekce = 60 s Počet segmentů = 1 Segment 1: Zap=2s, vypnuto=4s Celková délka vyzvánění = 60 s 

    Příklad 2 – Jedinečné vyzvánění (krátký, krátký, krátký, dlouhý):

     60(.2/.2,.2/.2,.2/.2,1/4) Počet sekcí kadence = 1 Oddíl 1: Délka sekce = 60 s Počet segmentů = 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: Zap=1,0s, vypnuto=4,0s celková délka vyzvánění = 60 s 
  • DialPlanScript – Skriptovací syntaxe, která se používá k zadání plánů vytáčení linky 1 a linky 2.

  • Plovoucí– Hodnota plovoucího bodu až n desetinných míst.

  • FQDN – Plně kvalifikovaný název domény. Může obsahovat až 63 znaků. Toto jsou příklady:

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

    • sip.Cisco.com nebo 109.12.14.12

  • FreqScript – Miniskript, který určuje parametry frekvence a hlasitosti tónu. Obsahuje až 127 znaků.

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

    • F1–F6 jsou frekvence v Hz (pouze celá čísla bez znaménka).

    • L1–L6 jsou odpovídající úrovně v dBm (až s jedním desetinným místem).

    Bílé znaky před čárkou a po ní jsou povoleny, ale nejsou doporučovány.

    Příklad 1 – Tón čekajícího hovoru:

     440@-10 Počet frekvencí = 1 Frekvence 1 = 440 Hz při –10 dBm 

    Příklad 2 – Oznamovací tón:

     350@-19,440@-19 Počet frekvencí = 2 Frekvence 1 = 350 Hz při –19 dBm Frekvence 2 = 440 Hz při –19 dBm 
  • IP – Platná adresa IPv4 v podobě x.x.x.x, kde x je mezi 0 a 255. Příklad: 10.1.2.100.

  • UserID – ID uživatele, jak se zobrazuje v adrese URL; až 63 znaků.

  • Telefon – Řetězec telefonního čísla, například 14081234567, *69, *72, 345678, nebo obecná adresa URL, například 1234@10.10.10.100:5068 nebo jsmith@Cisco.com. Řetězec může obsahovat až 39 znaků.

  • PhTmplt – šablona telefonního čísla. Každá šablona může obsahovat jeden nebo více vzorů oddělených čárkou (,). Bílé znaky na začátku jednotlivých vzorů jsou ignorovány. Znaky „?“ a „*“ představují zástupné znaky. Chcete-li to vyjádřit doslovně, použijte %xx. For example, %2a představuje *. Šablona může obsahovat až 39 znaků. Příklady: „1408*, 1510*“, „1408123????, 555?1.“.

  • Port – číslo portu TCP/UDP (0–65535). Lze jej zadat v desítkovém nebo šestnáctkovém formátu.

  • ProvisioningRuleSyntax – Syntaxe skriptování, která se používá k definici pravidel resynchronizace konfigurace a upgradu firmwaru.

  • PwrLevel – Úroveň hlasitosti vyjádřená v dBm s jedním desetinným místem, např. −13,5 nebo 1,5 (dBm).

  • RscTmplt – šablona stavového kódu odpovědi SIP, například „404, 5*“, „61?“, „407, 408, 487, 481“. Může obsahovat až 39 znaků.

  • Sig – Podepsaná hodnota n-bitů. Lze jej zadat v desítkovém nebo šestnáctkovém formátu. Před zápornými hodnotami musí být znak „-“. Znak + před kladnými hodnotami je volitelný.

  • Kódy s hvězdičkou – Aktivační kód doplňkové služby, např. *69. Kód může obsahovat až 7 znaků.

  • Str – Obecný řetězec až s nevyhrazenými znaky.

  • Čas– Doba trvání v sekundách až n desetinných míst. Další zadaná desetinná místa jsou ignorována.

  • ToneScript – Miniskript, který určuje parametry frekvence, hlasitost a kadence tónu probíhajícího hovoru. Skript může obsahovat až 127 znaků.

    Syntaxe: FreqScript;Z1[;Z2].

    Oddíl Z1 je podobný oddílu S1 v části CadScript s tou výjimkou, že po každém segmentu zapnutí/vypnutí následuje parametr komponentu frekvence: Z1 = D1(oni,1/offi,1/fi,1[,oni,2/offi,2/fi,2 [,oni,3/offi,3/fi,3 [,oni,4/offi,4/fi,4 [,oni,5/offi,5/fi,5 [,oni,6/offi,6/fi,6]]]]) kde:

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

    • 1 < nk < 6 určuje komponenty frekvence v FreqScript, které se v daném segmentu používají.

    Pokud se v segmentu používá více než jedna komponenta frekvence, komponenty se sečtou.

    Příklad 1 – Oznamovací tón:

     350@-19,440@-19;10(*/0/1+2) Počet frekvencí = 2 Frekvence 1 = 350 Hz při –19 dBm Frekvence 2 = 440 Hz při –19 dBm Počet sekcí kadence = 1 Sekce kadence 1: Délka sekce = 10 s Počet segmentů = 1 Segment 1: On=forever, s frekvencemi 1 a 2 Celková délka tónu = 10 s 

    Příklad 2 – Přerušovaný tón:

     350@-19,440@-19;2(.1/.1/1+2);10(*/0/1+2) Počet frekvencí = 2 Frekvence 1 = 350 Hz při –19 dBm Frekvence 2 = 440 Hz při –19 dBm Počet sekcí kadence = 2 Sekce kadence 1: Délka sekce = 2 s Počet segmentů = 1 Segment 1: On=0.1s, Off=0.1s s frekvencemi 1 a 2 Kadence, oddíl 2: Délka sekce = 10 s Počet segmentů = 1 Segment 1: On=forever, s frekvencemi 1 a 2 Celková délka tónu = 12 s 
  • Uns – Nepodepsaná n-bitová hodnota, kde n = 8, 16 nebo 32. Lze ji zadat v desítkovém nebo šestnáctkovém formátu, např. 12 nebo 0x18, pokud se hodnota vejde do n bitů.

Mějte na paměti následující:

  • představuje název parametru konfigurace. Odpovídající značka v profilu je vytvořena záměnou mezery za podtržítko „_“, jako je například Par_název.
  • Prázdné výchozí pole hodnoty znamená prázdný řetězec < “” >.
  • Telefon u značek, které nejsou přítomny v daném profilu, poslední nakonfigurované hodnoty.
  • Šablony se srovnávají v zadaném pořadí. Je vybrána první shoda, nikoli nejbližší. Název parametru se musí shodovat přesně.
  • Pokud je v profilu zadána více než jedna definice parametru, v telefonu začne platit poslední taková definice v souboru.
  • Specifikace parametru s prázdnou hodnotou parametru vynutí parametr zpět na výchozí hodnotu. Pokud chcete místo toho zadat prázdný řetězec, použijte jako hodnotu parametru prázdný řetězec "".