Žádost o podporu domácí VPN potřebuje jeden tok, ne hromadu konfigurace

Zveřejníte redigovanou konfiguraci, zmíníte, že VPN nefunguje, a dostanete šest odpovědí na šest různých věcí. Problém bývá v žádosti, ne v čtenářích. Pomocník z konfigurace nepozná, jestli se tunel nevytváří, jestli se vytváří, ale zahazuje provoz, nebo jestli funguje dobře, zatímco souborová služba za ním odmítá spojení. Popište místo toho jeden tok, se třemi vlastníky a jednou pozorovanou závadou, a odpovědi se hned zlepší.

Proč žádost dostává neužitečné odpovědi

Konfigurace popisuje, co je nastaveno. Nepopisuje, co jste zkusili, co se stalo ani který z několika strojů má dělat kterou práci. Bez toho každý čtenář hádá jinou fázi.

Ilustrativní případ je cestovní notebook, který má přes domácí bránu dosáhnout na souborovou službu na domácím serveru. Uveďte, zda brána, server VPN a souborový server jsou jeden stroj, nebo tři stroje, protože tento jediný fakt mění téměř každou odpověď.

Vyplňte tento záznam, než ho zveřejníte

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

Osm řádků a většina žádostí je zodpověditelná. Kontrolní řádek je ten, který lidé vynechávají: pokud prohlížení ze stejného notebooku funguje, zatímco sdílení souborů ne, zužuje to problém na trasy tunelu nebo na službu a nikdo se nemusí ptát.

Při redigování udržujte popisky konzistentní. Zachovejte rozdíl mezi veřejným koncovým bodem, adresou tunelu a domácí podsítí. Pokud se dva rozsahy překrývají, nechte tento vztah viditelný, místo abyste každou síť nahradili stejným zástupným znakem, protože překryv je často odpověď.

Pojmenujte selhávající fázi, ne celý záznam

Vyplatí se oddělit pět fází: překlad jmen, pokus o spojení, ověření identity, navázání tunelu a přístup ke zdroji. Řekněte, která podle vás selhala a co jste tam viděli.

Vložte malý výňatek kolem události, ne každý ladicí soubor, který klient umí vytvořit. Sto řádků šumu z navazování spojení skrývá ten jediný řádek, který říká, že jméno certifikátu nesouhlasilo.

Držte pozorování a vysvětlení oddělené. „Klient hlásí vypršení času navazování spojení po 30 sekundách“ je pozorování; „myslím, že poskytovatel blokuje UDP“ je teorie. Obojí je užitečné a jejich smíchání znamená, že pomocník nepozná, čemu věřit. Označte je a odpověď, kterou dostanete, se obrátí na to správné.

Pošlete to vlastníkovi, který může jednat

U notebooku spravovaného zaměstnavatelem začněte podporovaným kanálem zaměstnavatele, protože komunitní fórum jejich politiku nezmění. U komerční služby VPN uveďte produkt a účet soukromě, ne veřejně. U vlastní brány uveďte role routeru a serveru, které ovládáte.

Pokud používáte veřejnou komunitu, vyberte takovou, jejíž současný rozsah odpovídá úkolu. Staré vlákno o pravidlech fóra není smlouva o podpoře a není jí ani pět let stará odpověď o verzi protokolu, kterou neprovozujete.

Skryjte tajemství, aniž byste zploštili topologii

Odstraňte soukromé klíče, hesla, tokeny a odkazy nesoucí přihlašovací údaje dřív, než cokoli opustí váš stroj. Diagnostický export a úplná konfigurace jsou různé artefakty, i když názvy souborů vypadají podobně, a to, co jste vložili, může obsahovat předem sdílený klíč.

Pak zachovejte vztahy, které činí tok srozumitelným. RFC 6973 považuje zbytečné shromažďování a korelaci za otázky soukromí a stejný princip platí i zde: sdílejte důkazy, které příjemce potřebuje, ne celý stroj.

Uzavřete jednou zodpověditelnou otázkou o pozorovaném nesouladu, například proč klient dokončí ověření a pak už nikdy nedostane trasu. Konkrétní otázka dostane konkrétní odpověď a záznam, který jste sestavili, je to, co někomu umožní ji dát, aniž by se ptal na vaše tajemství.