Конфигуриране на телефона за повторно синхронизиране на профила

Повторно синхронизиране на профила на телефона през TFTP

Телефонът поддържа множество мрежови протоколи за извличане на профили за конфигуриране. най-основният протокол за прехвърляне на профили е TFTP (RFC1350). TFTP се използва широко за обезпечаване на мрежови устройства в частни LAN мрежи. Въпреки че не се препоръчва за разполагане на отдалечени крайни точки в интернет, TFTP може да бъде удобен за разполагане в рамките на малки организации, за домашно обезпечаване, както и за разработване и тестване. В следната процедура профилът се променя след изтегляне на файл от TFTP сървър.

1

В рамките на LAN среда свържете компютъра и телефона към хъб, превключвател или малък маршрутизатор.

2

На компютъра инсталирайте и активирайте TFTP сървър.

3

Използвайте текстов редактор, за да създадете профил за конфигуриране.

За да проверите дали профилът е осигурен за телефона по-късно, можете да зададете някои от стойностите като марки. Например задайте стойността за GPP_A на 12345678, както е показано в следния пример:
 <flat-profile>   <GPP_A> 12345678   A> </flat-profile>
_
4

Запишете XML конфигурационния файл в главната директория на TFTP сървъра.

Можете да проверите дали TFTP сървърът е конфигуриран правилно: заявете файла с конфигурационния профил, като използвате TFTP клиент, различен от телефона. За предпочитане използвайте TFTP клиент, който работи на отделен хост от сървъра за обезпечаване.

5

В уеб браузъра на компютъра отворете уеб страницата за администриране. Например да предположим, че IP адресът на телефона е 192.168.1.100, отворете следния URL в уеб браузъра си:


http://192.168.1.100/admin/advanced
6

Изберете раздела Глас > Обезпечаване и проверете стойностите на параметрите с общо предназначение GPP_A до GPP_P. Те трябва да са празни.

7

Синхронизирайте отново тестовия телефон с конфигурационния профил, който сте създали, като отворите URL адреса за повторно синхронизиране в уеб браузър.

Пример:

Ако IP адресът на TFTP сървъра е 192.168.1.200, командата трябва да бъде подобна на следния пример:


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

Когато телефонът получи тази команда, устройството на адрес 192.168.1.100 иска файла с профила за конфигуриране basic.txt от TFTP сървъра на IP адрес 192.168.1.200. След това телефонът сканира изтегления файл и актуализира параметъра GPP_ със стойност 12345678.

8

Проверете дали параметърът е актуализиран правилно. Опреснете уеб страницата за администриране и отидете на Глас > Осигуряване.

Параметърът GPP_А сега трябва да съдържа стойността 12345678.

Обезпечаване на специфичен за телефона профил на TFTP сървър
1

Получете MAC адреса на телефона от етикета на продукта. (MAC адресът е числото, използващо цифри и шестнадесетични цифри с малки букви, например 000e08aabbcc.

2

Преименувайте конфигурационния си файл на CP-xxxx macaddress.cfg (за замяна на xxxx с номера на модела и macaddress с MAC адреса на телефона).

Пример:

CP-8875 000e08aabbcc.cfg

3

Преместете новия файл във виртуалната корнева директория на TFTP сървъра.

4

Отворете уеб страницата за администриране на телефона.

5

Изберете Глас  > Осигуряване.

6

Въведете пътя на файла на профила в полето Правило на профила .

Пример: Да предположим, че IP адресът на TFTP сървъра е 192.168.1.200 и името на файла на профила е 

 <Profile_правило> tftp://192.168.1.200/CP-8875$MA.cfg правило>
rofile_
7

Щракнете върху Изпращане на всички промени. Това води до незабавно рестартиране и повторно синхронизиране.

При следващото повторно синхронизиране телефонът извлича новия файл чрез разширяване на макро израза $MA в неговия МАС адрес.

Повторно синхронизиране на профила на телефона с HTTP GET
1

Инсталирайте HTTP сървър на локалния компютър или друг достъпен хост.

Сървърът с отворен код Apache може да бъде изтеглен от интернет.

2

Качете файла с профила за конфигуриране във виртуалната главна директория на инсталирания сървър.

3

За да проверите правилното инсталиране на сървъра и достъпа до файла на профила, отворете профила с уеб браузър.

4

Променете правилото Profile_на тестовия телефон така, че да сочи към HTTP сървъра вместо към TFTP сървъра, така че да изтегля профила си периодично.

Например, ако приемем, че HTTP сървърът е на адрес 192.168.1.300, а името на файла на профила е basic.txt, въведете следната стойност:

<Profile_правило> http://192.168.1.200/basic.txt правило>
rofile_
5

Щракнете върху Изпращане на всички промени. Това води до незабавно рестартиране и повторно синхронизиране.

6

Наблюдавайте съобщенията syslog, които се изпращат от телефона. Периодичното повторно синхронизиране сега трябва да получава профила от HTTP сървър.

7

В регистрационните файлове на HTTP сървъра наблюдавайте как информацията, която идентифицира тестовия телефон, се появява в регистрационния файл на потребителските агенти.

Тази информация трябва да включва производителя, името на продукта, текущата версия на фърмуера и серийния номер.

Автоматично повторно синхронизиране на профила на телефона

Устройството може периодично да се синхронизира повторно със сървъра за обезпечаване, за да гарантира, че всички промени в профила, направени на сървъра, се разпространяват в крайното устройство (за разлика от изпращане на изрична заявка за повторно синхронизиране към крайната точка).

За да се предизвика периодично повторно синхронизиране на телефона със сървър, URL на профила за конфигуриране се дефинира чрез използване на параметъра Profile_правило, а периодът на повторно синхронизиране се дефинира чрез използване на параметъра Resync_Periodic.

1

Отворете уеб страницата за администриране на телефона.

2

Изберете Глас  > Осигуряване.

3

Дефинирайте параметъра Profile_правило. Този пример предполага IP адрес на TFTP сървър от 192.168.1.200.

4

В полето Периодично повторно синхронизиране въведете малка стойност за тестване, например 30 секунди.

5

Щракнете върху Изпращане на всички промени.

С новите настройки на параметъра телефонът се синхронизира повторно два пъти в минута с конфигурационния файл, посочен от URL.

6

Наблюдавайте получените съобщения в трасирането на syslog.

7

Уверете се, че полето Повторно синхронизиране при нулиране е зададено на Да.

 <Resync_On_Reset>ДаOn_Reset>
esync_
8

Включете телефона, за да го принудите да се синхронизира повторно със сървъра за обезпечаване.

Ако операцията за повторно синхронизиране е неуспешна по някаква причина, например ако сървърът не отговаря, модулът изчаква (за броя секунди, конфигуриран в Закъснение при повторен опит на грешка при повторно синхронизиране), преди да направи нов опит за повторно синхронизиране. Ако забавянето на повторен опит на грешка при повторно синхронизиране е нула, телефонът не прави опит за повторно синхронизиране след неуспешен опит за повторно синхронизиране.

9

(По избор) Задайте стойността на полето Повторен опит за закъснение на грешка при повторно синхронизиране на малка цифра, например 30.

 <Resync_Error_Retry_Delay>30Error_Retry_Delay>
esync_
10

Деактивирайте TFTP сървъра и наблюдавайте резултатите в изхода на syslog.

Параметри за повторно синхронизиране на профила

Следващата таблица дефинира функциите и използването на параметрите за повторно синхронизиране на профила в секцията Профил за конфигуриране в раздела Глас > Обезпечаване на уеб страницата на телефона. Освен това дефинира синтаксиса на низа, който се добавя към конфигурационния файл на телефона (cfg.xml) с XML код за конфигуриране на параметър.

Таблица 1. Параметри за повторно синхронизиране на профила

Параметър

Описание

Разрешаване на осигуряване

Позволява или отказва действия за повторно синхронизиране на профила за конфигуриране.

  • В конфигурационния файл на телефона (cfg.xml) с XML въведете низ в следния формат:

    <Provision_Enable ua="na">ДаEnable>rovision_

  • На уеб страницата на телефона задайте това поле на Да , за да разрешите действията за повторно синхронизиране, или Не , за да блокирате действията за повторно синхронизиране.

По подразбиране: Да

Повторно синхронизиране при нулиране

Указва дали телефонът синхронизира повторно конфигурациите със сървъра за обезпечаване след включване и след всеки опит за надграждане.

  • В конфигурационния файл на телефона (cfg.xml) с XML въведете низ в следния формат:

    <Resync_On_Reset ua="na">ДаOn_Reset>esync_

  • На уеб страницата на телефона задайте това поле на Да , за да разрешите повторното синхронизиране при включване или нулиране, или Не , за да блокирате повторното синхронизиране при включване или нулиране.

По подразбиране: Да

Произволно закъснение при повторно синхронизиране

Предотвратява претоварването на сървъра за обезпечаване при едновременно включване на голям брой устройства и опит за първоначална конфигурация. Това закъснение е ефективно само при първоначалния опит за конфигуриране след включване или нулиране на устройството.

Параметърът е максималният интервал от време, който устройството изчаква, преди да осъществи контакт със сървъра за обезпечаване. Действителното закъснение е псевдо случайно число между 0 и тази стойност.

Този параметър е в единици от 20 секунди.

Валидната стойност варира между 0 и 65535.

  • В конфигурационния файл на телефона (cfg.xml) с XML въведете низ в следния формат:

    <Resync_Random_Delay ua="na">2Random_Delay>esync_

  • На уеб страницата на телефона задайте броя на единиците (20 секунди), които телефонът да забави повторното синхронизиране след включване или нулиране.

Стойността по подразбиране е 2 (40 секунди).

Повторно синхронизиране при (ЧЧмм)

Времето (ЧЧмм), през което телефонът се синхронизира повторно със сървъра за обезпечаване.

Стойността за това поле трябва да е четирицифрено число в диапазона от 0000 до 2400, за да показва времето във формат ЧЧмм. Например 0959 показва 09:59.

  • В конфигурационния файл на телефона (cfg.xml) с XML въведете низ в следния формат:

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

  • На уеб страницата на телефоназадайте часа във формат HHMM, след което телефонът да започне повторно синхронизиране.

Стойността по подразбиране е празна. Ако стойността е невалидна, параметърът се игнорира. Ако този параметър е зададен с валидна стойност, параметърът за периодично повторно синхронизиране се игнорира.

Повторно синхронизиране при произволно закъснение

Предотвратява претоварването на сървъра за обезпечаване, когато едновременно се включват голям брой устройства.

За да избегнете наводняващи заявки за повторно синхронизиране към сървъра от множество телефони, телефонът се синхронизира повторно в диапазона между часовете и минутите и часовете и минутите плюс произволното закъснение (ччмм, ччмм+random_delay). Например, ако произволното закъснение = (Повторно синхронизиране при произволно закъснение + 30)/60 минути, входната стойност в секунди се преобразува в минути със закръгляне до следващата минута, за да се изчисли окончателния random_delay интервал.

  • В конфигурационния файл на телефона (cfg.xml) с XML въведете низ в следния формат:

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

  • На уеб страницата на телефоназадайте периода от време в секунди.

Валидната стойност варира между 600 и 65535.

Ако стойността е по-малка от 600, вътрешното произволно закъснение е между 0 и 600.

Стойността по подразбиране е 600 секунди (10 минути).

Периодично повторно синхронизиране

Времевият интервал между периодичното повторно синхронизиране със сървъра за обезпечаване. Свързаният таймер за повторно синхронизиране е активен само след първото успешно синхронизиране със сървъра.

Валидните формати са следните:

  • Цяло число

    Пример: Въвеждането на 3000 показва, че следващото повторно синхронизиране ще се извърши след 3000 секунди.

  • Няколко цели числа

    Пример: Въвеждането на 600,1200,300 показва, че първото повторно синхронизиране се извършва след 600 секунди, второто повторно синхронизиране се извършва 1200 секунди след първото, а третото повторно синхронизиране се извършва 300 секунди след второто.

  • Времеви диапазон

    Например въвеждането на 2400+30 показва, че следващото повторно синхронизиране се извършва между 2400 и 2430 секунди след успешно повторно синхронизиране.

  • В конфигурационния файл на телефона (cfg.xml) с XML въведете низ в следния формат:

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

  • На уеб страницата на телефоназадайте периода от време в секунди.

Задайте параметъра на нула, за да деактивирате периодичното повторно синхронизиране.

Стойността по подразбиране е 3600 секунди.

Закъснение на повторния опит за грешка при повторно синхронизиране

Ако операцията по повторно синхронизиране е неуспешна, тъй като телефонът не е могъл да извлече профила от сървъра или изтегленият файл е повреден, или възникне вътрешна грешка, телефонът прави опити за повторно синхронизиране отново след определено време в секунди.

Валидните формати са следните:

  • Цяло число

    Пример: Въвеждането на 300 показва, че следващият повторен опит за повторно синхронизиране се извършва след 300 секунди.

  • Няколко цели числа

    Пример: Въвеждането на 600,1200,300 показва, че първият повторен опит се извършва след 600 секунди след неуспеха, вторият повторен опит се извършва 1200 секунди след неуспеха на първия повторен опит, а третият повторен опит се извършва след 300 секунди след неуспеха на втория повторен опит.

  • Времеви диапазон

    Например въвеждане на 2400+30 показва, че следващият повторен опит се извършва между 2400 и 2430 секунди след неуспешно повторно синхронизиране.

Ако закъснението се установи на 0, устройството не прави отново опит за повторно синхронизиране след неуспешен опит за повторно синхронизиране.

  • В конфигурационния файл на телефона (cfg.xml) с XML въведете низ в следния формат:

    <Resync_Error_Retry_Delay ua="na">60,120,240,480,960,1920,3840,7680,15360,30720,61440,86400Error_Retry_Delay>esync_

  • На уеб страницата на телефоназадайте периода от време в секунди.

По подразбиране: 60,120,240,480,960,1920,3840,7680,15360,30720,61440,86400

Забавяне на принудителното повторно синхронизиране

Максималното закъснение (в секунди), което телефонът изчаква, преди да извърши повторно синхронизиране.

Устройството не се синхронизира повторно, докато една от телефонните му линии е активна. Тъй като повторното синхронизиране може да отнеме няколко секунди, е желателно да изчакате устройството да бъде свободно за продължителен период от време преди повторно синхронизиране. Това позволява на потребителя да извършва повиквания без прекъсване.

Устройството има таймер, който започва обратно броене, когато всички линии са свободни. Този параметър е първоначалната стойност на брояча. Събитията на повторно синхронизиране се забавят, докато броячът намалее до нула.

Валидната стойност варира между 0 и 65535.

  • В конфигурационния файл на телефона (cfg.xml) с XML въведете низ в следния формат:

    <Forced_Resync_Delay ua="na">14400Resync_Delay>orced_

  • На уеб страницата на телефоназадайте периода от време в секунди.

Стойността по подразбиране е 14 400 секунди.

Повторно синхронизиране от SIP

Управлява заявките за операции за повторно синхронизиране чрез събитие SIP NOTIFY, изпратено от прокси сървъра на доставчика на услуги до телефона. Ако е разрешено, прокси сървърът може да поиска повторно синхронизиране, като изпрати съобщение SIP NOTIFY, съдържащо събитието: синхронизирайте отново заглавката с устройството.

  • В конфигурационния файл на телефона (cfg.xml) с XML въведете низ в следния формат:

    <Resync_From_SIP ua="na">ДаFrom_SIP>esync_

  • На уеб страницата на телефона изберете Да , за да разрешите тази функция, или Не , за да я премахнете.

По подразбиране: Да

Повторно синхронизиране след опит за надграждане

Активира или деактивира операцията за повторно синхронизиране след надграждане. Ако е избрано Да , синхронизирането се задейства след надграждане на фърмуера.

  • В конфигурационния файл на телефона (cfg.xml) с XML въведете низ в следния формат:

    <Resync_After_Upgrade_Attempt ua="na">ДаAfter_Upgrade_Attempt>esync_

  • На уеб страницата на телефона изберете Да , за да стартирате повторно синхронизиране след надграждане на фърмуера, или Не , за да не синхронизирате повторно.

По подразбиране: Да

Тригер за повторно синхронизиране 1

Тригер за повторно синхронизиране 2

Ако логическото уравнение в тези параметри оцени като НЕВЯРНО, повторното синхронизиране не се задейства, дори когато Повторно синхронизиране при нулиране е установено на ВЯРНО. Само повторното синхронизиране чрез URL адрес за директно действие и уведомяване за SIP игнорира тези тригери за повторно синхронизиране.

Параметрите могат да бъдат програмирани с условен израз, който преминава макро разширение. За валидните макро разширения вижте Променливи за макро разширение под Параметри за обезпечаване.

  • В конфигурационния файл на телефона (cfg.xml) с XML въведете низ в следния формат:

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

    <Resync_Trigger_2 ua="na"/>

  • На уеб страницата на телефоназадайте тригерите.

По подразбиране: Празно

Повторно синхронизиране с възможност за конфигуриране от потребителя

Позволява на потребителя да синхронизира повторно телефона от менюто на екрана на телефона. Когато е зададено на Да, потребителят може да синхронизира повторно конфигурацията на телефона, като въведе правилото за профила от телефона. Когато е зададен на Не, параметърът Правило за профила не се показва в менюто на екрана на телефона.

  • В конфигурационния файл на телефона (cfg.xml) с XML въведете низ в следния формат:

    <User_Configurable_Resync ua="na">ДаConfigurable_Resync>ser_

  • На уеб страницата на телефона изберете Да , за да покажете параметъра Правило за профил в менюто на телефона, или изберете Не , за да скриете този параметър.

По подразбиране: Да

Неуспешно повторно синхронизиране на FNF

Повторното синхронизиране обикновено се счита за неуспешно, ако заявеният профил не се получи от сървъра. Този параметър замества това поведение. Когато е зададено на Не, устройството приема отговор за ненамерен файл от сървъра като успешно повторно синхронизиране.

  • В конфигурационния файл на телефона (cfg.xml) с XML въведете низ в следния формат:

    <Resync_Fails_On_FNF ua="na">ДаFails_On_FNF>esync_

  • На уеб страницата на телефона изберете Да , за да приемете отговор за ненамерен файл като неуспешно повторно синхронизиране, или изберете Не , за да приемете отговор за ненамерен файл като успешно повторно синхронизиране.

По подразбиране: Да

Тип удостоверяване на профила

Указва данните за вход, които да се използват за удостоверяване на акаунта на профила. Наличните опции са:

  • Деактивирано: Деактивира функцията за акаунт за профил. Когато тази функция е деактивирана, менюто Настройка на профил на акаунт не се показва на екрана на телефона.

  • Базово HTTP удостоверяване: Идентификационните данни за влизане в HTTP се използват за удостоверяване на акаунта на профила.

  • XSI удостоверяване: Идентификационните данни за влизане в XSI или идентификационните данни за XSI SIP се използват за удостоверяване на акаунта на профила. Идентификационните данни за удостоверяване зависят от XSI типа удостоверяване за телефона:

    • Когато типът XSI удостоверяване за телефона е зададен на Идентификационни данни за влизане, се използват идентификационните данни за влизане XSI.

    • Когато типът XSI удостоверяване за телефона е зададен на идентификационни данни за SIP, се използват идентификационни данни за XSI SIP.

  • В конфигурационния файл на телефона (cfg.xml) с XML въведете низ в следния формат:

    <Profile_Authentication_Type ua="na">Базово Http удостоверяванеAuthentication_Type>rofile_

  • На уеб страницата на телефона изберете опция от списъка за телефона за удостоверяване на повторното синхронизиране на профила.

По подразбиране: Базово HTTP удостоверяване

За повече информация вижте Посочване на типа удостоверяване на профила под Посочване на телефона за повторно синхронизиране на профила.

Правило на профила

Правило на профила Б

Правило на профила В

Правило на профила D

Всяко правило на профила информира телефона за източник, от който да получи профил (конфигурационен файл). При всяка операция за повторно синхронизиране телефонът прилага последователно всички профили.

Ако прилагате AES-256 CBC шифроване към конфигурационните файлове, посочете ключа за шифроване с ключовата дума --key , както следва:

[--ключ ]

Можете да приложите ключа за шифроване в двойни кавички ("), като опция.

  • В конфигурационния файл на телефона (cfg.xml) с XML въведете низ в следния формат:

    <Profile_Правило ua="na">/$PSN.xmlПравило>rofile_

    <Profile_Rule_B ua="na"/>

    <Profile_Rule_C ua="na"/>

    <Profile_Rule_D ua="na"/>

  • На уеб страницата на телефонаукажете правилото за профила.

По подразбиране: /$PSN.xml

Опция за използване на DHCP

Опции за DHCP, разделени със запетаи, използвани за извличане на фърмуер и профили.

По подразбиране: 66,160,159,150,60,43,125

Опция за използване на DHCPv6

Опции за DHCP, разделени със запетаи, използвани за извличане на фърмуер и профили.

По подразбиране: 17,160,159

Обезпечаване чрез Cisco XML

Можете да осигурявате телефони чрез XML функции на Cisco.

Можете да изпратите XML обект към телефона чрез SIP известие пакет или HTTP публикация към CGI интерфейса на телефона: http://PhoneIPAddress/CGI/Execute.

CP-xxxx-3PCC разширява XML функцията на Cisco да поддържа обезпечаване чрез XML обект:

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

След като телефонът получи XML обекта, той изтегля файла за обезпечаване от [правило на профила]. Това правило използва макроси за опростяване на развитието на приложението на XML услугите.

Разрешаване на URL адреси с макро разширение

Поддиректориите с множество профили на сървъра предоставят удобен метод за управление на голям брой разгърнати устройства. URL на профила може да съдържа:

  • Име на обезпечаващ сървър или изричен IP адрес. Ако профилът идентифицира сървъра за обезпечаване по име, телефонът изпълнява DNS търсене, за да разреши името.

  • Нестандартен сървърен порт, който е посочен в URL чрез използване на стандартен синтаксис :порт , следващ името на сървъра.

  • Поддиректорията на виртуалната корнева директория на сървъра, където се съхранява профилът, посочен чрез използване на стандартна URL нотация и управляван чрез макро разширение.

Например следното правило за Profile_изисква файлът на профила ($PN.cfg), в поддиректорията на сървъра /cisco/config, от TFTP сървъра, който работи на хост prov.telco.com, да слуша за връзка на порт 6900: 

 <Profile_правило> tftp://prov.telco.com:6900/cisco/config/$PN.cfg правило>
rofile_

Профилът за всеки от телефоните може да бъде идентифициран в параметър с общо предназначение, като стойността му е посочена в общо правило за профил при използване на макро израз.

Например да предположим, че GPP_B се дефинира като Dj6Lmp23Q.

Правилото Profile_има стойността:

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

При повторно синхронизиране на устройството и разширяване на макросите, телефонът с MAC адрес 000e08012345 изисква профил с име, което съдържа MAC адреса на устройството на следния URL:

 tftp://prov.telco.com/cisco/Dj6Lmp23Q/000e08012345.cfg
Задайте типа удостоверяване на профила

Удостоверяването на профила позволява на потребителите на телефона да синхронизират повторно профила за обезпечаване към телефона. Изисква се информация за удостоверяване, когато телефонът прави опит за повторно синхронизиране и изтегляне на конфигурационен файл за първи път и получи HTTP или HTTPS 401 грешка при удостоверяване. Когато активирате тази функция, на телефона се показва екранът за настройка на профил за следните ситуации:

  • Когато възникне грешка при удостоверяване на HTTP или HTTPs 401 по време на първото обезпечаване след рестартирането на телефона

  • Когато потребителското име и паролата за акаунта в профила са празни

  • Когато няма потребителско име и парола в правилото за профил

Ако екранът Настройка на профила е пропуснат или игнориран, потребителят може също да получи достъп до екрана за настройка чрез менюто на екрана на телефона или чрез софтуерния бутон Настройка , който се показва само когато няма регистрирана линия на телефона.

Когато деактивирате функцията, екранът Настройка на профил на акаунт не се показва на телефона.

Потребителското име и паролата в полето Правило на профила имат по-висок приоритет от акаунта на профила.

  • Когато предоставите правилен URL адрес в полето Правило за профил без потребителско име и парола, телефонът изисква удостоверяване или проверка, за да синхронизира отново профила. С правилния акаунт за профил удостоверяването преминава. При неправилен акаунт на профил удостоверяването е неуспешно.

  • Когато предоставите правилен URL адрес в полето Правило за профил с правилно потребителско име и парола, телефонът изисква удостоверяване или проверка, за да синхронизира отново профила. Акаунтът с профил не се използва за повторно синхронизиране на телефона. Влизането е успешно.

  • Когато предоставите правилен URL адрес в полето Правило за профил с неправилно потребителско име и парола, телефонът изисква удостоверяване или проверка, за да синхронизира отново профила. Акаунтът с профил не се използва за повторно синхронизиране на телефона. Влизането винаги е неуспешно.

  • Когато предоставите неправилен URL адрес в полето Правило за профил , влизането винаги е неуспешно.

Освен това можете да конфигурирате параметрите в конфигурационния файл на телефона с XML (cfg.xml) код.

Можете да зададете типа удостоверяване на профила от уеб страницата за администриране на телефона.

1

Отворете уеб страницата за администриране на телефона.

2

Изберете Глас > Осигуряване.

3

В раздела Профил за конфигуриране задайте параметъра Тип удостоверяване на профила , за да посочите данните за вход, които да се използват за удостоверяване на акаунта на профила.

Можете да конфигурирате този параметър в XML файла за конфигуриране на телефона (cfg.xml), като въведете низ в следния формат:

<Profile_Authentication_Type ua="na">ДеактивираноAuthentication_Type>
rofile_

Опции:

  • Деактивирано: Забранява функцията за акаунт за профил. Когато тази функция е деактивирана, менюто Настройка на акаунт за профил не се показва на екрана на телефона.

  • Базово HTTP удостоверяване: Идентификационните данни за влизане в HTTP се използват за удостоверяване на акаунта на профила.

  • XSI удостоверяване: Идентификационните данни за влизане в XSI или идентификационните данни за XSI SIP се използват за удостоверяване на акаунта на профила. Идентификационните данни за удостоверяване зависят от XSI типа удостоверяване за телефона:

    Когато типът XSI удостоверяване за телефона е зададен на Идентификационни данни за влизане, се използват идентификационните данни за влизане XSI.

    Когато типът XSI удостоверяване за телефона е зададен на идентификационни данни за SIP, се използват идентификационни данни за XSI SIP.

По подразбиране: Базово HTTP удостоверяване

4

Щракнете върху Изпращане на всички промени.

Ръчно прилагане на профил към телефона

Изтеглете конфигурационния файл на телефона от TFTP сървър

Изпълнете тези стъпки, за да изтеглите конфигурационния файл на приложението за TFTP сървър на вашия компютър.

1

Свържете компютъра към LAN порта на телефона.

2

Изпълнете приложението за TFTP сървър на компютъра и се уверете, че конфигурационният файл е достъпен в главната директория на TFTP.

3

В уеб браузър въведете IP адреса на LAN на телефона, IP адреса на компютъра, името на файла и данните за вход. Използвайте този формат:

http://<WAN_IP_Address>/admin/resync?tftp://<PC_IP_Address>/<file_name>&xuser=admin&xpassword=

Пример: 

http://192.168.15.1/admin/resync?tftp://192.168.15.100/my_config.xml&xuser=admin&xpassword=admin
Изтеглете конфигурационния файл на телефона с cURL

Изпълнете тези стъпки, за да изтеглите конфигурацията на телефона като използвате cURL. Този инструмент на командния ред се използва за прехвърляне на данни със синтаксис на URL. За да изтеглите cURL, посетете:

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

Препоръчваме ви да не използвате cURL, за да публикувате конфигурацията на телефона, тъй като потребителското име и паролата могат да се прихванат при използване на cURL.

1

Свържете компютъра към LAN порта на телефона.

2

Изтеглете конфигурационния файл на телефона, като въведете следната команда на cURL:

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

Профили за конфигуриране

Телефонът приема конфигурации в XML формат.

Примерите в този раздел използват профили за конфигуриране с XML синтаксис.

Формати на профили за конфигуриране

Профилът за конфигуриране определя стойностите на параметъра за телефона.

XML форматът на профила за конфигуриране използва стандартни инструменти за XML упълномощаване за компилиране на параметрите и стойностите.

Поддържа се само набор от знаци UTF-8. Ако промените профила в редактор, не променяйте формата на кодиране; в противен случай телефонът не може да разпознае файла.

Всеки телефон има различен набор от функции и следователно различен набор от параметри.

Формат на профила Open

Профилът в отворен формат е текстов файл с подобен на XML синтаксис в йерархия от елементи, с атрибути на елементи и стойности. Този формат ви позволява да използвате стандартни инструменти за създаване на конфигурационен файл. XML конфигурационен файл може да се изпрати от сървъра за обезпечаване към телефона по време на операция за повторно синхронизиране, без да се компилира като двоичен обект.

Телефонът може да приема формати за конфигуриране, генерирани от стандартните инструменти. Тази функция улеснява разработването на софтуера на сървъра за обезпечаване, който генерира профили за конфигуриране от съществуващи бази данни.

За да защити поверителната информация в профила за конфигуриране, сървърът за обезпечаване предава XML конфигурационния файл към телефона през защитен от TLS канал. Като опция файлът може да се компресира при използване на алгоритъм за намаляване на gzip (RFC1951).

Файлът може да бъде шифрован с един от следните методи за шифроване:

  • AES-256-CBC шифроване

  • Шифроване на HTTP, базирано на RFC-8188, с шифър AES-128-GCM

Конфигурационният файл може да включва следните компоненти:

  • Тагове на елементи

  • Атрибути

  • Параметри

  • Функции за форматиране

  • XML коментари

Пример: Формат на профила Open

 <flat-profile> <Resync_On_Reset> Да On_Reset> <Resync_Periodic> 7200 Periodic> <Profile_Rule> tftp://prov.telco.com:6900/cisco/config/CP_xxxx_MPP.cfgRule> </flat-profile>
esync_esync_rofile_

Етикетът на елемента огражда всички елементи на параметрите, които телефонът разпознава.

Свойства на таг на елемент

Имайте предвид следните правила, когато създавате или актуализирате конфигурационен файл.

  • Форматът за XML обезпечаване и уеб потребителският интерфейс позволяват конфигуриране на същите настройки. Имената на XML етикетите и имената на полетата в уеб потребителския интерфейс са подобни, но варират поради ограниченията за имена на XML елементи. Например долните черти ( _ ) в XML конфигурационния файл вместо интервали в уеб потребителския интерфейс.

  • Телефонът разпознава елементи с правилни имена на параметри, които са капсулирани в специалния елемент .

  • Имената на елементите са затворени в ъглови скоби.

  • Повечето имена на елементи са подобни на имената на полетата в уеб потребителския интерфейс на телефона със следните модификации:

    • Имената на елементите не могат да включват интервали или специални знаци. За да се извлече името на елемента от името на полето в уеб, заменете с долна черта всеки интервал или специалните знаци [, ], (, ) или /.

      Пример: Елементът <Resync_On_Reset> представлява полето Повторно синхронизиране при нулиране .

    • Всяко име на елемент трябва да е уникално. В уеб потребителския интерфейс на телефона едни и същи полета могат да се показват на много уеб страници, като страниците за линия, потребител и разширение. Добавете [n] към името на елемента, за да посочите номера, който е показан в раздела на страницата.

      Пример:<Dial_Plan_1_> представлява плана за набиране за линия 1.

  • Всеки отварящ таг на елемент трябва да има съответстващ затварящ таг. Например:

      <Resync_On_Reset> Да On_Reset> <Resync_Periodic> 7200 Periodic> <Profile_Rule>tftp://prov.telco.com:esync_esync_ 6900/cisco/config/CP_xxxx_MPP.cfg Правило>
    rofile_

  • Таговете на елементите различават малки и главни букви.

  • Разрешени са празни тагове на елементи и ще се интерпретират като конфигуриране на празна стойност. Въведете маркера на отварящия елемент без съответстващ маркер на елемент и поставете интервал и напред наклонена черта преди затварящата скоба за ъгъл (>). В този пример Profile Rule B е празно:

     <Profile_Rule_B />

  • Празен таг на елемент може да се използва, за да се предотврати презаписване на предоставени от потребителя стойности по време на операция за повторно синхронизиране. В следващия пример настройките за бързо набиране на потребителя не са променени:

     <Speed_гial_2_Name ua="rw"/> <Speed_гial_2_Номер ua="rw"/> <Speed_гial_3_Name ua="rw"/> <Speed_гial_3_Номер ua="rw"/> <Speed_гial_4_Name ua="rw"/> <Speed_гial_4_Номер ua="rw"/> <Speed_гial_5_Name ua="rw"/> <Speed_гial_5_Номер ua="rw"/> <Speed_гial_6_Name ua="rw"/> <Speed_гial_6_Номер ua="rw"/> <Speed_гial_7_Name ua="rw"/> <Speed_гial_7_Номер ua="rw"/> <Speed_гial_8_Name ua="rw"/> <Speed_гial_8_Номер ua="rw"/> <Speed_гial_9_Name ua="rw"/> <Speed_гial_9_Номер ua="rw"/>

  • Използвайте празна стойност, за да зададете съответния параметър на празен низ. Въведете отварящ и затварящ елемент без стойност между тях. В следващия пример параметърът GPP_А е зададен на празен низ.

     <плосък профил> <GPP_A>   A> </плосък профил>
    _

  • Неразпознатите имена на елементи се игнорират.

Свойства на параметъра

Тези свойства се отнасят за параметрите:

  • Всички параметри, които не са посочени от профила, остават непроменени в телефона.

  • Неразпознатите параметри се игнорират.

  • Ако профилът във формат Open съдържа няколко повторения на един и същ етикет на параметър, последното повторение има приоритет пред по-ранните. За да избегнете неволно припокриване на стойностите на конфигурацията за параметър, препоръчваме всеки профил да указва най-много един екземпляр на параметър.

  • Последният обработен профил има предимство. Ако няколко профила посочват един и същ параметър за конфигуриране, предимство има стойността на по-късния профил.

Формати на низове

Тези свойства се отнасят за форматирането на низовете:

  • Коментарите се разрешават чрез стандартен XML синтаксис.

  • Позволяват се водещи и крайни интервали за четливост, но се премахват от стойността на параметъра.

  • Новите редове в стойността се преобразуват в интервали.

  • Позволено е XML заглавка от формуляра <? ?> , но телефонът го игнорира.

  • За да въведете специални знаци, използвайте основните XML знаци, които са показани в следващата таблица.

    Специален знак

    XML ескейп последователност

    & Амперсанд

    &

    < (по-малко от)

    <

    > (по-голямо от)

    >

    ’ (апостроф)

    '

    ” (двойни кавички)

    "

    В следващия пример ескейп знаци се въвеждат, за да представляват символите за по-голямо и по-малко от, които се изискват в правилото на плана за набиране. Този пример дефинира план за набиране на гореща линия за информация, който задава параметъра <Dial_Plan_1_> (Влизане от администратор > Разширен > Глас > Вътрешен (n)) равен на (S0 ).

     <плосък профил> <Dial_Plan_1_> (S0 ) Plan_1_> </плосък профил>
    ial_

  • Ескейп символи с десетични и шестнадесетични стойности (напр. ( и .), се превеждат.

  • Фърмуерът на телефона поддържа само ASCII знаци.

Компресиране и шифроване на профил Open (XML)

Профилът за конфигуриране Open може да бъде компресиран, за да се намали мрежовото натоварване на сървъра за обезпечаване. Профилът може също да бъде шифрован, за да се защити поверителната информация. Не се изисква компресиране, но то трябва да предшества шифроването.

Компресиране на профил „Отваряне“

Поддържаният метод на компресиране е алгоритъм за намаляване на gzip (RFC1951). Помощната програма gzip и библиотеката за компресиране, която прилага същия алгоритъм (zlib), са достъпни от интернет сайтове.

За да разпознае компресирането, телефонът очаква компресираният файл да съдържа съвместима с gzip заглавка. Извикването на помощната програма gzip на оригиналния профил Open генерира заглавката. Телефонът проверява заглавието на изтегления файл, за да определи файловия формат.

Например, ако profile.xml е валиден профил, файлът profile.xml.gz също се приема. Всяка от следните команди може да генерира този тип профил:

  • >gzip profile.xml

    Заменя оригиналния файл с компресирания.

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

    Оставя на място оригиналния файл и създава нов компресиран файл.

Шифроване на профил Open

Симетричното шифроване с ключ може да се използва за шифроване на профил на отворена конфигурация, независимо дали файлът е компресиран или не. Компресиране, ако се прилага, трябва да се приложи преди шифроване.

Сървърът за обезпечаване използва HTTPS за обработване на първоначалното обезпечаване на телефона след разгръщането. Предварително шифрованите офлайн профили на конфигурацията позволяват използване на HTTP за последващо повторно синхронизиране на профилите. Това намалява натоварването на HTTPS сървъра при широкомащабни разгръщания.

Телефонът поддържа два метода за шифроване на конфигурационните файлове:

  • AES-256-CBC шифроване

  • Основаващо се на RFC 8188 шифроване на HTTP съдържание с шифър AES-128-GCM

Ключът или входният ключов материал (IKM) трябва да бъде предварително обезпечен в модула по-рано. Зареждащата лента на тайния ключ може да се извърши защитено при използване на HTTPS.

Името на конфигурационния файл не изисква конкретен формат, но името на файл, който завършва с разширението .cfg обикновено показва профил за конфигуриране.

AES-256-CBC шифроване

Телефонът поддържа AES-256-CBC шифроване за конфигурационни файлове.

Инструментът за шифроване OpenSSL, който можете да изтеглите от различни интернет сайтове, може да извърши шифроването. Поддръжката на 256-битово AES шифроване може да изисква повторно компилиране на инструмента, за да се активира AES кода. Фърмуерът е тестван спрямо версия openssl-1.1.1d.

Профилът очаква шифрован файл да има същия формат, който е генериран от следната команда:

 # пример ключ за шифроване = SecretPhrase 1234 openssl enc –e –aes-256-cbc –k SecretPhrase 1234 –in profile.xml –out profile.cfg # аналогично извикване за компресиран xml файл openssl enc –e –aes-256-cbc –k SecretPhrase 1234 –in profile.xml.gz –out profile.cfg

Малка буква -k предшества тайния ключ, който може да бъде обикновена текстова фраза и който се използва за генериране на произволна 64-битова сол. С посочена от -k аргумента тайна инструментът за шифроване извлича произволен 128-битов начален вектор и действителния 256-битов ключ за шифроване.

Когато тази форма на шифроване се използва на конфигурационен профил, телефонът трябва да бъде информиран за стойността на секретния ключ, за да дешифрира файла. Тази стойност се посочва като квалификатор в URL на профила. Синтаксисът е както следва, като се използва изричен URL:

 [--ключ “SecretPhrase 1234”] http://prov.telco.com/path/profile.cfg

Тази стойност се програмира чрез използване на един от параметрите за Profile_правило .

Макро разширение

Няколко параметъра за обезпечаване преминават вътрешно през макро разширение, преди да бъдат оценени. Тази стъпка за предварителна оценка осигурява по-голяма гъвкавост при управлението на повторното синхронизиране и дейностите по надграждане на телефона.

Тези групи параметри преминават през макро разширение преди оценка:

  • ОТРesync_Иrigger_*

  • Пrofile_правило*

  • Log_xxx_Msg

  • Upgrade_Правило

При определени условия някои параметри с общо предназначение (GPP_*) също преминават през макро разширение, както е посочено изрично в раздела Незадължителни аргументи за повторно синхронизиране по-долу.

По време на макро разширението съдържанието на именуваните променливи заменя изразите под формата на $NAME и $(NAME). Тези променливи включват параметри с общо предназначение, няколко идентификатора на продукта, определени таймери на събития и стойности на състоянието на обезпечаване. За пълен списък вижте Променливи за макро разширение под Параметри за обезпечаване.

В следващия пример изразът $(MAU) се използва за вмъкване на МАС адрес 000E08012345.

Администраторът въвежда: $(MAU)config.cfg

Полученият макро израз за устройство с MAC адрес 000E08012345 е: 000E08012345config.cfg

Ако макро името не бъде разпознато, то остава неразширено. Например името STRANGE не се разпознава като валидно макро име, докато MAU се разпознава като валидно макро име.

Администраторът въвежда: $STRANGE$MAU.cfg

Полученият макро израз за устройство с MAC адрес 000E08012345 е: $STRANGE138E08012345.cfg

Макро изразът не се прилага рекурсивно. Например $$MAU” се разширява в $MAU” (разширява се $$ ) и не води до MAC адрес.

Съдържанието на параметрите със специална цел GPP_SA до GPP_SD се съпоставя с макро изразите $SA до $SD. Тези параметри са макро разширени само като аргумент на опциите --key , --uid и --pwd в URL за повторно синхронизиране.

Условни изрази

Условните изрази могат да задействат събития за повторно синхронизиране и да избират от алтернативни URL адреси за операции по повторно синхронизиране и надграждане.

Условните изрази се състоят от списък от сравнения, разделени от и оператора. Всички сравнения трябва да бъдат удовлетворени, за да бъде условието истина.

Всяко сравнение може да се отнася до един от следните три вида литерали:

  • Цели стойности

  • Номера на софтуерни или хардуерни версии

  • Низове в двойни кавички

Номера на версии

Версията на софтуера за Cisco Video Phone 8875 използва този формат (където BN е номерът на компилацията):

PHONEOSгггг.1-0-1-0001-BN

където гггг показва модела на телефона или серията телефони; 1 е основната версия; 0 е по-малката версия; 1-0001 е микро версията, а BN е номера на компилацията.

Низът за сравнение трябва да използва същия формат. В противен случай се получава грешка при анализ във формат.

При сравняване на софтуерната версия се сравняват последователно основната, вторичната и микро версията, а най-левите цифри имат предимство пред последните. Когато номерата на версиите са идентични, се сравнява номерът на компилация.

Примери за валиден номер на версия

phoneos-8875.1-0-1-0001-19

Сравнение

Низовете в кавички могат да се сравняват за равенство или неравенство. Целите числа и номерата на версии също могат да се сравняват аритметично. Операторите за сравнение могат да бъдат изразени като символи или акроними. Акронимите са удобни за изразяване на условието в профил във формат Open.

Оператор

Алтернативен синтаксис

Описание

Приложимо за цели числа и операнди на версии

Приложим за операнди от низове в кавички

=

eq

равно на

Да

Да

!=

ре Ле

не е равно на

Да

Да

<

литовски

по-малко от

Да

Не

<=

на Съвета за сигурност

по-малко от или равно на

Да

Не

>

гт

по-голямо от

Да

Не

>=

ст

по-голямо или равно на

Да

Не

И

и

Да

Да

Важно е да оградите макро променливи в двойни кавички, където се очаква низов литерал. Не правете това, когато се очаква номер или номер на версия.

Когато се използват в контекста на параметрите Profile_правило* и Upgrade_правило, условните изрази трябва да бъдат затворени в синтаксиса „(expr)?“, както в този пример за правило на надграждане. Не забравяйте да замените BN с номера на компилация на зареждането на фърмуера си, до който да надстроите.

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

Не използвайте предходния синтаксис със скоби, за да конфигурирате параметрите за Resync_Trigger_*.

Синтаксис на URL адреса

Използвайте стандартен синтаксис на URL, за да посочите как да се извлекат конфигурационните файлове и зарежданията на фърмуера съответно в параметрите Profile_правило* и Upgrade_правило. Синтаксисът е както следва:

[ схема:// ] [ сървър [:порт]] път до файла

Където схемата е една от следните стойности:

  • tftp

  • http

  • https

Ако схемата се пропусне, се приема tftp. Сървърът може да бъде разпознат чрез DNS име на хост или цифров IP адрес. Портът е целевият UDP или номер на TCP порт. Пътят на файла трябва да започва с главната директория (/); трябва да бъде абсолютен път.

Ако сървърът липсва, се използва tftp сървър, посочен чрез DHCP (опция 66).

Сървърът трябва да бъде посочен за правила за надстройване.

Ако липсва порт , се използва стандартният порт за посочената схема. Tftp използва UDP порт 69, http използва TCP порт 80, https използва TCP порт 443.

Трябва да има път до файл. Не е необходимо да се отнася за статичен файл, но може да посочва динамично съдържание, получено чрез CGI.

Макро разширяването се прилага в рамките на URL адресите. Следват примери за валидни 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

При използване на DHCP опция 66 правилата за надграждане не поддържат празен синтаксис. Прилага се само за правило на профила*.

Основаващо се на RFC 8188 шифроване на HTTP съдържание

Телефонът поддържа базирано на RFC 8188 шифроване на HTTP съдържание с шифър AES-128-GCM за конфигурационни файлове. С този метод на шифроване всяка организация може да чете заглавията на HTTP съобщенията. Но само елементите, които знаят входния ключов материал (IKM), могат да четат полезния обем. Когато телефонът е обезпечен с IKM, телефонът и сървърът за обезпечаване могат да обменят конфигурационни файлове защитено, като същевременно позволяват на мрежовите елементи на трети страни да използват заглавията на съобщенията за целите на анализа и наблюдението.

XML конфигурационният параметър IKM_HTTP_Encrypt_Content държи IKM на телефона. Поради съображения за защита този параметър не е достъпен на уеб страницата за администриране на телефона. Освен това не се вижда в конфигурационния файл на телефона, до който имате достъп от IP адреса на телефона или от отчетите за конфигурацията на телефона, изпратени до сървъра за обезпечаване.

Ако искате да използвате основаващо се на RFC 8188 шифроване, гарантирайте следното:

  • Осигурете телефона с IKM, като посочите IKM с XML параметъра IKM_HTTP_Encrypt_Content в конфигурационния файл, който се изпраща от сървъра за обезпечаване към телефона.

  • Ако това шифроване се приложи към конфигурационните файлове, изпратени от сървъра за обезпечаване към телефона, се уверете, че HTTP заглавката Кодиране на съдържание в конфигурационния файл има aes ｟_ph_11｠ gcm.

    При липса на тази заглавка методът AES-256 CBC има предимство. Телефонът прилага дешифроване AES-256 CBC, ако в правилото на профила присъства бутон AES-256 CBC, независимо от IKM.

  • Ако искате телефонът да прилага това шифроване към отчетите за конфигуриране, които изпраща към сървъра за обезпечаване, се уверете, че няма зададен ключ AES-256 CBC в правилото на отчета.

Незадължителни аргументи за повторно синхронизиране

Незадължителните аргументи ключ, uid и pwd могат да предшестват URL, въведени в параметрите за Profile_правило* , оградени от квадратни скоби.

ключ

Опцията --ключ указва на телефона, че конфигурационният файл, който получава от сървъра за обезпечаване, е шифрован с AES-256-CBC шифроване, освен ако заглавката Кодиране на съдържание във файла не показва шифроване aes ｟_ph_11｠ gcm . Самият ключ се посочва като низ след термина --ключ. Ключът може да бъде затворен в двойни кавички ("), като опция. Телефонът използва ключа за дешифриране на конфигурационния файл.

Примери за използване
 [--ключ VerySecretValue] [--ключ “моята тайна фраза”] [--ключ a37d2fb9055c1d04883a0745eb0917a4]

Скобите за опция аргументи са макро разширени. Параметрите със специална цел, GPP_SA до GPP SD_, са макроразширени в макро променливи, $SA до $SD, само когато се използват като аргументи за ключова опция. Вижте следните примери:

[--ключ $SC] [--ключ “$SD”]

В профилите във формат Open аргументът към --key трябва да бъде същият като аргумента към опцията -k , която се дава на openssl.

uid и pwd

Опциите uid и pwd могат да се използват за указване на потребителскияИД и паролата, които ще бъдат изпратени в отговор на предизвикателствата при базово и хеширано удостоверяване на HTTP, когато се поиска посоченият URL адрес. Скобите за опция аргументи са макро разширени. Параметрите със специална цел, GPP_SA до GPP SD_, са макроразширени в макро променливи, $SA до $SD, само когато се използват като аргументи за ключова опция. Вижте следните примери:

GPP_SA = MyUserID GPP_SB = MySecretPassword

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

след това ще се разшири до:

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

Типове данни

Тези типове данни се използват с параметри на профила за конфигуриране:

  • {a,b,c,…}—Избор между a, b, c, …

  • Bool—Булева стойност от „да“ или „не“.

  • CadScript—Минискрипт, който посочва параметрите за каданс на сигнала. До 127 знака.

    Синтаксис: S1[;S2], където:

    • Si=Di(вкл.i,1/изклi,1[,вкл.i,2/изклi,2[,вкл.i,3/изклi,3[,вкл.i,4/изклi,4[,вкл.i,5/изклi,5[,вкл.i,6/изклi,6]]]]]) и е известно като раздел.

    • oni,j и offi,j са продължителността на включване/изключване в секунди на сегмент. i = 1 или 2 и j = 1 до 6.

    • Di е общата продължителност на секцията в секунди.

    Всички продължения могат да имат до три десетични места, за да се осигури разделителна способност от 1 ms. Знакът „*“ означава безкрайна продължителност. Сегментите в секцията се възпроизвеждат по ред и се повтарят, докато се възпроизвежда общата продължителност.

    Пример 1:

     60 (2/4) Брой на секции за честота = 1 Раздел за честота 1: Дължина на секцията = 60 s Брой сегменти = 1 Сегмент 1: On=2s, Off=4s Обща дължина на звънене = 60s

    Пример 2—Отличителен пръстен (short,short,short,long):

     60(.2/.2,.2/.2,.2/.2,1/4) Брой секции за честота = 1 Раздел за честота 1: Дължина на секцията = 60s Брой сегменти = 4 Сегмент 1: Вкл.=0,2s, изкл.=0,2s Сегмент 2: Вкл.=0,2s, изкл.=0,2s Сегмент 3: On=0,2s, Off=0,2s Сегмент 4: On=1,0s, Off=4,0s Обща дължина на звънене = 60s

  • DialPlanScript—Синтаксис за скриптиране, който се използва за посочване на планове за набиране на Линия 1 и Линия 2.

  • Плаваща<n>—Стойност на плаваща точка с до n десетични места.

  • FQDN—Напълно квалифицирано име на домейн. Може да съдържа до 63 знака. Примерите са следните:

    • sip.Cisco.com:5060 или 109.12.14.12:12345

    • sip.Cisco.com или 109.12.14.12

  • FreqScript—Минискрипт, който посочва параметрите за честота и ниво на тона. Съдържа до 127 знака.

    Синтаксис: F1@L1[,F2@L2[,F3@L3[,F4@L4[,F5@L5[,F6@L6]]]]], където:

    • F1–F6 са честотите в Hz (само цели числа без знак).

    • L1–L6 са съответните нива в dBm (с до едно десетично място).

    Интервалите преди и след запетаята са позволени, но не се препоръчват.

    Пример 1—Тон за изчакване на повикване:

     440@-10 Брой честоти = 1 Честота 1 = 440 Hz при –10 dBm

    Пример 2—Тон за набиране:

     350@-19,440@-19 Брой честоти = 2 Честота 1 = 350 Hz при –19 dBm Честота 2 = 440 Hz при –19 dBm

  • IP— Валиден IPv4 адрес под формата на x.x.x.x, където x е между 0 и 255. Пример: 10.1.2.100.

  • UserID – Потребителският ИД, както се показва на URL адрес; до 63 знака.

  • Phone—Низ за телефонен номер, като 14081234567, *69, *72, 345678; или генеричен URL, като 1234@10.10.10.100:5068 или jsmith@Cisco.com. Низът може да съдържа до 39 знака.

  • PhTmplt—Шаблон за телефонен номер. Всеки шаблон може да съдържа един или повече шаблони, разделени със запетая (,). Интервалите в началото на всеки модел се игнорират. „?“ и „*“ представляват заместващи знаци. За да представите буквално, използвайте %xx. For example, %2а представлява *. Шаблонът може да съдържа до 39 знака. Примери: „1408*, 1510*“, „1408123????, 555?1.“.

  • Порт—Номер на порт за TCP/UDP (0-65535). Може да се посочи в десетичен или шестнадесетичен формат.

  • ProvisioningRuleSyntax—Синтаксис за скриптиране, който се използва за дефиниране на повторно синхронизиране на конфигурацията и правила за надграждане на фърмуера.

  • PwrLevel—Ниво на мощност, изразено в dBm с едно десетично място, като –13,5 или 1,5 (dBm).

  • RscTmplt—Шаблон за код на статус на SIP отговор, като „404, 5*“, „61?“, „407, 408, 487, 481“. Може да съдържа до 39 знака.

  • Sig—Подписана n-битова стойност. Може да се посочи в десетичен или шестнадесетичен формат. Знакът „-“ трябва да предхожда отрицателните стойности. Знакът + преди положителните стойности е по желание.

  • Кодове със звезда—Код за активиране за допълнителна услуга, като *69. Кодът може да съдържа до 7 знака.

  • Str – Общ низ с до n нерезервирани знака.

  • Време – Продължителността на времето в секунди, с до n десетични места. Допълнително посочените десетични места се игнорират.

  • ToneScript—Минискрипт, който посочва параметрите за честота, ниво и каданс на тона за ход на повикване. Скриптът може да съдържа до 127 знака.

    Синтаксис: FreqScript;Z1[;Z2].

    Раздел Z1 е подобен на раздела S1 в CadScript, с изключение на това, че всеки сегмент за включване/изключване е последван от параметър за компоненти на честота: z1 = d1(наi,1/изключенi,1/еi,1[,наi,2/изключенi,2/еi,2 [,наi,3/изключенi,3/еi,3 [,наi,4/изключенi,4/еi,4 [,наi,5/изключенi,5/еi,5 [,наi,6/изключенi,6/еi,6]]]]), където:

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

    • 1 < nk < 6 указва компонентите за честота във FreqScript, които се използват в този сегмент.

    Ако в даден сегмент се използва повече от един компонент за честота, компонентите се сумират.

    Пример 1—Тон за набиране:

     350@-19,440@-19;10(*/0/1+2) Брой честоти = 2 Честота 1 = 350 Hz при –19 dBm Честота 2 = 440 Hz при –19 dBm Брой секции за честота = 1 Раздел за честота 1: Дължина на секцията = 10 s Брой сегменти = 1 Сегмент 1: On=завинаги, с честоти 1 и 2 обща дължина на тона = 10s

    Пример 2—Прекъсващ тон:

     350@-19,440@-19;2(.1/.1/1+2);10(*/0/1+2) Брой честоти = 2 Честота 1 = 350 Hz при –19 dBm Честота 2 = 440 Hz при –19 dBm Брой секции на честота = 2 Секция на честота 1: Дължина на секцията = 2s Брой сегменти = 1 Сегмент 1: On=0,1s, Off=0,1s с честота 1 и 2 честота Раздел 2: Дължина на секцията = 10 s Брой сегменти = 1 Сегмент 1: On=завинаги, с честоти 1 и 2 обща дължина на тона = 12s

  • Uns—Неподписана n-битова стойност, където n = 8, 16 или 32. Може да се посочи в десетичен или шестнадесетичен формат, като 12 или 0x18, стига стойността да се побере в n бита.

Имайте това предвид:

  • представлява име на параметър за конфигуриране. В профила съответният етикет се формира чрез замяна на пространството с долна черта „_“, като Par_Name.
  • Празно поле за стойност по подразбиране предполага празен низ < “” >.
  • Телефонът продължава да използва последните конфигурирани стойности за тагове, които не присъстват в даден профил.
  • Шаблоните се сравняват по реда им. Избира се първото, не най-близкото съвпадение. Името на параметъра трябва да съвпада точно.
  • Ако в профила е дадена повече от една дефиниция за параметър, последната дефиниция във файла е тази, която се прилага за телефона.
  • Спецификация на параметър с празна параметрична стойност привежда параметъра обратно до стойността му по подразбиране. За да посочите празен низ вместо това, използвайте празния низ "" като стойност на параметъра.