Kva ei lita VPN-handbok må kunne svare på i ein fart

Den driftsansvarlege som tok over klokka 02:00, kunne ikkje seie om tenesta var sunn, fordi dokumentet forklarte designet og aldri sa kva som skulle køyrast. Å gje fila til nokon andre og deretter forlate rommet er den einaste testen som betyr noko. Dei fleste små VPN-notat feilar han allereie på andre side. Forma nedanfor står han av, og ingenting av det treng å vere langt.

Start med eit kart ein trøytt person kan skumme gjennom

Skriv ned kva nokon må slå opp i ein fart: namna klientane koplar til, portane daemonen lyttar på, adressepølene han deler ut, korleis klientnamn blir løyste opp, og kva nettverk bak tunnelen som skal kunne nåast. Legg til byggnummeret du faktisk køyrer, og namngje komponenten som eig kvar bevegeleg del, fordi ruter, pakkefilter og klientprofilar ofte blir konfigurerte tre ulike stader. Noter òg dei ytre avhengnadene: hostingkontoen, opplenkja, identitetsleverandøren og dei private netverka i den fjerne enden. Ein tabell eller eit handteikna diagram ber dette betre enn avsnitt, fordi lesaren skummar i staden for å lese.

Namngje deretter personane som kan godkjenne ei naudendring, med ein kontaktveg som ikkje er avhengig av at tunnelen er oppe. Ei eskaleringslinje utan reserve er ei blindgate i nettopp den hendinga som treng henne. To namn og eitt telefonnummer er nok; kartet er ikkje ei personaloversikt.

Kvar kontroll treng svaret som blir rekna som sunt

For kvar teneste set du kommandoen og linja som betyr at han lukkast ved sida av kvarandre, slik at lesaren aldri må utleia den eine av den andre i ein fart. Prosessstatus og nåbarheit ende-til-ende ligg på ulike lag: det eine viser at daemonen godtok konfigurasjonen, det andre at ein klient kan bruke det tunnelen tilbyr. Skriv båe linjene, og sei kva feil kvar av dei fangar, fordi ein kontroll utan oppgjeve resultat blir ein diskusjon om korvidt utdata ser bra ut.

systemctl status openvpn-server@lab
ss -lntu | grep 1194

Køyr båe, og handsam dei som separate bevis i staden for ein sekvens. Ein grøn eining kan stå ved sida av ein tunnel ingen kan bruke, og det motsette skjer når ein lyttar overlever ei broten rute. Oppgje laget kvar linje observerer, og lesaren veit kven ein skal lite på når dei er usamde.

Tre feil dekkjer dei fleste nettene

Endepunkt utilgjengeleg, identitet avvist og tilkopla utan nyttig trafikk forklarer nesten alt som vekkjer nokon. For kvar av dei, list dei to første kontrollane og personen det blir eskalert til, slik at ingen må finne opp ein diagnoseorden klokka 02:00. Utilgjengelegheit peikar som regel på stien eller lyttaren, ein avvist identitet på eit sertifikat, eit legitimasjonslager eller ei klokke, og ei tom tilkopling på ruter, vidaresending eller namneoppslag. Dei tre greinene les ulike loggar, og difor må greina veljast før loggen blir opna.

Lenk til dokumentasjonen ovanfor i staden for å lime inn kommandoar du ikkje har køyrt på denne verten. Ein utesta kommando kopiert frå eit anna miljø er verre enn ein peikar, fordi han ser autoritativ ut og feilar stille.

Skriv endringa som ein sekvens, ikkje som eit avsnitt

For kvar endring, noter kontrollpunktet du kan gå tilbake til, kontrollen som stadfestar suksess og vilkåret som utløyser tilbakerulling, i den rekkjefølgja. Ta med ein veg tilbake som ikkje går gjennom tunnelen, fordi nettopp endringa du gjer kan stengje han. Noter korleis gjeldande tilbakekallingar ville bli gjenoppretta i staden for eit eldre augeblinksbilete, fordi ei utdatert liste stille godtek legitimasjon som vart trekt den morgonen. Nummererte imperative steg toler press; prosa blir tolking.

Øv den vegen tilbake før du treng han, kvar gong endringa er stor nok til å bety noko. Ei tilbakerulling skriven frå minnet er eit gjet med ein dato på.

Legitimasjon bur ein annan stad

Vis til passordhandsamaren, kvelven eller den forsegla konvolutten, og seie kven som kan opne han, i staden for å sitere materiale i fila. Private nøklar, eingongskodar for gjenoppretting og profilar som byggjer inn ein løyndom høyrer heime i verna lagring, og sida bør forklare korleis ein autorisert driftsansvarleg når dei klokka 02:00. Bruk aldri ein levande løyndom som døme, fordi døme blir limte inn i billettar og chat-trådar. Ein peikar pluss ei tillatingsliste er alt dokumentet treng.

Gå gjennom fila etter ei reell endring eller ei gjenopprettingsøving, slett stiar som ikkje finst lenger, og noter kven si oppgåve den neste vedlikehaldsavgjerda er. Hald ein endringslogg med tre kolonnar til slutt: dato, kva som vart endra, kven som verifiserte det. Det er den sida som fortel neste lesar om resten er oppdatert, og systemctl-dokumentasjonen frå systemd er ei betre lenkje enn ein parafrase av tenestekommandoar som vil drive.