Если токен уже увидел пользователь или он попал в доступный журнал, считайте его раскрытым. Сначала отзовите credential либо поверните связанный секрет, ограничьте активные сессии и проверьте использование после момента утечки. Косметическое скрытие строки в интерфейсе не отменяет копии в логах, APM, crash reports и чатах поддержки.

После сдерживания найдите источник: приложение могло вывести весь объект HTTP-ошибки, сериализовать request config вместе с `Authorization`, прикрепить environment variables к stack trace или повторить URL с token в query string. Ищите путь данных от клиента API до конечного error renderer, а не одно совпадение в шаблоне.

Определите масштаб до очистки следов

Где виден токенКто мог получить доступНемедленное действие
Экран пользователяПользователь, запись экрана, поддержкаОтозвать токен и убрать технические details
Серверный логРазработчики и log pipelineОграничить доступ, найти диапазон событий, запустить redaction
APM или crash reportСотрудники и интеграции мониторингаОтключить сбор поля и удалить доступные копии по процедуре
URL queryПрокси, история и referrerОтозвать token и перенести credential в header
Клиентская аналитикаПровайдер аналитикиОстановить событие и выполнить процедуру инцидента

Не вставляйте сам токен в поисковый запрос общего log explorer: это создаст ещё одну копию в истории запросов. Используйте безопасный отпечаток, внутренний token ID или ограниченный поиск по времени и request ID. Экспорт журналов «для анализа» тоже расширяет область утечки.

Пользовательская ошибка не должна повторять upstream response

Разделите публичное сообщение и внутреннюю диагностику. Пользователь получает стабильный код ошибки и безопасное объяснение. Внутреннее событие содержит request ID, компонент, класс исключения и разрешённые поля. Тело ответа внешнего API, headers и конфигурация запроса проходят через allowlist, а не выводятся целиком.

function publicError(error, requestId) {
  logger.error('upstream_request_failed', {
    requestId,
    service: error.service,
    status: error.status,
    code: error.code,
  });

  return {
    error: 'service_unavailable',
    requestId,
    message: 'Не удалось выполнить запрос. Повторите позже.',
  };
}

Пример намеренно не переносит `error.config`, request headers и raw body. Даже redaction по названию `token` недостаточна: секрет может находиться в `Authorization`, cookie, вложенном массиве или строке URL. Надёжнее заранее перечислить поля, разрешённые для логирования.

Фильтрация ставится в нескольких границах

  • HTTP-клиент удаляет Authorization, Cookie и Set-Cookie из объекта ошибки.
  • Logger применяет общий sanitizer к структурированным полям и строкам.
  • Error renderer никогда не показывает stack trace и upstream body в production.
  • Telemetry SDK отключает сбор request/response body либо использует allowlist.
  • CI проверяет fixtures и snapshots на признаки ключей перед публикацией.

OWASP рекомендует не писать напрямую access tokens, session IDs, пароли, ключи шифрования и другие основные секреты; при необходимости корреляции используется удалённое, замаскированное, хешированное или зашифрованное значение. Хеш без соли тоже может быть плохим выбором для коротких предсказуемых ключей.

Ротация проверяется как миграция

Создайте новый credential, переключите потребителей, подтвердите рабочий трафик и затем отзовите старый. Если сервис поддерживает перекрывающий период двух ключей, ограничьте его по времени. Для пользовательского access token безопаснее немедленный revoke; конкретный порядок зависит от того, ключ это приложения, refresh token или короткий JWT.

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

Регрессионный тест должен атаковать формат ошибки

Соберите тестовую ошибку с фиктивными секретами в header, query, JSON body, вложенном `cause` и многострочном stack. Прогоните её через logger, APM serializer и публичный HTTP-ответ. В результате остаются request ID и безопасные коды, но ни одно контрольное значение не встречается в выходах.

Для совместного разбора передайте схему error pipeline, названия полей и обезличенный пример после redaction. Реальный credential, полный log archive и production environment dump передавать нельзя.

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