Практичний посібник з безпеки / Секрети й API-ключі

Сканування секретів: API-ключі, файли .env і клієнтські бандли

Знайдіть ризиковані публічні змінні середовища й відкриті API-ключі. Дотримуйтеся практичного процесу перевірки й ротації облікових даних для сучасних вебзастосунків.

Автор: Bryxe Shield · Оновлено · Редакційна політика

Чи не потрапив приватний API-ключ у мій фронтенд?

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

Для кого це: Розробники, що працюють з обліковими даними Stripe, Supabase, AI-провайдерів і хмарних сервісів у вебзастосунках.

КРОК 01

Визначте, чи значення справді секретне

Не кожен рядок, схожий на токен, має однакові привілеї. Визначте постачальника, тип облікових даних, середовище й дозволені операції. Публічні ідентифікатори проєкту й publishable-ключі цілком можуть бути в браузері; привілейовані облікові дані — ні. Використовуйте знахідку сканера, щоб зʼясувати роль значення, замість копіювати сирі облікові дані в тікети чи чат.

Спробуйте: Для кожної знахідки зафіксуйте постачальника, обсяг прав і місце витоку, не відтворюючи робочих облікових даних.

КРОК 02

Перевірте, що насправді отримує браузер

Файл вихідного коду може виглядати суто серверним, тоді як імпорт чи налаштування збирання призводить до потрапляння чутливої конфігурації в клієнтський бандл. Перегляньте публічні змінні середовища й згенеровані ресурси. За потреби перевірте розгорнуті source maps і виведення помилок. Важливе питання — чи може недовірений відвідувач отримати привілейоване значення, а не чи приватний сам репозиторій.

Спробуйте: Пошукайте в релізних артефактах і перевірте клієнтські запити, використовуючи безпечні заглушки або відбитки облікових даних.

КРОК 03

Спершу локалізуйте, потім запобігайте повторенню

Видалення секрету з останнього коміту не анулює копії, які вже витекли. Ротуйте його через постачальника, безпечно розгорніть заміну й перегляньте відповідні журнали використання. Потім усуньте шлях витоку й додайте перевірку в процес розробки. Якщо значення може міститися в історичних репозиторіях чи артефактах, перевірте їх окремо.

Спробуйте: Переконайтеся, що старі облікові дані більше не авторизують запити, а застосунок працює із заміною.

Ваш чекліст перевірки

  • Визначте постачальника, привілеї й середовище облікових даних.
  • Перегляньте публічні змінні середовища й клієнтські імпорти.
  • Перевірте релізні артефакти на наявність привілейованих значень.
  • Відкличте або ротуйте підтверджено розкриті облікові дані.
  • Перегляньте журнали використання й зачеплені системи.
  • Додайте регресійну перевірку для початкового шляху витоку.

Що може перевірити Bryxe

Bryxe перевіряє наданий вихідний код на відомі патерни секретів і пропонує інструмент перевірки витоку змінних середовища. Під час перегляду назв змінних і конфігурації використовуйте цей інструмент із заглушками.

Що вам ще потрібно перевірити

Сканування надісланих файлів не охоплює всю історію репозиторію, старі розгортання чи журнали постачальника. Знахідка не ротує облікові дані, а відсутність знахідки не доводить, що виявлено кожен можливий секрет.

Поширені запитання

Чи варто вставляти продакшн-секрети в публічний сканер?

Для перевірки конфігурації використовуйте заглушки. Якщо справжні облікові дані вже розкрито, ротуйте їх у постачальника. Перш ніж завантажувати пропрієтарні файли, ознайомтеся з документацією сервісу щодо безпеки й конфіденційності.

Чи достатньо видалити злитий ключ із Git?

Ні. Видалення не відкликає облікові дані й не прибирає копії з попередніх артефактів. Ротуйте або відкличте їх, оновіть розгортання й перевірте відповідне використання на неочікувану активність.

Чи може публічна змінна безпечно містити приватний ключ?

Вважайте значення, налаштовані для клієнта, доступними для читання відвідувачам. Тримайте привілейовані ключі в довірених серверних середовищах і звертайтеся до привілейованого сервісу через автентифіковану й авторизовану серверну операцію.

Документація й додаткові матеріали

Ці першоджерела пояснюють описану вище поведінку платформ. Звіряйтеся з документацією для версій і конфігурації, які ви використовуєте.

Продовжте перевірку безпеки