Запуск Docker-контейнера c FAST-нодой в режиме тестирования

Режим тестирования FAST-ноды предполагает выполнение теста безопасности с использованием существующего набора запросов, а также создание и выполнение тестовых запросов для целевого приложения.

Переменные в режиме тестирования

В таблице ниже приведены параметры (переменные окружения), которые вы можете использовать в режиме тестирования FAST-ноды:

Получение идентификатора политики тестирования

Если вы планируете использовать собственную политику тестирования, то создайте ее в облаке Валарм. Вы можете передать ее идентификатор FAST-ноде с помощью параметра TEST_RUN_POLICY_ID.

Если вы планируете использовать политику по умолчанию, не используйте параметр TEST_RUN_POLICY_ID при запуске FAST-ноды.

Получение идентификатора набора запросов

Чтобы в режиме тестирования использовать конкретный набор запросов, вы можете передать FAST-ноде его идентификатор, используя параметр TEST_RECORD_ID. Таким образом, нет необходимости каждый раз сначала запускать FAST-ноду в режиме записи, а можно использовать заранее сформированный набор запросов и с помощью него проводить тесты безопасности многократно (разными нодами и с разными политиками тестирования).

Получить идентификатор набора запросов вы можете в интерфейсе портала Валарм или из лога FAST-ноды в режиме записи. Если вы не используете параметр TEST_RECORD_ID, то FAST-нода будет использовать последний записанный набор.

Запуск FAST-ноды в режиме тестирования

Для запуска FAST-ноды в режиме тестирования можно воспользоваться тем же файлом docker-compose.yaml, что и в режиме записи. При этом важно изменить переменную CI_MODE и присвоить ей значение testing. Это можно сделать, изменив значение в файле docker-compose.yaml или передав значение переменной при запуске Docker-контейнера через опцию -e:

docker-compose run --rm -e CI_MODE=testing fast

При успешном выполнения этой команды в терминал будут выведены подобные сообщения:

 __      __    _ _
 \ \    / /_ _| | |__ _ _ _ _ __
  \ \/\/ / _` | | / _` | '_| '  \
   \_/\_/\__,_|_|_\__,_|_| |_|_|_|
            ___ _   ___ _____
           | __/_\ / __|_   _|
           | _/ _ \\__ \ | |
           |_/_/ \_\___/ |_|

Loading...
INFO synccloud[13]: Registered new instance 16dd487f-3d40-4834-xxxx-8ff17842d60b
INFO [1]: Loaded 0 custom extensions for fast scanner
INFO [1]: Loaded 44 default extensions for fast scanner
INFO [1]: Use TestRecord#rec_0001 for creating TestRun
INFO [1]: TestRun#tr_1234 created

В данном случае FAST-нода сообщает о том, что создан и запущен тест безопасности с идентификатором tr_1234 на основе набора запросов с идентификатором rec_0001.

Далее целевому приложению будут отправляться сформированные тестовые запросы. В терминал при этом будут поступать подобные сообщения:

INFO [1]: Running a test set for the baseline #bl_7777
INFO [1]: Test set for the baseline #bl_7777 is running
INFO [1]: Retrieving the baseline request Hit#["hits_production_202_20xx10_v_1", "AW2xxxxxW26"]
INFO [1]: Use TestPolicy with name 'Default Policy'

Из приведенного консольного вывода ясно, что запущен набор тестовых запросов (test set) для базового запроса с номером bl_7777. Так как вручную не задавался идентификатор политики тестирования, то используется политика тестирования по умолчанию с именем Default Policy.

Завершение работы FAST-ноды в режиме тестирования

В зависимости от результатов тестирования целевого приложения на уязвимости работа FAST-ноды может завершиться по-разному.

Если в ходе тестирования были выявлены уязвимости, то завершающие сообщения FAST-ноды будут подобны следующим:

INFO [1]: Found 4 vulnerabilities, marking the test set for baseline #bl_7777 as failed
ERROR [1]: TestRun#tr_1234 failed

В данном случае найдено четыре уязвимости. Набор тестовых запросов (test set) для базового запроса с идентификатором bl_7777 и тест безопасности с идентификатором tr_1234 считаются проваленными (failed).

Если в ходе тестирования уязвимости выявлены не были, то завершающие сообщения FAST-ноды будут подобны следующим:

INFO [1]: No issues found. Test set for baseline #bl_7777 passed.
INFO [1]: TestRun#tr_1234 passed

В этом случае набор тестов для базового запроса с идентификатором bl_7777 и тест безопасности с идентификатором tr_1234 считаются пройденными (passed).

После завершения процесса тестирования с тем или иным результатом, FAST-нода завершает свою работу и возвращает процессу CI/CD-инструмента определенный код завершения (exit code):

• Если все тестовые запросы были пройдены и не было непредвиденных ошибок, то возвращается exit code = 0.
• Если найдены уязвимости или возникли непредвиденные ошибки в работе FAST-ноды, то exit code = 1.

Несмотря на то, что контейнер с FAST-нодой в режиме тестирования будет остановлен автоматически после завершения тестов безопасности, вы можете воспользоваться описанными ранее методами для остановки контейнера.

В приведенном примере при запуске контейнера использовалась опция --rm, поэтому удаление контейнера произойдет автоматически.