УвійтиЗамовити брифінг

Розділ 2.12

Перший запуск

Від неактивованої інсталяції до початку роботи користувачів. Створіть код активації (claim code), заявіть права на інсталяцію в браузері, створіть першого адміністратора з ключем доступу, а потім підключіть корпоративний вхід і запросіть усіх інших.

Цю сторінку перекладено за допомогою ШІ з англійського оригіналу. Якщо щось незрозуміло, орієнтуйтеся на англійську версію сторінки. Читати цю сторінку англійською

18 хв читання

Коли встановлення завершується, інсталяція не належить нікому. У ній немає ані організації, ані користувача, ані сеансу, і ніхто не може увійти. Вона чекає, поки одна людина доведе в браузері, що звертається саме до щойно створеної інсталяції. У Harrow Port Authority цією людиною була Aoife Brennan, керівниця ІТ-відділу, а поруч із нею біля термінала був Tomás Reilly. У цьому розділі описано їхні перші двадцять хвилин.

Порядок дій фіксований, і кожен крок назавжди закриває попередній: заявіть права на інсталяцію, створіть першого адміністратора й організацію, налаштуйте ключ доступу (passkey) і перейдіть на сторінку «Сьогодні». Після цього потрібно підготувати шість речей, налаштувати корпоративний вхід і запросити всіх інших — у будь-якому зручному для вас порядку.

Ланцюжок блоків зліва направо: «nexusctl claim-code (термінал)», «Заявити права на цю інсталяцію (браузер: код + відбиток)», «Перший адміністратор і організація», «Ключ доступу (друга перевірка)», «Сьогодні, коли все нове», «Шість умов, перш ніж хтось увійде», «Запросити людей». Під блоком підтвердження прав униз відходять дві червоні гілки: «код застарів: CLAIM_CODE_EXPIRED, створіть новий код» і «відбитки відрізняються: CLAIM_FINGERPRINT_MISMATCH, зупиніться». Тонка лінія під першими трьома блоками має підпис «кожен крок назавжди вимикає попередній».
Перший запуск — від термінала до першої сторінки «Сьогодні» — та два місця, де він може зупинитися.

Створення коду активації

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

nexusctl claim-code --administrator aoife.brennan@harrow.example

nexusctl claim-code запитує ключову службу інсталяції, nexus-keys, щоб створити код. Без nexusctl та сама команда виконується у власному поді ключової служби:

kubectl -n nexus exec deploy/nexus-keys -- nexus-keys claim-code \
  --administrator aoife.brennan@harrow.example --source "Tomás Reilly, ops terminal"

--source — це кілька слів про те, хто створив код. Сторінка підтвердження прав показує їх у полі «Створено», щоб особа, яка заявляє права, знала, звідки взявся код.

 Code  7KQM-4TXD-PL9R  works once, for 30 minutes, until 09:55 · 5 tries
 Fingerprint of this installation, to compare in the browser:
 3F9A C21B 77E0 5D4C 9B12 A6F3 0E88 41D7

Важливими є три особливості коду.

  • Він діє 30 хвилин. Код, підглянутий через чиєсь плече, невдовзі стає марним.
  • Він дає 5 спроб. Після п’ятої невдалої спроби код вичерпується незалежно від часу.
  • Він призначений для однієї особи. Електронна адреса, яку ви вказуєте, належить першому адміністратору. Вона передається разом із заявкою на права, і у формі першого адміністратора відображається як фіксована — її не потрібно вводити знову.

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

Активація інсталяції

  1. На комп’ютері, який ви використовуватимете як перший адміністратор, відкрийте адресу встановлення консолі, тут це https://console.harrow.example/install. Вона перенаправить вас на сторінку, що відповідає стану інсталяції: сторінку підтвердження прав, доки вона відкрита, сторінку першого адміністратора після підтвердження прав або консоль, якщо ви вже увійшли.
  2. На сторінці Заявити права на цю інсталяцію введіть код у поля Група один, Група два та Група три — по одній групі з чотирьох символів у кожне.
  3. Звірте Відбиток цієї інсталяції на сторінці з даними в терміналі — усі вісім груп по черзі.
  4. Якщо кожна група збігається, поставте прапорець Усі вісім груп збігаються з тим, що показує мій термінал.
  5. Натисніть Заявити права на цю інсталяцію — сторінка підтвердить права та перенаправить вас до налаштування першого адміністратора.
Підтвердити цю інсталяцію
Підтвердити цю інсталяцію
Сторінка підтвердження прав. Код вводиться трьома групами, повний відбиток відображається вісьмома групами по чотири символи для звірки з терміналом, а на картці праворуч указано, звідки надійшов код і скільки спроб залишилося.

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

Якщо відбиток не збігається, зупиніться

Інший відбиток означає, що за цією адресою відповідає інша інсталяція. Це може бути помилка в адресі, застарілий запис DNS (Domain Name System) або машина, налаштована для перехоплення даних першого адміністратора. Якби ви заявили на неї права, ваша організація опинилася б на тій машині.

Не заявляйте права та не вводьте код на тій сторінці. Закрийте сторінку, а потім перевірте дві речі: чи console.harrow.example веде до вашого ingress, і чи сертифікат, який показує браузер, виданий очікуваним центром сертифікації — CA (certificate authority). Ваша власна інсталяція залишається незмінною, і права на неї досі не заявлено.

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

Відбиток не збігається
Відбиток не збігається
Сторінка, на яку веде розбіжність у відбитку. Групи, що відрізняються, позначено, а запропоновані кроки дають змогу перевірити адресу й сертифікат, перш ніж вводити будь-що інше.

Створення першого адміністратора й організації

Наступна сторінка має заголовок «Дві короткі форми — і ви в системі». Перший адміністратор може додати всіх інших, і майже все вказане тут можна змінити пізніше. Дві речі змінити не можна, і сторінка позначає їх.

Поле Що вводиться Чи можна змінити пізніше?
Повне ім’я Ваше ім’я Так
Робоча електронна пошта Адреса, для якої було створено код підтвердження прав; відображається автоматично й не вводиться знову Це адреса адміністратора
Роль у Nexus Адміністратор організації. Перша особа завжди є адміністратором. Тут не вибирається
Друга перевірка Ключ доступу на цьому ноутбуці Так, можна додати інші
Назва (організації) Harrow Port Authority Так
Країна Де розташована організація Так
Коротка назва в адресах Утворюється з назви, наприклад harrow-port-authority Ні. Її використовують посилання та експортовані файли.
Де зберігаються дані Ця інсталяція Ні. Зміна цього параметра пізніше означає нову інсталяцію.
Мова та дати Англійська (Велика Британія), із сьогоднішньою датою Так
Часовий пояс Часовий пояс сервера Кожен користувач бачить час у власному часовому поясі

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

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

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

На сторінці також зазначено, що Adverant не отримує даних про те, хто ви. Ці відомості залишаються в інсталяції. У ліцензії вказується назва компанії, але ніколи — люди, які в ній працюють.

Натисніть Створити й увійти. Створення адміністратора й організації триває кілька секунд. Сторінка відповідає: «Створено для aoife.brennan@harrow.example. Тепер налаштуйте свій ключ доступу: саме за його допомогою ви входите в систему».

Перший адміністратор
Перший адміністратор
Перший адміністратор і організація на одній сторінці. Біля двох параметрів, які ніколи не можна змінити — короткої назви та місця зберігання даних, — є відповідна позначка, а аварійний вхід запечатано для сейфа.

Ключ доступу (passkey): друга перевірка

  1. Натисніть Налаштувати ключ доступу й увійти.
  2. Ваш браузер попросить створити ключ доступу. На ноутбуці з Touch ID або Windows Hello підтвердьте дію відбитком пальця, обличчям або PIN-кодом. Якщо комп’ютер не може створити ключ доступу самостійно, браузер покаже QR-код (quick response): наведіть на нього камеру телефона й виконайте інструкції на екрані телефона.
  3. Сторінка відповідає: «Ваш ключ доступу налаштовано, і ви увійшли як aoife.brennan@harrow.example.» та відкриває консоль.

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

Відтепер перший адміністратор входить за допомогою цього ключа доступу. Пароль повного адміністратора, введений сам по собі, ніколи не відкриває сеанс: служба входу відповідає запитом на другу перевірку. Це особливість архітектури й причина, чому ключ доступу такий важливий. Втрачений ключ доступу означає втрату можливості входу, тож у перший же день додайте другий ключ — на телефоні або апаратному ключі безпеки.

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

Код Що це означає Що робити
PASSKEY_UNSUPPORTED Цей браузер не може створити ключ доступу. Нічого не налаштовано. Відкрийте сторінку в браузері, який підтримує ключі доступу, на тому самому комп’ютері.
PASSKEY_CANCELLED Запит було закрито або нічого не вибрано вчасно. Нічого не надіслано. Натисніть кнопку ще раз.

Перша сторінка «Сьогодні» (Today)

Консоль відкривається на сторінці «Сьогодні», і в перший день майже всі її області порожні. У кожній порожній області зазначено, що там з’явиться, і є кнопка для запуску відповідної дії. Наприклад, у блоці «Потребує дій адміністратора» вказано, що тут очікуватимуть запити, коли приєднаються люди, а поруч розміщено кнопку Запросити людей. Контрольний список налаштування показує, скільки кроків уже виконано (у будь-якому порядку). Єдиний запис в історії — саме початкове налаштування — уже міститься в розділі «Що змінилося»: інсталяцію налаштовано та створено ключ доступу першого адміністратора.

«Сьогодні», коли все нове
«Сьогодні», коли все нове
Сторінка «Сьогодні» в перший день. У кожній порожній області вказано, що там з’явиться і як це запустити, а в розділі «Що змінилося» вже збережено дані про саме налаштування.

Шість кроків перед тим, як хтось увійде в систему

На сторінці Шість умов, перш ніж хтось увійде перелічено умови, які мають виконуватися до запрошення людей. Це не покроковий майстер. Виконуйте їх у будь-якому порядку, а сторінка вестиме підрахунок («Виконано три з шести»).

Пункт Умова виконання
Ліцензія Імпортовано ліцензію Enterprise. Розділ 2.13, Ліцензії. Версія Community не потребує ліцензії.
Адреса та сертифікат Публічна адреса відповідає сертифікатом із повним ланцюжком.
Резервні копії Установлено розклад резервного копіювання з цільовим сховищем, доступним для запису.
Корпоративний вхід Підключено та протестовано. До того часу користувачі входять за ключами доступу.
Пошта Налаштовано поштовий сервер. До того часу запрошення надсилати неможливо.
Модель ШІ Модель ШІ (штучного інтелекту): ключ моделі організації або модель на вашому власному обладнанні. До того часу асистент перебуває в режимі очікування. Розділ 2.14, Постачальники та моделі ШІ.

Кнопка Запросити людей стає доступною, коли виконано всі шість умов.

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

Nexus не відповідатиме на жодні запити до ШІ, доки в організації не буде моделі. За інсталяцією немає спільного ключа чи резервного варіанта, тому організація без ключа моделі отримує просту відмову з підказкою для адміністратора, що саме потрібно додати.

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

Корпоративний вхід

Більшість організацій хочуть, щоб люди входили за допомогою облікових записів, які вони вже мають. Підключіть свого постачальника посвідчень на сторінці корпоративного входу: через OIDC (OpenID Connect) у версії Community або через OIDC чи SAML (Security Assertion Markup Language) у версії Enterprise.

  1. Виберіть постачальника та стандарт, який він використовує.
  2. Введіть ідентифікатор застосунку та секрет застосунку, надані постачальником посвідчень. Після збереження секрет більше ніколи не відображається.
  3. Укажіть, кому дозволено вхід, наприклад, усім, хто має адресу з доменом @harrow.example.
  4. Натисніть Тестовий вхід і увійдіть під своїм обліковим записом. У результаті словами буде описано, хто увійшов і які дані надіслав постачальник.
  5. Збережіть.

Версія Community підтримує один корпоративний вхід для організації. Версія Enterprise додає примусове застосування та синхронізацію каталогу. Примусове застосування вимикає паролі, тож усі мусять використовувати корпоративний вхід, а спроба входу за паролем відхиляється з кодом SSO_REQUIRED і кнопкою переходу до правильного способу входу. Синхронізація каталогу копіює користувачів і групи з вашого каталогу кожні 15 хвилин і може призначати адміністраторів з однієї вказаної групи.

Коли корпоративний вхід перестає відповідати, користувачі, які вже увійшли, залишаються в системі, а нові спроби входу відхиляються з кодом IDP_UNREACHABLE (503). Тоді адміністратор може скористатися аварійним входом адміністратора із сейфа разом зі своїм ключем доступу. Кожне таке використання записується в журнал аудиту, повідомляється всім адміністраторам і завершується через чотири години або після відновлення роботи корпоративного входу.

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

Запрошення користувачів

Коли пошту налаштовано, запросіть людей зі сторінки «Люди». Для кожної особи вкажіть електронну пошту та роль:

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

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

Запрошені учасники входять у консоль і виконують там свою щоденну роботу: «Сьогодні», асистент, командний чат, файли та пошук, блокноти, агенти й робочі процеси — відповідно до дозволів їхньої ролі. Адміністратори також бачать сторінки адміністрування. Учасник, який відкриває сторінку адміністратора, потрапляє на сторінку «Не адміністратор». Вона показує налаштування в режимі лише для читання, пояснює причину й пропонує звернутися до адміністратора.

Запросити колегу
Запросити колегу
У запрошенні роль особи — Учасник або Адміністратор — вибирається ще до її приєднання, і до нього можна додати коротку примітку.

Самостійна реєстрація потребує затвердження

Люди також можуть подати запит на приєднання, зареєструвавшись самостійно. В інсталяції самостійна реєстрація сторонньої особи не створює робочого облікового запису. Служба nexus-auth відхиляє її з кодом SIGNUP_REQUIRES_APPROVAL (403) і затримує до затвердження адміністратором.

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

Повторні спроби, прострочені коди та інші відмови

Кожна відмова під час першого запуску пояснює, що сталося, зазначає, що нічого не змінилося (якщо це так), і підказує, що робити далі.

Код Статус Коли виникає Що робити
CLAIM_CODE_EXPIRED 410 Минуло 30 хвилин. Права не заявлено, нічого не змінилося. Створіть новий код за допомогою nexusctl claim-code --administrator <email>, а потім натисніть У мене є новий код.
CLAIM_FINGERPRINT_MISMATCH 403 Надісланий відбиток не належить цій інсталяції. Зупиніться. Перевірте адресу та сертифікат.
TRANSITION_NOT_PERMITTED 409 Повторно запитано крок, який уже виконано: підтвердження прав для інсталяції, на яку вже заявлено права, або повторне створення першого адміністратора. Увійдіть у консоль; перший адміністратор додає всіх інших.
TRANSITION_NOT_PERMITTED 409 Крок налаштування ключа доступу відкрито з браузера, де не очікується створення першого адміністратора, або після завершення відведених десяти хвилин. Див. нижче.
RATE_LIMITED 429 Забагато спроб на сторінках першого запуску протягом хвилини. Нічого не надіслано. Зачекайте вказану на сторінці кількість секунд і спробуйте ще раз.

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

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

Коли крок із ключем доступу було пропущено

Якщо першого адміністратора було створено, але ключ доступу не налаштували протягом десяти хвилин або браузер закрили, адміністратор існує, проте не має способу увійти. На кроці ключа доступу повертається код TRANSITION_NOT_PERMITTED зі словами: «Якщо ви створили першого адміністратора в цьому браузері понад десять хвилин тому, зверніться до оператора: адміністратор існує, але ще не має ключа доступу». На цьому етапі заявку на права вже використано, тому новий код підтвердження прав не допоможе. Перш ніж пробувати будь-що інше, зверніться до оператора, який виконував встановлення.

Коли браузер втратив дані підтвердження прав

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

Щойно Aoife отримала свій ключ доступу, Tomás закрив термінал. Сторінку підтвердження прав було вимкнено, перший адміністратор існував, і всі інші шляхи доступу до системи тепер проходили через неї.