Du ska lägga in en databasnyckel i ett Ansible-projekt och vill kunna versionshantera playbooken utan att lämna hemligheten synlig. Ansible Vault krypterar filer eller enskilda variabler, men skyddet beror också på hur lösenordet hanteras och vad som händer när värdet dekrypteras.

Vault skyddar hemligheter i lagring, men kräver en säker körning
- Hela filer: välj filkryptering när även variabelnamn och filinnehåll ska döljas.
- Enskilda värden: använd
encrypt_stringnär resten av YAML-filen gärna får vara läsbar. - Lösenord: håll Vault-lösenordet utanför Git och hämta det från en säker källa.
- Loggar: kryptering i repot hindrar inte läckor efter dekryptering under en körning.
Välj filkryptering när även strukturen är känslig
En variabelfil med lösenord kan avslöja mer än själva lösenordet: även namn på tjänster, miljöer och konton kan ge ledtrådar. Filkryptering döljer hela innehållet, medan kryptering av en variabel lämnar resten av filen synlig. Jag tycker att filkryptering är det tydligare valet när flera hemligheter hör ihop.
Skapa en krypterad fil med ansible-vault create secrets.yml, eller kryptera en befintlig fil med ansible-vault encrypt secrets.yml. Den officiella Ansible-dokumentationen om krypterat innehåll beskriver också hur du öppnar filen med ansible-vault edit och byter lösenord med ansible-vault rekey.
Priset för att dölja hela filen är sämre läsbarhet i Git-diffar, alltså jämförelsen mellan ändringar. Om teamet behöver granska ofarliga inställningar sida vid sida med krypterade värden kan en separat Vault-fil vara smidigare än att kryptera en hel uppgiftsfil.
Använd encrypt_string för enstaka hemligheter
En API-nyckel bland vanliga konfigurationsvärden passar ofta bättre som krypterad variabel. Kommandot ansible-vault encrypt_string skapar ett krypterat värde som kan ligga kvar i en i övrigt läsbar YAML-fil. Begränsningen är att enskilda krypterade variabler inte kan roteras med rekey; filkrypterade data kan däremot krypteras om med ett nytt Vault-lösenord.
Exempelvis kan en utvecklingsmiljö innehålla en synlig variabel service_url och ett krypterat api_token. Då kan ändringar av adressen granskas normalt, medan tokenvärdet förblir dolt i repot. Tänk dock på att själva variabelnamnet fortfarande syns, så välj ett namn som inte i sig avslöjar onödiga detaljer.
Om du matar in hemligheten direkt som ett argument i terminalen kan den hamna i kommandoradshistoriken. Mata hellre in värdet via standard input eller en lösenordsfråga, och kontrollera även att terminalen och den valda redigeraren inte sparar känsligt innehåll oskyddat.
Vault-ID hjälper dig skilja utveckling från produktion
När ett projekt använder olika lösenord för olika miljöer blir ett gemensamt lösenord lätt en genväg med för stor räckvidd. Med Vault-ID:n som dev och prod kan du ange vilken lösenordskälla som hör till respektive miljö. Ansible beskriver formatet som --vault-id etikett@källa, där källan kan vara en prompt, en fil eller ett skript.
En körning med separata lösenord kan exempelvis se ut så här:
ansible-playbook --vault-id dev@prompt --vault-id prod@prompt site.yml
Vault-ID:t är dock i grunden en etikett, inte en garanti för att rätt lösenord hör till rätt data. Enligt avsnittet om hantering av Vault-lösenord tvingar Ansible inte fram ett unikt lösenord per etikett. Om flera personer krypterar innehåll med samma etikett men olika lösenord kan resultatet därför bli rörigt; tydliga namnkonventioner och samordnad lösenordshantering förebygger misstaget.
Kryptering i Git skyddar inte värdet under körningen
Här går en vanlig missuppfattning snett: en hemlighet som är krypterad i repot är inte automatiskt skyddad överallt. Ansible Vault skyddar data i vila, men playbooken behöver dekryptera värdet för att använda det. Därefter kan känslig information hamna i uppgiftsresultat, felsökningsutskrifter eller loggar om arbetsflödet inte hanteras varsamt.
Den officiella översikten över Ansible Vault skiljer uttryckligen mellan data i vila och data i användning. Använd no_log: true på uppgifter vars resultat kan innehålla hemligheter, men slå inte på det slentrianmässigt för hela playbooken: det gör felsökningen svårare och döljer även information som hade varit ofarlig.
Följ den här tumregeln när du väljer upplägg:
| Situation | Trolig följd | Gör så här |
|---|---|---|
| Flera hemligheter ligger samlade i en fil | Filens struktur och variabelnamn kan avslöja känslig information | Kryptera hela filen med Vault |
| Enstaka token ligger bland vanliga inställningar | Hela filen blir svårläst om den krypteras | Kryptera värdet med encrypt_string |
| Samma playbook körs mot utveckling och produktion | Ett enda lösenord ger samma åtkomstgräns åt båda miljöerna | Använd separata Vault-ID:n och lösenordskällor |
| En uppgift skriver ut ett hemligt värde | Värdet kan bli synligt efter dekrypteringen | Begränsa utskriften och använd no_log: true där det behövs |
Håll Vault-lösenordet utanför projektet
En krypterad fil i Git hjälper föga om lösenordet ligger bredvid den i samma repo. För lokal körning kan du be Ansible fråga efter det med --ask-vault-pass; i automatiserade flöden kan lösenordet hämtas från en säker hemlighetshanterare via ett klientskript. Lösenordskällan ska ha en annan åtkomstväg än den krypterade projektfilen.
Om du lagrar lösenordet i en lokal fil, håll filen utanför versionshanteringen och begränsa vem som kan läsa den. I CI-miljöer bör det vara plattformens skyddade hemlighetsfunktion eller en extern hemlighetstjänst som lämnar lösenordet till jobbet, inte en vanlig variabelfil i projektet.
Har ett Vault-lösenord hamnat i Git räcker det inte att ta bort filen i senaste committen, eftersom äldre versioner kan finnas kvar i historiken. Byt då lösenordet, kryptera om berörda Vault-filer och hantera den exponerade hemligheten som komprometterad enligt teamets rutin.
En enkel gräns gör Vault lättare att lita på
En praktisk start är att använda filkryptering för sammanhängande hemligheter, krypterade strängar för enstaka värden och separata lösenord för miljöer med olika åtkomstkrav. Låt lösenordet komma från en källa utanför repot och granska vilka uppgifter som kan skriva ut dekrypterade värden.
Jag anser att Ansible Vault fungerar bäst när ansvaret är uppdelat: Vault skyddar lagringen, medan lösenordshantering och loggkontroll skyddar resten av körkedjan. Då blir det också lättare att se vad krypteringen faktiskt täcker, och vad som fortfarande behöver ett eget skydd.