Kotiverkon VPN-tukipyyntö tarvitsee yhden kulun, ei konfiguraatiotulvaa

Julkaiset redaktoidun konfiguraation, mainitset, ettei VPN toimi, ja saat kuusi vastausta kuudesta eri asiasta. Ongelma on yleensä pyynnössä, ei lukijoissa. Auttaja ei voi konfiguraatiosta päätellä, jääkö tunneli rakentamatta, rakentuuko se mutta pudottaa liikennettä, vai toimiiko se hyvin samalla kun sen takana oleva tiedostopalvelu hylkää yhteyden. Kuvaa sen sijaan yksi kulku, kolmella omistajalla ja yhdellä havaitulla vialla, niin vastaukset paranevat heti.

Miksi pyyntö saa hyödyttömiä vastauksia

Konfiguraatio kuvaa, mitä on asetettu. Se ei kuvaa, mitä yritit, mitä tapahtui tai minkä useasta koneesta pitäisi tehdä mikä työ. Ilman sitä jokainen lukija arvaa eri vaiheen.

Havainnollistava tapaus on matkustava kannettava, jonka pitäisi päästä kotiyhdyskäytävän kautta kotipalvelimen tiedostopalveluun. Kerro, ovatko yhdyskäytävä, VPN-palvelin ja tiedostopalvelin sama kone vai kolme konetta, koska tämä yksi seikka muuttaa lähes jokaista vastausta.

Täytä tämä kirjaus ennen julkaisua

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

Kahdeksan riviä, ja useimmat pyynnöt muuttuvat vastattaviksi. Kontrollirivi on se, jonka ihmiset jättävät pois: jos selaaminen samalta kannettavalta toimii mutta tiedostojako ei, se rajaa ongelman tunnelin reitteihin tai palveluun, eikä kenenkään tarvitse kysyä.

Pidä tunnisteet johdonmukaisina, kun redaktoit. Säilytä ero julkisen päätepisteen, tunneliosoitteen ja kotialiverkon välillä. Jos kaksi aluetta menee päällekkäin, pidä se suhde näkyvänä sen sijaan että korvaisit jokaisen verkon samalla paikkamerkillä, koska päällekkäisyys on usein vastaus.

Nimeä epäonnistuva vaihe, ei koko lokia

Viisi vaihetta kannattaa erottaa: nimien selvitys, yhteysyritys, todennus, tunnelin pystytys ja pääsy resurssiin. Sano, minkä uskot epäonnistuneen ja mitä näit siellä.

Liitä pieni ote tapahtuman ympäriltä sen sijaan että liittäisit jokaisen virheenkorjaustiedoston, jonka asiakas voi tuottaa. Sata riviä kättelyn kohinaa kätkee sen yhden rivin, joka sanoo, ettei varmenteen nimi täsmännyt.

Pidä havainto ja selitys erillään. ”Asiakas ilmoittaa kättelyn aikakatkaisun 30 sekunnin jälkeen” on havainto; ”luulen, että operaattori estää UDP:n” on teoria. Molemmat ovat hyödyllisiä, ja niiden sekoittaminen tarkoittaa, ettei auttaja voi tietää, kumpaan luottaa. Merkitse ne, ja saamasi vastaus käsittelee oikeaa.

Lähetä se omistajalle, joka voi toimia

Työnantajan hallinnoimalle kannettavalle aloita työnantajan tuetusta kanavasta, koska yhteisöfoorumi ei voi muuttaa heidän käytäntöään. Kaupalliselle VPN-palvelulle nimeä tuote ja tili yksityisesti, ei julkisesti. Omalle yhdyskäytävälle lisää ne reitittimen ja palvelimen roolit, joita hallitset.

Jos käytät julkista yhteisöä, valitse sellainen, jonka nykyinen laajuus sopii tehtävään. Vanha ketju foorumin säännöistä ei ole tukisopimus, eikä sitä ole viisi vuotta vanha vastaus protokollaversiosta, jota et aja.

Peitä salaisuudet litistämättä topologiaa

Poista yksityiset avaimet, salasanat, tunnukset ja valtuustiedot sisältävät linkit ennen kuin mitään lähtee koneeltasi. Diagnostiikkavienti ja täydellinen konfiguraatio ovat eri artefakteja, vaikka tiedostonimet näyttäisivät samalta, ja liittämäsi voi sisältää ennalta jaetun avaimen.

Säilytä sitten ne suhteet, jotka tekevät kulusta ymmärrettävän. RFC 6973 pitää tarpeetonta keräämistä ja korrelointia yksityisyyskysymyksinä, ja sama periaate pätee tässä: jaa se näyttö, jonka vastaanottaja tarvitsee, älä koko konetta.

Lopeta yhteen vastattavaan kysymykseen havaitusta ristiriidasta, esimerkiksi miksi asiakas suorittaa todennuksen ja jää sitten ilman reittiä. Täsmällinen kysymys saa täsmällisen vastauksen, ja rakentamasi kirjaus on se, mikä antaa jonkun antaa sellaisen kysymättä salaisuuksiasi.