Problém: tajemství v souboru vedle aplikace
Soubor s proměnnými prostředí vypadá nevinně, ale v praxi shromažďuje heslo k databázi, klíč aplikace a přístup k úložišti souborů. Zkopíruje ho každá záloha složky a při výměně serveru ho někdo přenese e-mailem nebo komunikátorem. Stačí jeden přehmat a heslo je v repozitáři navždy, protože historie gitu si pamatuje všechno.
Proto naše praxe předpokládá, že i ukázkový soubor obsahuje výhradně názvy proměnných bez jakýchkoli hodnot, a v pipeline běží blokace, která to hlídá automaticky. Ukázkový soubor slouží jako vzor, takže musí být stejně bezpečný jako zbytek repozitáře.
Zásada: repozitář bez souborů s proměnnými
Pravidlo je jednoduché: repozitář kódu neobsahuje soubory s proměnnými prostředí. Hodnoty jsou uložené v CI/CD, v prostředí kontejneru na serverech a ve výchozích hodnotách lokálního stacku vývojáře. Díky tomu na serveru závodu není soubor, který by někdo omylem zkopíroval nebo citoval v hlášení.
Pro správce z toho plyne jediné: konfiguraci nastavuje se tam, kde se kontejner spouští, nikoli ve složce s kódem.
Kontrakt názvů místo souboru s hodnotami
Seznam požadovaných proměnných prostředí je v repozitáři jako kontrakt obsahující pouze názvy, bez hodnot. Automatický test v každé pipeline ověřuje, že žádný požadovaný název nechybí a že soubor neobsahuje znak rovnítka. Je to jednoduchý mechanismus: kdo přidá novou proměnnou, musí doplnit její název do kontraktu, a kdo se pokusí zapsat hodnotu, pipeline zastaví.
Správce závodu tak dostane úplný seznam toho, co nastavit, a může ho porovnat s tím, co v prostředí skutečně běží.
Režim provozu vždy explicitní
Na serverech veškerou konfiguraci dodává prostředí kontejneru. Proměnná určující režim provozu aplikace je vždy nastavená a její absence zastaví start, místo aby tiše zapnula vývojový režim s debuggerem. Je to ochrana před klasickou chybou: produkce spuštěná ve vývojovém režimu s chybovými hlášeními viditelnými pro každého.
Zapište do popisu instalace, které proměnné nastavují režim a kdo je mění.
Srozumitelné hlášení o chybějící proměnné
Chybějící konfigurační proměnná končí hlášením s názvem chybějícího nastavení, nikoli hlášením o chybějícím souboru. To má praktický význam pro diagnostiku: když hlášení pojmenuje chybějící nastavení, správce neztrácí čas hledáním příčiny v síti nebo v jiných komponentách.
Sken tajemství v pipeline
Sken tajemství v pipeline blokuje vložení hesla nebo klíče do repozitáře. Je to druhá pojistka vedle zásady bez souborů: i když někdo napíše heslo do kódu nebo do dokumentace, pipeline ho zastaví. Pro závod je přínos dvojí: menší riziko úniku a důkaz pro audit dodavatelů, že výrobce takový mechanismus používá.
Pokud chcete zkontrolovat vlastní integrační repozitář, přečtěte si průvodce skenem tajemství u dodavatele softwaru.
Kontrolní seznam
Videomateriál
Často kladené otázky
Kde tedy leží hesla?
V CI/CD, v prostředí kontejneru na serverech a ve výchozích hodnotách lokálního stacku vývojáře. Repozitář je neobsahuje.
Co se stane, když proměnná chybí?
Aplikace zastaví start a uvede název chybějícího nastavení, místo aby se spustila ve vývojovém režimu.
Je soubor s názvy proměnných únik?
Ne. Kontrakt obsahuje pouze názvy bez hodnot a test hlídá, aby se v něm neobjevil znak rovnítka.
Nahrazuje sken tajemství kontrolu kódu?
Ne, ale automaticky blokuje jednu třídu chyb dříve, než se tajemství dostane do repozitáře.
Zdroje
Zeptejte se na náš kontrakt konfigurace
Ukážeme správci závodu, jak vypadá kontrakt proměnných a test, který hlídá jeho úplnost.
Pojďme si promluvit