Praktyczny poradnik bezpieczeństwa / Sekrety i klucze API

Skanowanie sekretów: klucze API, pliki .env i bundle klienta

Znajdź ryzykowne publiczne zmienne środowiskowe i ujawnione klucze API. Skorzystaj z praktycznego procesu przeglądu i rotacji danych dostępowych dla nowoczesnych aplikacji webowych.

Autor Bryxe Shield · Zaktualizowano · Polityka redakcyjna

Czy prywatny klucz API trafił do mojego frontendu?

Przejrzyj ekspozycję zmiennych środowiskowych, importy po stronie klienta i zbudowane zasoby, by znaleźć dane dostępowe, które przekroczyły granicę zaufania. Jeśli ujawniono aktywny klucz prywatny, unieważnij go lub zrotuj u dostawcy, zaktualizuj aplikację i zbadaj użycie starego klucza.

Dla kogo: Deweloperzy obsługujący w aplikacjach webowych dane dostępowe Stripe, Supabase, dostawców AI i chmury.

KROK 01

Ustal, czy wartość jest naprawdę sekretna

Nie każdy ciąg wyglądający jak token ma te same uprawnienia. Ustal dostawcę, typ danych dostępowych, środowisko i dozwolone operacje. Publiczne identyfikatory projektów i klucze publishable mogą być w przeglądarce; uprzywilejowane dane dostępowe nie. Wykorzystaj znalezisko skanera do zbadania roli wartości, zamiast kopiować surowy klucz do zgłoszeń czy czatu.

Spróbuj: Dla każdego znaleziska zapisz dostawcę, zakres i miejsce ekspozycji, nie powielając aktywnego klucza.

KROK 02

Sprawdź, co naprawdę dostaje przeglądarka

Plik źródłowy może wyglądać na wyłącznie serwerowy, a import lub ustawienie buildu i tak sprawi, że wrażliwa konfiguracja trafi do bundla klienta. Przejrzyj publiczne zmienne środowiskowe i wygenerowane zasoby. Tam, gdzie to ma zastosowanie, sprawdź wdrożone source mapy i komunikaty błędów. Istotne pytanie brzmi: czy niezaufany odwiedzający może pobrać uprzywilejowaną wartość, a nie: czy samo repozytorium jest prywatne.

Spróbuj: Przeszukaj artefakty wydania i sprawdź żądania klienta, używając bezpiecznych placeholderów lub odcisków (fingerprints) danych dostępowych.

KROK 03

Najpierw ogranicz szkody, potem zapobiegaj powtórce

Usunięcie sekretu z ostatniego commita nie unieważnia kopii, które już wyciekły. Zrotuj klucz u dostawcy, bezpiecznie wdróż nowy i przejrzyj odpowiednie logi użycia. Następnie napraw drogę ekspozycji i dodaj kontrolę do procesu developmentu. Jeśli historyczne repozytoria lub artefakty mogą zawierać tę wartość, sprawdź je osobno.

Spróbuj: Zweryfikuj, że stary klucz nie autoryzuje już żądań, a aplikacja działa z nowym.

Twoja checklista przeglądu

  • Ustal dostawcę, uprawnienia i środowisko danych dostępowych.
  • Przejrzyj publiczne zmienne środowiskowe i importy po stronie klienta.
  • Sprawdź artefakty wydania pod kątem uprzywilejowanych wartości.
  • Unieważnij lub zrotuj potwierdzone ujawnione dane dostępowe.
  • Przejrzyj logi użycia i dotknięte systemy.
  • Dodaj test regresyjny dla pierwotnej drogi ekspozycji.

Co Bryxe może sprawdzić

Bryxe sprawdza przesłany kod źródłowy pod kątem rozpoznawanych wzorców sekretów i oferuje narzędzie do wykrywania ekspozycji zmiennych środowiskowych. Przy przeglądzie nazw zmiennych i konfiguracji używaj tego narzędzia z placeholderami.

Co nadal musisz zweryfikować

Skanowanie przesłanych plików nie obejmuje całej historii repozytorium, starych wdrożeń ani logów dostawcy. Znalezisko nie rotuje klucza, a brak znaleziska nie dowodzi, że wykryto każdy możliwy sekret.

Częste pytania

Czy wklejać produkcyjne sekrety do publicznego skanera?

Do przeglądu konfiguracji używaj placeholderów. Jeśli prawdziwy klucz już wyciekł, zrotuj go u dostawcy. Zanim prześlesz własnościowe pliki, przeczytaj dokumentację usługi dotyczącą bezpieczeństwa i prywatności.

Czy wystarczy usunąć wyciekły klucz z Gita?

Nie. Usunięcie nie unieważnia klucza ani nie usuwa kopii z wcześniejszych artefaktów. Zrotuj go lub unieważnij, zaktualizuj wdrożenia i przejrzyj jego użycie pod kątem nieoczekiwanej aktywności.

Czy zmienna publiczna może bezpiecznie zawierać klucz prywatny?

Traktuj wartości skonfigurowane do ekspozycji po stronie klienta jako czytelne dla odwiedzających. Trzymaj klucze uprzywilejowane w zaufanych środowiskach serwerowych i wywołuj uprzywilejowaną usługę przez uwierzytelnioną, autoryzowaną operację serwerową.

Dokumentacja i dalsza lektura

Te źródła pierwotne wyjaśniają opisane wyżej działanie platform. Sprawdź dokumentację dla wersji i konfiguracji, których używasz.

Kontynuuj przegląd bezpieczeństwa