Налаштування параметрів профілю для телефонів серії 9800 і 8875 (BroadWorks)

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

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

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

1	У середовищі локальної мережі підключіть комп'ютер і телефон до концентратора, комутатора або невеликого маршрутизатора.
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	Виберіть вкладку Голос > Заб езпечення та перевірте значення параметрів загального призначення 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` -адресою телефону). Приклад: `КП-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	У полі Пересинхронізувати періоди чно введіть невелике значення для тестування, наприклад 30 секунд.
5	Натисніть Надіслати всі зміни. З новими налаштуваннями параметрів телефон повторно синхронізується двічі на хвилину з файлом конфігурації, який вказує URL-адреса.
6	Спостерігайте за отриманими повідомленнями в трасуванні syslog.
7	Переконайтеся, що для поля Синхронізація при скиданні встановлено значення Так. `<Resync_On_Reset>Yes</Resync_On_Reset>`
8	Увімкніть телефон, щоб змусити його повторно синхронізувати з сервером забезпечення. Якщо операція повторної синхронізації не вдається з якоїсь причини, наприклад, якщо сервер не відповідає, пристрій чекає (кількість секунд, налаштованих у Resync Error 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 Perio dic ігнорується.
Пересинхронізація при випадковій затримці	Запобігає перевантаженню сервера забезпечення при одночасному включенні великої кількості пристроїв. Щоб уникнути затоплення запитів на повторну синхронізацію на сервер з декількох телефонів, телефон повторно синхронізується в діапазоні між годинами та хвилинами, а також годинами та хвилинами плюс випадковою затримкою (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 200 300` вказує на те, що перша повторна спроба відбувається через 600 секунд після збою, друга повторна спроба відбувається через 1200 секунд після відмови першої повторної спроби, а третя повторна спроба відбувається через 300 секунд після збою другої повторної спроби. Часовий діапазон Наприклад, введення `2400+30` вказує на те, що наступна повторна спроба відбувається через 2400 до 2430 секунд після збою повторної синхронізації. Якщо затримка встановлена на 0, пристрій не спробує повторно синхронізувати після невдалої спроби повторної синхронізації. У файлі конфігурації телефону (cfg.xml) з XML введіть рядок в такому форматі: `<Resync_Error_Retry_Delay ua="na">60,120,240,480,960,1920,3840,7680,15360,30720,61440,8640.8640.86400</Resync_Error_Retry_Delay>` На веб-сторінці телефону вкажіть часовий проміжок в секундах. За замовчуванням: 60,120,240,480,960,1920,3840,7680,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, що містить заголовок Event: 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, повторна синхронізація не спрацьовує, навіть якщо Resync On Reset встановлено значення TRUE. Лише повторна синхронізація через URL-адресу прямої дії та сповіщення SIP ігнорує ці тригери повторної синхронізації. Параметри можуть бути запрограмовані умовним виразом, який зазнає розширення макросу. Допустимі розширення макросів див. у розділі Змінні розширення макросів у розділі Параме три забезпечення. У файлі конфігурації телефону (cfg.xml) з XML введіть рядок в такому форматі: `<Resync_Trigger_1 ua="na">$ УПГТМР gt 300 і $ ПЕРВТМР 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 Докладніші відомості див. у розділі В кажіть тип автентифікації профілю в розділі Вкажіть телефон для повторної синхронізації профілю.
Правило профілю Правило профілю B Правило профілю 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, він завантажує файл забезпечення з [profile-rule]. Це правило використовує макроси для спрощення розробки програми XML-служб.

Роздільна здатність URL з розширенням макросів

Підкаталоги з декількома профілями на сервері забезпечують зручний метод управління великою кількістю розгорнутих пристроїв. URL-адреса профілю може містити:

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

Наприклад, наступне Profile_Rule запитує файл профілю ($PN.cfg) у підкаталозі сервера /cisco/config від сервера TFTP, який працює на host 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-адресу локальної мережі телефону, 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 може бути надісланий з сервера забезпечення на телефон під час операції повторної синхронізації без компіляції як бінарного об'єкта.

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

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

Файл можна зашифрувати одним із таких методів шифрування:

Шифрування AES-256-CBC
Шифрування вмісту HTTP на основі RFC-8188 з шифруванням 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>мент представляє поле Resync On Resyn chronization.

Назва кожного елемента має бути унікальним. У веб-інтерфейсі телефону однакові поля можуть відображатися на кількох веб-сторінках, таких як сторінки «Лінія», «Користувач» та «Розширення». Додайте [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.

Передній і кінцевий пробіл допускається для читабельності, але вилучається зі значення параметра.
Нові рядки у значенні перетворюються на пробіли.
Заголовок XML форми <? ? > дозволено, але телефон ігнорує його.
Щоб ввести спеціальні символи, використовуйте базові символи XML, як показано в наступній таблиці.
Спеціальний символ
Послідовність виходу XML
& (амперсанд)
&
< (менше)
<
> (більше ніж)
>
'(апостроф)
'
» (подвійна цитата)
«
У наступному прикладі вводяться рядки символів, які представляють символи більше і менше, які потрібні в правилі плану набору номера. У цьому прикладі визначається план набору інформаційної гарячої лінії, який встановлює <Dial_Plan_1_>параметр (В хід адміністратора > розширений > Голос > Ext (n)) рівний (S0 <:18005551212>).
<flat-profile> <Dial_Plan_1_> (S0 <:18005551212>) </Dial_Plan_1_> </flat-profile>
Перекладаються рядки числових символів з використанням десяткових і шістнадцят кових значень (s.a. (і.).
Прошивка телефону підтримує тільки символи ASCII.

Спеціальний символ	Послідовність виходу XML
& (амперсанд)	&
< (менше)	<
> (більше ніж)	>
'(апостроф)	'
» (подвійна цитата)	«

Стиснення відкритого профілю

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

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

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

>gzip profile.xml

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

>cat profile.xml | gzip > профайл.xml.gz

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

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

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

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

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

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

Шифрування вмісту HTTP на основі RFC 8188 із шифруванням AES-128-GCM

Ключ або матеріал введення ключів (IKM) повинні бути попередньо встановлені в блоці раніше. Завантаження секретного ключа може бути здійснено безпечно за допомогою 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_повідомлення

Оновлення_правила

За певних умов деякі параметри загального призначення (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-адресі resync.

Умовні вирази можуть викликати події повторної синхронізації та вибирати з альтернативних URL-адрес для операцій повторної синхронізації та оновлення.

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

Кожне порівняння може стосуватися одного з наступних трьох типів літералів:

Цілі значення

Номери версій програмного або апаратного забезпечення

Рядки з подвійними лапками

Номери версій

Версія програмного забезпечення для Cisco Video Phone 8875 використовує такий формат (де BN - номер збірки):

ФОНЕОС ррры й. 1-0-1-0001 - БН

де yyyy вказує на модель телефону або серію телефону; 1 - основна версія; 0 - другорядна версія; 1-0001 - мікро версія; а BN - номер збір ки.

Рядок порівняння повинен використовувати той самий формат. В іншому випадку виникає помилка аналізу формату.

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

Приклади дійсного номера версії

PHONEOS-8875.1-0-1-0001-19

Порівняння

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

Оператор

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

Опис

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

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

=

еквалайзер

дорівнює

Так

Так

!=

ні

не дорівнює

Так

Так

<

лт

менше ніж

Так

Ні

<=

le

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

Так

Ні

>

гт

більше, ніж

Так

Ні

>=

Ге

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

Так

Ні

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_*.

Оператор	альтернативний синтаксис	Опис	Застосовується до цілочисельних операндів та версій	Застосовується до операндів рядків з цитатами
=	еквалайзер	дорівнює	Так	Так
!=	ні	не дорівнює	Так	Так
<	лт	менше ніж	Так	Ні
<=	le	менше або дорівнює	Так	Ні
>	гт	більше, ніж	Так	Ні
>=	Ге	більше або дорівнює	Так	Ні
AND		і	Так	Так

Використовуйте стандартний синтаксис URL-адреси, щоб вказати спосіб отримання файлів конфігурації та завантаження мікропрограми у параметрах Profile_Rule* та Upgrade_Rule відповідно. Синтаксис виглядає наступним чином:

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

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

тфтп

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. Однак лише ті об'єкти, які знають матеріал введення ключів (IKM), можуть читати корисне навантаження. Коли телефон забезпечений IKM, телефон і сервер забезпечення можуть безпечно обмінюватися файлами конфігурації, дозволяючи стороннім мережевим елементам використовувати заголовки повідомлень для аналітичних цілей та моніторингу.

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

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

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

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

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

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

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

Додаткові аргументи, key, uid та pwd, можуть передувати URL-адресам, введеним у параметри Profile_Rule*, разом укладених квадратними дужками.

ключ
uid та pwd

Параметр --key повідомляє телефону, що файл конфігурації, який він отримує від сервера забезпечення, зашифрований за допомогою шифрування AES-256-CBC, якщо тільки заголовок кодування вмісту у файлі не вказує шифрування aes128 gcm. Сам ключ вказується як рядок за терміном --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

[--код $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,...

Буль—булеве значення «yes» або «no».

CADScript — мінісценарій, який визначає параметри каденції сигналу. До 127 символів.

Синтаксис: S ₁ [; S ₂], де:

_{_{_{_{S _i =D _i (увімкнено _{i,1 /вимкнено i,1} [, на _i, 2/вимкнено _{i,2 [, на i,} 3 /вимкнено _i, _{3 [, на i,} 4 /вимкнено _{i,4 [, на i} _{,5 /вимкнено i,5 [, на i} ,6 /off _i ,6]]]]) і відомий як розділ.}}}}

on _{i, j} і off _{i, j -} тривалість включення/вимкнення в секундах сегмен та. i = 1 або 2, а j = 1 до 6.

D _i - загальна тривалість секції в секундах.

Усі тривалості можуть мати до трьох знаків після коми, щоб забезпечити роздільну здатність 1 мс. Символ «*» означає нескінченну тривалість. Сегменти в межах секції відтворюються в порядку і повторюються до відтворення загальної тривалості.

Приклад 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 ₁ _{@L 1} [, F ₂ _{@L 2} [, F ₃ _{@L 3} [, F ₄ _{@L 4} [, F ₅ _{@L 5} [, F ₆ _{@L 6}]]]], де:

F ₁ —F ₆ - частота в Гц (лише цілі числа без знаків).

L ₁ —L ₆ - відповідні рівні в дБм (до одного десяткового знака).

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

Приклад 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.

Ідентифікатор користувача — ідентифікатор користувача, який відображається в 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 — синтаксис сценаріїв, який використовується для визначення правил повторної синхронізації конфігурації та оновлення мікропрограми.

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

RSCTMPLT — шаблон коду статусу відповіді SIP, наприклад «404, 5*», «61?» , «407, 408, 487, 481». Він може містити до 39 символів.

Sig <n>— знакове n-бітове значення. Він може бути вказаний у десятковому або шестигранному форматі. Знак «-» повинен передувати від'ємним значенням. Знак + перед позитивними значеннями є необов'язковим.

Зоряні коди — код активації додаткової послуги, наприклад, *69. Код може містити до 7 символів.

Str <n>— загальний рядок із до n незарезервованих символів.

Час <n>— Тривалість часу в секундах, до n знаків після коми. Додатково вказані знаки після коми ігноруються.

ToneScript — мінісценарій, який визначає параметри частоти, рівня та каденції тону прогресу виклику. Скрипт може містити до 127 символів.

Синтаксис: Скрипт частоти; Z ₁ [; Z ₂].

_{_{_{_{_{_{_{_{Розділ Z ₁ подібний до розділу S ₁ в CADScript, за винятком того, що за кожним сегментом включення/вимкнення слідує параметр компонентів частоти: Z _{1 = D 1 (на i, 1 /off i, 1} /f i, ₁ [, на _i, 2 /off i, 2 /f _i, _{2 [, на _i, 3 /f i, 3 [, на i,} _{4 /off i,4 /f i, 4 /f _i, _{4 [, увімкнено i,} 5/вимкнено i} ,5 /ф i,5 [, на _i ,6 /вимкнено _i ,6 /ф}}}}}}}} _i,6]]]]) де:

f _{i, j} = n ₁ [+н ₂] +н ₃ [+n ₄ [+н ₅ [+н ₆]]]].

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.
Порожнє поле значення за замовчуванням означає порожній рядок < «» >.
Телефон продовжує використовувати останні налаштовані значення для тегів, яких немає в заданому профілі.
Шаблони порівнюються в наведеному порядку. Вибирається перший, не найближ чий, матч. Ім'я параметра має точно збігатися.
Якщо в профілі дано більше одного визначення для параметра, останнім таким визначенням у файлі є те, що вступає в силу в телефоні.
Специфікація параметра з порожнім значенням параметра змушує параметр повернутися до значення за замовчуванням. Щоб замість цього вказати порожній рядок, використовуйте порожній рядок «» як значення параметра.

Cisco AI Assistant

Дякуємо за відгук.