InnerWeb
Przejdź do treści

Konfiguracja bez plików env na serwerze zakładu

Plik z hasłami leżący obok aplikacji jest jednym z najczęstszych źródeł wycieków: trafia do repozytorium, do kopii zapasowej i do rąk każdego, kto ma dostęp do katalogu. Opisujemy praktykę, w której repozytorium nie zawiera plików ze zmiennymi środowiskowymi, a serwer dostaje konfigurację ze środowiska kontenera. Administrator zakładu dostaje przy tym prostą listę kontrolną.

0
plików ze zmiennymi środowiskowymi w repozytorium kodu
Źródło: zasada konfiguracji

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