Wersja 1.0.0-alpha.1najnowsza
Rozdział 2.12
Pierwsze uruchomienie
Od nieprzypisanej instalacji do gotowości do pracy. Wygeneruj kod przypisania, przejmij instalację w przeglądarce, utwórz pierwszego administratora z kluczem dostępu (passkey), a następnie podłącz logowanie firmowe i zaproś pozostałych użytkowników.
Ta strona została przetłumaczona przez AI z angielskiego oryginału. W razie jakichkolwiek niejasności wersją wiążącą jest strona w języku angielskim. Przeczytaj tę stronę po angielsku

Gdy instalacja dobiegnie końca, nie należy jeszcze do nikogo. Nie ma organizacji, użytkownika ani sesji, i nikt nie może się zalogować. Czeka, aż jedna osoba udowodni w przeglądarce, że łączy się z instalacją, która właśnie powstała. W Harrow Port Authority tą osobą była Aoife Brennan, szefowa IT, z Tomásem Reillym u boku przy terminalu. Ten rozdział opisuje ich pierwsze dwadzieścia minut.
Kolejność jest stała, a każdy krok na dobre zamyka poprzedni: przejęcie instalacji, utworzenie pierwszego administratora i organizacji, skonfigurowanie klucza dostępu (passkey) oraz przejście na stronę Dzisiaj (Today). Następnie przychodzi czas na przygotowanie sześciu rzeczy, logowanie firmowe i zaproszenie pozostałych osób, w dowolnej pasującej Państwu kolejności.
Generowanie kodu przypisania
Kod przejęcia udowadnia, że osoba przed przeglądarką widzi również terminal kogoś z dostępem do klastra. Tylko taka osoba może go wygenerować. Proszę uruchomić to polecenie tam, gdzie plik kubeconfig ma dostęp do klastra:
nexusctl claim-code --administrator aoife.brennan@harrow.examplenexusctl claim-code prosi usługę kluczy instalacji, nexus-keys, o wygenerowanie kodu. Bez nexusctl to samo polecenie jest uruchamiane we własnym podzie usługi kluczy:
kubectl -n nexus exec deploy/nexus-keys -- nexus-keys claim-code \
--administrator aoife.brennan@harrow.example --source "Tomás Reilly, ops terminal"--source to kilka słów określających, kto wygenerował kod. Strona przejęcia wyświetla je w sekcji „Utworzono przez” (Made by), dzięki czemu osoba przejmująca wie, skąd pochodzi kod.
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
W przypadku kodu istotne są trzy rzeczy.
- Jest ważny przez 30 minut. Kod podejrzany przez ramię szybko staje się bezużyteczny.
- Pozwala na 5 prób. Po piątej błędnej próbie zostaje zużyty, niezależnie od czasu.
- Jest przeznaczony dla jednej osoby. Podany adres e-mail należy do pierwszego administratora. Jest on przekazywany wraz z przejęciem, a formularz pierwszego administratora wyświetla go jako stałą wartość, bez konieczności ponownego wpisywania.
Odcisk palca (fingerprint) to osiem grup po cztery znaki, stanowiących własną tożsamość instalacji. Proszę zostawić go na ekranie. Porównają go Państwo, grupa po grupie, w przeglądarce.
Przejęcie instalacji
- Na komputerze, z którego będą Państwo korzystać jako pierwszy administrator, proszę otworzyć adres instalacyjny konsoli, tutaj
https://console.harrow.example/install. Przekieruje on Państwa na odpowiednią stronę w zależności od stanu instalacji: stronę przejęcia, gdy jest ona otwarta, stronę pierwszego administratora po jej przejęciu oraz konsolę, jeśli są już Państwo zalogowani. - Na stronie Przejmij tę instalację (Claim this installation) proszę wpisać kod w polach Grupa pierwsza (Group one), Grupa druga (Group two) i Grupa trzecia (Group three), po jednej czteroznakowej grupie w każdym.
- Proszę porównać widoczny na stronie Odcisk palca tej instalacji (Fingerprint of this installation) z terminalem, wszystkie osiem grup, jedna po drugiej.
- Jeśli każda grupa się zgadza, proszę zaznaczyć opcję Wszystkie osiem grup zgadza się z tym, co pokazuje mój terminal (All eight groups match what my terminal shows).
- Proszę nacisnąć Przejmij tę instalację (Claim this installation), a strona potwierdzi przejęcie i przekieruje Państwa do tworzenia pierwszego administratora.
Przejęcie robi trzy rzeczy. Sprawia, że ta przeglądarka staje się jedynym miejscem, w którym można utworzyć pierwszego administratora. Zapisuje w dzienniku audytu, kto i kiedy przejął instalację. Oraz wyłącza stronę przejęcia na stałe. Od tego momentu adres przejęcia odpowiada, że instalacja została już przejęta.
Jeśli odcisk palca się nie zgadza, proszę przerwać
Inny odcisk palca oznacza, że pod tym adresem odpowiada inna instalacja. Może to być błędnie wpisany adres, nieaktualny rekord DNS (Domain Name System) lub maszyna podstawiona w celu przechwycenia pierwszego administratora. Gdyby Państwo ją przejęli, ta maszyna przejęłaby Państwa organizację.
Proszę nie przejmować instalacji i nie wpisywać kodu na tej stronie. Proszę zamknąć stronę, a następnie sprawdzić dwie rzeczy: czy console.harrow.example rozwiązuje nazwę na Państwa ingress oraz czy certyfikat pokazywany przez przeglądarkę został wystawiony przez oczekiwany urząd certyfikacji (CA – certificate authority). Państwa własna instalacja pozostaje niezmieniona i nadal nieprzejęta.
Jeśli żądanie przejęcia zostanie wysłane z odciskiem palca, który nie należy do danej instalacji, usługa kluczy odrzuci je błędem CLAIM_FINGERPRINT_MISMATCH (403). Nic nie zostaje przejęte. Strona wyświetli wówczas oba odciski palca obok siebie z zaznaczonymi różniącymi się grupami oraz instrukcjami, jak sprawdzić adres i certyfikat.
Tworzenie pierwszego administratora i organizacji
Kolejna strona nosi nagłówek „Dwa krótkie formularze i gotowe” (Two short forms, then you are in). Pierwszy administrator może dodać wszystkich pozostałych, a niemal wszystko, co tu wpisano, można później zmienić. Dwóch rzeczy zmienić nie można, a strona wyraźnie je oznacza.
| Pole | Co należy wpisać | Czy można to później zmienić? |
|---|---|---|
| Imię i nazwisko | Państwa imię i nazwisko | Tak |
| Służbowy adres e-mail | Adres, dla którego wygenerowano kod przejęcia, wyświetlony i niewpisywany ponownie | To adres administratora |
| Rola w systemie Nexus | Administrator organizacji. Pierwsza osoba jest zawsze administratorem. | Niewybierane w tym miejscu |
| Druga weryfikacja | Klucz dostępu (passkey) na tym laptopie | Tak, można dodać więcej |
| Nazwa (organizacji) | Harrow Port Authority | Tak |
| Kraj | Siedziba organizacji | Tak |
| Krótka nazwa w adresach | Utworzona z nazwy, na przykład harrow-port-authority |
Nie. Korzystają z niej linki i eksporty. |
| Miejsce przechowywania danych | Ta instalacja | Nie. Późniejsza zmiana oznacza nową instalację. |
| Język i format dat | Angielski (Wielka Brytania), z dzisiejszą datą | Tak |
| Strefa czasowa | Strefa czasowa serwera | Każda osoba widzi czas we własnej strefie |
Krótka nazwa składa się z małych liter, cyfr i myślników, ma do 100 znaków i jest tworzona z nazwy organizacji po usunięciu znaków diakrytycznych. Proszę na nią spojrzeć przed naciśnięciem czegokolwiek. Pojawia się ona w każdym udostępnianym linku i w każdym wykonywanym eksporcie przez cały czas istnienia organizacji.
Na tej stronie ustawiają Państwo również hasło. Nigdy nie wystarcza ono samo w sobie: administrator nigdy nie loguje się wyłącznie za pomocą hasła. Logowanie umożliwia druga weryfikacja, opisana poniżej.
W tym samym czasie tworzone jest awaryjne logowanie administratora. Jest ono zapieczętowane i drukowane jednorazowo, z przeznaczeniem do sejfu. Działa tylko wtedy, gdy firmowe logowanie jest niedostępne, a każde jego użycie jest rejestrowane i ogłaszane wszystkim administratorom. Proszę włożyć je do sejfu w dniu wydrukowania.
Strona informuje również, że firma Adverant nie otrzymuje informacji o tym, kim Państwo są. Dane te pozostają w instalacji. Licencja wskazuje nazwę firmy, a nigdy osoby w niej pracujące.
Proszę nacisnąć Utwórz i zaloguj się (Create and sign in). Utworzenie administratora i organizacji zajmuje kilka sekund. Strona odpowiada: „Utworzono dla aoife.brennan@harrow.example. Teraz skonfiguruj swój klucz dostępu: to za jego pomocą się logujesz” (Made for aoife.brennan@harrow.example. Now set up your passkey: it is how you sign in.).
Klucz dostępu (passkey): drugie sprawdzenie
- Proszę nacisnąć Skonfiguruj klucz dostępu i zaloguj się (Set up the passkey and sign in).
- Przeglądarka poprosi o utworzenie klucza dostępu (passkey). Na laptopie z funkcją Touch ID lub Windows Hello proszę potwierdzić odciskiem palca, twarzą lub kodem PIN. Jeśli komputer nie może sam utworzyć klucza dostępu, przeglądarka wyświetli kod QR (quick response): proszę skierować na niego aparat telefonu i postępować zgodnie z instrukcjami na ekranie telefonu.
- Strona odpowiada: „Twój klucz dostępu jest skonfigurowany i jesteś zalogowany jako aoife.brennan@harrow.example” (Your passkey is set up and you are signed in as aoife.brennan@harrow.example.) i otwiera konsolę.
Od naciśnięcia Utwórz i zaloguj się mają Państwo dziesięć minut na utworzenie klucza dostępu w tej samej przeglądarce. Po tym czasie konfiguracja zostaje zamknięta, a administrator istnieje bez klucza dostępu. Wówczas musi pomóc operator, jak opisano poniżej w sekcji dotyczącej ponawiania prób.
Od tego momentu pierwszy administrator loguje się za pomocą tego klucza dostępu. Hasło pełnego administratora, wpisane samodzielnie, nigdy nie tworzy sesji: usługa logowania odpowiada żądaniem drugiej weryfikacji. Jest to cecha konstrukcyjna systemu i powód, dla którego klucz dostępu jest tak ważny. Utracony klucz dostępu oznacza utratę możliwości wejścia, dlatego już pierwszego dnia warto dodać drugi klucz – na telefonie lub kluczu bezpieczeństwa.
Później użytkownicy logują się do instalacji za pomocą klucza dostępu, konta Google, konta GitHub lub logowania firmowego, w zależności od tego, na co zezwala organizacja.
| Kod | Co to oznacza | Co należy zrobić |
|---|---|---|
PASSKEY_UNSUPPORTED |
Ta przeglądarka nie może utworzyć klucza dostępu. Nic nie zostało skonfigurowane. | Proszę otworzyć stronę w przeglądarce obsługującej klucze dostępu, na tym samym komputerze. |
PASSKEY_CANCELLED |
Okno monitu zostało zamknięte lub nie dokonano wyboru na czas. Nic nie zostało wysłane. | Proszę nacisnąć przycisk ponownie. |
Pierwsza strona Dzisiaj (Today)
Konsola otwiera się na stronie Dzisiaj (Today), a pierwszego dnia prawie wszystko na niej jest puste. Każdy pusty obszar informuje, co się w nim pojawi, i udostępnia przycisk, który to uruchamia – na przykład sekcja „Wymaga administratora” (Needs an administrator) informuje, że będą tam czekać prośby, gdy dołączą użytkownicy, a obok niej znajduje się przycisk Zaproś osoby (Invite people). Lista kontrolna konfiguracji pokazuje, ile kroków zostało wykonanych, w dowolnej kolejności. Jedyna rzeczywista historia, czyli sama konfiguracja, znajduje się już w sekcji „Co się zmieniło” (What changed): skonfigurowano instalację i utworzono klucz dostępu pierwszego administratora.
Sześć kroków przed pierwszym logowaniem użytkowników
Strona Sześć rzeczy przed pierwszym logowaniem (Six things before anyone signs in) wymienia warunki, które muszą zostać spełnione przed zaproszeniem użytkowników. Nie jest to kreator. Można je wykonać w dowolnej kolejności, a strona je zlicza („Spełniono trzy z sześciu” – Three of six true).
| Element | Warunek spełnienia |
|---|---|
| Licencja | Zaimportowano licencję Enterprise. Rozdział 2.13, Licencje. Wersja Community nie wymaga licencji. |
| Adres i certyfikat | Adres publiczny odpowiada certyfikatem z pełnym łańcuchem. |
| Kopie zapasowe | Ustawiono harmonogram tworzenia kopii zapasowych z miejscem docelowym umożliwiającym zapis. |
| Logowanie firmowe | Połączone i przetestowane. Do tego czasu użytkownicy korzystają z kluczy dostępu. |
| Poczta | Skonfigurowano serwer pocztowy. Do tego czasu nie można wysyłać zaproszeń. |
| Model AI | Model AI (artificial intelligence – sztuczna inteligencja): klucz modelu organizacji lub model na własnym sprzęcie. Do tego czasu asystent czeka. Rozdział 2.14, Dostawcy i modele AI. |
Przycisk Zaproś osoby (Invite people) staje się aktywny, gdy wszystkie sześć warunków zostanie spełnionych.
Ta sama strona wymienia elementy, które stają się niezmienne po zalogowaniu się użytkowników, wraz z uzasadnieniem dla każdego z nich: krótka nazwa w adresach, miejsce przechowywania danych oraz depozytariusz kluczy (klucze można przenieść z depozytariusza programowego do sprzętowego, nigdy odwrotnie). Nazwa organizacji również znajduje się na liście, ponieważ warto ją sprawdzić, choć akurat ją można zmienić.
Nexus nie odpowie na żadne zapytanie do AI, dopóki organizacja nie będzie miała modelu. Za instalacją nie kryje się żaden współdzielony klucz ani rozwiązanie awaryjne, więc organizacja bez klucza modelu otrzyma prostą odmowę z informacją dla administratora, co należy dodać.
Logowanie firmowe
Większość organizacji chce, aby użytkownicy logowali się za pomocą kont, które już posiadają. Proszę podłączyć swojego dostawcę tożsamości na stronie logowania firmowego: przez OIDC (OpenID Connect) w wersji Community lub przez OIDC albo SAML (Security Assertion Markup Language) w wersji Enterprise.
- Proszę wybrać dostawcę i używany przez niego standard.
- Proszę wprowadzić identyfikator aplikacji oraz klucz tajny aplikacji otrzymane od dostawcy tożsamości. Po zapisaniu klucz tajny nigdy nie jest wyświetlany ponownie.
- Proszę określić, kto może się logować, na przykład każdy posiadacz adresu w domenie
@harrow.example. - Proszę nacisnąć Testuj logowanie (Test sign-in) i zalogować się na własne konto. Wynik opisuje słownie, kto się zalogował i co przesłał dostawca.
- Proszę zapisać.
Wersja Community udostępnia jedno logowanie firmowe dla organizacji. Wersja Enterprise dodaje wymuszanie oraz synchronizację katalogu. Wymuszanie wyłącza hasła, więc wszyscy muszą korzystać z logowania firmowego, a próba użycia hasła zostaje odrzucona z kodem SSO_REQUIRED i przyciskiem prowadzącym do właściwej metody logowania. Synchronizacja katalogu kopiuje osoby i grupy z Państwa katalogu co 15 minut i może nadawać uprawnienia administratora członkom jednej wskazanej grupy.
Gdy logowanie firmowe przestaje odpowiadać, zalogowane już osoby pozostają zalogowane, a nowe próby logowania są odrzucane z kodem IDP_UNREACHABLE (503). Administrator może wówczas użyć awaryjnego logowania administratora z sejfu wraz ze swoim kluczem dostępu. Każde użycie jest zapisywane w dzienniku audytu, ogłaszane wszystkim administratorom i wygasa po czterech godzinach lub w momencie powrotu działania logowania firmowego.
Zapraszanie użytkowników
Po skonfigurowaniu poczty mogą Państwo zapraszać użytkowników ze strony Osoby (People). Dla każdej osoby należy podać adres e-mail i rolę:
- Członek (Member) korzysta ze wszystkiego, co ma organizacja, i nie zmienia żadnych ustawień.
- Administrator zarządza również osobami, modelami, budżetami i ustawieniami.
Zaproszenie jest ważne przez 7 dni. Osoba otwiera je, widzi, kto ją zaprosił, swoją rolę oraz to, co zobaczy, a następnie się loguje. Przy pierwszym logowaniu wymagana jest druga weryfikacja.
Zaproszeni członkowie logują się do konsoli i wykonują tam swoją codzienną pracę: korzystają ze strony Dzisiaj, asystenta, czatu zespołowego, plików i wyszukiwarki, notatników, agentów oraz przepływów pracy, w zakresie dozwolonym przez ich rolę. Administratorzy widzą również strony administracyjne. Członek, który otworzy stronę administratora, zobaczy stronę „Brak uprawnień administratora” (Not an administrator). Pokazuje ona ustawienia w trybie tylko do odczytu, wyjaśnia przyczynę i oferuje możliwość wysłania prośby do administratora.
Rejestracje wymagają zatwierdzenia
Użytkownicy mogą również poprosić o dołączenie, rejestrując się samodzielnie. W instalacji samodzielna rejestracja obcej osoby nie tworzy działającego konta. Usługa nexus-auth odrzuca ją z kodem SIGNUP_REQUIRES_APPROVAL (403) i wstrzymuje do czasu zatwierdzenia przez administratora.
W usłudze hostowanej przez Adverant istnieją dwa inne zabezpieczenia rejestracji, które w każdej własnej instalacji są wyłączone i nie ma możliwości ich włączenia. Internetowa weryfikacja CAPTCHA wymagałaby dostępu do internetu przy każdej rejestracji. Filtr sieciowy rejestracji wymagałby licencjonowanej bazy danych geolokalizacji, której instalacja nie zawiera. Bramką kontrolną instalacji jest zatwierdzanie przez administratora.
Ponowne próby, wygasłe kody i inne odmowy
Każda odmowa podczas pierwszego uruchomienia informuje, co się stało, potwierdza, że nic się nie zmieniło (tam, gdzie to prawda), i podpowiada, co zrobić dalej.
| Kod | Status | Kiedy | Co należy zrobić |
|---|---|---|---|
CLAIM_CODE_EXPIRED |
410 | Minęło 30 minut. Nic nie zostało przejęte i nic się nie zmieniło. | Proszę wygenerować nowy kod za pomocą nexusctl claim-code --administrator <email>, a następnie nacisnąć Mam nowy kod (I have a new code). |
CLAIM_FINGERPRINT_MISMATCH |
403 | Wysłany odcisk palca nie należy do tej instalacji. | Proszę przerwać. Należy sprawdzić adres i certyfikat. |
TRANSITION_NOT_PERMITTED |
409 | Ponownie zażądano kroku, który już został wykonany: przejęcia dla przejętej już instalacji lub utworzenia pierwszego administratora po raz drugi. | Proszę zalogować się w konsoli; pierwszy administrator dodaje wszystkich pozostałych. |
TRANSITION_NOT_PERMITTED |
409 | Krok z kluczem dostępu wywołany z przeglądarki, w której nie czeka pierwszy administrator, lub po upływie dziesięciu minut. | Patrz poniżej. |
RATE_LIMITED |
429 | Zbyt wiele prób na stronach pierwszego uruchomienia w ciągu minuty. Nic nie zostało wysłane. | Proszę odczekać liczbę sekund podaną na stronie, a następnie spróbować ponownie. |
Kod bez pozostałych prób wyświetla komunikat „Ten kod nie ma już dostępnych prób” (This code has no tries left). Proszę wygenerować nowy kod, tak samo jak w przypadku kodu przeterminowanego. Może to zrobić tylko osoba z dostępem do klastra, o co właśnie chodzi.
Strony pierwszego uruchomienia przyjmują łącznie 20 prób na minutę. Jeśli to nie Państwo wykonywali te próby, oznacza to, że ktoś inny w Państwa sieci próbuje uzyskać dostęp do strony, o czym warto wiedzieć.
Gdy pominięto krok z kluczem dostępu
Jeśli pierwszy administrator został utworzony, ale w ciągu dziesięciu minut nie utworzono klucza dostępu lub zamknięto przeglądarkę, administrator istnieje, ale nie ma możliwości zalogowania się. Krok konfiguracji klucza dostępu odpowiada błędem TRANSITION_NOT_PERMITTED ze słowami: „Jeśli utworzyłeś pierwszego administratora w tej przeglądarce ponad dziesięć minut temu, poproś operatora: administrator istnieje i nie ma jeszcze klucza dostępu” (If you made the first administrator in this browser over ten minutes ago, ask an operator: the administrator exists and has no passkey yet). Przejęcie zostało już w tym momencie wykorzystane, więc nowy kod przejęcia nie pomoże. Przed podjęciem jakichkolwiek innych prób proszę zwrócić się do operatora, który przeprowadzał instalację.
Gdy przeglądarka utraciła przejęcie
Przejęcie jest zapisane w przeglądarce, w której go dokonano, w pliku cookie, którego strona nie może odczytać. Jeśli przeglądarka utraci je między przejęciem a utworzeniem pierwszego administratora – na przykład w oknie prywatnym, które zostało zamknięte – formularz pierwszego administratora akceptuje również plik przejęcia i jego tajny klucz konfiguracji, wklejone ręcznie.
Gdy Aoife miała już swój klucz dostępu, Tomás zamknął terminal. Strona przejęcia była wyłączona, pierwszy administrator istniał, a każda kolejna droga wejścia prowadziła teraz przez nią.






