Vyžiadať ponuku
Porucha Odvetvia Kariéra O nás Blog Kontakt
Dvaja kolegovia pri tabuli plnej technických schém v zasadacej miestnosti so sklenenými stenami

IT dokumentácia: čo zapísať skôr, než niekto odíde

IT dokumentácia je práca, ktorá čaká, kým je neskoro. Kým je správca nablízku, stačí sa opýtať; v deň, keď je chorý, na dovolenke alebo preč, zistíte, čo existovalo len v jeho hlave. Tu je, čo do nej patrí, kde má ležať a kto ju udržiava.

7 min čítania Napísal tím ITproposal
Stručná odpoveď

Skutočné riziko nie je výpoveď, ale neohlásená neprítomnosť. Dokázal by niekto iný zajtra vstúpiť do firewallu, predĺžiť doménu a obnoviť zálohu?

Dobrá IT dokumentácia nie je príručka, ale pevná sada častí: sieťová schéma, plán IP adries, administrátorské práva, správca hesiel, licencie, dodávatelia, zálohy a postupy.

Neleží na systéme, ktorý opisuje, má vlastníka a je hotová, až keď podľa nej niekto iný vykonal úlohu.

Bus factor jedného IT človeka

Bus factor je počet ľudí, ktorí musia zmiznúť, aby niečo prestalo fungovať. V mnohých malých a stredných organizáciách je pri IT presne jedna: jeden kolega, ktorý vie, ako sieť do seba zapadá, kde sú administrátorské heslá a u ktorého registrátora je doména.

Nebezpečný moment je zriedka ohlásený odchod. Výpovedná lehota dáva týždne na odovzdanie. Bolí neohlásená neprítomnosť: choroba, nehoda, dovolenka bez signálu v deň, keď firewall odmieta aktualizáciu.

Užitočný test pre vedenie preto nie je otázka o dokumentácii, ale o dnešku: ak je náš IT človek nedostupný nasledujúce dva týždne, kto dokáže obnoviť administrátorský účet, vymeniť certifikát a obnoviť zmazaný priečinok? Ak je odpoveď „nikto“ alebo „neviem“, to je zadanie.

Čo patrí do IT dokumentácie

IT dokumentácia nemusí byť hrubá príručka. Je to pevná sada častí, každá taká krátka, ako sa dá, aby nikto nemusel hádať.

  • Sieťová schéma. Aké lokality, aké spojenia, kde sú firewall, prepínače a prístupové body a ako sú prepojené. Stačí popísaný náčrt, hlavne nech je správny.
  • Plán IP adries. Aké rozsahy a VLAN existujú, čo má pevnú adresu (tlačiarne, servery, kamery) a kde beží DHCP. Bez neho plán zisťujete tak, že sledujete, ako zariadenia vypadávajú.
  • Účty a administrátorské práva. Kto má akú administrátorskú rolu v Microsoft 365, na firewalle, u registrátora domény a v zálohovacej platforme. Vrátane účtov, ktoré nepatria žiadnemu človeku.
  • Licencie a zmluvy. Čo používate, na čie meno, kedy to končí a aká je výpovedná lehota. Tu odkážte na evidenciu IT majetku, namiesto druhej kópie.
  • Dodávatelia a kontakty. Internet, telefónia, tlačiarne, softvér, údržba serverovne: komu volať, s akým zákazníckym číslom a čo zmluva pokrýva.
  • Konfigurácia záloh a test obnovy. Čo sa zálohuje, ako často, kam, ako dlho sa to uchováva a kedy sa niečo naposledy obnovilo.
  • Postupy. Úlohy, ktoré sa vyskytujú zriedka, takže ich nikto nevie naspamäť: založenie nového zamestnanca, ukončenie odchádzajúceho, predĺženie domény, výmena certifikátu, spustenie po výpadku prúdu.

Heslá patria do trezoru hesiel, nie do tabuľky

Tabuľka s heslami je najčastejšia forma IT dokumentácie a najhoršia. Kto otvorí súbor, má všetko, nevidíte, kto sa naň pozeral, a kópia na pracovnej ploche je neaktuálna už mesiace.

Správca hesiel vyrieši tri veci naraz. Zdieľate po sekciách namiesto „všetko alebo nič“, vidíte, kto čo otvoril, a keď niekto odíde, prístup odoberiete bez toho, aby ste v to isté popoludnie menili každé heslo. Viac nájdete na stránke o správe identít a prístupov.

Dve pasce, ktoré vídame často. Prvou je administrátorský účet na meno IT človeka s viacfaktorovým overením na jeho súkromnom telefóne: prístup odíde s telefónom. Druhou je chýbajúci núdzový účet (break-glass): jeden administrátorský účet, ktorý nepatrí žiadnej osobe, s dlhým heslom uloženým bezpečne na dvoch miestach, ktorého použitie je viditeľné.

Záloha bez testu obnovy je predpoklad

Takmer každý vie, že záloha beží. Zriedka je zapísané to, čo potrebujete v deň, keď sa niečo pokazí: kde je kópia, kto k nej má prístup a ako vrátite jeden súbor, jednu schránku alebo celý server.

Zapisujte teda test obnovy, nie len zálohu. Dátum, čo sa obnovilo, ako dlho to trvalo a čo nešlo podľa plánu. Stav „úspešné“ v zálohovacej platforme hovorí, že sa niečo zapísalo, nie že sa to dá prečítať späť.

Toto žiadajú aj rámce. NIS2 uvádza správu záloh a správu majetku medzi svojimi opatreniami a ISO/IEC 27001 očakáva zdokumentované prevádzkové postupy. Ak to zapíšete pre seba, máte to aj pre audítora. Súvisiace služby: zálohovanie dát ako služba.

Kde leží: nie na systéme, ktorý opisuje

Najčastejšia chyba je zároveň najlogickejšia: dokumentácia leží na súborovom serveri alebo v SharePointe. Kým sa súborový server nezašifruje alebo sa účet Microsoft 365 neotvorí. Potom je príručka na obnovu zamknutá za tým, čo sa má obnoviť.

  • Majte kópiu mimo samotného prostredia, napríklad v správcovi hesiel, ktorý beží ako služba oddelená od vašich systémov, alebo u druhej strany.
  • Zabezpečte, aby sa k nej dostali aspoň dvaja ľudia, z ktorých jeden nie je IT človek. Často je to konateľ, ktorý jej nemusí rozumieť, ale musí ju vedieť otvoriť.
  • Podstatné uchovajte aj offline: núdzový účet, číslo podpory poskytovateľa internetu, kroky na otvorenie samotného trezoru. Obálka v trezore je staromódna a funguje.

Kto ju udržiava a ako viete, že je správna

Dokumentácia napísaná raz je do roka neaktuálna. Funguje nie veľké upratovanie, ale zvyk: zmena nie je hotová, kým sa nezmení dokumentácia. Nový prepínač, nový dodávateľ, nový administrátorský účet: tiket sa zatvorí, až keď je to v pláne.

Dajte jej vlastníka. Zvyčajne je to IT človek, ale vedenie by to malo vedieť a raz za štvrťrok sa pýtať, kedy sa naposledy kontrolovala.

Skutočný test je robenie, nie čítanie. Nechajte niekoho iného vykonať postup len s dokumentáciou v ruke: založiť používateľa, obnoviť súbor. Kde sa zasekne, tam riadok chýba. Jedno také cvičenie ročne povie viac než dokument, ktorý vyzerá kompletne.

V týždňoch pred odchodom

Keď odchádza človek, ktorý nosil IT, výpovedná lehota je posledná príležitosť dostať z jeho hlavy to, čo je v nej, na papier. Použite tie týždne na odovzdanie, nie na dokončovanie projektov.

  • Nechajte nástupcu robiť prácu, kým odchádzajúci pozerá, nie naopak. Čo odchádzajúci predvedie, vyzerá jasne; čo musí urobiť nástupca sám, ukáže, čo chýba.
  • Presuňte každý účet vedený na jeho meno: registrátor, portály dodávateľov, účty v obchodoch s aplikáciami, viacfaktorové overenie. To je oddelené od zatvorenia jeho vlastného účtu, ktoré príde až potom.
  • Pýtajte sa na to, čo nie je zapísané nikde: ročná úloha, tlačiareň, ktorá funguje až po reštarte, dodávateľ, ktorému treba zavolať, nie napísať.

Ak nie je komu odovzdať, je to moment rozhodnúť, či vedomosti pôjdu späť jednému novému kolegovi alebo tímu.

Kde naša práca končí

Čo robíme. Pre prostredie, ktoré spravujeme, píšeme a udržiavame IT dokumentáciu ako súčasť práce: sieťovú schému, plán IP adries, práva, dodávateľov, zálohy a postupy. Keď prevezmeme prostredie, začína sa zmapovaním toho, čo tam je, a odvtedy je bus factor tím, nie jeden človek.

Dokumentácia a trezor sú vaše, nie naše. Sú vo vašom prostredí alebo v trezore, ktorý vlastníte, s prístupom pre niekoho z vašej organizácie. Poskytovateľ spravovaných služieb, ktorý má heslá ako jediný, je bus factor jedna v inom kabáte.

Čo nerobíme. Nepíšeme obchodné procesy mimo IT ani príručku kvality pre celú organizáciu. Zmluvy právne neposudzujeme: zapíšeme, čo beží a kedy to končí, ale čo znamená ustanovenie, patrí právnikovi. A nikoho necertifikujeme: či dokumentácia spĺňa ISO/IEC 27001, rozhoduje certifikačný orgán.

Časté otázky

Otázky, ktoré dostávame

Päť, ktoré sa objavujú najčastejšie.

Čo má obsahovať IT dokumentácia?

Minimálne sieťovú schému, plán IP adries, prehľad účtov a administrátorských práv, správcu hesiel, licencie a zmluvy s dátumami konca, dodávateľov s kontaktmi, konfiguráciu záloh s posledným testom obnovy a postupy pre úlohy, ktoré sa vyskytujú zriedka. Stručné je v poriadku, ak nikto nemusí hádať.

Kde uchovávať IT dokumentáciu?

Nie na systéme, ktorý opisuje. Ak príručka na obnovu leží na práve zašifrovanom súborovom serveri, nepomôže vám. Majte kópiu mimo vlastného prostredia, zabezpečte prístup aspoň dvom ľuďom a núdzový účet a kroky na otvorenie trezoru majte aj offline.

Patria heslá do dokumentácie?

Nie do dokumentu alebo tabuľky. Heslá patria do správcu hesiel, kde zdieľate po sekciách, vidíte, kto čo otvoril, a môžete odobrať prístup. Dokumentácia odkazuje na trezor; heslá neobsahuje.

Ako často aktualizovať IT dokumentáciu?

Pri každej zmene, ako pevnú súčasť tejto zmeny, plus krátka kontrola raz za štvrťrok. Najlepší test je nechať raz ročne iného človeka vykonať postup len podľa dokumentácie.

Píšete nám IT dokumentáciu a komu patrí?

Pre prostredie, ktoré spravujeme, ju píšeme a udržiavame. Ostáva vaša: je vo vašom prostredí alebo v trezore, ktorý vlastníte. Nepíšeme obchodné procesy mimo IT, zmluvy právne neposudzujeme a nikoho necertifikujeme.

Súvisiace služby

Ako to súvisí s našou prácou

Časti, ktoré sa zbiehajú vo vašej dokumentácii.

Pozrieme sa, aký veľký je váš bus factor?

Povedzte nám, ako sa dnes IT prevádzkuje a kto čo vie. Ukážeme vám, ktoré časti dokumentácie existujú, ktoré chýbajú a čo musí prísť ako prvé, ak bude váš jediný IT človek zajtra nedostupný.

Praktické IT znalosti vo vašej e-mailovej schránke

Nové návody o správe, bezpečnosti a pracovných staniciach, písané ľuďmi, ktorí túto prácu robia. Žiadne obchodné reči a odhlásiť sa môžete jedným kliknutím.

Vašu adresu používame iba na newsletter. Pozrite si naše zásady ochrany osobných údajov.

Ponuka Zavolať