- Главная
- /
- Статья
Настройка параметров профиля для телефонов
Эта статья справки предназначена для телефонов Cisco, зарегистрированных в Cisco BroadWorks. Информация на этой странице включает повторную синхронизацию профиля, применение профиля вручную и синтаксис конфигурации.
Настройте телефон для повторной синхронизации профиля
Телефон поддерживает несколько сетевых протоколов для получения профилей конфигурации. Самый базовый протокол передачи профилей — TFTP (RFC1350). TFTP широко используется для подготовки сетевых устройств в частных локальных сетях. Хотя TFTP не рекомендуется для развертывания удаленных конечных точек через Интернет, он может быть удобным для развертывания в небольших организациях, для внутренней предварительной подготовки, а также для разработки и тестирования. В следующей процедуре профиль изменяется после скачивания файла с сервера TFTP.
1 |
В среде локальной сети подключите компьютер и телефон к концентратору, коммутатору или маленькому маршрутизатору. |
2 |
Установите и активируйте сервер TFTP на компьютере. |
3 |
Для создания профиля конфигурации используйте текстовый редактор. Чтобы проверить, был ли профиль подготовлен для вашего телефона позже, можно задать некоторые значения в качестве знаков. Например, задайте для GPP_A значение 12345678, как показано в следующем примере:
_ |
4 |
Сохраните файл конфигурации XML в корневом каталоге сервера TFTP. Проверьте правильность настройки TFTP-сервера. запросите файл профиля конфигурации с помощью клиента TFTP, отличного от телефона. Предпочтительно используйте TFTP-клиент, работающий на отдельном узле от сервера настройки. |
5 |
В веб-браузере на компьютере откройте веб-страницу администрирования. Например, предположим, что IP-адрес телефона 192.168.1.100, откройте следующий URL-адрес в веб-браузере:
|
6 |
Выберите вкладку и проверьте значения параметров общего назначения с GPP_А по GPP_P. Они должны быть пустыми. |
7 |
Выполните повторную синхронизацию тестового телефона с профилем конфигурации, созданным вами, открыв URL-адрес повторной синхронизации в веб-браузере. Пример: Если IP-адрес сервера TFTP — 192.168.1.200, команда должна быть похожа на следующий пример:
Когда телефон получает эту команду, устройство по адресу 192.168.1.100 запрашивает файл профиля конфигурации |
8 |
Убедитесь в правильности обновления параметра. Обновите веб-страницу администрирования и перейдите к меню .GPP_Параметр A теперь должен содержать значение 12345678. |
1 |
Получите MAC-адрес телефона на его этикетке продукта. (MAC-адрес — это номер с использованием цифр и шестнадцатеричных цифр в нижнем регистре, например 000e08aabbcc. |
2 |
Переименуйте файл конфигурации на Пример: |
3 |
Переместите новый файл в виртуальный корневой каталог сервера TFTP. |
4 |
Откройте веб-страницу администрирования телефона. |
5 |
Выберите . |
6 |
Введите путь к файлу профиля в поле Правило профиля . Пример. Предположим, что IP-адрес сервера TFTP — 192.168.1.200, а имя файла профиля — rofile_ |
7 |
Щелкните Отправить все изменения. Это приводит к немедленной перезагрузке и повторной синхронизации. При следующей повторной синхронизации телефон извлекает новый файл, расширяя выражение макроса $MA в свой MAC-адрес. |
1 |
Установите HTTP-сервер на локальный компьютер или другой доступный хост. Сервер Apache с открытым исходным кодом можно скачать из Интернета. |
2 |
Загрузите файл профиля конфигурации в виртуальный корневой каталог установленного сервера. |
3 |
Чтобы проверить правильную установку сервера и доступ к файлу профиля, откройте профиль с помощью веб-браузера. |
4 |
Измените Profile_Rule тестового телефона, чтобы указать на HTTP-сервер вместо TFTP-сервера, чтобы периодически загружать его профиль. Например, если HTTP-сервер имеет адрес 192.168.1.300 и имя файла профиля — 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 |
Убедитесь, что в поле Повторная синхронизация при сбросе установлено значение Да. esync_ |
8 |
Выключите и снова включите телефон для повторной синхронизации с сервером настройки. Если по какой-либо причине операция повторной синхронизации не выполняется, например если сервер не отвечает, устройство ожидает (количество секунд, настроенное в разделе Задержка повторения ошибки синхронизации), прежде чем повторить попытку повторной синхронизации. Если задержка повторения ошибки синхронизации равна нулю, телефон не пытается выполнить повторную синхронизацию после неудачной попытки синхронизации. |
9 |
(Необязательно) Задайте в поле Задержка повторения ошибки синхронизации небольшое число, например 30. esync_ |
10 |
Отключите сервер TFTP и просмотрите результаты в выходных данных системного журнала. |
В таблице ниже определены функциональное назначение и использование параметров повторной синхронизации профиля в разделе Профиль конфигурации на вкладке на веб-странице телефона. Он также определяет синтаксис строки, добавляемой в файл конфигурации телефона (cfg.xml) с XML-кодом для настройки параметра.
Параметр |
Описание |
---|---|
Включить подготовку |
Разрешает или запрещает действия по повторной синхронизации профиля конфигурации.
По умолчанию. Да |
Повторная синхронизация при сбросе |
Указывает, будет ли телефон повторно синхронизировать конфигурации с сервером настройки после включения и после каждой попытки обновления.
По умолчанию. Да |
Случайная задержка повторной синхронизации |
Предотвращает перегрузку сервера настройки при одновременном включении большого количества устройств и попытке начальной настройки. Эта задержка вступает в силу только при первоначальной попытке настройки после включения или сброса устройства. Этот параметр представляет собой максимальный интервал времени, который устройство ожидает перед установлением связи с сервером настройки. Фактическая задержка — это псевдослучайное число от 0 до этого значения. Этот параметр задан в единицах 20 секунд. Допустимое значение: от 0 до 65535.
Значение по умолчанию — 2 (40 секунд). |
Повторная синхронизация в (ЧЧмм) |
Время (ЧЧмм), когда телефон повторно синхронизируется с сервером настройки. Значение этого поля должно быть четырехзначным числом в диапазоне от 0000 до 2400, чтобы указать время в формате ЧЧмм. Например, 0959 означает 09:59.
Значение по умолчанию является пустым. Если значение недействительно, этот параметр игнорируется. Если для этого параметра задано допустимое значение, параметр периодической повторной синхронизации игнорируется. |
Повторная синхронизация с произвольной задержкой |
Предотвращает перегрузку сервера настройки при одновременном включении большого количества устройств. Во избежание ошибочных запросов на повторную синхронизацию с сервером с нескольких телефонов телефон выполняет повторную синхронизацию в диапазоне часов и минут, а также часов и минут плюс случайная задержка (ччмм, ччмм+random_delay). Например, если произвольная задержка = (повторная синхронизация с произвольной задержкой + 30)/60 минут, введенное значение в секундах преобразуется в минуты, округление до следующей минуты для расчета окончательного random_delay интервала.
Допустимое значение: от 600 до 65535. Если значение меньше 600, внутренняя произвольная задержка составляет от 0 до 600. Значение по умолчанию: 600 секунд (10 минут). |
Периодическая повторная синхронизация |
Временной интервал между периодической повторной синхронизацией с сервером настройки. Связанный таймер повторной синхронизации активен только после первой успешной синхронизации с сервером. Допустимые форматы приведены ниже.
Чтобы отключить периодическую повторную синхронизацию, задайте этот параметр равным нулю. Значение по умолчанию: 3600 секунд. |
Задержка повторения ошибки синхронизации |
Если операция повторной синхронизации не удалась из-за того, что телефон не смог получить профиль с сервера, загруженный файл поврежден или произошла внутренняя ошибка, телефон пытается выполнить повторную синхронизацию по истечении времени, указанного в секундах. Допустимые форматы приведены ниже.
Если для задержки установлено значение 0, устройство не пытается повторно выполнить синхронизацию после неудачной попытки синхронизации.
По умолчанию. 60,120,240,480,960,1920,3840,7680,15360,30720,61440,86400 |
Задержка принудительной повторной синхронизации |
Максимальная задержка (в секундах) телефона ожидает перед выполнением повторной синхронизации. Устройство не выполняет повторную синхронизацию, пока одна из его телефонных линий активна. Поскольку повторная синхронизация может занять несколько секунд, перед повторной синхронизацией следует подождать, пока устройство находится в режиме ожидания в течение длительного периода времени. Это позволяет пользователю последовательно совершать вызовы без прерываний. У устройства есть таймер, который начинает обратный отсчет, когда все его линии переходят в режим ожидания. Этот параметр является начальным значением счетчика. События повторной синхронизации откладываются до тех пор, пока этот счетчик не снизится до нуля. Допустимое значение: от 0 до 65535.
Значение по умолчанию — 14 400 секунд. |
Повторная синхронизация из SIP |
Управляет запросами на повторную синхронизацию с помощью события SIP NOTIFY, отправляемого на телефон с прокси-сервера поставщика услуг. Если этот параметр включен, прокси-сервер может запросить повторную синхронизацию, отправив сообщение SIP NOTIFY, содержащее событие: заголовок повторной синхронизации устройства.
По умолчанию. Да |
Попытка повторной синхронизации после модернизации |
Включает или отключает операцию повторной синхронизации после любого обновления. Если выбран параметр Да , синхронизация будет запущена после обновления микропрограммного обеспечения.
По умолчанию. Да |
Триггер повторной синхронизации 1 Триггер повторной синхронизации 2 |
Если логическое уравнение в этих параметрах имеет значение FALSE, повторная синхронизация не срабатывает, даже если для параметра Повторная синхронизация при сбросе установлено значение TRUE. Только повторная синхронизация через URL-адрес прямого действия и SIP игнорирует эти триггеры повторной синхронизации. Параметры могут быть запрограммированы условным выражением, которое подвергается раскрытию макроса. Действительные раскрытия макросов см. в разделе Переменные раскрытия макросов в разделе Параметры подготовки.
По умолчанию. Не заполнено |
Настраиваемая пользователем повторная синхронизация |
Позволяет пользователю повторно синхронизировать телефон из меню экрана телефона. Если задано значение Да, пользователь может повторно синхронизировать конфигурацию телефона, введя на телефоне правило профиля. Если задано значение Нет, параметр Правило профиля не отображается в меню экрана телефона.
По умолчанию. Да |
Сбой повторной синхронизации в FNF |
Повторная синхронизация обычно считается неудачной, если запрошенный профиль не получен с сервера. Этот параметр переопределяет это поведение. Если задано значение Нет, устройство принимает от сервера ответ
По умолчанию. Да |
Тип аутентификации профиля |
В этом поле указываются учетные данные для аутентификации учетной записи профиля. Доступные варианты:
По умолчанию. Базовая аутентификация HTTP Дополнительную информацию см. в разделе Указание типа аутентификации профиля в разделе Указание телефона для повторной синхронизации профиля. |
Правило профиля Правило профиля B Правило профиля C Правило профиля D |
Каждое правило профиля информирует телефон источника, из которого требуется получить профиль (файл конфигурации). Во время каждой операции повторной синхронизации телефон последовательно применяет все профили. Если к файлам конфигурации применяется шифрование AES-256-CBC, укажите ключ шифрования с помощью ключевого слова Ключ шифрования можно заключить в двойные кавычки (").
Значение по умолчанию: |
Параметр DHCP для использования |
Параметры DHCP, разделенные запятыми, используемые для извлечения микропрограммного обеспечения и профилей. По умолчанию. 66,160,159,150,60,43,125 |
Параметр DHCPv6 для использования |
Параметры DHCP, разделенные запятыми, используемые для извлечения микропрограммного обеспечения и профилей. По умолчанию. 17,160,159 |
Телефоны можно подготовить с помощью функций 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 профиля может содержать:
-
Имя сервера настройки или явный IP-адрес. Если профиль идентифицирует сервер настройки по имени, телефон выполняет поиск DNS для разрешения имени.
-
Нестандартный порт сервера, указанный в URL с использованием стандартного синтаксиса
:port
после имени сервера. -
Подкаталог виртуального корневого каталога сервера, в котором хранится профиль, указан с помощью стандартной нотации 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
.
Правило Profile_имеет следующее значение:
tftp://prov.telco.com/cisco/$B/$MA.cfg
Когда устройство повторно синхронизируется и макросы раскрыты, телефон с MAC-адресом 000e08012345 запрашивает профиль с именем, содержащим MAC-адрес устройства по следующему URL-адресу:
tftp://prov.telco.com/cisco/Dj6Lmp23Q/000e08012345.cfg
Аутентификация профиля позволяет пользователям телефона повторно синхронизировать профиль настройки с телефоном. Информация для аутентификации требуется, когда телефон пытается выполнить повторную синхронизацию и впервые скачать файл конфигурации и получает ошибку аутентификации HTTP или HTTPS 401. Если эта функция включена, на телефоне отображается экран Настройка учетной записи профиля в следующих ситуациях:
-
если при первой настройке после перезагрузки телефона возникает ошибка аутентификации HTTP или HTTPs 401
-
Если имя пользователя и пароль учетной записи профиля не указаны
-
Если в правиле профиля нет имени пользователя и пароля
Если экран настройки учетной записи профиля пропущен или проигнорирован, пользователь также может получить доступ к экрану настройки с помощью меню экрана телефона или программной клавиши Настройка , которая отображается только при отсутствии линии на телефоне.
При отключении этой функции на телефоне не отображается экран Настройка учетной записи профиля .
Имя пользователя и пароль в поле Правило профиля имеют более высокий приоритет, чем учетная запись профиля.
-
Если указать правильный URL-адрес в поле Правило профиля без имени пользователя и пароля, телефон должен выполнить аутентификацию или дайджест-проверку подлинности для повторной синхронизации профиля. При наличии правильной учетной записи профиля аутентификация будет пройдена. Если учетная запись профиля неверна, происходит сбой аутентификации.
-
Если указать правильный URL-адрес в поле Правило профиля с правильными именем пользователя и паролем, телефон должен выполнить аутентификацию или дайджест-проверку подлинности для повторной синхронизации профиля. Учетная запись профиля не используется для повторной синхронизации телефона. Вход в систему выполнен успешно.
-
Если указать правильный URL-адрес в поле Правило профиля с неправильными именем пользователя и паролем, телефон должен выполнить аутентификацию или дайджест-проверку подлинности для повторной синхронизации профиля. Учетная запись профиля не используется для повторной синхронизации телефона. Не удается выполнить вход.
-
Если указать неверный URL-адрес в поле Правило профиля , вход всегда не удастся.
Параметры также можно настроить в файле конфигурации телефона с помощью XML-кода (cfg.xml).
Тип аутентификации профиля можно указать на веб-странице администрирования телефона.
1 |
Откройте веб-страницу администрирования телефона. |
2 |
Выберите . |
3 |
В разделе Профиль конфигурации задайте параметр Тип аутентификации профиля , чтобы указать учетные данные, которые будут использоваться для аутентификации учетной записи профиля. Этот параметр можно настроить в XML-файле конфигурации телефона (cfg.xml), введя строку в следующем формате: rofile_ Параметры:
По умолчанию. Базовая аутентификация HTTP |
4 |
Щелкните Отправить все изменения. |
Вручную примените профиль к своему телефону
Выполните следующие действия, чтобы скачать файл конфигурации в приложение сервера TFTP на своем ПК.
1 |
Подключите компьютер к порту локальной сети телефона. |
2 |
Запустите приложение сервера TFTP на компьютере и убедитесь, что файл конфигурации доступен в корневом каталоге TFTP. |
3 |
В веб-браузере введите IP-адрес локальной сети телефона, IP-адрес компьютера, имя файла и учетные данные для входа. Используйте такой формат: Пример:
|
Выполните следующие действия, чтобы загрузить конфигурацию на телефон с помощью cURL. Этот инструмент командной строки используется для передачи данных с синтаксисом URL. Чтобы скачать cURL, перейдите по ссылке:
https://curl.haxx.se/download.html
Рекомендуется не использовать cURL для публикации конфигурации на телефоне, поскольку при использовании cURL могут быть записаны имя пользователя и пароль.
1 |
Подключите компьютер к порту локальной сети телефона. |
2 |
Загрузите файл конфигурации на телефон, введя следующую команду cURL: |
Профили конфигурации
Телефон принимает конфигурации в формате XML.
В примерах в этом разделе используются профили конфигурации с синтаксисом XML.
Профиль конфигурации определяет значения параметров для телефона.
XML-формат профиля конфигурации использует стандартные инструменты XML-авторизации для компиляции параметров и значений.
Каждый телефон имеет разный набор функций и, следовательно, разный набор параметров.
Открыть формат профиля
Профиль открытого формата — это текстовый файл с синтаксисом, похожим на XML в иерархии элементов с атрибутами и значениями элементов. Этот формат позволяет использовать стандартные инструменты для создания файла конфигурации. XML-файл конфигурации может быть отправлен с сервера настройки на телефон во время операции повторной синхронизации без компиляции в качестве двоичного объекта.
Телефон может принимать форматы конфигурации, создаваемые стандартными инструментами. Эта функция облегчает разработку программного обеспечения сервера серверной настройки, которое генерирует профили конфигурации из существующих баз данных.
Для защиты конфиденциальной информации в профиле конфигурации сервер настройки передает XML-файл конфигурации на телефон по каналу, защищенному TLS. При необходимости файл можно сжать с помощью алгоритма сжатия gzip (RFC ).
Файл можно зашифровать одним из следующих способов шифрования:
-
Шифрование AES-256-CBC
-
Шифрование содержимого HTTP на основе RFC-8188 с помощью шифра AES-128-GCM
Файл конфигурации может содержать следующие компоненты:
-
Теги элемента
-
Атрибуты
-
Параметры
-
Функции форматирования
-
Комментарии XML
Пример: Открыть формат профиля
<flat-profile> <Resync_On_Reset> Да On_Reset> <Resync_Periodic> 7200 Periodic> <Profile_Rule> tftp://prov.telco.com:6900/cisco/config/CP_xxxx_MPP.cfgRule> </flat-profile>
esync_esync_rofile_ Тег элемента охватывает все элементы параметров, распознаваемые телефоном.
Свойства тега элемента
При создании или обновлении файла конфигурации учтите приведенные ниже правила.
-
Формат подготовки XML и веб-интерфейс позволяют устанавливать одни и те же настройки. Имена тегов XML и имена полей в веб-интерфейсе аналогичны, но отличаются из-за ограничений по именам элементов XML. Например, подчеркивания ( _ ) в файле конфигурации XML вместо пространств в веб-интерфейсе пользователя.
-
Телефон распознает элементы с соответствующими именами параметров, которые инкапсулированы в специальный элемент
.
-
Имена элементов заключены в угловые скобки.
-
Большинство имен элементов аналогичны именам полей в веб-интерфейсе телефона с приведенными ниже изменениями.
-
Имена элементов могут не содержать пробелов и специальных символов. Чтобы получить имя элемента из имени веб-поля, замените символ подчеркивания для каждого пробела или специальных символов
[
,]
,(
,)
или/
.Пример. Элемент <Resync_On_Reset> представляет собой поле Resync On Reset .
-
Имя каждого элемента должно быть уникальным. В веб-интерфейсе телефона одни и те же поля могут отображаться на нескольких веб-страницах, таких как страницы линии, пользователя и добавочного номера. Добавьте
[n]
к имени элемента, чтобы указать номер, отображаемый на вкладке страницы.Пример. Элемент
<Dial_Plan_1_>
представляет собой план набора для линии 1.
-
-
Каждый открывающий тег элемента должен иметь соответствующий закрывающий тег элемента. Пример.
rofile_<Resync_On_Reset> Да On_Reset> <Resync_Periodic> 7200 Periodic> <Profile_Rule>tftp://prov.telco.com:esync_esync_ 6900/cisco/config/CP_xxxx_MPP.cfg Rule>
-
Теги элементов чувствительны к регистру.
-
Пустые теги элементов разрешены и будут интерпретированы как настройка значения как пустое. Введите открывающий тег элемента без соответствующего тега элемента и вставьте пробел и косую черту перед закрывающим угловым кронштейном (>). В этом примере правило профиля 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_Для параметра задана пустая строка.
_<flat-profile> <GPP_A> A> </flat-profile>
-
Нераспознанные имена элементов игнорируются.
Свойства параметра
Эти свойства применяются к параметрам:
Все параметры, не указанные в профиле, остаются неизменными на телефоне.
Нераспознанные параметры игнорируются.
Если профиль открытого формата содержит несколько повторений с одним тегом параметра, последнее из таких повторений переопределяет предыдущие. Во избежание непреднамеренного переопределения значений конфигурации для параметра рекомендуется указать не более одного экземпляра параметра в каждом профиле.
Приоритет имеет последний обработанный профиль. Если несколько профилей задают один и тот же параметр конфигурации, приоритет имеет значение последнего профиля.
Форматы строк
Эти свойства применяются к форматированию строк:
Комментарии разрешены посредством стандартного синтаксиса XML.
Пробелы в начале и в конце допустимы для читаемости, но удаляются из значения параметра.
Новые строки в значении преобразуются в пробелы.
XML-заголовок формы
<? ?>
допустим, но телефон его игнорирует.Для ввода специальных символов используйте базовые символы XML, как показано в таблице ниже.
Специальный символ
Последовательность завершения XML
& (амперсанд)
&
< (меньше чем)
<
> (больше)
>
' (апостроф)
'
" (двойная цитата)
"
В приведенном ниже примере для представления символов "больше" и "меньше", которые требуются в правиле номерного плана. В этом примере определяется план набора информационной горячей линии, в котором для параметра <Dial_Plan_1_> (
) установлено значение (S0 ).
ial_<flat-profile> <Dial_Plan_1_> (S0 ) Plan_1_> </flat-profile>
Числовые символы с использованием десятичных и шестнадцатеричных значений (например,
(
и.
) переведены.Микропрограммное обеспечение телефона поддерживает только символы ASCII.
Открытый профиль конфигурации можно сжать, чтобы уменьшить сетевую нагрузку на сервер настройки. Профиль также может быть зашифрован для защиты конфиденциальной информации. Сжатие не требуется, но оно должно предшествовать шифрованию.
Сжатие открытого профиля
Поддерживаемым методом сжатия является алгоритм сжатия gzip (RFC ). Утилита 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
Ключ или материал для генерации ключей (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
Это значение программируется с помощью одного из параметров Profile_Rule
(Правило P).
Раскрытие макросов
Перед оценкой несколько параметров настройки подвергаются внутреннему раскрытию макросов. Этот этап предварительной оценки обеспечивает большую гибкость управления действиями по повторной синхронизации и обновлению телефона.
Перед оценкой эти группы параметров подвергаются раскрытию макросов.
-
Resync_Trigger_*
-
Profile_Rule*
-
Log_xxx_Msg
-
Правило pgrade_U
При определенных условиях некоторые параметры общего назначения (GPP_*) также подвергаются макрорасширению, как это явным образом показано в разделе Дополнительные аргументы повторной синхронизации ниже.
Во время раскрытия макросов содержимое именованных переменных заменяет выражения $NAME и $(NAME). Эти переменные включают параметры общего назначения, несколько идентификаторов продукта, определенные таймеры событий и значения состояния настройки. Полный список см. в разделе Переменные раскрытия макросов в разделе Параметры подготовки.
В следующем примере выражение $(MAU) используется для вставки MAC-адреса 000E08012345.
Администратор вводит: $(MAU)config.cfg
Итоговое раскрытие макросов для устройства с MAC-адресом 000E08012345: 000E08012345config.cfg
Если имя макроса не распознано, оно остается нераскрытым. Например, имя STRANGE не распознается как допустимое имя макроса, в то время как MAU распознается как допустимое имя макроса.
Администратор вводит: $STRANGE$MAU.cfg
Итоговое раскрытие макроса для устройства с MAC-адресом 000E08012345: $STRANGE79E08012345.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
Сравнение
Цитируемые строки можно сравнить для равенства или неравенства. Целые числа и номера версий также можно сравнивать арифметически. Операции сравнения могут быть выражены как символами, так и акронимами. Акронимы удобны для выражения условия в профиле открытого формата.
Оператор |
Альтернативный синтаксис |
Описание |
Применимо к целым и версиям операндов |
Применимо к кавыченным строковым операндам |
---|---|---|---|---|
= |
eq |
равно |
Да |
Да |
!= |
ne |
не равно |
Да |
Да |
< |
lt |
меньше чем |
Да |
Нет |
<= |
le |
меньше или равно |
Да |
Нет |
> |
gt |
больше чем |
Да |
Нет |
>= |
ge |
больше или равно |
Да |
Нет |
И |
|
и |
Да |
Да |
Важно заключить переменные макроса в двойные кавычки, где предполагается строковый литерал. Не делайте этого, если ожидается номер или номер версии.
Если они используются в контексте параметров Profile_Rule* и Upgrade_, условные выражения должны быть заключены в синтаксис "(expr)?", как в этом примере правила обновления. Не забудьте заменить BN номером сборки загруженного микропрограммного обеспечения для модернизации.
($SWVER ne PHONEOS-8875.1-0-1-0001-19)? http://ps.tell.com/sw/PHONEOS-8875.1-0-1-0001-BN.loads
Для настройки параметров Resync_Trigger_* не используйте предыдущий синтаксис с скобками.
Синтаксис URL-адреса
Используйте стандартный синтаксис URL, чтобы указать способ извлечения файлов конфигурации и загрузки микропрограммного обеспечения в параметрах Profile_Rule* и Upgrade_ соответственно. Синтаксис приведен ниже.
[ схема:// ] [ сервер [:порт]] путь к файлу
Где схема
является одним из следующих значений:
-
TFTP-сервер
-
http
-
https
Если схема
опущена, предполагается использование tftp. Сервером может быть распознанное DNS имя хоста или числовой IP-адрес. Порт является номером порта UDP или TCP назначения. Путь к файлу должен начинаться с корневого каталога (/); он должен быть абсолютным.
Если сервер
отсутствует, используется сервер TFTP, указанный с помощью DHCP (параметр 66).
Для правил модернизации должен быть указан сервер.
Если порт
отсутствует, используется стандартный порт для указанной схемы. TFTP использует порт UDP 69, http использует порт TCP 80, https использует порт TCP 443.
Должен быть указан путь к файлу. Не обязательно ссылаться на статический файл, но может указывать динамическое содержимое, полученное через CGI.
Раскрытие макросов применяется в URL-адресах. Ниже приведены примеры допустимых URL-адресов.
/$MA.cfg /cisco/cfg.xml 192.168.1.130/profiles/init.cfg tftp://prov.call.com/cpe/cisco$MA.cfg http://neptune.speak.net:8080/prov/$D/$E.cfg https://secure.me.com/profile?Linksys
При использовании параметра DHCP 66 пустой синтаксис не поддерживается правилами модернизации. Это применимо только к правилу профиля*.
Шифрование контента HTTP на основе RFC 8188
Телефон поддерживает шифрование содержимого HTTP на основе RFC 8188 с помощью шифра AES-128-GCM для файлов конфигурации. С помощью этого метода шифрования любой объект может читать заголовки HTTP-сообщений. Однако считывать полезную нагрузку могут только энтитеты, которые знают материал генерации ввода (IKM). Если телефон подготовлен с помощью IKM, телефон и сервер настройки могут безопасно обмениваться файлами конфигурации, позволяя сторонним сетевым элементам использовать заголовки сообщений в целях аналитики и мониторинга.
Параметр конфигурации XML IKM_HTTP_Encrypt_Content
поддерживает IKM на телефоне. В целях безопасности этот параметр недоступен на веб-странице администрирования телефона. Он также не отображается в файле конфигурации телефона, доступ к которому можно получить с IP-адреса телефона или из отчетов о конфигурации телефона, отправленных на сервер настройки.
Чтобы использовать шифрование на основе RFC 8188, выполните приведенные ниже действия.
-
Подготовьте телефон с помощью IKM, указав IKM с помощью параметра XML
IKM_HTTP_Encrypt_Content
в файле конфигурации, отправляемом с сервера настройки на телефон. -
Если это шифрование применяется к файлам конфигурации, отправленным с сервера настройки на телефон, убедитесь, что заголовок HTTP Content-Encoding в файле конфигурации имеет
aes ⦅_ph_21⦆ 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 ⦅_ph_20⦆ gcm
. Сам ключ указывается в виде строки после термина --key
. Ключ может быть заключен в двойные кавычки ("). Телефон использует ключ для расшифровки файла конфигурации.
Примеры использования
[--ключ VerySecretValue] [--ключ "моя секретная фраза"] [--ключ a37d2fb9055c1d04883a0745eb0917a4]
Необязательные аргументы в квадратных скобках раскрыты макросами. Параметры специального назначения от GPP_SA до GPP_SD макросы раскрываются на переменные макросов от $SA до $SD, только если они используются в качестве аргументов ключевых параметров. См. следующие примеры:
[--key $SC] [--key “$SD”]
В профилях открытого формата аргумент в пользу --ключа должен совпадать с аргументом в пользу опции -k , предоставленной openssl.
uid и pwd
Параметры uid и pwd можно использовать для указания идентификатора пользователя и пароля, которые будут отправляться в ответ на вызовы базовой и дайджест-аутентификации HTTP при запросе указанного URL-адреса. Необязательные аргументы в квадратных скобках раскрыты макросами. Параметры специального назначения от GPP_SA до GPP_SD макросы раскрываются на переменные макросов от $SA до $SD, только если они используются в качестве аргументов ключевых параметров. См. следующие примеры:
GPP_SA = MyUserID GPP_SB = MySecretPassword
[--uid $SA --pwd $SB] https://provisioning_server_url/path_to_your_config/your_config.xml
затем будет расширяться до:
[--uid MyUserID --pwdMySecretPassword] https://provisioning_server_url/path_to_your_config/your_config.xml
Эти типы данных используются с параметрами профиля конфигурации:
-
{a, b, c,…} — выбор между a, b, c, …
-
Bool — логическое значение «да» или «нет».
-
CadScript — минискрипт, указывающий параметры частоты сигнала. До 127 символов.
Синтаксис. S1[;S2], где:
-
sя=dя(на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 s Количество сегментов = 1 Сегмент 1: On=2 с, Off=4 с Общая длина звонка = 60 с
Пример 2. Специальный звонок (короткий, короткий, короткий, длинный):
60(.2/.2,.2/.2,.2/.2, 1/4) Количество разделов частоты = 1 Раздел частоты 1: Длина раздела = 60 с Количество сегментов = 4 Сегмент 1: On=0,2 с, Off=0,2 с сегментом 2: On=0,2 с, Off=0,2 с сегментом 3: On=0,2 с, Off=0,2 с сегментом 4: On=1,0s, Off=4,0s Общая длина звонка = 60 с
-
-
DialPlanScript — синтаксис сценариев, который используется для указания планов набора линий 1 и 2.
-
Float — значение плавающего типа, содержащее до 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 s Количество сегментов = 1 Сегмент 1: On = навсегда, с частотами 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: Длина раздела = 2s Количество сегментов = 1 Сегмент 1: On=0,1s, Off=0,1s с частотами 1 и 2, раздел 2 частоты: Длина раздела = 10 s Количество сегментов = 1 Сегмент 1: On = навсегда, с частотами 1 и 2 Общая длина тонального сигнала = 12 с
-
-
Uns — неподписанное n-битное значение, где n = 8, 16 или 32. Он может быть указан в десятичном или шестнадцатеричном формате, например 12 или 0x18, если значение может помещаться в n бит.
Учтите следующие моменты:
- представляет имя параметра конфигурации. В профиле соответствующий тег формируется путем замены пространства подчеркиванием "_", например Par_Name.
- Пустое поле значения по умолчанию подразумевает пустую строку < "" >.
- Телефон продолжает использовать последние настроенные значения для тегов, которые отсутствуют в данном профиле.
- Шаблоны сравниваются в указанном порядке. Будет выбрано первое совпадение (не ближайшее). Имя параметра должно в точности совпадать.
- Если в профиле дано несколько определений для параметра, последнее такое определение в файле вступает в силу на телефоне.
- Спецификация параметра с пустым значением параметра приводит к возврату параметра к значению по умолчанию. Чтобы вместо этого указать пустую строку, используйте пустую строку "" в качестве значения параметра.