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
- Добавьте новый способ авторизации и метрику использования старого query-параметра.
- Переведите контролируемые клиенты и выдайте им отдельные credentials.
- На старом endpoint сократите права и срок действия, включите предупреждение.
- Назначьте дату отключения и после неё отвергайте URL-секреты.
- Ротируйте ключи, которые могли сохраниться в журналах, даже если логи очищены.
Не оставляйте поддержку `?api_key=` «на всякий случай». Такой fallback почти всегда переживает проект и снова появляется в новых интеграциях.
Контрольный тест после исправления
Повторите запрос с новым тестовым маркером. Он может присутствовать только там, где секрет действительно нужен для проверки, и не должен появляться в URL, аналитике и обычных журналах. Проверьте также 4xx/5xx: обработчики ошибок часто логируют больше, чем успешный путь.
Что подготовить для безопасного разбора
Нужны перечень точек входа, схема прокси и наблюдаемости, названия параметров и обезличенные примеры логов. Настоящие токены присылать не нужно. По этой карте можно составить порядок ротации и убрать утечку без остановки всех интеграций одновременно.