Захтев за подршку кућног VPN-а тражи један ток, а не гомилу конфигурације

Објављујете редиговану конфигурацију, наводите да VPN не ради и добијате шест одговора о шест различитих ствари. Проблем је обично у захтеву, не у читаоцима. Помоћник из конфигурације не може да утврди да ли се тунел не гради, да ли се гради али одбацује саобраћај, или ради добро док услуга датотека иза њега одбија везу. Опишите уместо тога један ток, са три власника и једном примећеном грешком, и одговори се одмах побољшавају.

Зашто захтев добија бескорисне одговоре

Конфигурација описује шта је подешено. Не описује шта сте покушали, шта се догодило или која од неколико машина треба да обави који посао. Без тога сваки читалац нагађа другу фазу.

Илустративни случај је путни преносни рачунар који треба да стигне до услуге датотека на кућном серверу кроз кућни излаз. Наведите да ли су излаз, VPN сервер и сервер датотека иста машина или три машине, јер та једна чињеница мења скоро сваки одговор.

Попуните овај запис пре објављивања

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

Осам редова, и већина захтева постаје одговорљива. Контролна линија је она коју људи изостављају: ако прегледање са истог преносног рачунара ради, а дељење датотека не, то сужава проблем на руте тунела или на услугу, и никоме не треба да пита.

Одржавајте ознаке доследним када редигујете. Сачувајте разлику између јавне крајње тачке, адресе тунела и кућне подмреже. Ако се два опсега преклапају, оставите тај однос видљивим уместо да сваку мрежу замените истим заменским знаком, јер преклапање је често одговор.

Именујте фазу која отказује, не цео дневник

Вреди раздвојити пет фаза: разрешавање имена, покушај везе, аутентикација, успостављање тунела и приступ ресурсу. Кажите која је по вашем мишљењу отказала и шта сте тамо видели.

Налепите мали изводак око догађаја уместо сваке датотеке за отклањање грешака коју клијент може да направи. Сто редова буке од руковања скривају тај један ред који каже да се име сертификата није поклопило.

Држите запажање и објашњење одвојено. „Клијент пријављује истек времена руковања после 30 секунди“ је запажање; „мислим да провајдер блокира UDP“ је теорија. Оба су корисна, а њихово мешање значи да помоћник не може да зна коме да верује. Означите их, и одговор који добијете обратиће се правом.

Пошаљите га власнику који може да делује

За преносни рачунар којим управља послодавац, почните од подржаног канала послодавца, јер форум заједнице не може да промени његову политику. За комерцијалну VPN услугу, наведите производ и налог приватно, а не јавно. За свој излаз, наведите улоге рутера и сервера које контролишете.

Ако користите јавну заједницу, изаберите ону чији садашњи обухват одговара задатку. Стара тема о правилима форума није уговор о подршци, а то није ни одговор стар пет година о верзији протокола коју не покрећете.

Сакријте тајне без спљоштавања топологије

Уклоните приватне кључеве, лозинке, токене и везе које носе акредитиве пре него што било шта напусти вашу машину. Дијагностички извоз и потпуна конфигурација су различити артефакти чак и када имена датотека изгледају слично, а оно што сте налепили може да садржи унапред дељени кључ.

Затим задржите односе који ток чине разумљивим. RFC 6973 сматра непотребно прикупљање и корелацију питањима приватности, и исти принцип важи овде: поделите доказе који су примаоцу потребни, а не целу машину.

Завршите једним питањем о примећеном нескладу на које се може одговорити, на пример зашто клијент завршава аутентикацију и затим никада не добија руту. Конкретно питање добија конкретан одговор, и запис који сте саставили је оно што некоме омогућава да га да без тражења ваших тајни.