Žiadosť o podporu domácej VPN potrebuje jeden tok, nie hromadu konfigurácie

Zverejníte redigovanú konfiguráciu, spomeniete, že VPN nefunguje, a dostanete šesť odpovedí na šesť rôznych vecí. Problém je zvyčajne v žiadosti, nie v čitateľoch. Pomocník z konfigurácie nezistí, či sa tunel nevytvára, či sa vytvára, ale zahadzuje prevádzku, alebo či funguje dobre, kým súborová služba za ním odmieta spojenie. Opíšte namiesto toho jeden tok, s tromi vlastníkmi a jednou pozorovanou poruchou, a odpovede sa hneď zlepšia.

Prečo žiadosť dostáva neužitočné odpovede

Konfigurácia opisuje, čo je nastavené. Neopisuje, čo ste skúsili, čo sa stalo ani ktorý z niekoľkých strojov má robiť ktorú prácu. Bez toho každý čitateľ tipuje inú fázu.

Ilustratívny prípad je cestovný notebook, ktorý by mal cez domácu bránu dosiahnuť súborovú službu na domácom serveri. Uveďte, či brána, server VPN a súborový server sú jeden stroj alebo tri stroje, pretože tento jediný fakt mení takmer každú odpoveď.

Vyplňte tento záznam pred zverejnením

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 riadkov, a väčšina žiadostí sa stane zodpovedateľnou. Kontrolný riadok je ten, ktorý ľudia vynechávajú: ak prehliadanie z rovnakého notebooku funguje, kým zdieľanie súborov nie, zužuje to problém na trasy tunela alebo na službu, a nikto sa nemusí pýtať.

Pri redigovaní udržujte popisky konzistentné. Zachovajte rozdiel medzi verejným koncovým bodom, adresou tunela a domácou podsietou. Ak sa dva rozsahy prekrývajú, nechajte tento vzťah viditeľný, namiesto toho, aby ste každú sieť nahradili rovnakým zástupným znakom, pretože prekrytie je často odpoveď.

Pomenujte zlyhávajúcu fázu, nie celý záznam

Oplatí sa oddeliť päť fáz: preklad mien, pokus o spojenie, overenie identity, nadviazanie tunela a prístup k zdroju. Povedzte, ktorá podľa vás zlyhala a čo ste tam videli.

Vložte malý výňatok okolo udalosti namiesto každého ladiacého súboru, ktorý klient dokáže vytvoriť. Sto riadkov šumu z nadväzovania spojenia skrýva ten jediný riadok, ktorý hovorí, že meno certifikátu nesúhlasilo.

Držte pozorovanie a vysvetlenie oddelene. „Klient hlási vypršanie času nadväzovania spojenia po 30 sekundách“ je pozorovanie; „myslím, že poskytovateľ blokuje UDP“ je teória. Oboje je užitočné a ich miešanie znamená, že pomocník nevie, čomu veriť. Označte ich a odpoveď, ktorú dostanete, sa obráti na to správne.

Pošlite to vlastníkovi, ktorý môže konať

Pri notebooku spravovanom zamestnávateľom začnite podporovaným kanálom zamestnávateľa, pretože komunitné fórum nezmení jeho politiku. Pri komerčnej službe VPN uveďte produkt a účet súkromne, nie verejne. Pri vlastnej bráne uveďte roly routera a servera, ktoré ovládate.

Ak používate verejnú komunitu, vyberte takú, ktorej súčasný rozsah zodpovedá úlohe. Staré vlákno o pravidlách fóra nie je zmluva o podpore a nie je ňou ani päť rokov stará odpoveď o verzii protokolu, ktorú nespúšťate.

Skryte tajomstvá bez splošťovania topológie

Odstráňte súkromné kľúče, heslá, tokeny a odkazy nesúce prihlasovacie údaje skôr, než čokoľvek opustí váš stroj. Diagnostický export a úplná konfigurácia sú rôzne artefakty, aj keď názvy súborov vyzerajú rovnako, a to, čo ste vložili, môže obsahovať vopred zdieľaný kľúč.

Potom zachovajte vzťahy, ktoré robia tok zrozumiteľným. RFC 6973 považuje zbytočné zhromažďovanie a koreláciu za otázky súkromia a rovnaký princíp platí aj tu: zdieľajte dôkazy, ktoré príjemca potrebuje, nie celý stroj.

Uzavrite jednou zodpovedateľnou otázkou o pozorovanom nesúlade, napríklad prečo klient dokončí overenie a potom už nikdy nedostane trasu. Konkrétna otázka dostane konkrétnu odpoveď a záznam, ktorý ste zostavili, je to, čo niekomu umožní ju dať bez pýtania sa na vaše tajomstvá.