Дві різні роботи продаються як одна: перетворити машину на VPN-сервер і додати VPN-клієнт на ноутбук, який має підключитися до чужого шлюзу. Скрипт встановлення відповідає на першу і не може відповісти на другу, хоч би що припускав його README. Візьміть проєкт setup-ipsec-vpn як конкретний приклад: він будує сервер IPsec/L2TP, Cisco IPsec або IKEv2 на підтримуваному хості Linux за допомогою Libreswan і xl2tpd. Це контракт розгортання для сервера, а не загальний рецепт для будь-якої машини. Вирішіть, яка робота у вас, до запуску скрипта, бо все подальше стосується сервера.

Будьте чесні щодо хоста

Машина, яка також завершує щось інше, або чий міжмережевий екран керується хмарною панеллю, а не операційною системою, це інша інсталяція, ніж чиста віртуальна машина. Запишіть протокол, який ви вмикаєте, і випуск, який використовуєте, потім звірте обидва зі списком підтримки проєкту, а не з дописом у блозі минулого року.

Увімкнення служби не відкриває шлях до неї. Для IPsec мережа перед хостом має пропускати UDP 500 і 4500 і, залежно від розгортання, сам протокол ESP. Скрипт, який успішно завершився за групою безпеки, що відкидає протокол 50, створив сервер, до якого ніхто не дістанеться, і ніщо у виводі інсталятора про це не скаже.

Що інсталятор насправді перебирає

Очікуйте конфігурацію та файл секретів IPsec, конфігурацію демона L2TP, параметри PPP і юніти systemd, які тепер володіють цими портами. README проєкту зазначає, що наявні конфігураційні файли копіюються перед змінами, що корисно і не те саме, що резервна копія хоста. Вирішіть, які компоненти оновлюватимуться пакетами дистрибутива, а які повторним запуском або переписуванням скрипта, бо це два шляхи обслуговування з різними режимами відмови.

Закріпіть ревізію, яку схвалили. Адреса завантаження, що віддає поточну гілку за замовчуванням, наступного місяця може повернути інший вміст, тому запишіть commit або випуск, який запускали, і збережіть його копію. Ця одна звичка перетворює стан, який нічим не пояснити, на те, про що друга людина може думати другої ночі.

Чого скрипт не може дати

Автоматизація створює робочу інсталяцію і на цьому зупиняється. Вона не вирішує, до яких приватних ресурсів має доходити тунель, а це питання політики доступу, щодо якого мають думку і міжмережевий екран хоста, і мережа вище. Вона не вирішує, хто отримує облікові дані, як їх видають і як знімають чийсь доступ, коли людина йде. І вона не вирішує як відновлюється машина після невдалого оновлення, а це та частина, яку зазвичай виявляють у найгірший момент.

Клієнтські профілі та показані секрети це матеріал доступу, а не журнали інсталяції. Згенерований профіль, вставлений у спільний канал, це обліковий запис, і той самий стандарт стосується знімків екрана з підсумком налаштування. Ведіть захищений перелік стану ідентичності, потрібного для відновлення служби, і зазначайте, які з цих облікових даних відтоді відкликані.

Перший клієнт це приймальний тест

Прийміть розгортання від одного авторизованого клієнта, з тим протоколом, який ви справді увімкнули. Перевірте, що приватне імʼя розвʼязується, зворотний шлях працює, повторне підключення поводиться правильно і ціль поза дозволеним набором відхиляється. Успішний вхід з іншого клієнтського застосунку не доводить нічого про те, яке ви віддали.

Якщо потрібне поєднання більше не підтримується, до інсталяції виберіть шлях, що обслуговується. Оживлення старого випуску, ослаблення автентифікації або повторний запуск непоясненого скрипта це відстрочки, а не плани обслуговування, і кожна з них ускладнює передачу.

Напишіть сторінку передачі

Тримайте її короткою: сервер, ревізія, що його збудувала, потрібні порти, компоненти та їхні власники оновлень, дозволені ресурси, шлях облікових даних і процедура відновлення. Додайте консольний або позасмуговий шлях, яким будете користуватися, коли саме зміна тунелю зламала доступ. Тоді наступна людина успадкує службу, а не команду, яку боїться запустити двічі.

Переглядайте цю сторінку, коли змінюється хост, а не лише коли щось ламається. Документ передачі, який ніхто не читає, це документ, що тихо перестав бути правдивим.

Схожі статті