Przejdź do treści
Baza wiedzy 12 min czytania

Zarządzanie sekretami: klucze API i hasła poza kodem i repozytorium

Programista usuwa z kodu klucz API, który przez pomyłkę trafił do repozytorium, ale na tym sprawa się nie kończy. Klucz nadal leży w historii commitów oraz w klonach i forkach zrobionych po wypchnięciu. Zarządzanie sekretami przenosi klucze i hasła do systemu, który wydaje je aplikacjom na krótko i zapisuje każde użycie.

Programista dodaje do repozytorium plik konfiguracyjny z kluczem API do bramki płatności. Po godzinie zauważa błąd, usuwa klucz w kolejnym commicie i wraca do pracy. Tymczasem klucz nadal leży w historii repozytorium, w klonach na laptopach całego zespołu, w forku zrobionym przez podwykonawcę i w logu zadania, które zdążyło się wykonać w potoku CI/CD.

Taki klucz to sekret, a dyscyplina, która trzyma go poza kodem, to zarządzanie sekretami (secrets management), jeden z filarów cyberbezpieczeństwa wytwarzania oprogramowania. Aplikacja dostaje w niej klucz w chwili uruchomienia, klucz żyje krótko, a każde jego użycie zostawia ślad. Wyciek oznacza wtedy wymianę jednego wpisu w jednym systemie, a nie przegląd historii wszystkich repozytoriów.

Czym jest zarządzanie sekretami (secrets management)?

Zarządzanie sekretami to centralne przechowywanie, wydawanie, audyt i rotacja poświadczeń, których używają aplikacje i automaty. OWASP Secrets Management Cheat Sheet zalicza do sekretów klucze API, poświadczenia baz danych, uprawnienia IAM, klucze SSH i certyfikaty. Ten sam dokument zauważa, że wiele organizacji trzyma je w kodzie źródłowym otwartym tekstem, rozrzucone po plikach konfiguracyjnych i narzędziach do zarządzania konfiguracją.

OWASP uzasadnia centralizację prostym argumentem: gdy kilka usług współdzieli ten sam sekret, trudno ustalić, skąd wyciekł. System zarządzania sekretami odwraca tę sytuację. Każda aplikacja dostaje własny sekret, system wie, kto i kiedy go pobrał, a wymiana odbywa się w jednym miejscu zamiast w wielu plikach konfiguracyjnych.

W praktyce zmienia się miejsce, w którym sekret istnieje. Zamiast zmiennej w pliku .env aplikacja przy starcie uwierzytelnia się w systemie sekretów i pobiera to, czego potrzebuje. Kod zawiera tylko nazwę sekretu, nigdy jego wartość.

Czym zarządzanie sekretami różni się od sejfu haseł?

Sejf haseł chroni poświadczenia, których używają ludzie, a system zarządzania sekretami obsługuje poświadczenia, których używają maszyny. Sejf haseł kontroluje, kto i kiedy może pobrać hasło administratora, rotuje je i zapisuje każde pobranie. To narzędzie z rodziny PAM, zbudowane wokół człowieka, który prosi o dostęp do poświadczenia.

Aplikacja nie prosi o dostęp przez formularz. Potrzebuje hasła do bazy danych w chwili startu, często wielokrotnie w ciągu dnia, w kontenerze, który za godzinę przestanie istnieć. Dlatego systemy zarządzania sekretami są budowane wokół API, integracji z potokami CI/CD i Kubernetesem oraz sekretów wydawanych na żądanie. W ofercie Delinea te dwie role pełnią osobne produkty: Secret Server jest sejfem PAM dla zespołów IT i bezpieczeństwa, a DevOps Secrets Vault służy do zarządzania sekretami w zespołach DevOps.

Jeśli o sekret prosi człowiek, rozmawiamy o sejfie haseł. Jeśli prosi o niego proces, rozmawiamy o zarządzaniu sekretami.

Dlaczego sekret w kodzie zostaje w repozytorium nawet po usunięciu?

Sekret zostaje, bo Git przechowuje całą historię zmian, a usunięcie linii w nowym commicie nie zmienia commitów wcześniejszych. Opis ryzyka CICD-SEC-6 z listy OWASP Top 10 CI/CD Security Risks mówi o tym jednoznacznie: od chwili wypchnięcia poświadczenie jest dostępne dla każdego, kto może czytać repozytorium, a po usunięciu z gałęzi nadal widnieje w historii commitów.

Słabość ma własny numer w katalogu MITRE. CWE-798 „Use of Hard-coded Credentials” opisuje produkt, który zawiera zapisane na stałe poświadczenia, takie jak hasło albo klucz kryptograficzny. Katalog rozróżnia wariant przychodzący, w którym produkt sprawdza logowanie względem wbudowanego hasła, i wychodzący, w którym sam łączy się z innym systemem zapisanym na stałe hasłem. Klucz API w repozytorium aplikacji to wariant wychodzący.

Przepisanie historii nie zamyka sprawy. Dokumentacja GitHuba o usuwaniu wrażliwych danych przypomina, że commity z sekretem mogą pozostać dostępne w klonach i forkach repozytorium, w widokach podręcznych pod ich skrótem SHA i w pull requestach, które się do nich odwołują. Z cudzych klonów nie da się niczego usunąć zdalnie. Sekret, który raz trafił do repozytorium, trzeba więc traktować jak ujawniony.

Gdzie poza kodem wyciekają sekrety?

Sekrety wyciekają przez każdy artefakt, który potok CI/CD tworzy po drodze. CICD-SEC-6 wymienia trzy takie miejsca poza repozytorium. Pierwszym są warstwy obrazów kontenerów: poświadczenie potrzebne tylko do zbudowania obrazu zostaje w jednej z warstw i może je odczytać każdy, kto pobierze obraz. Drugim są logi zadań, do których sekrety trafiają celowo albo przypadkiem, a stamtąd płyną dalej do systemów zarządzania logami.

Trzecim miejscem jest czas. CICD-SEC-6 zwraca uwagę, że poświadczenia rozproszone po całym środowisku inżynierskim zna duża grupa pracowników i wykonawców, a brak rotacji sprawia, że krąg osób z ważnym kluczem rośnie z każdym miesiącem. Klucze wdrożeniowe bywają według OWASP nietykane latami, bo „skoro działa, nie ruszaj”.

OWASP Secrets Management Cheat Sheet dokłada dwa kanały: opiekunowie projektu w GitLabie albo GitHubie często mogą zobaczyć lub wydobyć sekrety z ustawień potoku, a fork repozytorium albo kopia definicji zadania nie powinny kopiować sekretu. To drugie trzeba sprawdzić, a nie zakładać.

Najważniejsze:

  • Sekret wypchnięty do repozytorium pozostaje w historii commitów, klonach i forkach także po usunięciu z kodu.
  • Poza repozytorium sekrety wyciekają przez warstwy obrazów kontenerów, logi zadań i ustawienia potoków.
  • Klucz, którego nikt nie wymienia, z każdym miesiącem zna więcej osób.

Jak wygląda cykl życia sekretu?

Każdy sekret przechodzi przez cztery etapy: utworzenie, rotację, unieważnienie i wygaśnięcie. Tak opisuje go OWASP, a każdy etap ma własną regułę. Nowy sekret ma być kryptograficznie mocny i mieć najmniejsze uprawnienia potrzebne do jego roli. Rotacja ma sprawić, że skradzione poświadczenie działa tylko przez krótki czas. Sekret niepotrzebny albo podejrzany o wyciek unieważnia się od razu, a wygaśnięcie najlepiej ustawić przy tworzeniu.

Uzasadnienie dla rotacji daje NIST SP 800-57 Part 1 Rev. 5 z maja 2020 r. Publikacja definiuje okres ważności klucza (cryptoperiod) jako czas, w którym wolno go używać, i wymienia wśród jego zalet ograniczenie skutków, gdy pojedynczy klucz zostanie skompromitowany. Ten sam dokument stwierdza, że skompromitowany klucz traci ważność niezależnie od zaplanowanego okresu.

Jeden wyjątek warto znać, zanim ktoś ustawi rotację wszystkiego. OWASP wyłącza poświadczenia użytkowników z regularnej rotacji i powołuje się na zalecenia NIST: hasło człowieka wymienia się przy podejrzeniu lub dowodzie kompromitacji. Regularna rotacja dotyczy sekretów maszynowych, bo to je da się wymieniać automatycznie i bez szkody dla użytkownika.

Czym są sekrety dynamiczne i kiedy wybrać je zamiast rotacji?

Sekret dynamiczny powstaje na żądanie dla konkretnego odbiorcy i przestaje działać, gdy ten odbiorca kończy pracę. OWASP podaje przykład aplikacji, która przy starcie prosi o poświadczenia do bazy danych i dostaje nowe, wygenerowane dla tej sesji. Jeśli ktoś je ukradnie, po restarcie aplikacji będą już nieważne.

Rotacja i sekrety dynamiczne rozwiązują ten sam problem z dwóch stron. Rotacja skraca życie sekretu statycznego, który nadal jest współdzielony przez wszystkie instancje aplikacji. Sekret dynamiczny jest unikalny dla odbiorcy, więc OWASP zwraca uwagę na dodatkową korzyść: gdy ktoś użyje go z innego adresu IP niż odbiorca, nadużycie łatwo wykryć.

Rekomendacje CICD-SEC-6 ustawiają kolejność: najpierw poświadczenia tymczasowe zamiast statycznych, a tam, gdzie statyczne są konieczne, procedura okresowej rotacji i wykrywanie nieużywanych poświadczeń. Sekret statyczny zostaje tam, gdzie system docelowy nie wydaje poświadczeń na żądanie, na przykład przy kluczu API zewnętrznego dostawcy, i wtedy trzeba go rotować automatycznie.

Gdzie trzymać sekrety w potoku CI/CD?

OWASP wskazuje trzy miejsca, a najlepsze z nich to takie, w którym potok w ogóle nie dotyka sekretu. Pierwszym są wbudowane sekrety narzędzia CI/CD, na przykład w GitHubie albo GitLabie, co według OWASP nie jest tym samym co zapisanie sekretu w kodzie. Drugim jest system zarządzania sekretami, z którym potok łączy się własnym poświadczeniem. Trzecim jest układ, w którym potok tylko każe orkiestratorowi uruchomić usługę z określonym kontem, a usługa sama pobiera sekret.

Każde z tych miejsc ma swoje reguły. W narzędziu CI/CD OWASP zaleca sekrety krótkotrwałe, o wąskim zasięgu i niskiej wartości, bez jednego hasła dla wszystkich administratorów. Poświadczenie, którym potok loguje się do systemu sekretów, powinno być często wymieniane, wygasać po zakończeniu zadania i obejmować tylko sekrety potrzebne do tego zadania. Każde wywołanie musi dać się przypisać osobie albo usłudze, która uruchomiła zadanie.

Dostęp ludzi podlega tej samej zasadzie najmniejszych uprawnień: inżynier nie powinien widzieć wszystkich sekretów, a system powinien pozwalać nadawać uprawnienia do pojedynczych wpisów. OWASP zaleca też rejestrowanie każdej czynności w narzędziu CI/CD, bo atakujący może wyprowadzić sekret przez interfejs administracyjny albo nowo utworzone zadanie.

Jak wykryć sekret, zanim trafi do repozytorium?

Sekret najtaniej zatrzymać na komputerze programisty, zanim powstanie commit. OWASP zaleca wykrywanie sekretów już na poziomie dewelopera: w środowisku programistycznym, w testach albo w haku pre-commit. Narzędzie odrzuca commit z ciągiem przypominającym klucz, zanim cokolwiek opuści komputer.

Drugą linią jest serwer repozytorium. Funkcja push protection w GitHubie blokuje wypchnięcia zawierające sekrety, zanim trafią do repozytorium, zamiast alarmować po fakcie. Według dokumentacji GitHuba ochrona na poziomie repozytorium jest domyślnie wyłączona i włącza ją administrator, a ochrona na poziomie konta użytkownika w github.com jest domyślnie włączona i dotyczy wypchnięć do repozytoriów publicznych.

Trzecią linią jest skanowanie tego, co już jest w repozytorium. Secret scanning w GitHubie przegląda całą historię Git na wszystkich gałęziach i zgłasza znalezione poświadczenia jako alerty. Dokumentacja zaleca natychmiastową wymianę sekretu po alercie i dodaje, że usuwanie go z historii jest pracochłonne i często zbędne, jeśli sekret został już unieważniony. CICD-SEC-6 zaleca to samo niezależnie od platformy: automatyczne skanowanie przy każdym wypchnięciu i okresowe skanowanie repozytorium razem z dawnymi commitami.

Co zrobić, gdy sekret już wyciekł?

Najpierw unieważnij sekret, potem go wymień, a dopiero na końcu sprzątaj. OWASP opisuje ograniczanie skutków wycieku w czterech krokach: unieważnienie ujawnionego klucza, szybkie utworzenie i wdrożenie nowego, usunięcie sekretu z systemu, w którym wyciekł, także z kodu i logów, oraz zebranie informacji o jego historii. Zespół reagowania musi wiedzieć, kto miał dostęp do sekretu, kiedy go używano i kiedy był ostatnio wymieniany.

Kolejność ma znaczenie, bo przepisywanie historii repozytorium jest drogie i ryzykowne. Dokumentacja GitHuba o usuwaniu wrażliwych danych stawia sprawę jasno: jeśli wrażliwą daną jest hasło albo token, pierwszym krokiem jest unieważnienie lub wymiana, co może wystarczyć. Przepisanie historii zmienia skróty wszystkich późniejszych commitów, wymaga zdjęcia ochrony gałęzi przed wymuszonym wypchnięciem, a programista ze starym klonem może poleceniami git pull i git push przywrócić sekret do repozytorium.

Po wymianie sekretu trzeba sprawdzić, czy ktoś zdążył go użyć. Dopiero logi systemu, do którego klucz dawał dostęp, pozwalają ocenić, czy wyciek był błędem w repozytorium, czy incydentem z dostępem do danych.

Najważniejsze:

  • Po wycieku kolejność jest stała: unieważnienie, wymiana, usunięcie, analiza użycia.
  • Przepisanie historii repozytorium nie usuwa sekretu z cudzych klonów i forków.
  • Skanowanie przed commitem i blokowanie wypchnięć zatrzymują sekret, zanim trzeba będzie go unieważniać.

Jak wdrożyć zarządzanie sekretami krok po kroku?

Wdrożenie zaczyna się od inwentaryzacji, a kończy na sekretach, które powstają na czas zadania. Kolejność wynika z prostej reguły: nie da się chronić sekretów, o których nie wiadomo, a automatyzacja rotacji sekretów leżących w kodzie nie ma sensu.

EtapDecyzja do podjęciaDowód, że etap jest zamkniętyTypowy błąd
1. InwentaryzacjaKtóre repozytoria, potoki i obrazy skanujemy w całej historiiLista znalezionych sekretów z właścicielem każdego z nichSkanowanie tylko bieżącej gałęzi zamiast całej historii
2. Unieważnienie znaleziskKtóre sekrety wymieniamy od razu, a które w zaplanowanym oknieKażdy znaleziony sekret unieważniony albo z datą wymianyUsuwanie sekretu z kodu bez jego unieważnienia
3. Wybór systemu sekretówJeden system czy kilka, gdzie leży sekret zeroOpisany podział odpowiedzialności i miejsce głównego poświadczeniaGłówny sekret systemu trzymany w tym samym systemie
4. Migracja aplikacjiKolejność aplikacji i sposób pobierania sekretu przy starcieKod bez wartości sekretów, tylko odwołania do ich nazwPrzeniesienie sekretu z kodu do zmiennej w repozytorium potoku
5. Sekrety w CI/CDKtóre zadania potrzebują których sekretówPoświadczenia potoku z zakresem jednego zadania i datą wygaśnięciaJedno konto serwisowe z dostępem do wszystkich sekretów
6. Blokada na wejściuHak pre-commit, blokowanie wypchnięć, skaner w potokuCommit testowy z fałszywym kluczem zostaje odrzuconyNarzędzie w trybie tylko ostrzegawczym, którego nikt nie czyta
7. Sekrety dynamiczne i rotacjaKtóre systemy wydają poświadczenia na żądanie, a które rotujemyHarmonogram rotacji i sekrety dynamiczne dla baz danychRotacja ręczna, która przestaje się odbywać po pierwszym urlopie
8. Reakcja na wyciekKto unieważnia sekret i w jakim czasieProcedura przećwiczona na sekrecie testowymProcedura, w której pierwszym krokiem jest przepisywanie historii

Etap szósty warto powtarzać po każdej zmianie konfiguracji repozytorium: commit z fałszywym kluczem w formacie prawdziwego dostawcy od razu pokazuje, czy blokada nadal działa.

Jak nFlo może pomóc w zarządzaniu sekretami?

nFlo łączy zarządzanie sekretami z bezpieczeństwem całego potoku wytwarzania oprogramowania. W ramach usługi Wdrożenie DevSecOps wbudowujemy w potok CI/CD wykrywanie sekretów narzędziem GitLeaks, które blokuje commity z sekretami, obok analizy kodu i zależności. Szersze tło tych praktyk zbiera dział bazy wiedzy poświęcony DevSecOps.

Tam, gdzie potrzebny jest system zarządzania sekretami, wdrażamy rozwiązania producentów. Delinea DevOps Secrets Vault generuje sekrety dynamiczne na żądanie, nadaje im czas życia z automatycznym unieważnieniem i integruje się z Jenkinsem, GitLabem, GitHub Actions, Azure DevOps i Kubernetesem. IBM HashiCorp Vault wydaje dynamiczne poświadczenia do baz danych i chmury, automatycznie rotuje sekrety, rejestruje dostęp w logach audytowych i oferuje szyfrowanie jako usługę.

Jeśli chcesz sprawdzić, ile sekretów leży dziś w historii Twoich repozytoriów i od czego zacząć ich porządkowanie, skontaktuj się z nami.

Co jeszcze warto wiedzieć o zarządzaniu sekretami?

Czy wystarczy usunąć sekret z kodu i zrobić nowy commit?

Nie. Według opisu ryzyka CICD-SEC-6 poświadczenie usunięte z gałęzi nadal widnieje w historii commitów. Najpierw unieważnij i wymień sekret, a dopiero potem zdecyduj, czy przepisywać historię.

Czy plik .env w .gitignore rozwiązuje problem sekretów?

Tylko częściowo: plik nie trafi do repozytorium, ale sekret pozostaje statyczny i leży otwartym tekstem na dyskach programistów i serwerów. System zarządzania sekretami wydaje go aplikacji przy starcie i pozwala unieważnić w jednym miejscu.

Jak często wymieniać klucze API?

Tak często, jak pozwala automatyzacja, i natychmiast po podejrzeniu wycieku. NIST SP 800-57 wiąże okres ważności klucza z ograniczeniem skutków jego kompromitacji. Wyjątkiem są hasła użytkowników, które według OWASP wymienia się przy podejrzeniu kompromitacji.

Czy sekrety w zmiennych środowiskowych potoku CI/CD są bezpieczne?

Są bezpieczniejsze niż sekrety w kodzie, ale nie poza zasięgiem. OWASP przypomina, że opiekunowie projektu często mogą je zobaczyć lub wydobyć, a CICD-SEC-6 opisuje sekrety wypisywane do logów zadań. Stąd zalecenie: krótki czas życia i wąski zakres.

Czym jest sekret zero w systemie zarządzania sekretami?

To poświadczenie, którym aplikacja albo potok loguje się do samego systemu sekretów. OWASP zaleca trzymać główny sekret takiego systemu w innym miejscu, na przykład w mechanizmach dostawcy chmury, a poświadczenia administracyjne tego dostawcy jeszcze gdzie indziej.

Udostępnij:

Porozmawiaj z ekspertem

Masz pytania dotyczące tego tematu? Skontaktuj się z naszym opiekunem.

Opiekun handlowy
Grzegorz Gnych

Grzegorz Gnych

Opiekun handlowy

Odpowiedź w ciągu 24 godzin
Konsultacja z ekspertem
Indywidualne podejście

Podanie numeru telefonu przyspieszy kontakt.

Chcesz obniżyć ryzyko i koszty IT?

Umów konsultację - odpowiemy w ciągu 24h

Odpowiedź w 24h Indywidualna wycena Bez zobowiązań

Lub pobierz bezpłatny przewodnik:

E-book: Strategia odporności cyfrowej 2026