Så förhindrar du att Home Assistant-hemligheter läcker in i Compose-filer eller säkerhetskopior

Eva Wong är teknisk skribent och händig hemmabyggare på ZimaSpace. Som tekniknörd sedan barnsben med ett brinnande intresse för hemlabb och programvara med öppen källkodspecialiserar hon sig på att göra komplexa tekniska koncept begripliga genom praktiska, praktiska guider. Eva tycker att självhosting ska vara roligt, inte avskräckande. Genom sina handledningar hjälper hon communityn att göra hårdvaruinstallationer mindre mystiska, från att bygga sin första NAS till att bemästra Docker-containrar.

Förhindra att hemligheter läcker ut genom att hålla värden borta från Compose-definitioner som kan delas och behandla varje säkerhetskopia eller diagnostisk export som känslig tills den har godkänts vid en innehållsgranskning.

Home Assistant behöver autentiseringsuppgifter vid körning, så ingen lokal struktur gör dem osynliga för en administratör med fullständig åtkomst till värddatorn. Det praktiska målet är snävare: förhindra oavsiktliga incheckningar, uppladdningar till supporten, omfattande kopior i säkerhetskopior och onödig åtkomst från containrar. Inventera var varje värde kommer in i stacken, ersätt bokstavliga värden med en kontrollerad hemlighetskälla och testa de exporterade artefakterna utan att skriva ut själva hemligheterna.

Kartlägg alla platser där en hemlighet kan läcka ut

Lista API-token, databaslösenord, MQTT-autentiseringsuppgifter, webhook-URL:er, krypteringsnycklar, privata certifikat och återställningsnycklar. Anteckna för varje värde vilken komponent som använder det vid körning, lagringssökväg, filägare, om det ingår i säkerhetskopior, status i kodförrådet, exponering i loggar och rotationsmetod. Kopiera inte värdena till inventeringen.

Hemlighetsfiler organiserar värden, men de är fortfarande i klartext för konton som kan läsa värddatorn. Denna åtkomstgräns för klartext innebär att separationen främst minskar risken för oavsiktligt röjande, snarare än att stå emot en angripare med fullständiga privilegier.

Ett fel innebär att det finns ett bokstavligt värde i Compose-YAML, en versionshanterad miljöfil, en konfigurationskatalog som är läsbar för många eller en export vars innehåll är okänt. Pausa delning och pushar till kodförråd tills varje exponeringsväg har en ansvarig och en åtgärd.

Skilj körningshemligheter från driftsättningsdefinitioner

Ersätt bokstavliga värden i Compose med filbaserade hemligheter som beviljats begränsad åtkomst eller en annan hemlighetskälla som driftsättningen stöder. Ge varje tjänst endast de värden den använder, montera dem skrivskyddade där det är möjligt och begränsa värdbehörigheterna till körningsidentiteten och administratörer.

Miljövärden kan bli synliga vid inspektion, via processkontext eller i loggar, medan filbaserad montering av hemligheter kan begränsa vilka containrar som får en autentiseringsuppgift. Lokala hemlighetsfiler kräver fortfarande behörighetskontroll.

Börja med platshållare, granska den renderade Compose-konfigurationen för oavsiktliga literalvärden, starta sedan en tjänst och bekräfta att den bara kan läsa sin tilldelade hemlighet. Återställ ändringen om den får ett program att återge värden eller kräver alltför tillåtande katalogåtkomst.

Kontrollera innehållet i säkerhetskopior och supportpaket

Klassificera säkerhetskopior som innehållande autentiseringsuppgifter om inte motsatsen har bevisats genom en granskning av innehållet. Kryptera kopior som lämnar den betrodda lagringsgränsen, förvara återställningsnycklar separat, begränsa lagringstid och åtkomst, och bifoga aldrig ett komplett konfigurationsarkiv när ett avidentifierat loggutdrag räcker för att besvara supportfrågan.

Använd arbetsflödet för konfigurationsskydd för att bevara återställningsmöjligheten och samtidigt separera säker lagring från distributionsmaterial som kan delas.

Före lansering ska du skanna filnamn och extraherad text efter kända nyckelnamn, tokenprefix, privata URL:er, e-postadresser, certifikat och exakta hashar för kontrollerade testmarkörer. En godkänd skanning är ett lanseringskrav, inte ett bevis på att ett okänt hemlighetsformat inte kan förekomma.

Rotera exponerade värden och bevisa att förebyggande åtgärder fungerar

Om ett användbart värde har hamnat i ett arkiv, en supportförfrågan, en chatt, en offentlig länk eller en säkerhetskopia som inte är betrodd ska du återkalla eller rotera det först. Att radera den synliga kopian gör inte kopior eller historik ogiltiga. Notera vilken tjänst som berörs och när rotationen skedde, utan att spara det gamla värdet.

Skapa en ofarlig kanariehemlighet, distribuera den via den nya vägen, skapa den vanliga Compose-renderingen, säkerhetskopian och diagnostikpaketet och sök sedan igenom dessa artefakter. Körmiljön ska få kanariehemligheten, medan artefakter som kan delas inte exponerar den utanför den avsiktligt skyddade säkerhetskopieringsgränsen.

Avbryt när riktiga hemligheter saknas i distributionsdefinitioner och arkiv, skyddade säkerhetskopior har en separat återställningsväg, skanningar av artefakter godkänns och exponerade autentiseringsuppgifter har roterats. Eskalera när en integration från tredje part loggar hemlighetsvärden eller inte kan använda en avgränsad hemlighetskälla utan bredare åtkomst till värden.

Support och tips

Mer att läsa

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.