Вернуться в блог
Журнал Adal Cloud

Adal Cloud теперь поддерживает HTTP-туннели

Подключите локальный HTTP-сервис к публичному HTTPS-адресу и изучайте запросы и ответы в кабинете.

Опубликовано
Adal Cloud теперь поддерживает HTTP-туннели

Допустим, вы разрабатываете API для заказов. На вашем компьютере POST /orders уже работает, и теперь нужно проверить, как его вызывает внешняя система. Для этого ей нужен адрес, доступный из интернета, а вам важно увидеть, какой ответ получит клиент.

Мы добавили в Adal Cloud HTTP-туннели для таких задач. Создайте туннель, укажите адрес локального приложения и подключите Adal CLI. Внешняя система сможет вызвать API по публичному HTTPS-адресу и получить ответ приложения в рамках того же HTTP-запроса. В кабинете можно открыть журнал и посмотреть, как прошёл обмен.

Как запрос доходит до локального API

Туннель получает публичный HTTPS-адрес в выбранном регионе. Adal CLI запускается там, откуда доступен ваш сервис, и устанавливает исходящее соединение с Adal Cloud. Для этого компьютеру не нужны публичный IP и открытый входящий порт.

Запрос: внешний клиент → HTTPS-адрес туннеля → Adal CLI → локальный API
Ответ: локальный API → Adal CLI → туннель → внешний клиент

Если в настройке Endpoint URL указан http://127.0.0.1:3000/api, запрос на /orders?source=test по адресу туннеля попадёт на http://127.0.0.1:3000/api/orders?source=test. Если приложение вернёт 201 Created и JSON с идентификатором заказа, внешний клиент получит этот статус и тело ответа. Если приложение вернёт 400 Bad Request, например из-за пропущенного поля, клиент увидит этот ответ и сможет обработать его как обычно.

Так можно проверить интеграцию с внешней системой, показать API коллеге или воспроизвести ошибку, которая возникает только при вызове из другого окружения.

Что видно в журнале

Откройте Tunnels → Requests в кабинете и выберите нужный запрос. Журнал показывает HTTP-код, источник ответа и результат передачи. Например, по 502 можно понять, вернул ли его сам API или ответ сформировал Adal Cloud. Если приложение начало отвечать с 200 OK, а передача тела оборвалась, журнал покажет, что обмен завершился не полностью.

Настройки Save request и Save response действуют независимо для каждого туннеля. Можно сохранить обе стороны обмена, только одну или отключить обе. При включённом сохранении доступны заголовки и тело, если они были получены и сохранены. HTTP-данные доступны до 90 дней с момента приёма. Результат обмена и объём переданных данных видны в журнале независимо от настроек сохранения.

Туннель и доставка вебхуков

HTTP-туннель подходит для запросов, ответ на которые должно сформировать само приложение, пока клиент ждёт. Для этого Adal CLI должен быть подключён, а локальный сервис — доступен. Запросы через туннель проходят без очереди и автоматических повторов.

Когда задача состоит в том, чтобы принять вебхук и доставить его обработчику отдельно, используйте Inbound. В этом режиме Сервер Adal Cloud принимает событие, а доставка выполняется по настроенному маршруту и может включать повторные попытки.

Как подключить первый туннель

  1. Откройте Tunnels в кабинете и нажмите Create tunnel.

  2. Выберите регион и укажите Endpoint URL, например http://127.0.0.1:3000.

  3. Выпустите CLI token в карточке туннеля и запустите Adal CLI версии 1.0.3 или новее с этим токеном.

  4. Когда туннель покажет статус Online, отправьте запрос на его публичный HTTPS-адрес и откройте запись в журнале.

Адрес туннеля публичный. Для первого запуска используйте тестовый сервис, рассчитанный на внешние запросы. Туннели используют общий баланс трафика Adal Cloud. Учитываются фактически полученные байты тел запроса и ответа независимо от настроек сохранения.

В быстром старте есть команды для macOS, Linux и Windows и пример, который можно запустить со своим тестовым сервисом.

Другие материалы блога Adal Cloud

Читайте об обновлениях продукта, работе с вебхуками и инженерных решениях.

Вернуться в блог