К содержимому
← Вернуться в блог

Как подготовить ТЗ на вход через Smart-ID и проверить отмену авторизации

Вход через Smart-ID в Эстонии воспринимается как привычный элемент электронных услуг, но для команды разработки это отдельный сценарий с десятками деталей. Подготовка ТЗ на вход через Smart-ID и проверка отмены авторизации — две части одной задачи: сначала нужно описать ожидаемое поведение сервиса, затем доказать, что оно выполняется на тестовом стенде. Ниже — рабочая рамка для требований. Конкретные параметры протокола, названия статусов и коды ответов сверяйте с официальной документацией поставщика Smart-ID и требованиями вашей инфраструктуры: они могут меняться.

Такой документ нужен не только разработчикам. По нему тестировщик строит проверки, поддержка готовит ответы на обращения, а заказчик понимает, что именно принимает. Чем раньше эти роли сойдутся на одном тексте, тем меньше спорных ситуаций возникнет на приёмке.

Определите границы проекта и пользовательские сценарии

Прежде чем писать требования, зафиксируйте границы: вход только для существующих пользователей или ещё и первичная регистрация; нужен ли повторный вход для отдельных действий; что считается ошибкой, а что — обычной отменой. Для сервиса, рассчитанного на эстонскую аудиторию, вход через Smart-ID может быть одним из способов электронной идентификации. Проверьте, какие способы вы поддерживаете и не создаёт ли Smart-ID особых ожиданий у пользователя. Если сервис уже принимает ID-карту или Mobiil-ID, опишите, как способы входа сочетаются: общий экран, отдельные кнопки, одинаковые или разные правила блокировки.

  • роли и права: кто входит, какие действия доступны после входа;
  • точки входа: главная страница, глубокая ссылка, повторная авторизация;
  • результат: создание сессии, привязка идентификатора, переход в кабинет;
  • альтернативы: другие способы входа и поведение, если Smart-ID недоступен;
  • границы: что сервис не делает, например не создаёт учётную запись автоматически без отдельного шага.

Полезно нарисовать путь пользователя от нажатия кнопки до выхода из сессии. На этой схеме сразу видны места, где нужны тексты, тайм-ауты, повторные попытки и проверки. Если схема получается слишком большой, разделите её на основной вход и повторную аутентификацию для чувствительных действий.

Отдельно решите, для кого документ. Если ТЗ читает внешний подрядчик, добавьте короткий словарь терминов: «сессия», «идентификатор», «отмена», «тайм-аут» могут пониматься по-разному. Глоссарий на десять строк экономит часы переписки и снимает часть споров на приёмке.

Как подготовить ТЗ на вход через Smart-ID и проверить отмену авторизации

Этот раздел — ядро документа. Разделите требования на пользовательские, интеграционные и приёмочные. Пользовательские описывают, что видит человек; интеграционные — что сервис передаёт и принимает; приёмочные — как вы докажете, что всё работает. Не смешивайте их в одном абзаце: разработчику, тестировщику и заказчику нужны разные уровни детализации.

Практический приём: формулируйте требование в связке «действие — ожидаемый результат — способ проверки». Фраза «сервис корректно обрабатывает отмену» звучит убедительно, но проверить её нельзя. Фраза «после отмены защищённая страница не открывается, пользователь остаётся на экране входа и видит сообщение о незавершённом входе» уже даёт тестировщику конкретную проверку, а разработчику — понятную цель.

Функциональные требования к входу

В ТЗ стоит описать полный цикл, а не только успешный ответ. Начните с момента, когда пользователь нажимает кнопку, и закончите выходом из сессии или повторным входом. Для каждого шага укажите, что происходит с интерфейсом, какие данные сохраняются и какие сообщения видит человек.

  • начало входа: какие данные нужны, что отображается до ответа, можно ли нажать кнопку повторно;
  • ожидание: как показывается процесс, через какое время интерфейс предлагает повторить или закрыть сценарий;
  • успех: как создаётся сессия, что записывается в профиль, куда переходит пользователь;
  • неуспех: отмена, отказ, техническая ошибка, недоступность сервиса — разные тексты и разные действия;
  • повторный вход: что происходит со старой сессией, можно ли войти в другой вкладке, как работает выход.

Отдельно опишите, какие данные сервис получает от поставщика и какие хранит у себя. Не включайте в ТЗ фразу «получаем идентификатор» без расшифровки: нужно понять, достаточен ли он для входа, нужен ли дополнительный признак, как обрабатывается ситуация, когда пользователь сменил способ идентификации. Точный состав полей и их названия уточняйте в документации.

Тексты интерфейса тоже часть требований. Сообщение об отмене не должно выглядеть как сбой сервиса, а сообщение о недоступности — обещать, что «всё восстановится само». Зафиксируйте хотя бы смысл и тон сообщений, а финальные формулировки передайте редактору или ответственному за контент.

Что зафиксировать по отмене и тайм-ауту

Отмена — не то же самое, что техническая ошибка. Пользователь может нажать «Отмена» в интерфейсе сервиса, закрыть окно, отказаться в приложении Smart-ID или просто не дождаться ответа. В ТЗ перечислите все такие ветки и для каждой определите: остаётся ли пользователь на странице входа, появляется ли сообщение, можно ли сразу повторить попытку, создаётся ли сессия, что пишется в журнал.

Совет: сделайте отмену отдельным сценарием с собственным текстом и критерием приёмки. Если описать её только как «ошибку входа», тестировщик может проверить лишь один случай, а разработчик — обработать только один тип ответа.

Тайм-аут опишите как ожидание, которое закончилось без ответа. Для пользователя результат может выглядеть похоже на отмену, но в журналах и текстах это разные события. Не придумывайте конкретные коды и статусы заранее: в ТЗ достаточно указать класс события и ожидаемую реакцию, а точные значения взять из официальной документации и согласовать с поставщиком.

Ещё один пункт — идемпотентность. Если пользователь дважды нажал кнопку или обновил страницу, сервис не должен создавать две независимые сессии и не должен принимать старый ответ за новый вход. Формулировка может быть общей: «повторная обработка одного и того же ответа не приводит к повторному созданию сессии». Как это реализовать — вопрос архитектуры, но критерий стоит зафиксировать.

Добавьте правило для повторных попыток: сколько раз пользователь может начать вход заново, что происходит после успешного входа, как ведёт себя интерфейс, если предыдущая попытка ещё не завершена. Конкретные лимиты зависят от вашей политики и возможностей поставщика, поэтому не подставляйте числа наугад — обозначьте параметр как настраиваемый и согласуйте значение отдельно.

Как проверить отмену авторизации на тестовом стенде

Проверка начинается не с интерфейса, а с тестового плана. В нём должны быть не только успешные входы, но и отрицательные сценарии. Если тестовый стенд позволяет управлять ответом поставщика, проверьте разные моменты отмены; если нет — используйте доступные способы прервать сценарий и фиксируйте, что именно удалось воспроизвести.

  • отмена до подтверждения — пользователь возвращается на страницу входа без активной сессии;
  • отмена после подтверждения, но до возврата в сервис — если такой этап есть в вашей архитектуре, проверьте, не появляется ли частичный доступ;
  • закрытие окна или вкладки — повторное открытие не должно показывать чужую или устаревшую сессию;
  • тайм-аут — сообщение объясняет, что время истекло, и предлагает начать заново;
  • потеря сети — интерфейс не зависает, пользователь может повторить попытку;
  • повторная попытка после отмены — новый вход работает, старый ответ не применяется;
  • параллельные вкладки — вход в одной не ломает состояние другой без понятного правила;
  • кнопка «назад» — возврат в браузере не открывает закрытую часть кабинета.

Похожие проверки для другого канала описаны в материале о том, как проверить вход через Mobiil-ID при отмене запроса и тайм-ауте. Он полезен как образец логики, но не заменяет требования Smart-ID: у разных способов идентификации свои детали.

Заранее решите, какие среды вы используете и что делать, если поведение на стенде отличается от ожидаемого. Тестовая среда не всегда повторяет продуктивную, поэтому расхождение — это не автоматически дефект, а повод зафиксировать условие проверки. Укажите в протоколе версию конфигурации и дату, иначе через месяц результат будет невозможно воспроизвести.

Приёмочные проверки и критерии

Приёмку удобно строить как матрицу «сценарий — ожидаемый результат — доказательство». В доказательство включите не только скриншот, но и запись в журнале, отсутствие лишней записи в базе и повторный вход после отмены. Ниже — минимальный набор критериев, который стоит адаптировать под ваш продукт.

  • после отмены нет активной сессии и доступа к защищённым страницам;
  • пользователь видит понятное сообщение и может повторить вход без перезапуска браузера;
  • в журнале есть событие отмены или тайм-аута без лишних персональных данных;
  • повторный вход после отмены проходит успешно;
  • старый ответ не используется повторно и не создаёт вторую сессию;
  • поведение совпадает с официальной документацией и согласованными требованиями;
  • тексты интерфейса не обещают того, чего сервис не делает.

Если сервис поддерживает разные браузеры, добавьте проверку в целевых средах. Отдельный материал о том, как протестировать вход с эстонской ID-картой в разных браузерах, помогает не забыть про мобильные устройства, возврат назад и различия в поведении окон. Для Smart-ID набор будет своим, но принцип тот же: проверяйте не только «получилось войти», но и «получилось корректно не войти».

Результаты держите в одном месте: сценарий, среда, ожидание, факт, чем подтверждено. Через месяц после релиза такая запись помогает понять, был ли дефект известен заранее. Для повторяемости используйте тестовые данные, которые можно вернуть в исходное состояние, и не проводите негативные проверки на реальных учётных записях.

Безопасность, данные и журналирование

В ТЗ на вход через Smart-ID неизбежно появляются персональные данные и события аутентификации. Не превращайте раздел безопасности в набор общих слов. Опишите, какие данные нужны для входа, где они хранятся, кто имеет доступ и как долго живёт сессия. Конкретные правовые основания, сроки хранения и порядок уведомлений проверьте с юристом и в официальных источниках: статья даёт редакционную рамку, а не юридическое заключение.

Для журналов достаточно принципа: событие должно помогать разобрать инцидент, но не должно содержать секретов и лишних данных. Не логируйте полные ответы поставщика, пароли, коды подтверждения и всё, что не нужно для диагностики. Если вы записываете IP-адрес, тип устройства или идентификатор пользователя, обоснуйте необходимость и ограничьте доступ к этим данным.

Отдельно зафиксируйте защиту от повторного использования ответа: старый результат не должен открывать новую сессию. Ограничьте количество попыток и время ожидания. Предусмотрите понятное поведение при недоступности поставщика: сервис не должен показывать пользователю технические детали, но должен дать возможность повторить позже. Эти требования стоит согласовать с ответственным за безопасность и с поставщиком, если он задаёт обязательные условия.

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

Как оформить документ и принять результат

Структура ТЗ может быть такой: цель и границы; роли и сценарии; функциональные требования; поведение при отмене, тайм-ауте и ошибках; данные и журналы; интеграционные ограничения; тестовая среда; критерии приёмки; открытые вопросы. Не обязательно делать документ огромным. Полезнее, если каждый пункт можно проверить: у требования есть ожидаемый результат, а у результата — способ проверки.

В приёмке разделите обязательные и желательные требования. Например, отсутствие сессии после отмены — обязательный критерий, а формулировка сообщения — вопрос качества, который можно уточнять отдельно. Если какой-то пункт зависит от поставщика, отметьте его как открытый вопрос и не выдавайте предположение за требование. Такой подход снижает риск, что команда реализует одно поведение, а тестировщик будет проверять другое.

Добавьте раздел с владельцами решений: кто отвечает за сверку с поставщиком, кто утверждает тексты, кто принимает финальную сборку. Пункт без владельца обычно остаётся нерешённым до самого релиза. Там же пригодится история версий: если требования менялись, должно быть видно, какая редакция действует сейчас.

Перед передачей в разработку пройдитесь по документу глазами тестировщика: сможет ли он по этому тексту воспроизвести отмену? Понятно ли, что считается успехом и что — неуспехом? Есть ли ссылка на официальную документацию и указано, какие версии требований действуют? Если на эти вопросы нет ответа, ТЗ ещё не готово.

Частые вопросы

Можно ли подготовить ТЗ на Smart-ID без технической документации?

Можно описать бизнес-сценарии, роли и ожидаемое поведение интерфейса, но перед разработкой нужно сверить протокол, состав данных, ограничения и коды ответов с официальной документацией поставщика Smart-ID. Без этого ТЗ останется на уровне пожеланий и может разойтись с фактической интеграцией.

Что должно происходить при отмене входа?

Сервис не должен открывать полноценную сессию или давать доступ к защищённым страницам. Пользователь должен понять, что вход не завершён, и иметь возможность повторить попытку. Конкретное поведение зависит от этапа отмены и фиксируется в ТЗ; точные статусы сверяйте с документацией.

Чем отмена отличается от тайм-аута?

При отмене действие инициирует пользователь или интерфейс, а при тайм-ауте ответ просто не приходит за отведённое время. Для пользователя итог может быть похожим, но в журналах, текстах и тестах это разные события.

Нужно ли проверять отмену в разных браузерах?

Да, если эти браузеры входят в ваши целевые среды. Поведение окон, возврата назад и повторного открытия страницы может отличаться. Проверьте хотя бы мобильный и десктопный сценарии, которые вы обещаете поддерживать.

Какие данные не стоит писать в журнал?

Не журналируйте секреты, полные ответы поставщика и персональные данные, которые не нужны для диагностики. Перечень зависит от вашей политики и правовых требований; его стоит согласовать с ответственным за защиту данных и проверить в официальных источниках.

Как принять работу по отмене авторизации?

По заранее согласованной матрице сценариев: после отмены нет активной сессии, пользователь видит понятное сообщение, повторный вход работает, старый ответ не используется, а журнал содержит достаточно информации для разбора. Поведение должно совпадать с официальной документацией и требованиями ТЗ.