Få et tilbud
Akut hjælp Brancher Karriere Om os Videnbase Kontakt
To kolleger ved en tavle fuld af tekniske diagrammer i et mødelokale med glasvægge

IT-dokumentation: hvad der skal skrives ned, før nogen går

IT-dokumentation er det arbejde, der venter, til det er for sent. Så længe IT-medarbejderen er der, kan man bare spørge; den dag vedkommende er syg, på ferie eller holdt op, opdager man, hvad der kun fandtes i hans eller hendes hoved. Her er, hvad der hører med, hvor det skal ligge, og hvem der holder det ajour.

7 min. læsetid Skrevet af teamet i ITproposal
Kort svar

Den reelle risiko er ikke opsigelsen, men det fravær, ingen har varslet. Kan en anden i morgen komme ind i firewallen, forny domænet og gendanne en backup?

God IT-dokumentation er ikke en manual, men et fast sæt dele: netværksdiagram, IP-plan, administratorrettigheder, en adgangskodeboks, licenser, leverandører, backup og procedurer.

Den ligger ikke på det system, den beskriver, den har en ejer, og den er først færdig, når en anden har udført en opgave ud fra den.

Afhængigheden af én IT-medarbejder

I mange små og mellemstore organisationer er antallet af personer, der skal forsvinde, før noget holder op med at virke, præcis én for IT: en kollega, der ved, hvordan netværket hænger sammen, hvor administratoradgangskoderne ligger, og hvilken registrator der har domænet.

Det farlige øjeblik er sjældent den varslede afgang. Et opsigelsesvarsel giver uger til overdragelse. Det, der gør ondt, er det fravær, ingen så komme: sygdom, en ulykke, en ferie uden dækning den dag, firewallen nægter at tage en opdatering.

En nyttig test for ledelsen er derfor ikke et spørgsmål om dokumentation, men om i dag: hvis vores IT-medarbejder ikke kan nås de næste to uger, hvem kan så genskabe en administratorkonto, forny et certifikat og gendanne en slettet mappe? Er svaret »ingen« eller »det ved jeg ikke«, er det opgaven.

Hvad der hører til i IT-dokumentationen

IT-dokumentation behøver ikke være en tyk manual. Det er et fast sæt dele, hver så kort som muligt uden at nogen skal gætte.

  • Netværksdiagram. Hvilke lokationer, hvilke forbindelser, hvor firewall, switche og accesspoints sidder, og hvordan de hænger sammen. En mærket skitse er nok, bare den er rigtig.
  • IP-plan. Hvilke intervaller og VLAN der findes, hvad der har fast adresse (printere, servere, kameraer), og hvor DHCP kører. Uden den genopdager man planen ved at se enheder falde fra.
  • Konti og administratorrettigheder. Hvem der har hvilken administratorrolle i Microsoft 365, på firewallen, hos domæneregistratoren og i backupplatformen. Også de konti, der ikke tilhører en person.
  • Licenser og aftaler. Hvad I bruger, i hvis navn, hvornår det udløber, og hvad opsigelsesvarslet er. Henvis her til jeres oversigt over IT-aktiver frem for at føre en kopi til.
  • Leverandører og kontakter. Internet, telefoni, printere, software, vedligeholdelse af serverrummet: hvem man ringer til, med hvilket kundenummer, og hvad aftalen dækker.
  • Backupkonfiguration og gendannelsestest. Hvad der tages backup af, hvor ofte, hvortil, hvor længe det gemmes, og hvornår noget sidst blev gendannet.
  • Procedurer. De opgaver, der sjældent kommer, så ingen kan dem udenad: oprettelse af en ny medarbejder, lukning af en fratrådt, fornyelse af domænet, udskiftning af et certifikat, opstart efter strømsvigt.

Adgangskoder hører hjemme i en boks, ikke i et regneark

Regnearket med adgangskoder er den mest almindelige form for IT-dokumentation og den dårligste. Den, der kan åbne filen, har alt, man kan ikke se, hvem der har kigget i den, og kopien på en andens skrivebord har været forældet i måneder.

En adgangskodeboks løser tre ting på én gang. Man deler pr. boks i stedet for alt eller intet, man kan se, hvem der har åbnet hvad, og når nogen holder op, trækker man adgangen tilbage uden at skulle skifte alle adgangskoder samme eftermiddag.

To fælder, vi ofte ser. Den første er administratorkontoen i IT-medarbejderens eget navn, med multifaktorgodkendelse på vedkommendes private telefon: adgangen forlader huset sammen med telefonen. Den anden er den manglende nødkonto: én administratorkonto, der ikke er knyttet til en person, med en lang adgangskode gemt sikkert to steder, og hvis brug man opdager.

En backup uden gendannelsestest er et gæt

Næsten alle ved, at en backup kører. Det, der sjældent er skrevet ned, er den del, man har brug for den dag, det går galt: hvor kopien er, hvem der har adgang til den, og hvordan man får én fil, én postkasse eller en hel server tilbage.

Skriv derfor gendannelsestesten ned, ikke kun backuppen. Datoen, hvad der blev gendannet, hvor lang tid det tog, og hvad der ikke gik efter planen. En »vellykket« status i backupplatformen fortæller, at noget blev skrevet, ikke at det kan læses tilbage.

Det er også det, regelsættene beder om. NIS2-direktivet nævner styring af backup og styring af aktiver blandt sine foranstaltninger, og ISO/IEC 27001 forventer dokumenterede driftsprocedurer. Skriver man det ned for sig selv, har man det også til revisoren.

Hvor den ligger: ikke på det system, den beskriver

Den mest almindelige fejl er også den mest logiske: dokumentationen ligger på filserveren eller i SharePoint. Indtil filserveren bliver krypteret, eller Microsoft 365-kontoen ikke kan åbnes. Så er genopretningsvejledningen låst inde bag netop det, der skal genoprettes.

  • Opbevar en kopi uden for selve miljøet, for eksempel i adgangskodeboksen, der kører som en tjeneste adskilt fra jeres egne systemer, eller hos en anden part.
  • Sørg for, at mindst to personer kan komme til den, hvoraf den ene ikke er IT-medarbejderen. Ofte er det en direktør, som ikke behøver forstå den, men skal kunne åbne den.
  • Opbevar det væsentligste også offline: nødkontoen, internetudbyderens supportnummer, trinnene til at åbne selve boksen. En kuvert i et pengeskab er gammeldags, og det virker.

Hvem der holder den ajour, og hvordan man ved, at den er rigtig

Dokumentation, der er skrevet én gang, er forældet inden for et år. Det, der virker, er ikke en stor oprydning, men en vane: en ændring er ikke færdig, før dokumentationen er opdateret. Ny switch, ny leverandør, ny administratorkonto: sagen lukkes først, når den står i planen.

Giv den en ejer. Det er som regel IT-medarbejderen, men ledelsen bør vide det og spørge én gang i kvartalet, hvornår den sidst er kontrolleret.

Den egentlige test er at gøre, ikke at læse. Lad en anden udføre en procedure med kun dokumentationen i hånden: opret en bruger, gendan en fil. Hvor vedkommende går i stå, mangler der en linje. Én sådan øvelse om året fortæller mere end et dokument, der ser komplet ud.

I ugerne, før nogen går

Når den, der har båret IT, er på vej væk, er opsigelsesperioden den sidste chance for at få det, der er i vedkommendes hoved, over på papir. Brug de uger på overdragelse, ikke på at afslutte projekter.

  • Lad efterfølgeren udføre arbejdet, mens den fratrædende ser på, ikke omvendt. Det, den fratrædende viser, ser klart ud; det, efterfølgeren selv skal gøre, viser, hvad der mangler.
  • Flyt hver konto, der står i vedkommendes navn: registratoren, leverandørportaler, konti hos app-butikker, multifaktorgodkendelsen. Det er noget andet end at lukke vedkommendes egen konto, hvilket kommer bagefter.
  • Spørg til det, der ikke står nogen steder: den årlige opgave, printeren der kun virker efter en genstart, leverandøren man skal ringe til frem for at skrive til.

Er der ingen at overdrage til, er det øjeblikket til at beslutte, om viden skal tilbage til én ny kollega eller til et team.

Hvor vores arbejde stopper

Det gør vi. For et miljø, vi driver, skriver og vedligeholder vi IT-dokumentationen som en del af opgaven: netværksdiagram, IP-plan, rettigheder, leverandører, backup og procedurer. Når vi overtager et miljø, begynder det med en kortlægning af det, der er, og derfra er afhængigheden af én person et team i stedet.

Dokumentationen og boksen er jeres, ikke vores. De ligger i jeres miljø eller i en boks, I ejer, med adgang for en fra jeres egen organisation. En managed service provider, der som den eneste har adgangskoderne, er afhængigheden af én person i en anden frakke.

Det gør vi ikke. Vi skriver ikke forretningsprocesser uden for IT eller en kvalitetshåndbog for hele organisationen. Vi gennemgår ikke aftaler juridisk: vi registrerer, hvad der kører, og hvornår det udløber, men hvad en klausul betyder, er en sag for en jurist. Og vi certificerer ingen: om dokumentation lever op til ISO/IEC 27001, afgør certificeringsorganet.

Ofte stillede spørgsmål

Spørgsmål, vi får om emnet

De fem, der oftest kommer op.

Hvad skal IT-dokumentation indeholde?

Som minimum et netværksdiagram, en IP-plan, en oversigt over konti og administratorrettigheder, en adgangskodeboks, licenser og aftaler med slutdatoer, leverandører med kontakter, backupkonfigurationen med den seneste gendannelsestest og procedurer for de opgaver, der sjældent kommer. Kort er fint, bare ingen skal gætte.

Hvor skal IT-dokumentationen opbevares?

Ikke på det system, den beskriver. Ligger genopretningsvejledningen på den filserver, der netop er blevet krypteret, kan den ikke bruges. Opbevar en kopi uden for jeres eget miljø, sørg for, at to personer kan nå den, og hold også nødkontoen og trinnene til at åbne boksen offline.

Skal adgangskoder stå i dokumentationen?

Ikke i et dokument eller et regneark. Adgangskoder hører hjemme i en adgangskodeboks, hvor man deler pr. afsnit, kan se, hvem der har åbnet hvad, og kan trække adgangen tilbage. Dokumentationen peger på boksen; den indeholder ikke adgangskoderne.

Hvor ofte skal IT-dokumentationen opdateres?

Ved hver ændring, som en fast del af ændringen, plus et kort tjek hvert kvartal. Den bedste test er at lade en anden udføre en procedure én gang om året med kun dokumentationen i hånden.

Skriver I vores IT-dokumentation, og hvem ejer den?

For et miljø, vi driver, skriver og vedligeholder vi dokumentationen. Den forbliver jeres: den ligger i jeres miljø eller i en boks, I ejer. Vi skriver ikke forretningsprocesser uden for IT, vi gennemgår ikke aftaler juridisk, og vi certificerer ingen.

Relaterede ydelser

Hvor det hører til hos os

De dele, der mødes i jeres dokumentation.

Skal vi se på, hvor afhængige I er af én person?

Fortæl os, hvordan jeres IT drives i dag, og hvem der ved hvad. Vi viser, hvilke dele af dokumentationen der findes, hvilke der mangler, og hvad der skal komme først, hvis jeres eneste IT-medarbejder ikke kan nås i morgen.

Praktisk IT-viden i din indbakke

Nye guides om drift, sikkerhed og arbejdspladser, skrevet af de folk, der laver arbejdet. Ingen salgssnak, og du afmelder dig med ét klik.

Vi bruger din adresse kun til nyhedsbrevet. Se vores privatlivspolitik.

Tilbud Ring