Тестовые учётные данные и секреты в автоматизированных браузерных тестах
By Mirko Peters · · Updated
Секреты в автоматизированных браузерных тестах утекают через код, трассировки, видео и журналы. Разберитесь, как не хранить пароли в репозитории, ограничивать тестовые учётные записи и очищать артефакты.
Automatically translated with AI from the original post. Read the English original
Секреты в автоматизированных браузерных тестах — это пароли, токены, ключи API и cookie сеанса, которые тестам нужны для входа в систему. Утекают они в больше мест, чем ожидает большинство команд. Правильная работа с ними — базовая часть автоматизации тестирования и автоматизации браузера в целом. Это руководство для инженеров по автоматизации тестирования, которые пишут или поддерживают браузерные тесты для сквозного тестирования, выполняющего вход в реальные системы. Вы узнаете, где утекают секреты, как не допускать их попадания в код и репозитории, как настраивать тестовые учётные записи с ограниченным доступом, как безопасно повторно использовать состояние входа и как работать с многофакторной аутентификацией. Пример с вымышленными цифрами наглядно показывает быстрый аудит.
Ключевые выводы
- Секреты в браузерных тестах утекают в гораздо большем числе мест, чем сам тестовый код: трассировки, скриншоты, видео, журналы консоли, файлы HAR и сохранённое состояние входа могут содержать токены или пароли.
- Никогда не прописывайте пароли жёстко в файлах тестов. Локально загружайте их из переменных окружения, а в конвейерах — из хранилища секретов CI-платформы.
- Сохранённый файл состояния браузера может содержать действующие cookie сеанса, которые позволят кому-то выдать себя за тестовую учётную запись, поэтому держите его вне каждого репозитория.
- Используйте выделенные тестовые учётные записи: по одной на роль и, для параллельных запусков, которые меняют общие данные, по одной на каждого исполнителя. Каждая запись должна иметь только тот доступ, который нужен её тестам.
- Очищайте артефакты до того, как они покинут раннер, ограничивайте круг тех, кто может читать отчёты, и не допускайте попадания тестовых обходных способов входа в производственную среду.
Где утекают секреты в автоматизированных браузерных тестах
Очевидная утечка — пароль, введённый в один из ваших тестовых скриптов. Менее очевидные утечки связаны с файлами, которые создаёт тестовый прогон. В статье Currents о предотвращении утечек данных в Playwright перечислены эти риски, и они применимы к другим инструментам, которые записывают прогоны похожим образом:
- Трассировки. Трассировка может содержать необработанные заголовки авторизации, bearer-токены, значения cookie, снимки страниц и персональные данные, видимые в сетевом трафике. В статье трассировки названы самым критичным риском.
- Скриншоты. Значение может быть видно, пока тест его вводит, а токен может отображаться в уведомлении.
- Видео. Видео записывает весь экран на протяжении всего теста, включая автозаполненные пароли и токены, показанные на страницах администрирования.
- Журналы консоли и вложения. Вывод консоли повторяется при каждой повторной попытке, а прикреплённые ответы API могут содержать токены или персональные данные.
- Вывод отчётов и шагов. Если в название шага включено значение из окружения, оно попадает в журналы CI и HTML-отчёты.
- Файлы HAR. В этих записях сетевых запросов хранятся заголовки и тела запросов и ответов, которые могут содержать учётные данные.
- Сохранённое состояние входа. Файл состояния содержит действующие cookie сеанса и токены и может попасть в Git, если никто не добавит его в игнорируемые.
В статье также предупреждается, что маскирование секретов в CI покрывает только вывод журналов и пропускает значения, которые закодированы, обрезаны или объединены с другим текстом. Маскирование — это страховочная сетка, а не решение проблемы.
Храните пароли вне кода и репозитория
В руководстве TestDino по аутентификации в Playwright всё прямо: никогда не записывайте пароли непосредственно в тестовые файлы. Его рекомендации для запусков в CI совпадают с общепринятой практикой и в других фреймворках:
- Используйте переменные окружения. Локально храните пароли в файле окружения, который исключён из системы контроля версий. В CI используйте механизм управления секретами вашего провайдера и читайте значения из окружения процесса.
- Игнорируйте файл. Добавьте шаблоны файлов окружения в список игнорируемых до первого коммита и фиксируйте только файл-заглушку, в котором перечислены имена переменных.
- Пусть приоритет будет у конвейера. Currents советует настроить загрузчик окружения так, чтобы значения, переданные из CI, имели приоритет над значениями из локального файла.
- Для больших команд используйте менеджер секретов. Эти рекомендации по безопасности хорошо масштабируются. Currents называет встроенные в CI хранилища секретов и внешние менеджеры, такие как Vault, AWS Secrets Manager и Google Cloud Secret Manager. Также он рекомендует краткоживущие токены через workload identity и разрешения раннеров, ограниченные только теми путями к секретам, которые нужны запуску.
- Не меняйте имена шагов. Не записывайте секрет в название шага. Используйте фиксированную метку.
Если секрет уже попал в коммит, считайте его скомпрометированным. Смените его, а затем очистите историю. Удаление файла в последующем коммите не убирает его из истории.
Используйте выделенные тестовые учётные записи с минимальными привилегиями
Тестовая учётная запись — это настоящая учётная запись, и она требует такой же внимательности, как и любая другая. Когда вы автоматизируете вход, вы автоматизируете и доступ к реальной системе, поэтому проверяйте, к чему каждая учётная запись имеет доступ, в каждой тестовой среде. Принцип наименьших привилегий применяется здесь напрямую: выдавайте каждой учётной записи только тот доступ, который нужен её тестам, и не больше.
- Никогда не используйте личную учётную запись. Выделенную учётную запись можно отключить, сменить ей пароль или проверить её активность, не затрагивая доступ конкретного человека.
- Одна учётная запись на роль. Если тесты проверяют, что видит администратор и что видит обычный пользователь, каждой роли нужна своя учётная запись. TestDino включает это в список требований для тестов с несколькими ролями.
- Одна учётная запись на параллельный воркер, если тесты изменяют общие данные. Документация Playwright по входу описывает это так: одна общая учётная запись подходит только в том случае, если тесты могут выполняться одновременно, не влияя друг на друга. В противном случае каждому параллельному воркеру нужна собственная учётная запись. TestDino описывает выбор учётной записи по индексу воркера.
- Ограничивайте доступ к боевым системам. Если какой-либо тест обращается к работающей системе, учётная запись для входа должна быть изолирована и не иметь доступа к биллингу или данным клиентов.
- Назначьте владельца и срок действия. Запишите, кто владеет каждой учётной записью и когда пересматриваются её пароли. Это наша собственная рекомендация, а не положение из источников.
Учётные записи, у которых нет владельца, переживают тесты, для которых были созданы, и остаются действительными намного дольше.
Повторно используйте состояние входа, не раскрывая его
Тестовые данные и состояние входа — это разные вещи, но оба требуют защиты. Вход через экран перед каждым тестом занимает много времени и делает каждый автоматизированный тест зависимым от сценария входа. В документации Playwright по аутентификации описан распространённый подход: шаг настройки выполняет ввход один раз и записывает состояние браузера в файл, после чего тесты начинают работу с этого состояния. В документации также приведены правила безопасности:
- Создайте папку для файлов состояния и добавьте её в файл игнорируемых. Документация рекомендует именно это.
- Относитесь к файлу как к учётным данным. В предупреждении указано, что он может содержать чувствительные cookie и заголовки, которые можно использовать для выдачи себя за вас или за вашу тестовую учётную запись, и документация настоятельно не рекомендует добавлять такие файлы в приватные или публичные репозитории.
- Удаляйте сохранённое состояние по истечении срока действия или записывайте его в выходную папку, если его не нужно сохранять между запусками.
- Если приложение поддерживает вход через API, это может быть проще и быстрее, чем управление интерфейсом, а полученное состояние сохраняется так же.
Currents добавляет шаг очистки: очищайте cookie в teardown вашей фикстуры входа и ограничивайте круг лиц, которые могут читать артефакты CI.
Многофакторный вход и обходные пути только для тестов
Многофакторная аутентификация усложняет автоматизацию, и в этом её смысл. TestDino предлагает варианты для тестовых учётных записей. Для кодов из приложения-аутентификатора генерируйте код в скрипте настройки с помощью библиотеки. Для кодов по SMS или электронной почте отключите многофакторный вход для тестовых учётных записей в staging или используйте маршрут, предназначенный только для тестов.
Обходной маршрут только для тестов — реальный риск. По словам TestDino, его следует ограничивать проверкой переменной окружения и никогда не развёртывать в production. Любой обход входа нужно рассматривать как функцию безопасности, которая требует собственной проверки.
Выбирайте тестовые сценарии, которым нужен реальный вход
Не каждому тест-кейсу нужен живой вход. В рамках стратегии тестирования мы предлагаем оставить один-два сквозных сценария, которые проходят реальную страницу входа в настоящем браузере, а остальные функциональные тесты начинать с сохранённого состояния или со входа через API, как при тестировании API. Так ограничивается число ввода секретов, ускоряется выполнение тестов, и при этом сохраняется покрытие процесса входа.
Собирайте шаги входа в одном месте, например в классе page object model или в общей фикстуре, чтобы изменение страницы входа или способа чтения секретов затрагивало только один скрипт автоматизации. Если копировать шаги входа в каждый тест, это частая причина утечек, а при изменении страницы такой тест становится более нестабильным.
Ручное и исследовательское тестирование экранов входа проводите на учётных записях, которые автоматизация не использует, поскольку общие логины приводят к блокировкам и размывают журнал аудита. Добавьте небольшую проверку безопасности в тот же параллельный запуск, например поиск токенов в отчётах. Какой бы инструмент автоматизации вы ни выбрали, правила работы с секретами не меняются.
Пример: 30-минутный аудит
Цифры вымышленные.
Команда запускает 90 браузерных тестов в рамках своего регрессионного тестирования и проверяет репозиторий тестов на наличие секретов. Аудит занимает 30 минут и выявляет пять проблем:
- Два пароля, записанные в вспомогательном файле тестов.
- Папка с файлами сохранённого состояния входа, которой нет в списке игнорируемых.
- Настройка трассировки, которая записывает каждый тест, и артефакты отчётов, доступные для открытия всем сотрудникам.
- Одна учётная запись, которую используют все 8 параллельных воркеров, из-за чего два теста случайно падают.
- Личная учётная запись бывшего тестировщика, которую до сих пор использует один тест.
Исправления занимают один день. Пароли переносятся в хранилище секретов CI, а старые значения меняются. Папка состояния добавляется в игнорируемые и удаляется из истории. Трассировки сохраняются только для упавших тестов, а доступ к отчётам сужается до группы QA. Каждый параллельный воркер получает собственную учётную запись, и случайные сбои прекращаются. Личная учётная запись заменяется выделенной, у которой есть владелец. Команда планирует повторять такой аудит каждый квартал.
Распространённые ошибки
- Жёстко прописанный пароль «пока что». Он остаётся в истории навсегда.
- Коммит сохранённого состояния входа. Файл работает как пароль для учётной записи.
- Доверие маскировке логов CI. Она пропускает закодированные или частичные значения и ничего не делает для трассировок и видео.
- Запись всего подряд. Видео, полные трассировки и открытые отчёты распространяют секреты на большее число людей.
- Общий логин для параллельных воркеров. Это вызывает и случайные сбои, и размытый журнал аудита.
- Забытые обходные маршруты для тестов в production. Ограничивайте их и проверяйте.
Как может помочь программное обеспечение
Начните с хранилища секретов вашей CI-платформы и с сканирования секретов в репозитории, если оно есть. Менеджер секретов также может шифровать сохранённые значения и помогает, когда несколько команд используют общие логины, поскольку в одном месте управляет доступом, ротацией и журналированием. Настройки вашего тестового фреймворка определяют, что записывается, а небольшой скрипт может удалять конфиденциальные заголовки из артефактов. Выбирайте инструменты автоматизированного тестирования, которые подходят вашей CI-настройке, и проверьте очистку на пробном запуске, прежде чем на неё полагаться. Те же правила действуют в Selenium, Cypress, Playwright или наборе тестов на Python, а также для UI-тестов и для API-тестов, которые вызывают веб-приложение.
Следующий шаг
Откройте сегодня свой репозиторий тестов и найдите в нём пароли, токены и файлы сохранённого состояния, затем перенесите каждый найденный секрет в хранилище секретов CI. После этого проверьте, как ваши тесты записывают трассировки и видео, чтобы секреты в автоматизированных браузерных тестах перестали распространяться через отчёты.