Zahtjev za podršku kućnog VPN-a traži jedan tok, a ne hrpu konfiguracije

Objavite redigiranu konfiguraciju, navedete da VPN ne radi i dobijete šest odgovora o šest različitih stvari. Problem je obično u zahtjevu, ne u čitaocima. Pomoćnik iz konfiguracije ne može zaključiti ne uspostavlja li se tunel, uspostavlja li se ali ispušta promet, ili radi dobro dok usluga datoteka iza njega odbija vezu. Opišite umjesto toga jedan tok, s tri vlasnika i jednim uočenim kvarom, i odgovori se odmah popravljaju.

Zašto zahtjev dobija nekorisne odgovore

Konfiguracija opisuje šta je podešeno. Ne opisuje šta ste pokušali, šta se dogodilo ni koja od nekoliko mašina treba obaviti koji posao. Bez toga svaki čitalac nagađa drugu fazu.

Ilustrativni slučaj je putni laptop koji treba dosegnuti uslugu datoteka na kućnom serveru kroz kućni gateway. Navedite jesu li gateway, VPN server i server datoteka ista mašina ili tri mašine, jer ta jedna činjenica mijenja gotovo svaki odgovor.

Ispunite ovaj zapis prije objave

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

Osam redova, i većina zahtjeva postaje odgovoriva. Kontrolni red je onaj koji ljudi izostavljaju: ako pregledanje s istog laptopa radi dok dijeljenje datoteka ne radi, to sužava problem na rute tunela ili na uslugu, i nikome ne treba pitati.

Držite oznake dosljednim kada redigirate. Sačuvajte razliku između javne krajnje točke, adrese tunela i kućne podmreže. Ako se dva raspona preklapaju, ostavite taj odnos vidljivim umjesto da svaku mrežu zamijenite istim rezerviranim mjestom, jer preklapanje je često odgovor.

Imenujte fazu koja je zakazala, a ne cijeli dnevnik

Pet faza vrijedi razdvojiti: razrješavanje imena, pokušaj veze, provjera identiteta, uspostavljanje tunela i pristup resursu. Recite koja je po vama zakazala i šta ste tamo vidjeli.

Zalijepite mali izvadak oko događaja umjesto svake datoteke za otklanjanje grešaka koju klijent može proizvesti. Sto redova šuma rukovanja skriva onaj jedan red koji kaže da se ime certifikata nije poklopilo.

Držite opažanje i objašnjenje odvojeno. “Klijent prijavljuje istek vremena rukovanja nakon 30 sekundi” je opažanje; “mislim da ISP blokira UDP” je teorija. Oboje je korisno, a njihovo miješanje znači da pomoćnik ne može znati kojem vjerovati. Označite ih, i odgovor koji dobijete obratit će se pravom.

Pošaljite ga vlasniku koji može djelovati

Za laptop kojim upravlja poslodavac počnite s kanalom podrške poslodavca, jer zajednički forum ne može promijeniti njihovu politiku. Za komercijalnu VPN uslugu navedite proizvod i račun privatno, a ne javno. Za vlastiti gateway uključite uloge rutera i servera koje kontrolišete.

Ako koristite javnu zajednicu, odaberite onu čiji trenutni obim odgovara zadatku. Stara tema o pravilima foruma nije ugovor o podršci, a nije ni odgovor star pet godina o verziji protokola koju ne koristite.

Sakrijte tajne bez spljoštavanja topologije

Uklonite privatne ključeve, lozinke, tokene i veze koje nose akreditive prije nego što išta napusti vašu mašinu. Dijagnostički izvoz i potpuna konfiguracija različiti su artefakti čak i kada im imena datoteka izgledaju slično, a ono što ste zalijepili može sadržavati unaprijed dijeljeni ključ.

Zatim zadržite odnose koji tok čine razumljivim. RFC 6973 smatra nepotrebno prikupljanje i povezivanje pitanjima privatnosti, i isti princip vrijedi ovdje: podijelite dokaze koje primalac treba, a ne cijelu mašinu.

Završite jednim pitanjem o uočenom neskladu na koje se može odgovoriti, poput zašto klijent završi provjeru identiteta i zatim nikada ne dobije rutu. Konkretno pitanje dobija konkretan odgovor, a zapis koji ste sastavili je ono što nekome omogućava da ga da bez traženja vaših tajni.