Jak zapobiec wyciekowi sekretów Home Assistant do plików Compose lub kopii zapasowych

Eva Wong jest redaktorką techniczną i rezydentką majsterkowania w ZimaSpace. Jest geekiem od zawsze, z pasją do domowych laboratoriów i oprogramowania open source, a jej specjalnością jest przekładanie złożonych zagadnień technicznych na przystępne, praktyczne poradniki. Eva wierzy, że samodzielne hostowanie powinno sprawiać radość, a nie onieśmielać. Dzięki swoim samouczkom pomaga społeczności oswoić konfigurację sprzętu, od budowy pierwszego serwera NAS po opanowanie kontenerów Docker.

Zapobiegaj wyciekom sekretów, nie umieszczając ich w definicjach Compose przeznaczonych do udostępniania i traktując każdą kopię zapasową lub eksport diagnostyczny jako poufny, dopóki nie przejdzie skanowania zawartości.

Home Assistant potrzebuje poświadczeń w czasie działania, więc żaden lokalny układ nie ukryje ich przed administratorem mającym pełny dostęp do hosta. Praktyczny cel jest skromniejszy: zapobiec przypadkowym zatwierdzeniom zmian, wysyłaniu ich do repozytorium, kopiowaniu do szeroko dostępnych kopii zapasowych i niepotrzebnemu dostępowi kontenerów. Sporządź wykaz miejsc, przez które każda wartość trafia do stosu, zastąp wpisane na stałe wartości kontrolowanym źródłem sekretów i przetestuj eksportowane pliki bez wyświetlania samych sekretów.

Zmapuj wszystkie miejsca, z których sekret może wyciec

Wypisz tokeny API, hasła do baz danych, dane logowania MQTT, adresy URL webhooków, klucze szyfrujące, certyfikaty prywatne i klucze odzyskiwania. Dla każdego zanotuj, który komponent używa go w czasie działania, ścieżkę przechowywania, właściciela pliku, uwzględnienie w kopiach zapasowych, status w repozytorium, możliwość ujawnienia w logach i sposób rotacji. Nie kopiuj wartości do wykazu.

Pliki z sekretami porządkują wartości, ale dla konta z prawem odczytu na hoście nadal są zwykłym tekstem. Ta granica dostępu do tekstu jawnego oznacza, że separacja ogranicza przede wszystkim przypadkowe ujawnienie, a nie chroni przed atakującym z pełnymi uprawnieniami.

Za wyciek uznaj każdą wartość wpisaną na stałe w pliku YAML Compose, śledzonym pliku środowiskowym, katalogu konfiguracyjnym z szerokimi uprawnieniami do odczytu lub eksporcie o nieznanej zawartości. Wstrzymaj udostępnianie i wysyłanie zmian do repozytorium, dopóki każda droga wycieku nie będzie mieć przypisanej osoby odpowiedzialnej i wdrożonego rozwiązania.

Oddziel sekrety środowiska uruchomieniowego od definicji wdrożenia

Zastąp wpisane na stałe wartości w Compose sekretami z plików o ściśle ograniczonych uprawnieniach lub innym źródłem sekretów obsługiwanym przez dane środowisko wdrożeniowe. Udostępniaj każdej usłudze tylko potrzebne jej wartości, montuj je jako pliki tylko do odczytu, jeśli to możliwe, i ogranicz uprawnienia na hoście do użytkownika uruchamiającego usługę oraz administratorów.

Wartości zmiennych środowiskowych mogą ujawnić się podczas inspekcji, w kontekście procesu lub w logach, natomiast montowanie sekretów z plików pozwala ograniczyć dostęp do poświadczeń do wybranych kontenerów. Lokalne pliki z sekretami nadal wymagają kontroli uprawnień.

Najpierw sprawdź działanie na symbolach zastępczych, skontroluj wyrenderowaną konfigurację Compose pod kątem przypadkowo umieszczonych wartości literalnych, a następnie uruchom jedną usługę i potwierdź, że może odczytać wyłącznie przypisany jej sekret. Cofnij zmianę, jeśli powoduje ona, że aplikacja wypisuje wartości lub wymaga nadmiernie szerokich uprawnień dostępu do katalogu.

Kontroluj zawartość kopii zapasowych i pakietów pomocy technicznej

Traktuj kopie zapasowe jako zawierające dane uwierzytelniające, chyba że wykazano, że nie obejmują takich danych. Zaszyfruj kopie opuszczające zaufany obszar przechowywania, przechowuj klucze odzyskiwania osobno, ogranicz okres przechowywania i dostęp, a zamiast pełnego archiwum konfiguracji nigdy nie załączaj go do zgłoszenia do pomocy technicznej, jeśli wystarczy zredagowany fragment logu.

Użyj procedury ochrony konfiguracji, aby zachować możliwość odzyskiwania danych, oddzielając bezpieczne miejsce przechowywania od udostępnianych materiałów wdrożeniowych.

Przed wydaniem przeskanuj nazwy plików i wyodrębniony tekst pod kątem znanych nazw kluczy, prefiksów tokenów, prywatnych adresów URL, adresów e-mail, certyfikatów oraz dokładnych skrótów kontrolnych znaczników testowych. Czysty wynik skanowania jest warunkiem wydania, ale nie dowodzi, że nie występuje nieznany format sekretu.

Zmień ujawnione dane i sprawdź, czy ścieżka zapobiegania działa

Jeśli użyteczna wartość trafiła do repozytorium, zgłoszenia, czatu, publicznego linku lub niezaufanej kopii zapasowej, najpierw ją unieważnij lub zmień; usunięcie widocznej kopii nie unieważnia innych kopii ani historii. Zapisz, której usługi dotyczy problem, oraz czas zmiany, nie zachowując starej wartości.

Utwórz nieszkodliwy sekret-pułapkę, wdróż go nową ścieżką, wygeneruj standardowy wynik renderowania Compose, kopię zapasową i pakiet diagnostyczny, a następnie przeszukaj te artefakty. Środowisko uruchomieniowe powinno otrzymać sekret-pułapkę, natomiast udostępniane artefakty nie powinny go ujawniać poza celowo chronioną kopią zapasową.

Zatrzymaj się, gdy w definicjach wdrożeniowych i repozytoriach nie ma rzeczywistych sekretów, chronione kopie zapasowe mają odrębną ścieżkę odzyskiwania, skanowanie artefaktów kończy się pomyślnie, a ujawnione dane uwierzytelniające zostały zmienione. Eskaluj problem, gdy integracja zewnętrzna zapisuje wartości sekretów w logach lub nie może korzystać z wąskiego źródła sekretów bez szerszego dostępu do hosta.

Wsparcie i porady

Więcej do przeczytania

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.