Zahteva za podporo domačemu VPN potrebuje en tok, ne kup konfiguracije

Objavite redigirano konfiguracijo, omenite, da VPN ne deluje, in prejmete šest odgovorov o šestih različnih stvareh. Težava je običajno v zahtevi, ne v bralcih. Pomočnik iz konfiguracije ne more ugotoviti, ali se tunel ne vzpostavi, ali se vzpostavi, a zavrže promet, ali deluje dobro, medtem ko datotečna storitev za njim zavrača povezavo. Namesto tega opišite en tok, s tremi lastniki in eno opaženo okvaro, in odgovori se takoj izboljšajo.

Zakaj zahteva dobi neuporabne odgovore

Konfiguracija opisuje, kaj je nastavljeno. Ne opisuje, kaj ste poskusili, kaj se je zgodilo ali katera od več naprav mora opraviti katero delo. Brez tega vsak bralec ugiba drugo stopnjo.

Ilustrativni primer je potujoči prenosnik, ki bi moral prek domačih vrat doseči datotečno storitev na domačem strežniku. Navedite, ali so vrata, strežnik VPN in datotečni strežnik isti stroj ali trije stroji, ker to eno dejstvo spremeni skoraj vsak odgovor.

Izpolnite ta zapis, preden objavite

Goal: the one resource or operation that should work
Path: client -> access network -> VPN endpoint -> resource
Owners: who controls the client, the gateway and the resource
Software: product, version and protocol in use
Expected: what success would look like
Observed: exact non-secret error or response
Time and change: when it started and what changed
Control: one comparable operation that still works

Osem vrstic, in večina zahtev postane odgovorljivih. Kontrolna vrstica je tista, ki jo ljudje izpustijo: če brskanje z istega prenosnika deluje, skupna raba datotek pa ne, to zoži težavo na poti tunela ali na storitev, in nikomur ni treba vprašati.

Pri redigiranju ohranite oznake dosledne. Ohranite razliko med javno končno točko, naslovom tunela in domačim podomrežjem. Če se dva obsega prekrivata, pustite to razmerje vidno, namesto da vsako omrežje zamenjate z istim nadomestnim znakom, ker je prekrivanje pogosto odgovor.

Poimenujte stopnjo, ki odpove, ne celotnega dnevnika

Vredno je ločiti pet stopenj: razreševanje imen, poskus povezave, preverjanje pristnosti, vzpostavitev tunela in dostop do vira. Recite, katera je po vašem mnenju odpovedala in kaj ste tam videli.

Prilepite majhen izsek okoli dogodka, namesto vsake datoteke za odpravljanje napak, ki jo odjemalec lahko ustvari. Sto vrstic hrupa rokovanja skrije tisto eno vrstico, ki pravi, da se ime potrdila ni ujemalo.

Opažanje in razlago imejte ločeno. „Odjemalec poroča o prekoračitvi časa rokovanja po 30 sekundah“ je opažanje; „mislim, da ponudnik blokira UDP“ je teorija. Oboje je koristno, njuno mešanje pa pomeni, da pomočnik ne more vedeti, kateremu naj verjame. Označite ju, in odgovor, ki ga dobite, bo naslovil pravega.

Pošljite jo lastniku, ki lahko ukrepa

Za prenosnik, ki ga upravlja delodajalec, začnite s podprtim kanalom delodajalca, ker skupnostni forum ne more spremeniti njegove politike. Za komercialno storitev VPN navedite izdelek in račun zasebno, ne javno. Za svoja vrata navedite vlogi usmerjevalnika in strežnika, ki ju nadzirate.

Če uporabljate javno skupnost, izberite tisto, katere trenutni obseg ustreza nalogi. Stara nit o pravilih foruma ni pogodba o podpori, in tudi pet let star odgovor o različici protokola, ki je ne poganjate, ni.

Skrijte skrivnosti, ne da bi sploščili topologijo

Odstranite zasebne ključe, gesla, žetone in povezave s poverilnicami, preden kar koli zapusti vaš stroj. Diagnostični izvoz in popolna konfiguracija sta različna artefakta, tudi ko so imena datotek podobna, in to, kar ste prilepili, lahko vsebuje vnaprej deljen ključ.

Nato ohranite razmerja, ki naredijo tok razumljiv. RFC 6973 obravnava nepotrebno zbiranje in korelacijo kot vprašanja zasebnosti, in isto načelo velja tukaj: delite dokaze, ki jih prejemnik potrebuje, ne celega stroja.

Zaključite z enim odgovorljivim vprašanjem o opaženem neskladju, na primer zakaj odjemalec dokonča preverjanje pristnosti in nato nikoli ne prejme poti. Konkretno vprašanje dobi konkreten odgovor, in zapis, ki ste ga sestavili, je tisto, kar nekomu omogoči, da ga da, ne da bi vas spraševal po skrivnostih.