Секретный ключ Stripe утёк: что делать прямо сейчас
Коротко
Немедленно пересоздайте ключ (roll) в панели Stripe: секретный ключ (sk_live_ или sk_test_) позволяет создавать платежи, делать возвраты и читать данные клиентов. Затем проверьте недавнюю активность, оставьте новый ключ только в серверном коде и перейдите на ограниченный ключ с минимальными правами. Публичный ключ (pk_) предназначен для открытого доступа и проблемой не является.
Почему это случилось
У Stripe два типа ключей. Публичный начинается с pk_ и живёт в браузерном коде. Секретный начинается с sk_ и должен оставаться на сервере. Секретный ключ становится публичным, если его положили в переменную фронтенда, закоммитили в репозиторий, вставили в клиентский компонент с помощью ИИ-помощника или оставили в мобильном приложении.
Что сможет сделать злоумышленник, зависит от прав ключа. Полный секретный ключ позволяет читать данные клиентов и платежей, создавать платежи и возвраты и менять настройки. Сами номера карт не раскрываются, потому что Stripe их не отдаёт, но остального достаточно для серьёзных проблем.
Что делать прямо сейчас
В панели Stripe откройте Developers, затем API keys и пересоздайте (roll) утёкший секретный ключ. Для старого ключа можно задать срок действия, чтобы успеть задеплоить новый, но держите это окно коротким.
Пропишите новый ключ в переменных окружения сервера и задеплойте. Проверьте, что в браузерной сборке и репозитории старого ключа больше нет.
Просмотрите Payments, Customers, Refunds и журнал Events за период, пока ключ был открыт. Ищите платежи, возвраты, выплаты или клиентов, которых вы не создавали, и изменённые адреса вебхуков.
Если увидите что-то подозрительное, напишите в поддержку Stripe и сообщите об утечке ключа. Не ждите, что всё решится само.
Как исправить правильно
Создавайте клиент Stripe только на сервере и читайте ключ из окружения.
// только сервер, например API-роут
import Stripe from 'stripe';
export const stripe = new Stripe(process.env.STRIPE_SECRET_KEY!);Замените полный ключ на ограниченный (restricted), у которого запись разрешена только тому, что нужно этому коду, например созданию сессий Checkout. Утечка ограниченного ключа обходится дешевле. Создать его можно в Developers, API keys.
Проверяйте подпись вебхуков, чтобы никто не подделал подтверждение платежа, обратившись к вашему эндпоинту. Читайте сырое тело запроса, а не разобранный JSON.
const sig = req.headers.get('stripe-signature')!;
const body = await req.text();
const event = stripe.webhooks.constructEvent(body, sig, process.env.STRIPE_WEBHOOK_SECRET!);Никогда не определяйте цену или тариф в браузере. Передавайте идентификатор товара, а цену пусть находит сервер. Включите сканирование секретов в репозитории, чтобы следующая ошибка была заблокирована.
Как проверить, что исправлено
Поищите строки sk_live и sk_test в истории репозитория и в JavaScript развёрнутого сайта. Откройте исходники сайта в инструментах разработчика и убедитесь, что ничего, начинающегося с sk_, там нет.
Бесплатная проверка ScanAnt ищет в JavaScript вашего сайта секретные ключи Stripe среди ключей других провайдеров, показывает их в маске и никогда не использует и не хранит целиком. Она также смотрит, не определяются ли цены и платный доступ в браузере. Серверный код и приватный репозиторий она не видит.
Вопросы и ответы
Публичный ключ pk_, это утечка?
Нет. Он предназначен для фронтенд-кода и умеет лишь ограниченное, например создавать токены.
Сломает ли сайт смена ключа?
Платежи не проходят, пока не задеплоен новый ключ, поэтому обновите окружение сразу после смены. Короткий срок действия старого ключа сгладит переход.
Могут ли с этим ключом украсть номера карт?
Stripe не возвращает полные номера карт через API, но утёкший ключ всё равно раскрывает данные клиентов и позволяет двигать деньги, поэтому относитесь серьёзно.
Нужно ли использовать тестовые ключи при разработке?
Да. Утёкший ключ sk_test_ не двигает настоящие деньги, но его всё равно стоит заменить.
Связанные проверки
Проверьте сайт после исправления
Быстрая проверка бесплатна для любого публичного сайта и не требует регистрации. Проверки, которые обращаются к базе или файлам, работают только после подтверждения владения сайтом.
Выбрать уровень проверки →