Problem: sekret w pliku obok aplikacji
Plik ze zmiennymi środowiskowymi wygląda niewinnie, a w praktyce zbiera hasło bazy, klucz aplikacji i dostęp do magazynu plików. Kopiuje go każda kopia katalogu, a przy zmianie serwera ktoś przenosi go pocztą lub komunikatorem. Wystarczy jedna pomyłka i hasło jest w repozytorium na zawsze, bo historia gita pamięta wszystko.
Dlatego nasza praktyka zakłada, że także plik przykładowy zawiera wyłącznie nazwy zmiennych, bez żadnych wartości, a w potoku działa blokada, która pilnuje tego automatycznie. Plik przykładowy służy jako wzór, więc musi być równie bezpieczny jak reszta repozytorium.
Zasada: repozytorium bez plików ze zmiennymi
Polityka jest prosta: repozytorium kodu nie zawiera plików ze zmiennymi środowiskowymi. Wartości trzymane są w CI/CD, w środowisku kontenera na serwerach i w domyślnych wartościach lokalnego stosu dewelopera. Dzięki temu na serwerze zakładu nie ma pliku, który ktoś mógłby przypadkiem skopiować lub zacytować w zgłoszeniu.
Dla administratora wynika z tego jedno: konfigurację ustawia się tam, gdzie uruchamia się kontener, a nie w katalogu z kodem.
Kontrakt nazw zamiast pliku z wartościami
Lista wymaganych zmiennych środowiskowych jest w repozytorium jako kontrakt zawierający same nazwy, bez wartości. Test automatyczny w każdym potoku sprawdza, że żadna wymagana nazwa nie brakuje i że w pliku nie ma znaku równości. To prosty mechanizm: kto doda nową zmienną, musi dopisać jej nazwę do kontraktu, a kto spróbuje wpisać wartość, zatrzyma potok.
Administrator zakładu dostaje dzięki temu kompletną listę, co ma ustawić, i może ją porównać z tym, co faktycznie działa w środowisku.
Tryb działania zawsze jawny
Na serwerach całą konfigurację dostarcza środowisko kontenera. Zmienna określająca tryb działania aplikacji jest zawsze ustawiona, a brak tej zmiennej zatrzymuje start zamiast po cichu włączyć tryb deweloperski z debugerem. To zabezpieczenie przed klasycznym błędem: produkcja uruchomiona w trybie deweloperskim, z komunikatami błędów widocznymi dla każdego.
Zapisz w opisie instalacji, które zmienne ustawiają tryb i kto je zmienia.
Czytelny komunikat o brakującej zmiennej
Brakująca zmienna konfiguracyjna kończy się komunikatem z nazwą brakującego ustawienia, a nie komunikatem o brakującym pliku. Ma to praktyczne znaczenie dla diagnostyki: gdy komunikat nazywa brakujące ustawienie, administrator nie traci czasu na szukanie przyczyny w sieci lub w innych komponentach.
Skan sekretów w potoku
Skan sekretów w potoku blokuje wejście hasła lub klucza do repozytorium. To drugie zabezpieczenie po zasadzie braku plików: nawet gdy ktoś wpisze hasło w kodzie lub w dokumentacji, potok go zatrzyma. Dla zakładu korzyść jest podwójna: mniejsze ryzyko wycieku i dowód do audytu dostawców, że producent taki mechanizm stosuje.
Jeśli chcesz sprawdzić własne repozytorium integracyjne, przeczytaj poradnik o skanie sekretów u dostawcy oprogramowania.
Lista kontrolna
Materiał wideo
Często zadawane pytania
Gdzie w takim razie leżą hasła?
W CI/CD, w środowisku kontenera na serwerach i w domyślnych wartościach lokalnego stosu dewelopera. Repozytorium ich nie zawiera.
Co się stanie, gdy zmiennej zabraknie?
Aplikacja zatrzyma start i wskaże nazwę brakującego ustawienia, zamiast uruchomić się w trybie deweloperskim.
Czy plik z nazwami zmiennych to wyciek?
Nie. Kontrakt zawiera same nazwy bez wartości, a test pilnuje, żeby nie pojawił się w nim znak równości.
Czy skan sekretów zastępuje przegląd kodu?
Nie, ale blokuje jedną klasę błędów automatycznie, zanim sekret trafi do repozytorium.
Źródła
Zapytaj o nasz kontrakt konfiguracji
Pokażemy administratorowi zakładu, jak wygląda kontrakt zmiennych i test, który pilnuje jego kompletności.
Porozmawiajmy