Допустим, вы разрабатываете 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 принимает событие, а доставка выполняется по настроенному маршруту и может включать повторные попытки.
Как подключить первый туннель
Откройте Tunnels в кабинете и нажмите Create tunnel.
Выберите регион и укажите Endpoint URL, например
http://127.0.0.1:3000.Выпустите CLI token в карточке туннеля и запустите Adal CLI версии 1.0.3 или новее с этим токеном.
Когда туннель покажет статус Online, отправьте запрос на его публичный HTTPS-адрес и откройте запись в журнале.
Адрес туннеля публичный. Для первого запуска используйте тестовый сервис, рассчитанный на внешние запросы. Туннели используют общий баланс трафика Adal Cloud. Учитываются фактически полученные байты тел запроса и ответа независимо от настроек сохранения.
В быстром старте есть команды для macOS, Linux и Windows и пример, который можно запустить со своим тестовым сервисом.