URL редко остаётся только между двумя сервисами. Его записывают reverse proxy, CDN, APM, браузерная история, система аналитики и иногда Referer при переходе на другую страницу. Поэтому `?token=...` следует считать не просто неудобным форматом, а потенциально размноженным секретом.

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

Пройдите путь одного URL

Создайте тестовый маркер, который нельзя использовать как настоящий ключ, и выполните обычный запрос. Ищите его в access-log приложения и прокси, CDN, trace, error tracker, аналитике, очередях, уведомлениях и тикетах. Так вы получите фактическую карту, а не предположение по архитектурной схеме.

СлойПочему видит URLЧто изменить
Reverse proxyСтандартный request lineРедактирование query и запрет чувствительных параметров
APM и ошибкиАвтоматический capture запросаSanitizer до отправки события
БраузерИстория и копирование ссылкиНе помещать bearer secret в адрес
АналитикаPage URL как атрибут событияAllowlist безопасных параметров

Выберите замену по типу взаимодействия

Сервис вызывает сервис

Передавайте bearer token в заголовке `Authorization` по TLS. Ещё лучше — выдавайте отдельную идентичность каждому сервису, ограничивайте audience и scopes и используйте короткий срок жизни. Заголовки тоже нельзя бездумно писать в лог: sanitizer должен работать до трассировки.

Пользователь переходит по ссылке

Для подтверждения email или входа по ссылке используйте одноразовый короткоживущий код. После первого запроса обменяйте его на защищённую сессию и сразу перенаправьте пользователя на чистый URL. Код должен быть привязан к действию и становиться недействительным после применения.

GET /confirm?code=one-time-random-value
302 Location: /account/confirmed
Set-Cookie: session=...; Secure; HttpOnly; SameSite=Lax

Миграция без скрытого вечного fallback

  1. Добавьте новый способ авторизации и метрику использования старого query-параметра.
  2. Переведите контролируемые клиенты и выдайте им отдельные credentials.
  3. На старом endpoint сократите права и срок действия, включите предупреждение.
  4. Назначьте дату отключения и после неё отвергайте URL-секреты.
  5. Ротируйте ключи, которые могли сохраниться в журналах, даже если логи очищены.

Не оставляйте поддержку `?api_key=` «на всякий случай». Такой fallback почти всегда переживает проект и снова появляется в новых интеграциях.

Контрольный тест после исправления

Повторите запрос с новым тестовым маркером. Он может присутствовать только там, где секрет действительно нужен для проверки, и не должен появляться в URL, аналитике и обычных журналах. Проверьте также 4xx/5xx: обработчики ошибок часто логируют больше, чем успешный путь.

Что подготовить для безопасного разбора

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

Проверенные источники