ВходЗапазете среща

Глава 2.12

Първото стартиране

От незаявена инсталация до работещи хора. Създайте кода за заявяване, заявете инсталацията в браузър, създайте първия администратор с ключ за достъп, след което свържете фирменото влизане и поканете всички останали.

Тази страница е преведена от ИИ от английския оригинал. Ако нещо е неясно, английската страница е референтна. Прочетете тази страница на английски

18 минути за четене

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

Редът е фиксиран и всяка стъпка затваря предходната завинаги: заявете инсталацията, създайте първия администратор и организацията, настройте ключ за достъп (passkey) и отидете на страницата „Днес“ (Today). След това идват шестте неща за подготовка, фирменото влизане и поканването на всички останали, в какъвто ред Ви е удобно.

Верига от кутии отляво надясно: „nexusctl claim-code (терминал)“, „Заявете тази инсталация (браузър: код + отпечатък)“, „Първият администратор и организацията“, „Ключ за достъп (втора проверка)“, „Днес, когато всичко е ново“, „Шест неща, преди някой да влезе“, „Поканете хора“. Под кутията за заявяване се спускат две червени разклонения: „кодът е твърде стар: CLAIM_CODE_EXPIRED, създайте нов код“ и „отпечатъците се различават: CLAIM_FINGERPRINT_MISMATCH, спрете“. Тънка линия под първите три кутии е надписана „всяка стъпка изключва предходната завинаги“.
Първото стартиране, от терминала до първата страница „Днес“ (Today), и двете места, където може да спре.

Създаване на кода за заявяване

Кодът за заявяване доказва, че човекът пред браузъра вижда и терминала на някого с достъп до клъстера. Само такъв човек може да създаде код. Изпълнете това там, откъдето Вашият kubeconfig има достъп до клъстера:

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

nexusctl claim-code иска от ключовата услуга на инсталацията, nexus-keys, да създаде кода. Без nexusctl същата команда се изпълнява в собствения под (pod) на ключовата услуга:

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

--source представлява няколко думи, указващи кой е създал кода. Страницата за заявяване ги показва под „Създаден от“ (Made by), така че човекът, който заявява, знае откъде идва кодът.

 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. На Заявете тази инсталация (Claim this installation) въведете кода в Група едно (Group one), Група две (Group two) и Група три (Group three), по една група от четири знака във всяка.
  3. Сравнете Отпечатък на тази инсталация (Fingerprint of this installation) на страницата с терминала – всичките осем групи, една по една.
  4. Ако всяка група съвпада, отметнете Всички осем групи съвпадат с показаното в моя терминал (All eight groups match what my terminal shows).
  5. Натиснете Заявете тази инсталация (Claim this installation) и страницата потвърждава заявяването и Ви препраща към първия администратор.
Заяви тази инсталация
Заяви тази инсталация
Страницата за заявяване. Кодът се въвежда в три групи, пълният отпечатък е показан в осем групи по четири знака за сравнение с терминала, а картата вдясно показва откъде идва кодът и колко опита остават.

Заявяването прави три неща. Прави този браузър единственото място, където може да бъде създаден първият администратор. Записва в одитния дневник кой е заявил инсталацията и кога. И изключва страницата за заявяване завинаги. От този момент нататък адресът за заявяване отговаря, че инсталацията е заявена.

Ако отпечатъкът не съвпада, спрете

Различен отпечатък означава, че на този адрес отговаря друга инсталация. Може да е грешно написан адрес, остарял запис в DNS (Domain Name System) или машина, настроена да прихване първия администратор. Ако я заявите, тази машина ще държи Вашата организация.

Не заявявайте и не въвеждайте кода на тази страница. Затворете страницата, след което проверете две неща: че console.harrow.example се насочва към Вашия ingress и че сертификатът, който браузърът показва, е издаден от удостоверяващия орган – CA (certificate authority), който очаквате. Вашата собствена инсталация е непроменена и все още незаявена.

Ако бъде изпратено заявяване с отпечатък, който не е на инсталацията, ключовата услуга го отказва с CLAIM_FINGERPRINT_MISMATCH (403). Нищо не е заявено. След това страницата показва двата отпечатъка един до друг, като групите, които се различават, са отбелязани, заедно със стъпките за проверка на адреса и сертификата.

Отпечатъкът не съвпада
Отпечатъкът не съвпада
Страницата, до която води несъвпадащ отпечатък. Различаващите се групи са отбелязани, а стъпките проверяват адреса и сертификата, преди да бъде въведено каквото и да е друго.

Създаване на първия администратор и организацията

Страницата, която следва, е озаглавена „Два кратки формуляра и сте вътре“ (Two short forms, then you are in). Първият администратор може да добави всички останали и почти всичко тук може да се промени по-късно. Две неща не могат и страницата ги отбелязва.

Поле Какво се въвежда Може ли да се промени по-късно?
Пълно име (Full name) Вашето име Да
Служебен имейл (Work email) Адресът, за който е създаден кодът за заявяване, показан и без да се въвежда отново Това е адресът на администратора
Роля в Nexus (Role in Nexus) Администратор на организацията. Първият човек винаги е администратор. Не се избира тук
Втора проверка (Second check) Ключ за достъп (passkey) на този лаптоп Да, могат да се добавят още
Име (Name) (на организацията) Harrow Port Authority Да
Държава (Country) Къде е базирана организацията Да
Кратко име в адресите (Short name in addresses) Създадено от името, например harrow-port-authority Не. Връзките и експортите го използват.
Къде се съхраняват данните (Where data is kept) Тази инсталация Не. Промяната му по-късно означава нова инсталация.
Език и дати (Language and dates) Английски (Обединеното кралство), с днешната дата Да
Часова зона (Time zone) Часовата зона на сървъра Всеки човек вижда часовете в своята собствена

Краткото име се състои от малки букви, цифри и тирета, до 100 знака, създадено от името на организацията с премахнати ударения и диакритични знаци. Погледнете го, преди да натиснете каквото и да е. То се появява във всяка връзка, която хората споделят, и във всеки експорт, който правят, докато организацията съществува.

На тази страница задавате и парола. Тя никога не е достатъчна сама по себе си: администратор никога не влиза само с парола. Втората проверка по-долу е това, което Ви вписва.

По същото време се създава и авариен вход за администратор. Той се запечатва и разпечатва веднъж, за сейфа. Работи само когато фирменото влизане не работи, а всяко използване се записва и обявява на всички администратори. Приберете го в сейфа в деня, в който го разпечатате.

Страницата също така казва, че на Adverant не се съобщава кои сте Вие. Тези данни остават в инсталацията. Лицензът назовава компанията, никога хората в нея.

Натиснете Създаване и влизане (Create and sign in). Създаването на администратора и организацията отнема няколко секунди. Страницата отговаря „Създадено за aoife.brennan@harrow.example. Сега настройте своя ключ за достъп: чрез него влизате.“

Първият администратор
Първият администратор
Първият администратор и организацията на една страница. Двата избора, които никога не могат да се променят – краткото име и къде се съхраняват данните – го указват до полето, а аварийният вход е запечатан за сейфа.

Ключът за достъп: втората проверка

  1. Натиснете Настройване на ключа за достъп и влизане (Set up the passkey and sign in).
  2. Вашият браузър Ви моли да създадете ключ за достъп (passkey). На лаптоп с Touch ID или Windows Hello потвърдете с пръст, лице или ПИН код. Ако компютърът не може сам да създаде ключ за достъп, браузърът показва QR (quick response) код: насочете камерата на телефона си към него и следвайте инструкциите на телефона.
  3. Страницата отговаря „Вашият ключ за достъп е настроен и сте влезли като aoife.brennan@harrow.example.“ и отваря конзолата.

Имате десет минути от натискането на Създаване и влизане (Create and sign in), за да създадете ключа за достъп в същия браузър. След това настройката се затваря и администраторът съществува без ключ за достъп. Оператор трябва да помогне, както е описано при повторните опити по-долу.

Оттук нататък първият администратор влиза с този ключ за достъп. Паролата на пълен администратор, въведена сама по себе си, никога не създава сесия: услугата за влизане отговаря със заявка за втората проверка. Това е свойство на дизайна и причината ключът за достъп да е от значение. Изгубен ключ за достъп е изгубен начин за влизане, затова добавете втори – на телефон или хардуерен ключ за сигурност – още в първия ден.

По-късно хората влизат в инсталацията с ключ за достъп, с Google, с GitHub или с фирменото си влизане, в зависимост от това какво позволява организацията.

Код Какво означава Какво да предприемете
PASSKEY_UNSUPPORTED Този браузър не може да създаде ключ за достъп. Нищо не беше настроено. Отворете страницата в браузър, който поддържа ключове за достъп, на същия компютър.
PASSKEY_CANCELLED Подканата беше затворена или нищо не беше избрано навреме. Нищо не беше изпратено. Натиснете бутона отново.

Първата страница Today

Конзолата се отваря на „Днес“ (Today) и в първия ден почти всичко в нея е празно. Всяка празна област казва какво ще се появи там и дава бутона, който го стартира, така че „Изисква администратор“ (Needs an administrator) казва, че заявките ще чакат там, след като хората се присъединят, с Поканете хора (Invite people) до него. Контролният списък за настройка показва колко от стъпките му са изпълнени, в произволен ред. Единствената реална хронология – самата настройка – вече е под „Какво се промени“ (What changed): инсталацията е настроена и ключът за достъп на първия администратор е създаден.

„Днес“, когато всичко е ново
„Днес“, когато всичко е ново
„Днес“ (Today) в първия ден. Всяка празна област казва какво ще се появи там и как да го стартирате, а „Какво се промени“ (What changed) вече съдържа самата настройка.

Шест неща, преди някой да влезе

Страницата Шест неща, преди някой да влезе (Six things before anyone signs in) изброява какво трябва да е изпълнено, преди хората да бъдат поканени. Това не е съветник стъпка по стъпка. Изпълнете ги в произволен ред и страницата ги брои („Три от шест са изпълнени“).

Елемент Какво го прави изпълнено
Лиценз (Licence) Импортиран е лиценз Enterprise. Глава 2.13, Лицензи. Community не се нуждае от лиценз.
Адрес и сертификат (Address and certificate) Публичният адрес отговаря със сертификат, чиято верига е пълна.
Резервни копия (Backups) Зададен е график за резервни копия с местоназначение, в което може да се записва.
Фирмено влизане (Company sign-in) Свързано и тествано. Дотогава хората използват ключове за достъп.
Поща (Mail) Зададен е пощенски сървър. Дотогава не могат да се изпращат покани.
Модел на ИИ (AI model) Модел на ИИ (изкуствен интелект): ключ за модел на организацията или модел на собствен хардуер. Дотогава асистентът изчаква. Глава 2.14, Доставчици и модели на ИИ.

Поканете хора (Invite people) се отваря, когато всичките шест са изпълнени.

Същата страница изброява какво става фиксирано, след като хората влязат, с причината за всяко от тях: краткото име в адресите, къде се съхраняват данните и пазителят на ключовете (ключовете могат да се преместят от софтуерен пазител към хардуер, но никога обратно). Името на организацията също е в списъка, защото си струва да се провери, въпреки че може да се променя.

Nexus няма да отговори на ничия заявка към ИИ, докато организацията няма модел. Зад инсталацията няма споделен ключ и няма резервен вариант, така че организация без ключ за модел получава директен отказ, който казва на администратора какво да добави.

Шест неща, преди някой да влезе
Шест неща, преди някой да влезе
Шест проверки в произволен ред, преброени с думи. Изборите, които стават фиксирани, след като хората влязат, са изброени с причината, така че никой да не разбере впоследствие.

Фирмено влизане

Повечето организации искат хората да влизат с акаунтите, които вече имат. Свържете Вашия доставчик на идентичност на страницата за фирмено влизане: през OIDC (OpenID Connect) при Community, или през OIDC или SAML (Security Assertion Markup Language) при Enterprise.

  1. Изберете доставчика и стандарта, който използва.
  2. Въведете идентичността на приложението (application identity) и тайната на приложението (application secret), които Вашият доставчик на идентичност Ви е дал. Тайната никога не се показва отново, след като я запазите.
  3. Посочете кой може да влиза, например всеки с адрес @harrow.example.
  4. Натиснете Тестване на влизането (Test sign-in) и влезте със своя профил. Резултатът казва с думи кой е влязъл и какво е изпратил доставчикът.
  5. Запазете.

Community получава едно фирмено влизане за организацията. Enterprise добавя принудително прилагане (enforcement) и синхронизиране на директорията (directory sync). Принудителното прилагане изключва паролите, така че всеки трябва да използва фирмено влизане, а опитът за влизане с парола се отказва с SSO_REQUIRED и бутон към правилния начин за влизане. Синхронизирането на директорията копира хора и групи от Вашата директория на всеки 15 минути и може да прави администратори от една посочена група.

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

Свържете Вашия доставчик на идентичност
Свържете Вашия доставчик на идентичност
Фирмено влизане с тест. Доставчикът, стандартът с дребен шрифт и тестово влизане, чийто резултат е написан с думи, преди някой да разчита на него.

Поканване на хора

След като пощата е настроена, поканете хора от страницата „Хора“ (People). За всеки посочете имейл и роля:

  • Член (Member) използва всичко, което организацията има, и не променя настройки.
  • Администратор (Administrator) управлява също хора, модели, бюджети и настройки.

Поканата е валидна 7 дни. Човекът я отваря, вижда кой го е поканил, своята роля и какво ще вижда, и влиза. При първото му влизане се изисква втора проверка.

Поканените членове влизат в конзолата и вършат ежедневната си работа там: „Днес“ (Today), асистента, екипния чат, файловете и търсенето, бележниците, агентите и работните потоци, според това какво позволява ролята им. Администраторите виждат и административните страници. Член, който отвори страница на администратор, получава страницата „Не сте администратор“ (Not an administrator). Тя показва настройките само за четене, казва защо и предлага да се попита администратор.

Покани колега
Покани колега
Поканата избира ролята на човека, преди да пристигне – Член или Администратор – и може да съдържа кратка бележка.

Регистрациите изискват одобрение

Хората могат също да поискат да се присъединят, като се регистрират сами. В една инсталация регистрацията на непознат не създава работещ акаунт. nexus-auth я отказва с SIGNUP_REQUIRES_APPROVAL (403) и я задържа за одобрение от администратор.

В хостваната услуга на Adverant съществуват още две контроли при регистрация, които са изключени във всяка инсталация, без стойност за включването им. Интернет CAPTCHA би изисквала интернет при всяка регистрация. Мрежовият филтър при регистрация би изисквал лицензирана база данни за геолокация, каквато инсталацията не съдържа. Одобрението е входната врата на инсталацията.

Повторни опити, изтекли кодове и други откази

Всеки отказ при първото стартиране казва какво се е случило, че нищо не се е променило, когато това е вярно, и какво да се направи след това.

Код Състояние Кога Какво да предприемете
CLAIM_CODE_EXPIRED 410 Изминали са 30-те минути. Нищо не е заявено и нищо не се е променило. Създайте нов код с nexusctl claim-code --administrator <email>, след което натиснете Имам нов код (I have a new code).
CLAIM_FINGERPRINT_MISMATCH 403 Изпратеният отпечатък не е на тази инсталация. Спрете. Проверете адреса и сертификата.
TRANSITION_NOT_PERMITTED 409 Стъпка, която вече се е случила, е била поискана отново: заявяване на вече заявена инсталация или създаване на първия администратор за втори път. Влезте в конзолата; първият администратор добавя всички останали.
TRANSITION_NOT_PERMITTED 409 Стъпката за ключ за достъп, от браузър без чакащ първи администратор или след изтичане на десетте ѝ минути. Вижте по-долу.
RATE_LIMITED 429 Твърде много опити на страниците за първо стартиране в рамките на една минута. Нищо не беше изпратено. Изчакайте секундите, които страницата показва, след което опитайте отново.

Код без оставащи опити гласи „Този код няма оставащи опити“ (This code has no tries left). Създайте нов, точно както при изтекъл код. Само някой с достъп до клъстера може да го направи, което е и целта.

Страниците за първо стартиране приемат общо 20 опита в минута. Ако Вие не сте направили тези опити, някой друг във Вашата мрежа пробва страницата и това си струва да се знае.

Когато стъпката за ключ за достъп е пропусната

Ако първият администратор е бил създаден, но не е направен ключ за достъп в рамките на десет минути, или браузърът е бил затворен, администраторът съществува без начин за влизане. Стъпката за ключ за достъп отговаря с TRANSITION_NOT_PERMITTED с думите „Ако сте създали първия администратор в този браузър преди повече от десет минути, обърнете се към оператор: администраторът съществува и все още няма ключ за достъп“. В този момент заявяването е изразходвано, така че нов код за заявяване няма да помогне. Попитайте оператора, който е извършил инсталацията, преди да се опитва каквото и да е друго.

Когато браузърът е изгубил заявяването

Заявяването се съхранява в браузъра, който го е направил, в бисквитка, която страницата не може да прочете. Ако този браузър я загуби между заявяването и създаването на първия администратор – например в поверителен прозорец, който е бил затворен – формулярът на първия администратор приема също файла за заявяване и неговата тайна за настройка, поставени на ръка.

След като Aoife имаше своя ключ за достъп, Tomás затвори терминала си. Страницата за заявяване беше изключена, първият администратор съществуваше и всеки друг начин за влизане вече минаваше през нея.