Налаштуйте свій телефон для повторної синхронізації профілю.

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

Телефон підтримує кілька мережевих протоколів для отримання профілів конфігурації. Найпростіший протокол перенесення профілю — TFTP (RFC1350). TFTP широко використовується для підготовки мережевих пристроїв у приватних мережах LAN. Хоча не рекомендовано для розгортання віддалених кінцевих точок через Інтернет, TFTP може бути зручним для розгортання в невеликих організаціях, для підготовки в приміщенні, а також для розробки та тестування. У вказаній далі процедурі профіль буде змінено після завантаження файлу з сервера TFTP.

1

У середовищі локальної мережі підключіть свій комп’ютер і телефон до вузла, комутатора або невеликого маршрутизатора.

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_A зі значенням 12345678.

8

Упевніться, що параметр було оновлено правильно. Оновіть вебсторінку адміністрування та перейдіть до Голос > Підготовка.

Параметр GPP_A тепер має містити значення 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_Rule> tftp://192.168.1.200/CP-8875$MA.cfg Rule>
rofile_
7

Клацніть Надіслати всі зміни. Це призведе до негайного перезавантаження та повторної синхронізації.

Коли відбувається наступна повторна синхронізація, телефон отримує новий файл, розгорнувши вираз макросу $MA в свою MAC-адресу.

Повторно синхронізувати профіль телефону за допомогою HTTP GET
1

Установіть HTTP-сервер на локальний комп’ютер або інший доступний хост.

Сервер Apache з відкритим кодом можна завантажити з інтернету.

2

Передайте файл профілю конфігурації до віртуального кореневого каталогу встановленого сервера.

3

Щоб перевірити правильне встановлення сервера й доступ до файлу профілю, відкрийте профіль у веббраузері.

4

Змініть Рrofile_Правило тестового телефону, щоб указати на сервер HTTP замість сервера TFTP, щоб періодично завантажувати його профіль.

Наприклад, якщо сервер HTTP має значення 192.168.1.300, а ім’я файлу профілю basic.txt, введіть таке значення:

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

Клацніть Надіслати всі зміни. Це призведе до негайного перезавантаження та повторної синхронізації.

6

Слідкуйте за системними повідомленнями, які надсилає телефон. Тепер періодична повторна синхронізація повинна отримувати профіль із сервера HTTP.

7

У журналах HTTP-серверів спостерігайте, як інформація, яка ідентифікує тестовий телефон, відображається в журналі операторів користувачів.

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

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

Пристрій може періодично повторно синхронізуватися з сервером підготовки, щоб переконатися, що будь-які зміни профілю, внесені на сервері, поширюються на кінцевий пристрій (на відміну від надсилання явного запиту на повторну синхронізацію кінцевому пристрою).

Щоб викликати періодичну повторну синхронізацію телефона на сервер, URL-адресу профілю конфігурації визначається за допомогою параметра Profile_Rule, а період повторної синхронізації визначається за допомогою параметра Resync_Periodic.

1

Перейдіть на вебсторінку адміністрування телефонів.

2

Виберіть Голос  > Підготовка.

3

Визначте параметр Profile_Rule. Цей приклад припускає, що IP-адреса сервера TFTP дорівнює 192.168.1.200.

4

У полі Періодична повторна синхронізація введіть невелике значення для перевірки, наприклад 30 секунд.

5

Клацніть Надіслати всі Зміни.

Завдяки новим параметрам телефон повторно синхронізується двічі на хвилину до файлу конфігурації, вказаного в URL.

6

Слідкуйте за отриманими повідомленнями в трасі системного лотка.

7

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

 <Resync_On_Скинути>ТакOn_Скинути>
esync_
8

Увімкніть цикл телефону, щоб змусити його повторно синхронізуватися з сервером підготовки.

Якщо операція повторної синхронізації зазнає невдачі з будь-якої причини, наприклад якщо сервер не відповідає, то модуль очікує (за кількість секунд, налаштовану в Помилка повторної синхронізації. Затримка повторення спроб) перед повторною синхронізацією. Якщо затримка помилки повторної синхронізації становить нуль, телефон не намагатиметься повторно синхронізувати після невдалої спроби повторної синхронізації.

9

(Необов’язково) Установіть значення поля Повторна синхронізація помилки повторної спроби до невеликого числа, наприклад 30.

 <Resync_Error_Retry_Затримка>30Error_Retry_Затримка>
esync_
10

Вимкніть сервер TFTP і перегляньте результати у виході syslog.

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

У наведеній нижче таблиці визначено функцію та використання параметрів повторної синхронізації профілю в розділі Профіль конфігурації на вкладці Голос > Підготовка на вебсторінці телефону. Він також визначає синтаксис рядка, який додається до файлу конфігурації телефону (cfg.xml) з XML-кодом для налаштування параметра.

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

Параметр

Опис

Увімкнути підготовку

Дозволяє або забороняє повторну синхронізацію профілю конфігурації.

  • У файлі конфігурації телефону (cfg.xml) з XML введіть рядок у цьому форматі:

    <Provision_Увімкнути ua="na">ТакУвімкнути>rovision_

  • На вебсторінці телефону встановіть у це поле значення Так , щоб дозволити повторну синхронізацію дій, або Ні , щоб блокувати повторну синхронізацію дій.

За замовчуванням: Так

Повторна синхронізація після скидання

Визначає, чи буде телефон повторно синхронізувати конфігурації з сервером підготовки після power up і після кожної спроби оновлення версії.

  • У файлі конфігурації телефону (cfg.xml) з XML введіть рядок у цьому форматі:

    <Resync_On_Reset ua="na">ТакOn_Reset>esync_

  • На вебсторінці телефону встановіть у це поле значення Так , щоб дозволити повторну синхронізацію під час увімкнення або скидання, або Ні , щоб блокувати повторну синхронізацію під час увімкнення або скидання.

За замовчуванням: Так

Повторна синхронізація випадкової затримки

Запобігає перевантаженню сервера підготовки в разі одночасного ввімкнення великої кількості пристроїв і спроб початкової конфігурації. Ця затримка набуває чинності лише під час початкової спроби конфігурації після увімкнення або скидання пристрою.

Цей параметр є максимальним інтервалом часу, який пристрій очікує, перш ніж зв’язатися з сервером підготовки. Фактична затримка є псевдовипадковим числом від 0 до цього значення.

Цей параметр має значення в одиницях по 20 секунд.

Допустиме значення має діапазон від 0 до 65535.

  • У файлі конфігурації телефону (cfg.xml) з XML введіть рядок у цьому форматі:

    <Resync_Random_Затримка ua="na">2Random_Затримка>esync_

  • На вебсторінці телефону вкажіть кількість одиниць (20 секунд), протягом яких телефон повинен затримати повторну синхронізацію після увімкнення або скидання.

Значення за замовчуванням: 2 (40 секунд).

Повторна синхронізація О (ГГмм)

Час (ГГмм) повторної синхронізації телефону з сервером підготовки.

Значення цього поля має складатися з чотирьох цифр у діапазоні від 0000 до 2400, щоб указати час у форматі ГГмм. Наприклад, 0959 позначає 09:59.

  • У файлі конфігурації телефону (cfg.xml) з XML введіть рядок у цьому форматі:

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

  • На вебсторінці телефону вкажіть час у форматі ГГхх, щоб телефон почав повторну синхронізацію.

Значення за замовчуванням пусте. Якщо значення неприпустиме, параметр ігнорується. Якщо цей параметр задано допустиме значення, параметр періодичної повторної синхронізації ігнорується.

Повторна синхронізація З Випадковою Затримкою

Запобігає перевантаженню сервера підготовки, коли одночасно працює велика кількість пристроїв.

Щоб уникнути затоплення запитів повторної синхронізації до сервера з кількох телефонів, телефон повторно синхронізується в діапазоні від годин до хвилин, годин і хвилин плюс випадкова затримка (гмм, гмм+random_delay). Наприклад, якщо випадкова затримка = (повторна синхронізація Під Час Випадкової Затримки + 30)/60 хвилин, введене значення в секундах перетворюється на хвилини, заокруглюючи до наступної хвилини для обчислення кінцевого random_delay інтервалу.

  • У файлі конфігурації телефону (cfg.xml) з XML введіть рядок у цьому форматі:

    <Resync_At_Random_Затримка ua="na">600At_Random_Затримка>esync_

  • На вебсторінці телефону вкажіть період у секундах.

Допустиме значення має діапазон від 600 до 65535.

Якщо значення менше ніж 600, внутрішня випадкова затримка становить від 0 до 600.

Значення за замовчуванням: 600 секунд (10 хвилин).

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

Інтервал часу між періодичною повторною синхронізацією із сервером підготовки. Пов’язаний таймер повторної синхронізації активний лише після першої успішної синхронізації з сервером.

Допустимі формати:

  • Ціле число

    Приклад: Вхідні дані 3000 означають, що наступна повторна синхронізація відбувається за 3000 секунд.

  • Кілька цілих чисел

    Приклад: Вхід 600,1200,300 вказує, що перша повторна синхронізація відбувається за 600 секунд, друга повторна синхронізація відбувається за 1200 секунд після першої, а третя повторна синхронізація відбувається за 300 секунд після другої.

  • Діапазон часу

    Наприклад, введення значення 2400+30 вказує, що наступна повторна синхронізація відбувається через 2400–2430 секунд після успішної повторної синхронізації.

  • У файлі конфігурації телефону (cfg.xml) з XML введіть рядок у цьому форматі:

    <Resync_Періодичний ua="na">3600Періодичний>esync_

  • На вебсторінці телефону вкажіть період у секундах.

Щоб вимкнути періодичну повторну синхронізацію, установіть цей параметр на нуль.

Значення за замовчуванням — 3600 секунд.

Помилка повторної синхронізації. Затримка повторення спроб

Якщо не вдасться виконати повторну синхронізацію через те, що телефон не вдалось отримати профіль із сервера, або завантажений файл пошкоджено, або сталася внутрішня помилка, телефон спробує повторно синхронізувати знову через вказаний у секундах час.

Допустимі формати:

  • Ціле число

    Приклад: Введення значення 300 вказує на те, що наступна повторна спроба повторної синхронізації відбудеться за 300 секунд.

  • Кілька цілих чисел

    Приклад: Введення значення 600,1200,300 вказує, що перша повторна спроба відбувається через 600 секунд після помилки, друга повторна спроба відбувається через 1200 секунд після помилки першої повторної спроби, а третя — через 300 секунд після помилки другої повторної спроби.

  • Діапазон часу

    Наприклад, введення значення 2400+30 вказує, що наступна повторна спроба відбувається через 2400–2430 секунд після помилки повторної синхронізації.

Якщо затримка встановлена на 0, пристрій не спробує повторно синхронізувати після невдалої спроби повторної синхронізації.

  • У файлі конфігурації телефону (cfg.xml) з XML введіть рядок у цьому форматі:

    <Resync_Error_Retry_Затримка ua="na">60,120,240,480,960,1920,3840,7680,15360,30720,61440,86400Error_Retry_Затримка>esync_

  • На вебсторінці телефону вкажіть період у секундах.

За замовчуванням: 60,120,240,480,960,1920,3840,7680,15360,30720,61440,86400

Затримка примусової повторної синхронізації

Максимальна затримка (у секундах), протягом якої телефон очікує перед повторною синхронізацією.

Пристрій не повторно синхронізується, поки активна одна з його телефонних ліній. Оскільки повторна синхронізація може тривати кілька секунд, бажано зачекати, поки пристрій перебуватиме в режимі очікування протягом тривалого періоду часу, перш ніж повторна синхронізація. Це дозволяє користувачу здійснювати виклики послідовно без переривань.

Пристрій має таймер, який починає відлік, коли всі його лінії стають у режимі очікування. Цей параметр є початковим значенням лічильника. Повторна синхронізація подій відкладається, поки цей лічильник не зменшиться до нуля.

Допустиме значення має діапазон від 0 до 65535.

  • У файлі конфігурації телефону (cfg.xml) з XML введіть рядок у цьому форматі:

    <Forced_Resync_Затримка ua="na">14400Resync_Затримка>orced_

  • На вебсторінці телефону вкажіть період у секундах.

Значення за замовчуванням складає 14 400 секунд.

Повторна синхронізація з SIP

Керує запитами на повторну синхронізацію через подію СПОВІЩЕННЯ SIP, надіслану від проксі-сервера постачальника послуг на телефон. Якщо цей параметр увімкнено, проксі може подати запит на повторну синхронізацію, надіславши повідомлення СПОВІЩЕННЯ SIP, що містить Подію: повторно синхронізувати заголовок пристрою.

  • У файлі конфігурації телефону (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

Якщо логічне рівняння в цих параметрах оцінює як FALSE, повторна синхронізація не запускається, навіть якщо параметр Повторна синхронізація після скидання задано значення TRUE. Сповіщення про ці тригери повторної синхронізації через 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

Додаткову інформацію див. в розділі Задати тип автентифікації профілю в розділі Задати телефон для повторної синхронізації профілю.

Правило профілю

Правило профілю B

Правило C профілю

Правило профілю D

Кожне правило профілю повідомляє телефон джерела, з якого отримати профіль (файл конфігурації). Під час кожної операції повторної синхронізації телефон послідовно застосовує всі профілі.

Якщо ви застосовуєте шифрування AES-256-CBC до файлів конфігурації, зазначте ключ шифрування за допомогою ключового слова --key так:

[--key ]

"Додатково можна додати ключ шифрування до подвійних лапок ("")."

  • У файлі конфігурації телефону (cfg.xml) з XML введіть рядок у цьому форматі:

    <Profile_Rule ua="na">/$PSN.xmlRule>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

Можна підготувати телефони за допомогою функцій Cisco XML.

Можна надіслати об’єкт XML на телефон за допомогою пакета сповіщень SIP або повідомлення HTTP до інтерфейсу 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 за допомогою стандартного синтаксису :порт після імені сервера.

  • Підкаталог віртуального кореневого каталогу сервера, у якому зберігається профіль, заданий за допомогою стандартних нотацій URL і керується за допомогою розширення макросів.

Наприклад, наведене далі правило Profile_Rule запитує файл профілю ($PN.cfg) у підкаталозі сервера /cisco/config від сервера TFTP, який працює на хост prov.telco.com, для прослуховування підключення на порту 6900: 

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

Профіль для кожного телефону можна ідентифікувати в параметрі загального призначення; його значення зазначається в спільному правилі профілю за допомогою розширення макросу.

Наприклад, припустімо, що GPP_B визначається як Dj6Lmp23Q.

Правило Рrofile_має значення:

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

Коли пристрій повторно синхронізується та макроси розгорнуто, телефон з MAC-адресою 000e08012345 запитує профіль із ім’ям, що містить MAC-адресу пристрою, за такою URL-адресою:

 tftp://prov.telco.com/cisco/Dj6Lmp23Q/000e08012345.cfg
Укажіть тип автентифікації профілю

Автентифікація профілю дозволяє користувачам телефону повторно синхронізувати профіль підготовки на телефоні. Інформація для автентифікації потрібна, коли телефон вперше намагається повторно синхронізувати та завантажити файл конфігурації та отримує помилку автентифікації HTTP або HTTPS 401. Якщо ввімкнути цю функцію, на телефоні відображатиметься екран Налаштування облікового запису профілю для таких ситуацій:

  • Коли під час першої підготовки після перезавантажень телефону виникає помилка автентифікації HTTP або HTTP 401

  • Якщо ім’я користувача та пароль облікового запису профілю пусті

  • Якщо в правилі профілю немає імені користувача й пароля

Якщо екран Налаштування облікового запису профілю пропущено або проігноровано, користувач також може отримати доступ до екрана налаштування через меню екрана телефону або програмну клавішу Налаштування , яка відображається, лише коли на телефоні не зареєстровано жодної лінії.

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

Ім’я користувача й пароль у полі Правило профілю мають вищий пріоритет, ніж обліковий запис профілю.

  • Якщо в полі Правило профілю вказано правильну URL-адресу без імені користувача та пароля, для повторної синхронізації профілю телефон потребує автентифікації або дайджест. З правильним обліковим записом профілю автентифікація проходить. Автентифікація відбувається через неправильний обліковий запис профілю.

  • Якщо в полі Правило профілю вказано правильну URL-адресу з правильним ім’ям користувача та паролем, для повторної синхронізації профілю телефон потребує автентифікації або дайджест. Обліковий запис профілю не використовується для повторної синхронізації телефону. Вхід виконано успішно.

  • Якщо в полі Правило профілю вказано правильну URL-адресу з неправильним ім’ям користувача та паролем, для повторної синхронізації профілю телефон потребує автентифікації або дайджест. Обліковий запис профілю не використовується для повторної синхронізації телефону. Вхід завжди не вдається.

  • Якщо в полі Правило профілю вводиться неправильна URL-адреса, вхід завжди не вдається.

Також можна налаштувати параметри в файлі конфігурації телефону за допомогою коду XML(cfg.xml).

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

1

Перейдіть на вебсторінку адміністрування телефонів.

2

Виберіть Голос > Підготовка.

3

У розділі Профіль конфігурації налаштуйте параметр Тип автентифікації профілю , щоб указати облікові дані, які будуть використовуватися для автентифікації облікового запису профілю.

Можна налаштувати цей параметр у файлі конфігурації телефону (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-адресу телефонної локальної мережі, 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. Якщо ви змінюєте профіль у редакторі, не змінюйте формат кодування, інакше телефон не зможе розпізнати файл.

Кожен телефон має різний набір функцій, а отже, різний набір параметрів.

Відкрити формат профілю

Профіль відкритого формату — це текстовий файл з XML-подібним синтаксисом у ієрархії елементів, з атрибутами елемента та значеннями. Цей формат дозволяє використовувати стандартні інструменти для створення файлу конфігурації. Файл конфігурації XML можна надіслати з сервера підготовки на телефон під час повторної синхронізації без компіляції як двійковий об’єкт.

Телефон може приймати формати конфігурації, які генерують стандартні інструменти. Ця функція полегшує розробку програмного забезпечення резервної підготовки сервера, яке генерує профілі конфігурації з наявних баз даних.

Щоб захистити конфіденційну інформацію в профілі конфігурації, сервер підготовки передає файл конфігурації XML на телефон через канал, захищений TLS. Додатково файл може бути стиснутий за допомогою алгоритму GZIP deflate (RFC165).

Файл можна зашифрувати за допомогою одного з таких способів шифрування:

  • Шифрування AES-256-CBC

  • Шифрування контенту на основі RFC-8188 за допомогою шифрування AES-128-GCM

Файл конфігурації може містити такі компоненти:

  • Теги елементів

  • Атрибути

  • Параметри

  • Функції форматування

  • Коментарі XML

Приклад: Відкрити формат профілю

 <flat-profile> <Resync_абоn_Скинути> Так абоn_Скинути> <Resync_Періодично> 7200 Періодично> <Profile_Правило> tftp://prov.telco.com:6900/cisco/config/CP_xxxx_MPP.cfgПравило> </flat-profile>
esync_esync_rofile_

Тег елемента містить усі елементи параметрів, які розпізнає телефон.

Властивості тега елемента

Майте на увазі наведені нижче правила під час створення або оновлення файлу конфігурації.

  • Формат підготовки XML і вебінтерфейс дозволяють конфігурацію тих самих параметрів. Імена тегів XML і імена полів у вебінтерфейсі подібні, але відрізняються через обмеження імен елементів XML. Наприклад, підкреслює ( _ ) у файлі конфігурації XML, а не простори вебінтерфейсу користувача.

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

  • Імена елементів закриті кутовими дужками.

  • Більшість імен елементів подібні до імен полів у вебінтерфейсі телефона із такими змінами:

    • Імена елементів не можуть містити пробіли або спеціальні символи. Щоб отримати ім’я елемента з імені вебполя, замініть підкреслення для кожного простору або спеціальних символів [, ], (, ) або /.

      Приклад:" Елемент <Resync_On_Reset> представляє поле ""Повторна синхронізація під час скидання ""."

    • Кожне ім’я елемента має бути унікальним. "У вебінтерфейсі телефона ті самі поля можуть з’являтися на кількох вебсторінках, як-от сторінки ""Лінія"", ""Користувач"" та ""Додаткові номери""." Додайте [n] до імені елемента, щоб зазначити номер, що відображається на вкладці сторінки.

      Приклад:Елемент <Dial_Plan_1_> представляє абонентську групу для лінії 1.

  • Кожен тег відкритого елемента повинен мати відповідний тег закривального елемента. Наприклад:

      <Resync_абоn_Скинути> Так абоn_Скинути> <Resync_Періодично> 7200 Періодично> <Profile_Правило>tftp://prov.telco.com:esync_esync_ 6900/cisco/config/CP_xxxx_MPP.cfg Правило>
    rofile_

  • Теги елементів чутливі до регістру.

  • Дозволено використовувати пусті теги елементів, їх буде інтерпретовано як налаштування значення на пусте. Введіть тег відкритого елемента без відповідного тега елемента, а потім вставте пробіл і вперед скісну риску перед дужкою закривного кута (>). У цьому прикладі правило профілю B порожнє:

     <Profile_Rule_B />

  • Щоб запобігти перезапису будь-яких введених користувачем значень під час повторної синхронізації, можна використовувати пустий тег елемента. У наведеному нижче прикладі налаштування швидкого набору користувачів не змінюються:

    <flat-profile> <Speed_дial_2_Ім’я ua="rw"/> <Speed_дial_2_Номер ua="rw"/> <Speed_дial_3_Ім’я ua="rw"/> <Speed_дial_3_Номер ua="rw"/> <Speed_дial_4_Ім’я ua="rw"/> <Speed_дial_4_Номер ua="rw"/> <Speed_дial_5_Ім’я ua="rw"/> <Speed_дial_5_Номер ua="rw"/> <Speed_дial_6_Ім’я ua="rw"/> <Speed_дial_6_Номер ua="rw"/> <Speed_дial_7_Ім’я ua="rw"/> <Speed_дial_7_Номер ua="rw"/> <Speed_дial_8_Ім’я ua="rw"/> <Speed_дial_8_Номер ua="rw"/> <Speed_дial_9_Ім’я ua="rw"/> <Speed_дial_9_Номер ua="rw"/> </flat-profile>

  • Використовуйте пусте значення, щоб установити відповідний параметр у пустий рядок. Введіть елемент відкриття та закриття без будь-якого значення між ними. У наведеному нижче прикладі параметр GPP_A встановлено на пустий рядок.

     <flat-profile> <GPP_A>   A> </flat-profile>
    _

  • Нерозпізнані імена елементів ігноруються.

Властивості параметра

Ці властивості застосовуються до параметрів:

  • Усі параметри, не задані профілем, залишаються незмінними на телефоні.

  • Нерозпізнані параметри ігноруються.

  • Якщо профіль відкритого формату містить кілька повторень одного й того ж тега параметра, останнє таке повторення перевизначає будь-які попередні повторення. Щоб уникнути ненавмисного перевизначення значень конфігурації для параметра, рекомендовано для кожного профілю задавати не більше одного екземпляра параметра.

  • Пріоритет має останній оброблений профіль. Якщо кілька профілів задають один і той самий параметр конфігурації, пріоритет має значення останнього профілю.

Формати рядків

Ці властивості застосовуються до форматування рядків:

  • Коментарі дозволені за допомогою стандартного синтаксису XML.

  • Пробіли, що починаються та закінчуються, дозволені для читання, але їх видалено зі значення параметра.

  • Нові лінії всередині значення перетворюються на пробіли.

  • Заголовок XML форми <? ?> дозволено, але телефон його ігнорує.

  • Щоб ввести спеціальні символи, використовуйте основні символи XML, як показано в таблиці нижче.

    Спеціальний символ

    Послідовність Escape XML

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

    &

    < (менше ніж)

    <

    > (більше ніж)

    >

    » (апостроф)

    '

    » (подвійна цитата)

    "

    У наступному прикладі вводиться пробіли символів, які відповідають символам, більшим або меншим за символи, які потрібні в правилі абонентської групи. Цей приклад визначає інформаційну абонентську групу гарячої лінії, яка встановлює параметр <Dial_Plan_1_> (Вхід адміністратора > розширені > Голос > Ext (n)), рівний (S0 ).

    <
     flat-profile> <Dial_Plan_1_> (S0 ) Plan_1_>
    ial_

  • Використання числового символу, що використовується десяткове та шістнадцяткове значення (напр. ( і .), перекладені.

  • Мікропрограма телефона підтримує лише символи ASCII.

Стискання та шифрування профілю (XML)

Профіль конфігурації Відкрити можна стиснути, щоб зменшити навантаження мережі на сервері підготовки. Профіль також можна зашифрувати для захисту конфіденційної інформації. Стискання не потрібне, але воно має передувати шифруванню.

Відкрити стискання профілю

Підтримуваним методом стискання є алгоритм дефляції gzip (RFC165). Утиліта gzip і бібліотека стискання, що реалізує той самий алгоритм (zlib), доступні з інтернет-сайтів.

Щоб визначити стискання, телефон очікує, що стиснутий файл міститиме заголовок, сумісний з GZIP. Виклик програми gzip у початковому відкритому профілі створює заголовок. Телефон перевіряє заголовок завантаженого файлу, щоб визначити формат файлу.

Наприклад, якщо profile.xml є допустимим профілем, то також буде прийнято файл profile.xml.gz . Будь-яка з наведених далі команд може створити цей тип профілю.

  • >gzip profile. xml

    Замінює оригінальний файл стиснутим файлом.

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

    Залишає оригінальний файл на місці й створює новий стиснутий файл.

Відкрити шифрування профілю

Шифрування симетричних ключів можна використовувати для шифрування відкритого профілю конфігурації, незалежно від того, стискається файл чи ні. Стискання, якщо застосовано, має бути застосовано до шифрування.

Сервер підготовки використовує HTTPS для обробки початкової підготовки телефону після розгортання. Попереднє шифрування профілів конфігурації в автономному режимі дозволяє використовувати HTTP для подальшої повторної синхронізації профілів. Це зменшує навантаження на сервер HTTPS у великомасштабних розгортаннях.

Телефон підтримує два способи шифрування файлів конфігурації:

  • Шифрування AES-256-CBC

  • Шифрування HTTP-контенту на основі RFC 8188 за допомогою шифрування AES-128-GCM

Ключ або вхідний матеріал Keying Material (IKM) необхідно попередньо підготувати в блок раніше. Бутстреп секретного ключа можна виконати безпечно за допомогою HTTPS.

Ім’я файлу конфігурації не вимагає певного формату, але ім’я файлу, що закінчується розширенням .cfg , зазвичай вказує на профіль конфігурації.

Шифрування AES-256-CBC

Телефон підтримує шифрування AES-256-CBC для файлів конфігурації.

Інструмент шифрування OpenSSL, доступний для завантаження з різних інтернет-сайтів, може виконувати шифрування. Підтримка 256-розрядного шифрування AES може вимагати перекомпіляції інструменту для ввімкнення коду AES. Мікропрограму було протестовано на версію openssl-1.1.1d.

Для зашифрованого файлу профіль очікує, що файл матиме той самий формат, що й створений нашою командою:

 # приклад ключа шифрування = SecretPhrase1234 openssl enc –e –aes-256-cbc –k SecretPhrase1234 –in profile.xml –out profile.cfg # аналоговий виклик для стиснутого файлу xml openssl enc –e –aes-256-cbc –k SecretPhrase1234 –in profile.xml.gz –out profile.cfg

Нижній регістр -k передує секретному ключу, який може бути будь-якою звичайною текстовою фразою, і який використовується для створення випадкової 64-розрядної сілі. З секретом, заданим аргументом -k, інструмент шифрування отримує випадковий 128-розрядний початковий вектор і фактичний 256-розрядний ключ шифрування.

Якщо ця форма шифрування використовується в профілі конфігурації, телефон повинен бути повідомлений про значення секретного ключа для дешифрування файлу. Це значення вказано як кваліфікатор в URL профілю. Синтаксис працює так, використовуючи явну URL-адресу:

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

Це значення запрограмовано за допомогою одного з параметрів Рrofile_Правила .

Розширення макросів

Перед оцінюванням декілька параметрів підготовки проходять внутрішнє розширення макросу. Цей крок попереднього оцінювання забезпечує більшу гнучкість під час керування повторною синхронізацією телефону та оновленням версії.

Ці групи параметрів проходять макророзширення перед оцінкою:

  • Рesync_Тrigger_*

  • Пrofile_правило*

  • Log_xxx_Msg

  • Upgrade_Правило

За певних умов деякі параметри загального призначення (GPP_*) також піддаються макророзширенню, як чітко зазначено в розділі Необов’язкові параметри повторної синхронізації нижче.

Під час розширення макросів вміст іменованих змінних замінюють вирази форм $NAME і $(NAME). Ці змінні включають параметри загального призначення, кілька ідентифікаторів продуктів, певні таймери подій і значення стану підготовки. Повний список див. в розділі Змінні розширення макросів у розділі Параметри підготовки.

У наведеному нижче прикладі вираз $(MAU) використовується для вставки MAC-адреси 000E08012345.

Адміністратор входить: $(MAU)config.cfg

Отримане розширення макросу для пристрою з MAC-адресою 000E08012345: 000E08012345config.cfg

Якщо ім’я макросу не розпізнано, воно залишається нерозгорнутим. Наприклад, ім’я STRANGE не розпізнається як допустиме ім’я макросу, тоді як MAU визнано допустимим ім’ям макросу.

Адміністратор входить: $STRANGE$MAU.cfg

Отримане розширення макросу для пристрою з MAC-адресою 000E08012345 дорівнює: $STRANGE ‌ E08012345.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

Порівняння

Цитовані рядки можна порівняти для рівності або нерівності. Цілі та номери версій також можна порівняти арифметично. Оператори порівняння можуть бути виражені як символи або як абревіатури. Абревіатури зручні для вираження умови в профілі Відкритого формату.

Оператор

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

Опис

Застосовується до цілих операндів і операндів версії

Застосовується до цитованих строкових операндів

=

екв

дорівнює

Так

Так

!=

не

не дорівнює

Так

Так

<

lt

менше ніж

Так

Ні

<=

Вікторія

менше або дорівнює

Так

Ні

>

gt

більше ніж

Так

Ні

>=

гт

більше або дорівнює

Так

Ні

ТА

та

Так

Так

Важливо включити макрозмінні в подвійні лапки, де очікується рядок літералів. Не робіть цього там, де очікується номер або номер версії.

При використанні в контексті параметрів Рrofile_Правила* та 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_Rule* та Upgrade_Rule відповідно. Синтаксис такий:

[ scheme:// ] [ сервер [:порт]] шлях файлу

Де схема є одним із таких значень:

  • 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 пустий синтаксис не підтримується правилами оновлення версії. Він застосовується лише до правила профілю*.

Шифрування HTTP-контенту на основі RFC 8188

Телефон підтримує шифрування HTTP-контенту на основі RFC 8188 з шифруванням AES-128-GCM для файлів конфігурації. За допомогою цього методу шифрування будь-який запис може читати заголовки повідомлень HTTP. Однак лише об'єкти, які знають вхідний матеріал Keying Material (IKM), можуть читати корисне навантаження. Коли телефон забезпечено IKM, телефон і сервер підготовки можуть безпечно обмінюватися файлами конфігурації, дозволяючи стороннім мережевим елементам використовувати заголовки повідомлень для аналітичних і моніторингових цілей.

Параметр конфігурації XML IKM_HTTP_Encrypt_Content утримує IKM на телефоні. З міркувань безпеки цей параметр недоступний на вебсторінці адміністрування телефону. Він також не відображається у файлі конфігурації телефону, до якого можна отримати доступ з IP-адреси телефону або з звітів про конфігурацію телефону, надісланих на сервер підготовки.

Якщо ви хочете використовувати шифрування на основі RFC 8188, переконайтеся, що таке:

  • Підготуйте телефон IKM, зазначивши IKM за допомогою параметра XML IKM_HTTP_Encrypt_Content у файлі конфігурації, який надсилається від сервера підготовки на телефон.

  • Якщо це шифрування застосовується до файлів конфігурації, надісланих із сервера підготовки на телефон, переконайтеся, що заголовок Content-Encoding HTTP у файлі конфігурації має aes165 gcm.

    За відсутності цього заголовка пріоритет надається метод AES-256-CBC. Телефон застосовує дешифрування AES-256-CBC, якщо ключ AES-256-CBC присутній у правилі профілю, незалежно від IKM.

  • Якщо ви хочете, щоб телефон застосував це шифрування до звітів про конфігурацію, які він надсилає на сервер підготовки, переконайтеся, що в правилі звіту не вказано ключ AES-256-CBC.

Необов’язкові параметри повторної синхронізації

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

клавіша

Параметр --key повідомляє телефону, що файл конфігурації, який він отримує від сервера підготовки, зашифровано шифруванням AES-256-CBC, якщо тільки заголовок Content-Encoding у файлі не вказує на шифрування aes✓ gcm . Сам ключ вказано як рядок, що слідує за терміном --key. Додатково ключ може бути додано в подвійні лапки ("). Телефон використовує ключ для дешифрування файлу конфігурації.

Приклади використання
 [--key VerySecretValue] [--key «моя секретна фраза»] [--key a37d2fb9055c1d04883a0745eb0917a4]

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

[--key $SC] [--key "$SD"]

У профілях відкритого формату аргумент до --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, …

  • Булеве — логічне значення «так» або «ні».

  • 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 мс. Символ узагальнення "*" означає нескінченну тривалість. Сегменти в розділі відтворюються в порядку й повторюються, доки не буде відтворено загальну тривалість.

    Приклад 1.

     60(2/4) Кількість розділів частот = 1 Розділ частот 1: Довжина розділу = 60 с Кількість сегментів = 1 Сегмент 1: увімк. = 2 с, вимк. = 4 с. Загальна довжина дзвінка = 60 с

    Приклад 2 — Distinctive ring (short, short, short, long):

     60(.2/.2,.2/.2,.2/.2,1/4) Кількість розділів частот = 1 Розділ частот 1: Довжина розділу = 60 с Кількість сегментів = 4 Сегмент 1: Увімкнено=0,2s, вимкнено=0,2s Сегмент 2: ON=0.2S, Off=0.2s Сегмент 3: ON=0.2S, Off=0.2s Сегмент 4: on=1,0s, off=4,0s Загальна довжина дзвінка = 60 с

  • 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 — це частота в Гц (лише цілі числа без підпису).

    • L1–L6 — це відповідні рівні в дБм (до одного знака після коми).

    Дозволені пробіли до та після коми, але не рекомендовано.

    Приклад 1 — Сигнал очікування виклику:

     440@-10 Кількість частот = 1 Частота 1 = 440 Гц при -10 дБм

    Приклад 2—Сигнал набору:

     350@-19,440@-19 Кількість частот = 2 Частота 1 = 350 Гц при -19 дБм Частота 2 = 440 Гц при -19 дБм

  • 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. For example, %2a представляє *. Шаблон може містити до 39 символів. Приклади: «1408*, 1510*», «1408123????, 555?1.».

  • Порт — номер порту TCP/UDP (0-65535). Він може бути заданий у форматі десяткового або шістнадцяткового.

  • ProvisioningRuleSyntax — синтаксис скриптів, який використовується для визначення повторної синхронізації конфігурації та правил оновлення мікропрограми.

  • PwrLevel — рівень потужності, виражений в дБм з одним десятковим місцем, наприклад -13,5 або 1,5 (дБм).

  • 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/fi,1[, увімкненоi, 2/вимк.i, 2/fi, 2 [, увімкненоi,3/вимк.i,3/fi,3 [, увімкненоi,4/вимк.i,4/fi,4 [, увімкненоi,5/вимк.i,5/fi,5 [, увімкненоi,6/вимк.i,6/fi,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 Гц при -19 дБм Частота 2 = 440 Гц при -19 дБм Кількість секцій частот = 1 Секція частот 1: Довжина розділу = 10 с Кількість сегментів = 1 Сегмент 1: Увімкнено=назавжди, з частотами 1 і 2 Загальна довжина сигналу = 10 с

    Приклад 2 — Сигнал затвору:

     350@-19,440@-19;2(.1/.1/1+2);10(*/0/1+2) Кількість частот = 2 Частота 1 = 350 Гц при -19 дБм Частота 2 = 440 Гц при -19 дБм Кількість секцій частот = 2 Секція частот 1: Довжина розділу = 2 с Кількість сегментів = 1 Сегмент 1: Увімк. = 0,1с, вимк. = 0,1с. з частотами 1 і 2, секція частот 2: Довжина розділу = 10 с Кількість сегментів = 1 Сегмент 1: Увімкнено=назавжди, з частотами 1 і 2 Загальна довжина сигналу = 12 с

  • Uns — непідписане n-бітне значення, де n = 8, 16 або 32. Він може бути заданий у форматі десяткового або шістнадцяткового, наприклад, 12 або 0x18, якщо значення може вміщатися в n біт.

Слідкуйте за ними:

  • представляє ім’я параметра конфігурації. "У профілі відповідний тег утворюється шляхом заміни простору на підкреслення ""_"", наприклад Par_Name."
  • Порожнє поле значення за замовчуванням має пустий рядок < "" >.
  • Телефон продовжує використовувати останні налаштовані значення для тегів, яких немає в певному профілі.
  • Шаблони порівнюються в даному порядку. Вибрано перший, не найближчий збіг. Ім’я параметра має точно збігатися.
  • Якщо в профілі наведено більше одного визначення параметра, останнє таке визначення у файлі є тим, що набуває чинності на телефоні.
  • Специфікація параметра з пустим значенням параметра змушує параметр повернутися до значення за замовчуванням. Щоб натомість задати пустий рядок, використовуйте пустий рядок «» як значення параметра.