Напишете брифинг за дизајн на VPN што некој навистина може да го прегледа

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

Прво, дали прашањето е одлука или желба

Одлуката има алтернативи и набљудување што би избрало меѓу нив. Ако не можете да именувате во што би гледале за да изберете една, прашањето е уште желба. Прво запишете ги алтернативите, дури и ако списокот има само две точки. Потоа запишете го компромисот што ги дели.

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

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

Второ, именувајте ги тековите и одбивањата

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

Бидете конкретни за насоката. Локација што може да иницира врски кон централата е различен дизајн од онаа што може да ги прифати, и разликата се гледа во секое правило што потоа ќе го напишете.

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

Држете го списокот доволно краток за тестирање. Десет текови што можете да ги проверите се подобри од четириесет што не можете.

Проверка 3: одвојте фактите од претпоставките

Означете го секој тврдење што сте го провериле, и означете ги тие што не сте. Јавното адресирање, достапната пропустливост и пристапот на администратор се трите претпоставки што најчесто го менуваат одговорот. Ако една од нив е непозната, кажете како дизајнот се менува кога ќе излезе во која било насока.

Илустративна мрежа е во ред додека е означена. Проблемот е хипотетичка филијала што тивко добива втор нагорен линк или јавен блок адреси што никогаш го немала.

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

ip route get 10.50.0.10
traceroute -n -m 6 10.50.0.10
nc -vz 10.50.0.10 443

Четврто, напишете го договорот за отказ

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

Потоа одлучете го резервниот план: блокирајте го сообраќајот, насочете го по друг одобрен пат или направете нешто различно по апликација. Тихото враќање на директен пат е дизајнерска одлука дури и кога никој не ја запишал.

Додадете ја целта за враќање на едноставен јазик, на пример колку долго локацијата смее да работи во влошена состојба и кој го објавува инцидентот.

Проверка 5 и 6: изберете го шевот и запишете ја промената

Изберете еден шев за расправа, зашто преглед што се обидува да реши сето тоа не решава ништо. Рутирањето, авторизацијата и шифрирањето се три различни шевови, и брифингот треба да каже за кој од нив е прашањето. RFC 4301 е корисно потсетување овде, зашто ги одделува политичките одлуки, заштитениот сообраќај и безбедносните асоцијации наместо да ги третира како еден објект.

Потоа запишете што се промени по одлуката, вклучително и прегледаните претпоставки. Токму овој запис го прави следниот преглед пократок.

git diff --stat design/vpn-brief.md
grep -n 'assumption' design/vpn-brief.md
ip route get 10.50.0.10

Брифинг што ги поминува сите шест проверки создава прашање со одговор: дизајнот ги задоволува наведените текови и договорот за отказ, или именувано ограничување го спречува. Кога ограничувањето подоцна ќе се промени, записот покажува која одлука треба да се прегледа и која може да остане. Тоа ја прави вежбата повеќекратно употреблива, а не еднократна расправа.