По вашему запросу ничего не найдено :(
Убедитесь, что запрос написан правильно, или посмотрите другие
наши статьи:
Всем привет! Сегодня мы расскажем про то, как подключить FTP-сервер к Deployment Service (DLS), который может использоваться для загрузки прошивок для телефонов, мелодий для звонка, фоновых изображений и прочего. Также рассмотрим процесс установки прошивки на телефон семейства OpenStage.
/p>
Добавление FTP
После входа в DLS переходим во вкладку Deployment Service → Administration → FTP Server Configuration и нажимаем на кнопку New, расположенную внизу. Затем указываем все необходимые атрибуты для подключения: IP адрес сервера, его имя, протокол, путь до файлов прошивок, порт, логин и пароль. После заполнения нажимаем Save.
Найти добавленный FTP-сервер можно перейдя во вкладку Search и найти его либо по его реквизитам, либо в общем списке серверов. На этой странице в таблице внизу отображаются прошивки для телефонов, которые находятся на сервере, в папке, которую мы указывали ранее. Если новый файл прошивки закинули на сервер, то для того чтобы он появился в таблице нужно нажать на кнопку Start Scan.
Установка прошивки на телефон
Теперь, когда FTP-сервер вместе со всеми файлами подключен, установим новую прошивку на телефон. Для этого переходим во вкладку Deployment Service → Software Deployment → Deploy Workpoints. Тут указываем необходимые для поиска данные и нажимаем Search
После того как мы нашли необходимый телефон нажимаем Deploy и в появившемся окне выбираем нужную версию и снова нажимаем на кнопку Deploy. Если необходимо установить прошивку, тип которой отличается от той которая стоит на данный момент (например, если стоит SIP, а нужно поставить HFA), то ставим галочку в Derestrict and deploy independent of the device type. Прошивка типа HFA используется для подключения телефона к станции HiPath (HFA = HiPath Feature Access)
Затем появляется еще одно окно с настройками применения прошивки в котором мы нажимаем ОК.
После этих манипуляций начнется установка прошивки на телефон, в процессе которой он перезагрузится и затем телефон будет готов к использованию.
Стандарт JSON Web Tokens (JWT) – это лаконичный метод передачи данных, поддающихся проверке. Каждый токен содержит подпись, с помощью которой эмитент может проверить целостность сообщения.
С помощью этой статьи вы можете узнать, что из себя представляет структура JWT и как можно создать свои собственные токены. JWT – это популярный способ защиты API и аутентификации сеансов пользователей, так как они достаточно просты и являются автономными.
Как работают JWT?
Одна из самых распространенных задач в любом API – это проверка того факта, что пользователи являются теми, за кого себя выдают. Как правило, аутентификация выполняется тогда, когда клиент использует ключ API для запросов, которые он отправляет на сервер. Этот ключ содержит информацию, которая подтверждает личность пользователя. Но все еще остается вопрос: как сервер проверяет, что пользователь сначала предоставил ключ?
JWT с легкостью решают эту проблему с помощью секретного ключа, который используется для подписи каждого токена. Сервер проверяет действительность токена, повторно пересчитывая подпись с помощью своего секретного ключа. Любое несанкционированное вмешательство приведет к тому, что проверка не будет выполнена.
Структура JWT
JWT состоят из трех отдельных компонентов:
Заголовок
(header) – содержит метаданные о токене, например, алгоритм подписи, который был использован.
Полезная нагрузка
(payload) – в качестве полезной нагрузки могут выступать любые случайные данные, которые так или иначе относятся к вашей системе. Полезная нагрузка может содержать ID пользователя и набор определенных функций, с которыми пользователь может взаимодействовать.
Подпись
(signature) – подпись позволяет в дальнейшем проверить целостность токена. Подпись создается путем подписания заголовка и полезной нагрузки с помощью секретного ключа, который знает только сервер.
Для того, чтобы сформировать JWT, все эти три компонента нужно записать через точку:
header.payload.signature
Каждый компонент кодируется с помощью стандарта Base-64. Готовый токен представляет собой строку текста, которую можно использовать в средах разработки программ и отправлять вместе с HTTP-запросами.
Создание JWT
Создать JWT можно на любом языке программирования. В данном случае мы будем использовать PHP, но вы можете использовать и другой язык, процесс будет аналогичным.
Начнем с создания заголовка. Как правило, он включает в себя два поля –
alg
и
typ
:
alg
– это алгоритм хеширования, который мы будем использовать для создания подписи. Как правило, используют HMAC SHA256 (
HS256
).
typ
– это тип токена, который мы создаем. Здесь мы должны указать
JWT
.
Вот так выглядит объект JSON, который определяет заголовок:
{
"alg": "HS256",
"typ": "JWT"
}
Заголовок необходимо закодировать с помощью Base-64:
$headerData = ["alg" => "HS256", "typ" => "JWT"];
$header = base64_encode(json_encode($headerData));
Затем нам необходимо определить еще один объект JSON - полезную нагрузку токена. Что из себя будет представлять полезная нагрузка зависит от приложения. В данном примере мы используем информацию об учетной записи аутентифицированного пользователя и информацию о самом токене.
exp
,
iat
и
nbf
– это условные поля, которые используются для того, чтобы указать время истечения срока действия токена, время его создания и момент времени (начальный), до которого он считается недействительным. Полезную нагрузку также необходимо закодировать с помощью Base-64.
$payloadData = [
"userId" => 1001,
"userName" => "demo",
"licensedFeatures" => ["todos", "calendar", "invoicing"],
"exp" => (time() + 900),
"iat" => time(),
"nbf" => time()
];
$payload = base64_encode(json_encode($payloadData));
Нам остается только создать подпись. Для этого сначала нужно объединить заголовок и полезную нагрузку в одну сроку, разделив их точкой:
$headerAndPayload = "$header.$payload";
Затем мы должны сгенерировать уникальный секретный ключ, который мы будем использовать в качестве секретного ключа подписи. Этот ключ должен надежно храниться на вашем сервере, и его ни в коем случае нельзя передавать клиентам. Если значение секретного ключа будет раскрыто, то любой пользователь сможет создавать действительные токены.
// PHP method to generate 32 random characters
$secret = bin2hex(openssl_random_pseudo_bytes(16));
И мы завершаем процесс с помощью подписи объединенной строки (заголовка и полезной нагрузки) с помощью секретного ключа. Для этого мы будем использовать алгоритм хеширования, который мы указали в заголовке. Получившаяся подпись также, как и другие компоненты, должна быть закодирована с помощью Base-64.
$signature = base64_encode(hash_hmac("sha256", $headerAndPayload, $secret, true));
Итак, у нас теперь есть заголовок, полезная нагрузка и подпись. Они представляют собой отдельные текстовые компоненты. Для того, чтобы создать JWT, мы должны объединить из с помощью точки. И теперь мы можем отправить его клиенту:
$jwt = "$header.$payload.$signature";
Проверка входящих JWT
Клиентское приложение может определить, какие функции доступны пользователю, если расшифрует полезную нагрузку токена. Вот пример, написанный на JavaScript:
const tokenComponents = jwt.split(".");
const payload = token[1];
const payloadDecoded = JSON.parse(atob(payload));
// ["todos", "calendar", "invoicing"]
console.log(payloadDecoded.licensedFeatures);
Злоумышленник может подумать, что эти данные представляют собой простой текст и его легко изменить. Он может попробовать убедить сервер в том, что у него есть некая дополнительная доступная ему функция, изменив полезную нагрузку токена в своем запросе:
// Create a new payload component
const modifiedPayload = btoa(JSON.stringify({
...payloadDecoded,
licensedFeatures: ["todos", "calendar", "invoicing", "extraPremiumFeature"]
}));
// Stitch the JWT back together with the original header and signature
const newJwt = `${token[0]}.${modifiedPayload}.${token[2]}`
Как же сервер защищается от подобных атак? Ответ заключается в процессе создания подписи. Значение подписи учитывает, как заголовок токена, так и его полезную нагрузку. В случае данного примера изменение полезной нагрузки ведет к тому, что подпись становится недействительной.
Серверная программа проверяет входящие JWT путем пересчета их подписей. Если подпись, отправленная клиентом, не совпадает с подписью, посчитанной на сервере, то можно сделать вывод о том, что токен был подделан.
$tamperedToken = $_POST["apiKey"];
list($header, $payload, $signature) = $tamperedToken;
// Determine the signature this token *should* have
// when the server's secret is used as the key
$expectedSignature = hash_hmac("sha256", "$header.$payload", $secret, true);
// The token has been tampered with because its
// signature is incorrect for the data it includes
if ($signature !== $expectedSignature) {
http_response_code(403);
}
// The signatures match - we generated this
// token and can safely trust its data
else {
$user = fetchUserById($payload["userId"]);
}
Злоумышленник не может создать действительный токен, если он не знает секретный ключ, который хранится на сервере. Также это означает, что случайная утеря или преднамеренная передача секретного ключа сразу же делает все ранее созданные токены недействительными.
В реальной ситуации ваш код аутентификации должен проверять срок действия токена, а также должен убедиться, что он уже является действительным (
nbf
в полезной нагрузке). Это все необходимо для того, чтобы определить, является ли сеанс пользователя действительным.
Когда нужно использовать JWT
JWT, как правило используют для аутентификации API, поскольку их достаточно просто реализовать на сервере, легко использовать на клиентской стороне и просто передавать через границы сети. Но несмотря на то, что они такие простые, они обеспечивают хороший уровень безопасности за счет того, что каждый токен подписывается с помощью секретного ключа, который хранится на сервере.
JWT – это механизм, который не фиксирует текущее состояние, поэтому нет необходимости фиксировать информацию о созданных токенах на вашем сервере. Информацию о клиенте, который предоставляет вам JWT, вы можете получить из полезной нагрузки, а не искать ее в базе данных. После того, как подпись будет проверена, эта информация будет считаться достоверной.
Если вам необходимо обмениваться информацией между двумя сторонами без какого-либо постороннего вмешательства, то использование JWT – это отличный вариант. Однако у этого механизма есть слабые места, о которых следует знать заранее. В случае, если произойдет утечка секретного ключа или если ваш код проверки подписи содержит ошибку, то будет скомпрометирована вся система. Именно поэтому для реализации процесса создания и проверки JWT многие разработчики используют библиотеку с открытым исходным кодом. Функции доступны для всех популярных языков программирования, и они исключают риск ошибок при проверке токена.
Заключение
Стандарт JWT – это формат обмена данными, который включает в себя проверку целостности. Как правило, JWT используют для защиты взаимодействия между серверами API и клиентскими приложениями. Сервер может доверять входящим токенам, если у него получается воспроизвести их подписи. С помощью информации, полученной из полезной нагрузки, можно обеспечить безопасность при выполнении каких-либо действий
JWT достаточно удобны, но при этом имеют некоторые недостатки. Текстовое представление JWT в кодировке Base-64 может быть слишком объемным, если в полезной нагрузке будет слишком много полей. Это будет недопустимым потреблением ресурсов, если ваш клиент собирается отправлять JWT с каждым запросом.
Еще одним возможным недостатком может оказаться то, что JWT не фиксирует текущее состояние. После того, как токен был создан, он является неизменяемым и должен использоваться как есть до истечения своего срока действия. Клиенты, которые используют полезные данные JWT для определения прав доступа пользователя или для использования лицензированных функций, должны будут получать новый токен с сервера каждый раз, когда что-то из этого меняется.
Сегодня рассмотрим установку малоизвестного аналога FreePBX под названием Wazo – отличий достаточно много, начиная от версии Linux (Debian), дистрибутив с которой можно скачать с официального сайта http://wazo.community и заканчивая крайне непривычным видом самого Web-интерфейса.
Установка
В первую очередь, необходимо создать виртуальную машину под скачанный дистрибутив корректной разрядности – то есть машина должна быть 64-битной, если вы скачали соответствующий дистрибутив и наоборот. Далее, выбираем образ, с которого машина будет грузиться (здесь все также как и прежде – никаких изменений) и запускаем машину. Далее будет предложено выбрать способ установки, выбираем просто Install:
Далее появится возможность выбрать язык для установки – выбираем русский язык.
Выбираем местоположение – страну или регион:
Выбираем раскладку клавиатуры – нам нужна английская:
Далее начинается загрузка дополнительных компонентов – придётся немного подождать.
Дистрибутив Wazo «весит» совсем немного – около 400MB, однако, докачивает много файлов в процессе установки, и, конкретно в моём случае процесс установки получился очень длительным.
Далее вводим пароль суперпользователя (пароль на пользователя root). Обязательно сгенерируйте его соответствующим требованиям безопасности.
Затем выбираем часовой пояс, после чего начнётся установка базовой системы (на скриншотах ниже).
Далее начинается процесс настройки менеджера пакетов (в случае Debian-систем используется apt-get, в отличие от привычного yum). Сначала выбираем страну расположения – логично также выбрать РФ, затем выбираем зеркало – я выбрал зеркало МИФИ:
Оставляем пустым поле HTTP-прокси – в моём случае его заполнять не нужно. Сразу после этого будет довольно длительная процедура по настройке apt:
Последним шагом необходимо выбрать диск для установки системного загрузчика – так как в моём случае Wazo устанавливается на простейшей виртуальной машине, то и диск один – его и выбираем. После этого появится последний прогресс-бар о продолжении процесса установки. Как только процесс завершится (у меня этот процесс занял около 30 минут) произойдет перезагрузка.
Как только система загрузится, введите логин – root и пароль, который вы установили ранее. После чего, введите команду ipconfig для того, чтобы понять, какой адрес был присвоен IP-АТС. Кстати, в случае FreePBX пользователь видит IP - адрес сразу после входа на АТС. Далее заходим по адресу, который вы видите в выводе команды и продолжаем процесс первичной настройки.
Выбираем язык – к сожалению, выбрать можем только между английским и французским. Далее нажимаем Next и сначала читаем, затем соглашаемся с лицензионным соглашением GNU GPL.
После чего последовательно производим следующие настройки:
Hostname - имя вашего сервера с АТС;
Domain name - ваш домен;
WebInterface root password - пароль суперпользователя для управления АТС через веб-интерфейс;
Interface VoIP - адрес АТС и адрес шлюза по умолчанию;
DNS servers -DNS сервер – я оставил данную настройку нетронутой;
Затем будет неожиданное – настройка контекста внутренних вызовов, внешних и интервала нумерации:
Entity - название вашей организации;
Internal calls context - название контекста для внутренних вызовов и диапазон нумерации пользователей – позднее это можно будет изменить;
Incalls context - контекст для прямых вызовов (DID) и их диапазон – я оставил данное поле незаполненным;
Outcalls context - название контекста для исходящих вызовов;
После нажатия на Next вы увидите всю введенную информацию (для подтверждения) ещё раз – необходимо нажать на кнопку Validate:
Наконец-то можно начать пользоваться системой – но предварительно вы увидите экран, похожий на Dashboard у FreePBX – здесь есть информация о сетевых интерфейсах, железе, жёстком диске, запущенных серверах и плагинах.
Попробовать что-то покрутить касаемо телефонной части можно нажав на кнопку Services и, затем, IPBX – тут можно управлять транками, пользователями и так далее.
Заключение
Решать нужна ли вам данная АТС – только вам, но мы настоятельно советуем попробовать её установить, так как определённое количество «фишек» у неё присутствует – о них и о подробной настройке данной АТС мы расскажем в следующих статьях.