Переменные окружения FAST-ноды
Для изменения настроек FAST-ноды используются различные параметры. Их значения можно изменять, задавая переменные окружения FAST-ноды с соответствующими именами.
Менять значения переменных окружения и передавать их FAST-ноде можно:
Через опцию
-e
:docker run --name <имя контейнера> \ -e <переменная окружения 1>=<значение> \ ... -e <переменная окружения N>=<значение> \ -p <порт для публикации>:8080 wallarm/fast
Через опцию
--env-file
, которой передается путь до файла с переменными окружения:docker run --name <имя> \ --env-file=<файл с переменными среды окружения> \ -p <порт для публикации>:8080 wallarm/fast
Внутри файла переменные окружения перечисляются построчно:
# Пример файла с переменными окружения WALLARM_API_TOKEN=token_Qwe12345 # Демонстрационное значение — используйте полученный вами токен ALLOWED_HOSTS=google-gruyere.appspot.com # Хост, запросы к которому будут записываться в набор запросов
В таблице ниже приведены параметры, которые вы можете использовать.
Параметр | Значение | Обязателен |
---|---|---|
WALLARM_API_TOKEN |
Токен, полученный ранее в облаке Валарм. | Да |
WALLARM_API_HOST |
Адрес используемого API-сервера Валарм. Возможные значения: us1.api.wallarm.com — для американского облака;api.wallarm.com — для европейского облака;api.wallarm.ru — для российского облака. |
Да |
ALLOWED_HOSTS |
Перечень хостов целевого приложения, запросы к которым будут записаны в набор запросов. По умолчанию записываются все запросы. Подробнее здесь. |
Нет |
WALLARM_API_USE_SSL |
Использовать SSL-соединение при подключении к API Валарм. Возможные значения: true , false .По умолчанию: true . |
Нет |
WORKERS |
Количество потоков, извлекающих базовые запросы из набора запросов и выполняющих тесты безопасности. По умолчанию: 10 . |
Нет |
GIT_EXTENSIONS |
Ссылка на Git-репозиторий с DSL-расширениями (должен быть доступен из контейнера FAST-ноды) | Нет |
CI_MODE |
Режим работы FAST-ноды при внедрении в рабочие процеccы CI/CD. Возможные значения: recording — для режима записи; testing — для режима тестирования. |
Нет |
BACKEND_HTTPS_PORTS |
Порт(ы) протокола HTTPS для целевого приложения, если используе(ю)тся нестандартный(е) порт(ы).Доступно перечисление нескольких портов: BACKEND_HTTPS_PORTS='443;3000;8091' По умолчанию: 443 |
Нет |
WALLARM_API_CA_VERIFY |
Производить валидацию API Валарм (проверка CA-сертификата). Возможные значения: true , false .По умолчанию: false . |
Нет |
CA_CERT |
Расположение CA-сертификата FAST-ноды. По умолчанию: /etc/nginx/ssl/nginx.crt . |
Нет |
CA_KEY |
Расположение CA-ключа FAST-ноды. По умолчанию: /etc/nginx/ssl/nginx.key . |
Нет |
Ограничение записываемых запросов
По умолчанию FAST-нода расценивает все поступившие запросы как базовые — она осуществляет их запись, создает и выполняет тестовые запросы на их основе. Однако через FAST-ноду при включенном проксировании может проходить большое количество запросов, не являющихся базовыми запросами к целевому приложению.
Вы можете ограничить количество записываемых запросов при помощи отсечения всех входящих запросов, не являющихся базовыми. Это позволит ускорить процесс тестирования с помощью FAST и снизить нагрузку на FAST-ноду и целевое приложение. Для этого вам необходимо знать, с какими хостами, относящимся к целевому приложению, взаимодействует источник запросов в процессе тестирования. Отсечь все не-базовые запросы, можно, задав значение переменной среды окружения ALLOWED_HOSTS
.
Допустимые значения переменной ALLOWED_HOSTS
Переменная ALLOWED_HOSTS
может принимать значения хостов в следующих форматах:
- полные имена (например,
node.example.local
) - значение, начинающееся с точки (например,
.example.local
), которое распознается как множество всех поддоменов домена, указанного после первой точки - значение
*
, которому соответствует любой хост (в этом случае, все полученные запросы будут записаны FAST-нодой) - набор из нескольких значений, например:
"(node.example.local|example.com)"
- регулярное выражение в формате, описанном в документации NGINX
Более подробная информация о значениях переменной ALLOWED_HOSTS
доступна по ссылке.
FAST-нода работает с переменной ALLOWED_HOSTS
следующим образом:
- Если заголовок Host поступившего запроса соответствует значению переменной
ALLOWED_HOSTS
, считать запрос базовым. Такой запрос записывается и проксируется. - Для всех других запросов: запись не выполняется, они только проксируются.
results matching ""
No results matching ""
results matching ""
No results matching ""