В тази статия
dropdown icon
Конфигурирайте телефона си за синхронизиране на профила
    Пресинхронизирайте профила на телефона през TFTP
    Предоставяне на специфичен за телефона профил на TFTP сървър
    Пресинхронизирайте профила на телефона с HTTP GET
    Автоматично синхронизирайте профила на телефона
    Параметри за синхронизиране на профил
    Осигуряване чрез Cisco XML
    Разделителна способност на URL адреса с разширяване на
    Посочете типа удостоверяване на профила
dropdown icon
Ръчно приложете профил към телефона си
    Изтеглете конфигурационния файл на телефона от TFTP сървър
    Изтеглете конфигурационния файл на телефона с cURL
dropdown icon
Препратки за конфигурация на профила
    Конфигурационни формати на профили
    Компресия на отворения профил
    Отворете криптиране на профил
    Незадължителни аргументи за синхронизи
    Типове данни

Конфигурирайте настройките на профила за телефони от серия 9800 и 8875 (BroadWorks)

list-menuВ тази статия
list-menuОбратна връзка?

Тази Помощна статия е за настолен телефон Cisco от серия 9800 и видеотелефон Cisco 8875, регистриран в Cisco BroadWorks. Информацията на тази страница включва повторно синхронизиране на профила, ръчно прилагане на профил и синтаксис на конфигурацията.

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

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

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

1

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

2

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

3

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

За да проверите дали профилът е предоставен на телефона ви по-късно, можете да зададете някои от стойностите като маркировки. Например, задайте стойността за GPP_A на 12345678, както е показано в следния пример:

<flat-profile>
  <GPP_A> 12345678
  </GPP_A>
</flat-profile>
4

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

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

5

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


http://192.168.1.100/admin/advanced

6

Изберете раздела Voice > Provisioning и проверете стойностите на параметрите с общо предназначение 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_A със стойността 12345678.

8

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

Параметърът GPP_A вече трябва да съдържа стойността 12345678.

Предоставяне на специфичен за телефона профил на TFTP сървър

1

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

2

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

Пример:

КП-8875 000e08aabbcc.cfg

3

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

4

Достъп до уеб страницата за администриране на телефона.

5

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

6

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

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


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

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

Когато се случи следващото повторно синхронизиране, телефонът извлича новия файл, като разширява макрос израза $MA в своя MAC адрес.

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

1

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

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

2

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

3

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

4

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

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

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

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

6

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

7

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

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

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

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

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

1

Достъп до уеб страницата за администриране на телефона.

2

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

3

Определете параметъра Profile_Rule. Този пример предполага IP адрес на TFTP сървър от 192.168.1.200.

4

В полето Resync Peri odic въведете малка стойност за тестване, например 30 секунди.

5

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

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

6

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

7

Уверете се, че полето Resync при нулиране е настроено на Да.


<Resync_On_Reset>Yes</Resync_On_Reset>

8

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

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

9

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


<Resync_Error_Retry_Delay>30</Resync_Error_Retry_Delay>

10

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

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

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

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

параметър

Описание

Активиране на предоставянето

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

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

    <Provision_Enable ua="na">Да</Provision_Enable>
  • На уеб страницата на телефона задайте това поле на Да, за да разрешите действия за повторно синхронизиране, или Не, за да блокирате действията за повторно синхронизиране.

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

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

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

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

    <Resync_On_Reset ua="na">Да</Resync_On_Reset>
  • На уеб страницата на телефона задайте това поле на Да, за да разрешите повторното синхронизиране при включване или нулиране, или Не, за да блокирате повторното синхронизиране при включване или нулиране.

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

Пресинхронизирайте случайно забавяне

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

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

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

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

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

    <Resync_Random_Delay ua="na">2</Resync_Random_Delay>
  • На уеб страницата на телефона посочете броя на устройствата (20 секунди), за да забави повторното синхронизиране след включване или нулиране.

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

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

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

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

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

    <Resync_At__HHmm_ ua="na">0959</Resync_At__HHmm_>
  • На уеб страницата на телефона посочете времето във формат HHMM за телефонът да започне повторно синхронизиране.

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

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

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

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

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

    <Resync_At_Random_Delay ua="na">600</Resync_At_Random_Delay>
  • На уеб страницата на телефона посочете периода от време в секунди.

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

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

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

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

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

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

  • Едно цяло число

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

  • Множество цели числа

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

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

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

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

    <Resync_Periodic ua="na">3600</Resync_Periodic>
  • На уеб страницата на телефона посочете периода от време в секунди.

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

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

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

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

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

  • Едно цяло число

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

  • Множество цели числа

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

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

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

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

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

    <Resync_Error_Retry_Delay ua="na">60120.240.480,960.1920.3840.768015360.30720.61440.86400</Resync_Error_Retry_Delay>
  • На уеб страницата на телефона посочете периода от време в секунди.

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

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

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

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

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

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

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

    <Forced_Resync_Delay ua="na">14400</Forced_Resync_Delay>
  • На уеб страницата на телефона посочете периода от време в секунди.

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

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

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

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

    <Resync_From_SIP ua="na">Да</Resync_From_SIP>
  • На уеб страницата на телефона изберете Да, за да активирате тази функция, или Не, за да я изключите.

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

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

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

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

    <Resync_After_Upgrade_Attempt ua="na">Да</Resync_After_Upgrade_Attempt>
  • На уеб страницата на телефона изберете Да, за да задействате повторно синхронизиране след надстройка на фърмуера, или Не, за да не се синхронизира отново.

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

Ресинхронизиращ тригер 1

Ресинхронизиращ тригер 2

Ако логическото уравнение в тези параметри се оценява на FALSE, повторното синхронизиране не се задейства дори когато Resyn c On Reset е настроена на TRUE. Само повторното синхронизиране чрез URL адрес за директно действие и SIP известието игнорира тези тригери за повторно синхронизиране.

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

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

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

    <Resync_Trigger_2 ua="na"/>

  • На уеб страницата на телефона посочете тригерите.

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

Потребителска конфигурируема ресинхронизация

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

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

    <User_Configurable_Resync ua="na">Да</User_Configurable_Resync>

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

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

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

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

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

    <Resync_Fails_On_FNF ua="na">Да</Resync_Fails_On_FNF>
  • На уеб страницата на телефона изберете Да, за да приемете отговор от не открит файл като неуспешна пресинхронизация, или изберете Не, за да приемете отговор от неоткрит файл като успешно пресинхронизи ране.

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

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

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

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

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

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

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

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

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

    <Profile_Authentication_Type ua="na">Основна Http удостоверяване</Profile_Authentication_Type>
  • На уеб страницата на телефона изберете опция от списъка, за да може телефонът да удостоверява повторното синхронизиране на профила.

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

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

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

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

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

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

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

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

[--ключ] <encryption key>

Можете да приложите ключа за криптиране в двойни кавички („) по желание.

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

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

    <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

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

Можете да изпратите XML обект до телефона чрез пакет SIP Notify или HTTP Post до CGI интерфейса на телефона: http://PhoneIPAddress/CGI/Execute.

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


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

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

Разделителна способност на URL адреса с разширяване на

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

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

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

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

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


<Profile_Rule>
tftp://prov.telco.com:6900/cisco/config/$PN.cfg
</Profile_Rule>

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

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

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


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">Disabled</Profile_Authentication_Type>

Опции:

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

  • Основно удостоверяване на 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=<password>

Пример:

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. Ако промените профила в редактор, не променяйте формата на кодиране; в противен случай телефонът не може да разпознае файла.

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

Отворете формата на профила

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

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

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

Файлът може да бъде криптиран с един от следните методи за криптиране:

  • AES-256-CBC криптиране

  • RFC-8188 базирано HTTP криптиране на съдържание с AES-128-GCM шифриране

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

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

  • Атрибути

  • Параметри

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

  • XML коментари

Пример: Отворете формата на профила


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

Ети <flat-profile>кетът на елемента обхваща всички елементи на параметъра, които телефонът разпознава.

Свойства на елементния етикет

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

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

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

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

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

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

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

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

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

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

    
    <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>
    
  • Таговете на елементите са чувствителни към малки и малки букви

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

    
    <Profile_Rule_B />
    
  • Таг с празен елемент може да се използва, за да се предотврати презаписването на всички предоставени от потребителя стойности по време на операция за пресинхронизиране. В следния пример настройките за бързо набиране на потребителя са непроменени:

    <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>
    
  • Използвайте празна стойност, за да зададете съответния параметър на празен низ. Въведете елемент за отваряне и затваряне без никаква стойност между тях. В следващия пример параметърът GPP_A е зададен на празен низ.

    
    <flat-profile>
    <GPP_A>
      </GPP_A>
    </flat-profile>
    
  • Имената на неразпознати елементи се игнорират.

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

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

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

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

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

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

Струнни формати

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

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

    <!-- My comment is typed here -->
  • Водещото и последното бяло пространство е разрешено за четливост, но се премахва от стойността на параметъра.

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

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

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

    Специален характер

    XML секвенция за бягство

    & (амперсенд)

    &

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

    <

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

    >

    „(апостроф)

    '

    „(двоен цитат)

    „

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

    
    <flat-profile>
     <Dial_Plan_1_>
      (S0 &lt;:18005551212&gt;)
     </Dial_Plan_1_>
    </flat-profile>
  • Превеждат се цифровите символни избягвания, като се използват десетични и шестнадесетични стойности (s.a. (и.).

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

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

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

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

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

  • >gzip profile.xml

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

  • >cat profile.xml | gzip > профил.xml.gz

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

Отворете криптиране на профил

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

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

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

  • AES-256-CBC криптиране

  • RFC 8188 базирано HTTP криптиране на съдържание с AES-128-GCM шифриране

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

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

AES-256-CBC криптиране

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

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

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


# example encryption key = SecretPhrase1234

openssl enc –e –aes-256-cbc –k SecretPhrase1234 –in profile.xml –out profile.cfg

# analogous invocation for a compressed xml file

openssl enc –e –aes-256-cbc –k SecretPhrase1234 –in profile.xml.gz –out profile.cfg

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

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


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

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

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

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

  • Ресинкционно_тригер_*

  • Правило за профил*

  • Лог_XXX_MSG

  • Правило за надграждане

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

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

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

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

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

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

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

Полученото разширение на макроса за устройство с MAC адрес 000E08012345 е: $Strange000E08012345.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 - БН

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

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

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

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

PHONEOS-8875.1-0-1-0001-19

Сравнение

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

Оператор

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

Описание

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

Приложимо за цитирани струнни операнди

=

екв

равно на

Да

Да

!=

не

не е равно на

Да

Да

<

лт

по-малко от

Да

Не

<=

ле

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

Да

Не

>

гт

по-голям от

Да

Не

>=

дж

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

Да

Не

AND

и

Да

Да

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

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

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

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

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

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

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

  • ТФТП

  • хтп

  • хтптс

Ако с хемата е пропусната, се приема 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 заглавката за кодиране на съдърж анието в конфигурационния файл има aes128gcm.

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

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

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

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

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

Примери за използване


[--key VerySecretValue]
[--key “my secret phrase”]
[--key a37d2fb9055c1d04883a0745eb0917a4]

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

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

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

Опциите uid и pwd могат да се използват за определяне на потребителския номер и паролата, които ще бъдат изпратени в отговор на предизвикателствата за удостоверяване на HTTP Basic и Digest, когато се поиска посоченият 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,...

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

  • CADScript — минискрипт, който определя параметрите на ритъма на сигнала. До 127 знака.

    Синтаксис: S 1 [; S 2], където:

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

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

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

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

    Пример 1:

    
    60(2/4)
    
    Number of Cadence Sections = 1
    Cadence Section 1: Section Length = 60 s
    Number of Segments = 1
    Segment 1: On=2s, Off=4s
    
    Total Ring Length = 60s
    
    

    Пример 2 - Отличителен пръстен (къс, къс, къс, дълъг):

    
    60(.2/.2,.2/.2,.2/.2,1/4)
    
    Number of Cadence Sections = 1
    Cadence Section 1: Section Length = 60s
    Number of Segments = 4
    Segment 1: On=0.2s, Off=0.2s
    Segment 2: On=0.2s, Off=0.2s
    Segment 3: On=0.2s, Off=0.2s
    Segment 4: On=1.0s, Off=4.0s
    
    Total Ring Length = 60s
    
    
  • DialPlanScript — синтаксис за скриптиране, който се използва за определяне на плановете за набиране на ред 1 и ред 2.

  • Float <n>—стойност с плаваща запетая с до n знака след десетичната запетая.

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

    • SIP.CISCO.COM:5060 или 109.12.14. 12:12345

    • SIP.Cisco.com или 109.12.14.12

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

    Синтаксис: F 1 @L 1 [, F 2 @L 2 [, F 3 @L 3 [, F 4 @L 4 [, F 5 @L 5 [, F 6 @L 6]]]], където:

    • F 1 —F 6 са честоти в Hz (само неподписани цели числа).

    • L 1 —L 6 са съответните нива в dBm (с до един знак след десетичната запетая).

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

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

    
    440@-10
    
    Number of Frequencies = 1
    Frequency 1 = 440 Hz at –10 dBm
    
    

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

    
    350@-19,440@-19
    
    Number of Frequencies = 2
    Frequency 1 = 350 Hz at –19 dBm
    Frequency 2 = 440 Hz at –19 dBm
    
  • IP— Валиден IPv4 адрес под формата на x.x.x.x, където x е между 0 и 255. Пример: 10.1.2.100.

  • UserID — потребителски идентификатор, както се показва в URL адреса; до 63 знака.

  • Телефон — низ от телефонни номера, като 14081234567, *69, *72, 345678; или общ URL адрес, като например 1234 @10 .10.10. 100:5068 или jsmith@Cisco.com. Низът може да съдържа до 39 знака.

  • PHTMPLT - шаблон за телефонен номер. Всеки шаблон може да съдържа един или повече шаблони, които са разделени със запетая (,). Бялото пространство в началото на всеки модел се игнорира. „?“ и „*“ представляват заместващи символи. За да представите буквално, използвайте %xx. Пример% 2a представлява *. Шаблонът може да съдържа до 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>—Подписана n-битова стойност. Тя може да бъде посочена в десетичен или шестостенен формат. Знакът „-“ трябва да предхожда отрицателните стойности. Знак + преди положителните стойности не е задължителен.

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

  • Str <n>—общ низ с до n незапазени символа.

  • Време <n>— продължителност на времето в секунди, с до n знака след десетичната запетая. Допълнително зададените десетични знаци се игнорират.

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

    Синтаксис: FreqScript; Z 1 [; Z 2].

    Разделът Z 1 е подобен на секцията S 1 в CADScript, с изключение на това, че всеки сегмент за включване/изключване е последван от параметър на честотните компоненти: Z 1 = D 1 (на i, 1 /off i,1 /f i,1 [, на i, 2 /off i, 2 [, on i, 3 /off i,3 [, на i, 4 /off i, 4 f i ,4 [, включено i ,5 /изключено i,5 /f i ,5 [, на i, 6/изключено i,6/f i,6]]]]]) където:

    • f i, j = n 1 [+n 2] +n 3 [+n 4 [+n 5 [+n 6]]]].

    • 1 < n k < 6 определя честотните компоненти във FreqScript, които се използват в този сегмент.

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

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

    
    350@-19,440@-19;10(*/0/1+2)
    
    Number of Frequencies = 2
    Frequency 1 = 350 Hz at –19 dBm
    Frequency 2 = 440 Hz at –19 dBm
    Number of Cadence Sections = 1
    Cadence Section 1: Section Length = 10 s
    Number of Segments = 1
    Segment 1: On=forever, with Frequencies 1 and 2
    
    Total Tone Length = 10s
    
    

    Пример 2 - Тон на заекване:

    
    350@-19,440@-19;2(.1/.1/1+2);10(*/0/1+2)
    
    Number of Frequencies = 2
    Frequency 1 = 350 Hz at –19 dBm
    Frequency 2 = 440 Hz at –19 dBm
    Number of Cadence Sections = 2
    Cadence Section 1: Section Length = 2s
    Number of Segments = 1
    Segment 1: On=0.1s, Off=0.1s with Frequencies 1 and 2
    Cadence Section 2: Section Length = 10s
    Number of Segments = 1
    Segment 1: On=forever, with Frequencies 1 and 2
    
    Total Tone Length = 12s
    
    
  • Uns <n>— неподписана n-битова стойност, където n = 8, 16 или 32. Тя може да бъде посочена в десетичен или шестостенен формат, като 12 или 0x18, стига стойността да се побере в n бита.

Пазете тези под внимание:

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