Konfigurace telefonu pro resynchronizaci profilu

Telefon podporuje více síťových protokolů k načítání konfiguračních profilů. Nejzákladnější protokol pro přenos profilu je TFTP (RFC1350). Protokol TFTP je široce využíván 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 jít o praktickou možnost při nasazování v malé organizace pro předběžné zřizování na pracovišti a při vývoji 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

K vytvoření konfiguračního profilu použijte textový editor.

Pokud chcete později ověřit, zda byl profil do telefonu zajištěn, můžete některé hodnoty nastavit jako značky. Například nastavte hodnotu GPP_A na 12345678, jak je uvedeno v následujícím příkladu:
<flat-profile>
  <GPP_A> 12345678
  </GPP_A>
</flat-profile>
4

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

Že je server TFTP správně nakonfigurován, můžete ověřit takto: 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 pro správu. Předpokládejte například, že adresa IP telefonu je 192.168.1.100. Ve webovém prohlížeči otevřete následující adresu URL:

http://192.168.1.100/admin/advanced
6

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

7

Znovu synchronizujte testovací telefon s konfiguračním profilem, který jste vytvořili, otevřením adresy URL pro resynchronizaci 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 konfigurace zařízení basic.txt. Telefon poté analyzuje stažený soubor a aktualizuje parametr GPP_A na hodnotu 12345678.

8

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

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

1

Zjistěte 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 (místo xxxx zadejte číslo modelu a místo macaddress adresu 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 možnosti Hlas  > Zřizování.

6

Zadejte cestu k souboru profilu do pole Pravidlo profilu.

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

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

Klikněte na tlačítko Submit All Changes. 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

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

3

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

4

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

Za předpokladu, že se server HTTP nachází na adrese 192.168.1.300 a název souboru profilu je basic.txt, zadejte následující hodnotu:

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

Klikněte na tlačítko Submit All Changes. 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, že se v protokolu uživatelských agentů objevují údaje identifikující testovací telefon.

Součástí tohoto údaje 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_Rule 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 možnosti Hlas  > Zřizování.

3

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

4

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

5

Klikněte na tlačítko 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

Sledujte výsledné zprávy ve sledování syslogu.

7

Pole Resynchronizace při restartování musí být nastaveno na Ano.

<Resync_On_Reset>Yes</Resync_On_Reset>
8

Telefon restartujte, a vynuťte tak resynchronizaci se zřizovacím serverem.

Pokud se resynchronizace z nějakého důvodu nezdaří, například když server neodpovídá, jednotka počká (počet sekund nakonfigurovaný v parametru Prodleva opakování po chybě resynchronizace)a poté se znovu pokusí o resynchronizaci. Pokud je parametr Prodleva opakování po chybě resynchronizace nastaven na nulu, telefon se po neúspěšném pokusu o resynchronizaci nepokusí ji provést znovu.

9

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

<Resync_Error_Retry_Delay>30</Resync_Error_Retry_Delay>
10

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

Následující tabulka definuje funkci a použití parametrů opakované synchronizace profilu v částiKonfigurační profilna kartě Hlas > Zřizování na webové stránce telefonu. Definuje také syntaxi řetězce, který je přidán do konfiguračního souboru telefonu (cfg.xml) s kódem XML (cfg.xml) za účelem konfigurace parametru.

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 kódem XML (cfg.xml) zadejte řetězec v tomto formátu:

    <Provision_Enable ua="na">Yes</Provision_Enable>
  • Na webové stránce telefonu nastavte toto pole na Yes pro povolení akcí resynchronizace nebo No pro blokování akcí resynchronizace.

Výchozí hodnota: Ano

Resynchronizace při restartování

Určuje, zda telefon po zapnutí a po každém pokusu o upgrade znovu synchronizuje konfigurace se serverem zřizování.

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

    <Resync_On_Reset ua="na">Yes</Resync_On_Reset>
  • Na webové stránce telefonu nastavte toto pole na hodnotu Ano, pokud chcete povolit resynchronizaci při zapnutí nebo resetování, nebo na hodnotu Ne, pokud chcete zablokovat resynchronizaci při zapnutí nebo resetování.

Výchozí hodnota: 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 počáteční konfiguraci. Toto zpoždění je účinné pouze při prvním pokusu o konfiguraci po zapnutí nebo resetu zařízení.

Parametr představuje maximální časový interval, po který zařízení čeká, než naváže kontakt se zřizovacím serverem. Skutečné zpoždění je náhodné číslo mezi 0 a touto hodnotou.

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

Rozmezí platných hodnot je 0 až 65 535.

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

    <Resync_Random_Delay ua="na">2</Resync_Random_Delay>
  • Na webové stránce telefonu zadejte počet jednotek (20 sekund), o které má telefon zpozdit resynchronizaci po zapnutí nebo resetu.

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 kódem XML (cfg.xml) zadejte řetězec v tomto formátu:

    <Resync_At__HHmm_ ua="na">0959</Resync_At__HHmm_>
  • Na webové stránce telefonu zadejte čas ve formátu HHMM, kdy 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 spustí 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 + náhodná_prodleva). Pokud je například náhodná prodleva = (resynchronizace po náhodné prodlevě + 30)/60 minut, pro výpočet konečného intervalu náhodné_prodlevy je vstupní hodnota v sekundách převedena na minuty a je zaokrouhlena na následující minutu.

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

    <Resync_At_Random_Delay ua="na">600</Resync_At_Random_Delay>
  • Na webové stránce telefonu zadejte časový úsek v sekundách.

Rozmezí platných hodnot je 0 až 65 535.

Pokud je hodnota menší než 600, je náhodné vnitřní zpoždění v rozmezí 0 až 600.

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

Pravidelná resynchronizace

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

Platné formáty:

  • 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 kódem XML (cfg.xml) zadejte řetězec v tomto formátu:

    <Resync_Periodic ua="na">3600</Resync_Periodic>
  • Na webové stránce telefonu zadejte časový úsek v sekundách.

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

Výchozí hodnota je 3600 sekund.

Prodleva opakování po chybě resynchronizace

Pokud se resynchronizace nezdaří, protože telefon nedokázal 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:

  • Celé číslo

    Příklad: Vstup 300 značí, ž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 resynchronizaci 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 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 neúspěšném pokusu o resynchronizaci.

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 kódem XML (cfg.xml) zadejte řetězec v tomto formátu:

    <Resync_Error_Retry_Delay ua="na">60,120,240,480,960,1920,3840,7680,15360,30720,61440,86400</Resync_Error_Retry_Delay>
  • Na webové stránce telefonu zadejte časový úsek v sekundách.

Výchozí nastavení: 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 výchozí hodnota čítače. Události resynchronizace jsou odloženy, dokud tento čítač neklesne na nulu.

Rozmezí platných hodnot je 0 až 65 535.

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

    <Forced_Resync_Delay ua="na">14400</Forced_Resync_Delay>
  • Na webové stránce telefonu zadejte časový úsek v sekundách.

Výchozí hodnota je 14,400 sekund.

Resynchronizace ze SIP

Řídí požadavky na operace resynchronizace prostřednictvím události SIP NOTIFY odeslané z proxy serveru poskytovatele služeb do telefonu. Pokud je tato funkce povolena, může proxy server požádat o resynchronizaci odesláním zprávy SIP NOTIFY obsahující hlavičku Událost: resynchronizace do zařízení.

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

    <Resync_From_SIP ua="na">Yes</Resync_From_SIP>
  • Na webové stránce telefonu vyberte možnost Ano, pokud chcete tuto funkci povolit, nebo Ne, pokud ji chcete zakázat.

Výchozí hodnota: 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 spustí po upgradu firmwaru.

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

    <Resync_After_Upgrade_Attempt ua="na">Yes</Resync_After_Upgrade_Attempt>
  • Na webové stránce telefonu vyberte možnost Ano pro spuštění resynchronizace po upgradu firmwaru nebo Ne pro obnovení synchronizace.

Výchozí hodnota: Ano

Spouštěcí událost resynchronizace 1

Spouštěcí událost resynchronizace 2

Pokud je logická rovnice v těchto parametrech vyhodnocena jako FALSE, resynchronizace se nespustí, ani když je položka Resynchronizovat při resetování nastavena na hodnotu TRUE. Pouze resynchronizace prostřednictvím přímé akce URL a oznámení SIP ignoruje tyto spouštěče resynchronizace.

Parametr lze naprogramovat pomocí podmíněného výrazu, který podléhá rozšíření makra. Platná rozšíření maker najdete v tématu proměnné rozšíření maker v části parametry zřizování.

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

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

    <Resync_Trigger_2 ua="na"/>

  • Na webové stránce telefonu zadejte spouštěcí události.

Výchozí hodnota: Prázdný

Uživatelsky konfigurovatelná resynchronizace

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

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

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

  • Na webové stránce telefonu vyberte možnost Ano pro zobrazení parametru Pravidlo profilu v nabídce telefonu, nebo vyberte Ne pro skrytí tohoto parametru.

Výchozí hodnota: Ano

Resynchronizace se nezdaří při FNF

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

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

    <Resync_Fails_On_FNF ua="na">Yes</Resync_Fails_On_FNF>
  • Na webové stránce telefonu vyberte možnost Ano, aby byla odpověď file-not-found považována za neúspěšnou resynchronizaci, nebo vyberte možnost Ne, aby byla odpověď file-not-found považována za úspěšnou resynchronizaci,

Výchozí hodnota: Ano

Typ ověření profilu

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

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

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

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

    • Pokud je Typ ověření XSI pro telefon nastaven na hodnotu Přihlašovací údaje, použijí se přihlašovací údaje XSI.

    • Pokud je Typ ověření XSI pro telefon nastaven na hodnotu Přihlašovací údaje SIP, použijí se přihlašovací údaje XSI SIP.

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

    <Profile_Authentication_Type ua="na">Basic Http Authentication</Profile_Authentication_Type>
  • Na webové stránce telefonu vyberte ze seznamu možnost telefonu pro ověření resynchronizace profilu.

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

Další informace naleznete v tématu Zadání typu ověřování profilu v části Zadejte telefon pro opětovnou synchronizaci 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é resynchronizaci 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:

[--key <šifrovací klíč>]

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

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

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

    <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žnost DHCP

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

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

Možnost použití DHCPv6

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

Výchozí nastavení: 17,160,159

Telefony můžete zřizovat prostřednictvím 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=Resync:[profile-rule]/></CP-xxxx-3PCCExecute>

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

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 přímo 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 zadaný 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.

Například následující Profile_Rule si vyžádá soubor profilu ($PN.cfg) v podsložce 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_Rule>
tftp://prov.telco.com:6900/cisco/config/$PN.cfg
</Profile_Rule>

Profil lze u jednotlivých telefonů identifikovat pomocí obecného parametru, na jehož hodnotu se odkáže v obecném pravidle profilu pomocí rozšíření makra.

Dejme tomu, že je GPP_B definováno jako Dj6Lmp23Q.

Profile_Rule má hodnotu:

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

Když se zařízení resynchronizuje a makra jsou rozšířena, telefon s adresou 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 profil zřizování do telefonu. Při prvním pokusu o resynchronizaci a stažení konfiguračního souboru, kdy telefon obdrží chybu ověření HTTP nebo HTTPS 401, jsou vyžadovány ověřovací informace. Pokud tuto funkci povolíte, zobrazí se v telefonu obrazovka Nastavení účtu profilu v následujících situacích:

  • Pokud při prvním zřízení po restartu telefonu dojde k chybě ověření HTTP nebo HTTPs 401.

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

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

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

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

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

  • Pokud do pole Pravidlo profilu zadáte správnou adresu URL bez uživatelského jména a hesla, telefon bude pro opětovnou synchronizaci profilu vyžadovat ověření nebo hodnotu hash. Se správným účtem profilu ověření projde. Při použití nesprávného účtu profilu se ověření nezdaří.

  • Pokud do pole Pravidlo profilu zadáte správnou adresu URL se správným uživatelským jménem a heslem, telefon bude pro opětovnou synchronizaci profilu vyžadovat ověření nebo hodnotu hash. Účet profilu se nepoužívá pro resynchronizaci telefonu. Přihlášení bylo úspěšné.

  • Pokud do pole Pravidlo profilu zadáte správnou adresu URL s nesprávným uživatelským jménem a heslem, telefon bude pro opětovnou synchronizaci profilu vyžadovat ověření nebo hodnotu hash. Účet profilu se není používán pro resynchronizaci telefonu. Přihlášení vždy selže.

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

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

Typ ověření 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 možnosti Hlas > Zřizování.

3

V části Profil konfigurace nastavte parametr Typ ověření profilu a určete pověření, které se má použít pro ověření účtu profilu.

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

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

Možnosti:

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

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

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

    Pokud je Typ ověření XSI pro telefon nastaven na hodnotu Přihlašovací údaje, použijí se přihlašovací údaje XSI.

    Pokud je Typ ověření XSI pro telefon nastaven na hodnotu Přihlašovací údaje SIP, použijí se přihlašovací údaje XSI SIP.

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

4

Klikněte na tlačítko Submit All Changes.

Ruční použití profilu v telefonu

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

1

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

2

Na počítači spusťte aplikaci serveru TFTP a zkontrolujte, ž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://<Adresa_IP_WAN>/admin/resync?tftp://<Adresa_IP_počítače>/<název_souboru>&xuser=admin&xpassword=<heslo>

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

Pomocí 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.

Příklady v této části používají konfigurační profily se syntaxí XML.

Konfigurační profil definuje hodnoty parametrů telefonu.

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


 
Je podporována pouze znaková sada UTF-8. Když upravujete profil v editoru, neměňte formát kódování. Jinak telefon soubor nerozpozná.

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

Otevřený 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 k vytváření konfiguračního souboru umožňuje použití standardních nástrojů. Konfigurační soubor XML může být odeslán ze serveru zřizování do telefonu během operace resynchronizace bez kompilace jako binární objekt.

Telefon dokáže přijímat formáty konfigurace, které standardní nástroje generují. Tato funkce usnadňuje vývoj back-endového softwaru zřizovacích serverů, který generuje profily konfigurace z existují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 můžete 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í prvky

  • Komentáře XML

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

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

Telefon rozpoznává elementy se správnými názvy parametrů, které jsou součástí speciálního elementu <flat-profile>.

Vlastnosti značek prvků

Při vytváření nebo aktualizaci konfiguračního souboru mějte na paměti následující pravidla.

  • Formát zřizování XML a webové uživatelské rozhraní umožňují konfiguraci stejného nastavení. Názvy značky 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 místo mezer ve webovém uživatelském rozhraní.

  • Telefon rozpoznává elementy se správnými názvy parametrů, které jsou součástí speciálního elementu <flat-profile>.

  • Názvy elementů se uzavírají do špičatých závorek.

  • Většina názvů prvků 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 pole webu nahraďte všechny mezery a speciální znaky [, ], (, )/ podtržítky.

      Příklad: Element <Resync_On_Reset> odpovídá poli Resync On Reset.

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

      Příklad: Element <Dial_Plan_1_> odpovídá poli Dial Plan pro linku 1.

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

    <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>
  • U značek elementů záleží na velikosti písmen.

  • Prázdné značky elementů jsou povolené 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 využí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:

    <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>
  • Pokud chcete příslušný parametr nastavit na prázdný řetězec, použijte prázdnou hodnotu. Zadejte otevírací a koncový element a mezi ně nezadávejte žádnou hodnotu. V následujícím příkladu je parametr GPP_A nastaven jako prázdný řetězec.

    <flat-profile><GPP_A>  </GPP_A></flat-profile>
  • Nerozpoznané názvy elementů jsou ignorovány.

Vlastnosti parametru

Parametry mají následující 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 je možné přidávat pomocí standardní syntaxe XML.

    <!-- Můj komentář je napsán zde -->
  • 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 je ignoruje.

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

    Zvláštní znak

    Kód znaku XML

    & (ampersand)

    &amp;

    < (menší než)

    &lt;

    > (větší než)

    &gt;

    ’ (apostrof)

    &apos;

    ” (dvojité uvozovky)

    &quot;

    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 plán číslování informační linky, který nastavuje parametr (Přihlášení správce > Pokročilé > Hlas > Linka (n)) na (S0 <:18005551212>).

    <flat-profile> <Dial_Plan_1_> (S0 &lt;:18005551212&gt;) </Dial_Plan_1_></flat-profile>
  • Řídící číselné znaky pomocí desítkových a šestnáctkových hodnot (s.a. &#40;&#x2e;) 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 je možné také na ochranu důvěrných údajů zašifrovat. Komprese není vyžadována, ale musí být provedena před zašifrováním.

Komprese otevřeného profilu

Podporovaná metoda komprese je kompresní 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 hlavičky staženého souboru, aby určil jeho formát.

Pokud je například profile.xml platný profil, soubor profile.xml.gz je také přijat. Tento profil mohou vygenerovat oba následující příkazy:

  • >gzip profile.xml

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

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

    Nechá 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. Když používáte kompresi, 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 rozsáhlých nasazeních.

Telefon podporuje dvě metoddy š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 třeba pro jednotku předem zřídit klíč nebo data IKM (Input Keying Material). Samozavedení tajného klíče lze zabezpečeně provést pomocí protokolu HTTPS.

Název konfiguračního souboru nemusí mít 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 otestová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 # analogické vyvolání komprimovaného souboru XML openssl enc –e –aes-256-cbc –k SecretPhrase1234 –in profile.xml.gz –out profile.cfg 

Malé -k následované 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šifrovaní souboru informován o hodnotě tajného klíče. Tato hodnota je zadána jako modifikátor adresy URL profilu. Syntaxe je za použití explicitní adresy URL tato:

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

Toto je 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ím makra před vyhodnocením procházejí tyto parametry:

  • Resync_Trigger_*

  • Profile_Rule*

  • Log_xxx_Msg

  • Upgrade_Rule

Za určitých podmínek některé obecné parametry (GPP_*) také procházejí rozšířením makra, jak je explicitně uvedeno v části Volitelné argumenty opětovné synchronizace 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 rozšiřující proměnné maker 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: $STRANGE000E08012345.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 výrazy jsou jako makro rozšíření pouze jako argument možností --key, --uid--pwd v adrese URL resynchronizace.

Podmíněné výrazy

Podmíněné výrazy mohou spouštět událost resynchronizace s volit mezi alternativními adresami URL při operaci resynchronizace a upgradu.

Podmíněné výrazy se skládají ze seznamu srovnání oddělených operátorem a. 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 typů hodnot:

  • Celočíselné hodnoty

  • Čísla verzí softwaru a hardwaru

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

Čísla verzí

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

PHONEOSyyyy.1-0-1-0001-BN

kde yyyy označuje model nebo řadu telefonu; 1 je hlavní verze; 0 je vedlejší 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 porovnávání verze softwaru se postupně porovnávají hlavní verze, vedlejší verze a mikroverze, přičemž číslice nejvíce nalevo mají přednost před posledními. Pokud jsou čísla verzí shodná, porovnává se číslo sestavení.

Příklady platného čísla verze

PHONEOS-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.

Operátor

Alternativní syntax

Popis

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

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

=

eq

rovná se

Ano

Ano

!=

ne

nerovná se

Ano

Ano

<

lt

menší než

Ano

Ne

<=

le

menší nebo rovno

Ano

Ne

>

gt

větší než

Ano

Ne

>=

ge

větší nebo rovno

Ano

Ne

A

a

Ano

Ano

Tam, kde je očekávána hodnota řetězce, je důležité proměnné makra uzavírat do dvojitých uvozovek. Nedělejte to tam, kde se očekává číslo nebo číslo verze.

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

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

Uvedenou syntax se závorkami nepoužívejte ke konfiguraci parametrů Resync_Trigger*.

Syntax URL

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

[ protokol:// ] [ server [:port]] cesta k souboru

Kde protokol je jedna z těchto hodnot:

  • tftp

  • http

  • https

Při vynechání hodnoty protokol se předpokládá tftp. Server může být název hostitele rozpoznávaný 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í hodnota 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í hodnota port, používá 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 nesmí chybět. Není třeba nutně odkazovat na statický soubor, ale je možné zadat dynamický obsah získaný prostřednictvím skriptu 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 aktualizace v současné době 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 konfiguračních souborů pro protokol HTTP pomocí metody RFC 8188. Pomocí této metody šifrování může jakákoli entita číst záhlaví zpráv HTTP. Datovou část však mohou číst jen 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 monitrování.

Parametr konfigurace XML IKM_HTTP_Encrypt_Content v telefonu obsahuje data IKM. Z důvodů zabezpečení není tento parametr přístupný na webové stránce správy telefonu. Ani 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 třeba splnit následující podmínky:

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

  • Pokud toto šifrování chcete použít 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 hodnotu aes128gcm. aes128gcm.

    Pokud toto záhlaví bude chybět, přednost bude dána metodě AES-256-CBC. Telefon použije šifrování AES-256-CBC, jestliže 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, and pwd, , mohou být uvedeny společně uzavřené do hranatých závorek před adresami URL zadanými v parametrech Profile_Rule*.

key

Možnost --key informuje telefon, že pro konfigurační soubor přijatý ze zřizovacího serveru je použito šifrování AES-256-CBC, pokud není v záhlaví Content-Encoding v souboru uvedeno šifrování aes128gcm. aes128gcm šifrování. 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 “my secret phrase”][--key a37d2fb9055c1d04883a0745eb0917a4]

Volitelné argumenty v závorkách podléhají rozšíření makra. Parametry pro zvláštní účel, GPP_SA až GPP_SD, se rozšiřují makrem na hodnoty 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é budou odeslány jako odpověď na výzvy k ověření HTTP Basic a Digest při vyžádání zadané adresy URL. Volitelné argumenty v závorkách podléhají rozšíření makra. Parametry pro zvláštní účel, GPP_SA až GPP_SD, se rozšiřují makrem na hodnoty makra $SA až $SD, jen když se používají jako argumenty možnosti key. Viz tyto příklady:

GPP_SA = ID uživatele GPP_SB = Heslo_tajemství 

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

se rozšíří na:

[--uid MyUserID --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ý definuje parametry kadence signálu. Až 127 znaků.

    Syntax: 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 doby trvání vypnutí a zapnutí segmentu. 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 přesnosti 1 ms. Zástupný znak „*“ znamená nekonečně dlouhé 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 úseků kadence = 1 Kadence Sekce 1: Délka sekce = 60 s Počet segmentů = 1 Segment 1: Zapnuto = 2s, vypnuto = 4s Celková délka kroužku = 60s 

    Příklad 2 – Rozpoznatelné zvonění (krátký, krátký, krátký, dlouhý):

     60(.2/.2,.2/.2,.2/.2,1/4) Počet úseků kadence = 1 kadence Sekce 1: Délka sekce = 60s Počet segmentů = 4 Segment 1: Zapnuto = 0,2 s, vypnuto = 0,2 s Segment 2: zapnuto = 0,2 s, vypnuto = 0,2s Segment 3: zapnuto = 0,2 s, vypnuto = 0,2s Segment 4: zapnuto = 1,0 s, vypnuto = 4,0 s Celková délka kroužku = 60s 
  • DialPlanScript – Skriptovací syntaxe, která se používá u zadání plánů číslování linky 1 a linky 2.

  • Float<n> – Hodnota s plovoucí desetinnou čárkou a až n desetinnými místy.

  • 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ů.

    Syntax: 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í hlasitosti 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. Například: 10.1.2.100.

  • UserID – ID uživatele, jak se uvádí 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 čárkami (,). Bílý znaky na začátku jednotlivých vzorů jsou ignorovány. „?“ a „*“ představují zástupné znaky. Pokud chcete uvést přímo je, použijte %xx. Například %2a představuje *. Šablona může obsahovat až 39 znaků. Například: “1408*, 1510*”, “1408123????, 555?1.”.

  • Port – Číslo portu TCP/UDP (0–65535). Zadání je možné 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ř. “404, 5*”, “61?”, “407, 408, 487, 481”. Může obsahovat až 39 znaků.

  • Sig<n> – N-bitová hodnota se znaménkem. Zadání je možné 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čkami – Aktivační kód doplňkové služby, např. *69. Kód může obsahovat až 7 znaků.

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

  • Time<n> – 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ů.

    Syntax: FreqScript;Z1[;Z2].

    Oddíl Z1 je podobný jako oddíl S1 v části CadScript s tou výjimkou, že po každém segmentu zapnuto/vypnuto 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 části FreqScript, které se v daném segmentu používají.

    Pokud se v segmentu používá více než jeden komponent 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 úseků kadence = 1 Kadence Sekce 1: Délka sekce = 10 s Počet segmentů = 1 Segment 1: Zapnuto = navždy, s frekvencemi 1 a 2 Celková délka tónu = 10s 

    Příklad 2 – Tón čeká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 úseků kadence = 2 Kadence Sekce 1: Délka sekce = 2s Počet segmentů = 1 Segment 1: Zapnuto = 0,1 s, vypnuto = 0,1 s frekvencí 1 a 2 Kadence Část 2: Délka sekce = 10s Počet segmentů = 1 Segment 1: Zapnuto = navždy, s frekvencemi 1 a 2 celková délka tónu = 12s 
  • Uns<n> – nezapsaná n-bitová hodnota, kde n = 8, 16 nebo 32. Může být zadána v desítkovém nebo šestnáctkovém formátu, například 12 nebo 0x18, pokud se hodnota vejde do n bitů.


 

Mějte na paměti toto:

  • <Par Name> představuje název parametru konfigurace. V profilu se odpovídající značka vytvoří nahrazením mezery podtržítkem "_", např. Par_Name.
  • Prázdné pole výchozí hodnoty představuje 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, ne ta nejlepší. Název parametru musí odpovídat přesně.
  • Pokud je v profilu zadána více než jedna definice parametru, v telefonu začne platit poslední taková definice v souboru.
  • Zadání parametru na prázdnou hodnotu vrátí parametr na výchozí hodnotu. Pokud chcete místo toho zadat prázdný řetězec, použijte jako hodnotu parametru prázdný řetězec "".