Zaloguj sięUmów spotkanie

Rozdział 2.13

Licencje

Co zawiera plik licencji Nexus, jak instalacja sprawdza go w trybie offline, w jakich sześciu stanach może się znajdować oraz jak wystąpić o licencję, zaimportować ją, odnowić i wycofać.

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

Czas czytania: 19 min

Harrow Port Authority uruchamia system Nexus Enterprise na własnym klastrze Kubernetes pod adresem harrow.example, bez trasy z klastra do internetu. Co roku Aoife Brennan, szefowa działu IT, odnawia umowę, a Tomás Reilly, inżynier platformy, przenosi mały plik JSON przez granicę sieci i go importuje. Nic nie uruchamia się ponownie, a strona licencji pokazuje nową datę końcową.

Ten rozdział dotyczy właśnie tego pliku. W skrócie: licencja to pojedynczy podpisany dokument JSON powiązany z jedną instalacją. Instalacja sprawdza go samodzielnie za pomocą kluczy publicznych wbudowanych w obraz i nie wykonuje przy tym żadnego połączenia sieciowego. Licencja nigdy nie jest wartością Helm ani zamontowanym plikiem. Importują ją Państwo przez konsolę, nexusctl lub interfejs programowania aplikacji (API) i nigdzie indziej.

Dokument licencji

Licencja to pojedynczy obiekt JSON w formacie nexus-licence/v1. Oto licencja Harrow ze skróconymi dwiema wartościami podpisów.

{
  "format": "nexus-licence/v1",
  "licence_id": "8c1e4f2a-6b0d-4e7a-9f31-2d5c7a9e0b14",
  "issued_at": "2026-12-14T10:20:00Z",
  "type": "alpha",
  "channel": "alpha",
  "licensee": { "name": "Harrow Port Authority", "customer_id": "harrow-port-authority" },
  "scope": {
    "deployment": { "installation_id": "4b7d2e90-1c5a-4f8e-a3d6-7e0b9c2f5a18" },
    "tenants": []
  },
  "edition": "enterprise",
  "grants": [
    { "feature_group": "enterprise-base", "scope": "deployment" },
    { "feature_group": "map-and-geoai", "scope": "deployment" }
  ],
  "add_ons": ["mail"],
  "domain_packs": ["logistics-and-maritime"],
  "metric": { "kind": "per-environment", "quantity": 1 },
  "term": { "starts_on": "2027-01-01", "ends_on": "2027-12-31", "warn_days": 30, "grace_days": 30 },
  "matrix": { "version": 1, "sha256": "<64 lower-case hexadecimal characters>" },
  "signatures": {
    "ed25519": { "key_id": "licence-ed-2026a", "sig": "<86 characters>" },
    "p256": { "key_id": "licence-p256-2026a", "sig": "<86 characters>" }
  }
}

Każde pole jest wymagane, a każdy obiekt w dokumencie jest zamknięty. Element niewymieniony w formacie zostaje odrzucony, dzięki czemu nic nie może zostać przemycone poza podpisem.

Pole Co zawiera
format Dokładnie nexus-licence/v1. Każda inna wartość, w tym nowsza wersja, zostaje odrzucona.
licence_id Identyfikator UUID (uniwersalnie unikalny identyfikator) zapisany małymi literami. Instalacja importuje każdy identyfikator licencji tylko raz.
issued_at Moment wydania licencji przez Adverant, w formacie YYYY-MM-DDThh:mm:ssZ.
type alpha, evaluation lub commercial.
channel Kanał wydawniczy, dla którego wydano licencję, np. alpha. Podpisany i przenoszony z dokumentem; weryfikacja nie zależy od tej wartości.
licensee.name Od 1 do 200 znaków, podpisane dokładnie tak, jak zapisano. Brennan i Brennán to dwie różne nazwy z dwoma różnymi podpisami.
licensee.customer_id Państwa identyfikator klienta w Adverant: małe litery, cyfry, ., _ i -.
scope.deployment.installation_id Tożsamość instalacji, wygenerowana przez jej usługę kluczy podczas pierwszej instalacji.
scope.tenants Identyfikatory organizacji, do 1,000. Puste, chyba że któreś z uprawnień ma zasięg ograniczony do dzierżawcy (tenant-scoped).
edition enterprise lub team. Licencja Enterprise zawsze przyznaje enterprise-base.
grants Od 1 do 500 par {feature_group, scope}, każda grupa wymieniona raz.
add_ons Identyfikatory dodatków z macierzy edycji, do 100. Może być puste.
domain_packs Identyfikatory pakietów domenowych z macierzy edycji, do 100. Może być puste.
metric kind to per-environment, per-core lub named-seat; quantity to liczba całkowita od 1.
term starts_on i ends_on to daty; warn_days i grace_days to liczby całkowite od 0 do 365.
matrix Wersja macierzy edycji, względem której zapisano grupy, oraz skrót SHA-256 pliku tej macierzy, zachowane do celów audytu.
signatures Dwa podpisy, ed25519 i p256. Jedyne pole, które nie jest podpisywane.

Daty są datami kalendarzowymi w strefie UTC, a dany dzień musi istnieć: wartość 2028-02-29 jest prawidłowa, natomiast 2027-02-29 zostaje odrzucona.

Dwa podpisy, oba wymagane

Adverant podpisuje każdą licencję dwoma niezależnymi kluczami. Jeden podpis to Ed25519. Drugi to ECDSA (Elliptic Curve Digital Signature Algorithm) na krzywej P-256 od NIST (amerykańskiego Narodowego Instytutu Standardów i Technologii), o który proszą nabywcy wymagający algorytmów federalnych USA. Oba są tworzone na podstawie tych samych bajtów i oba muszą przejść weryfikację. Dokument, w którym brakuje jednej połowy lub którakolwiek połowa jest nieprawidłowa, jest traktowany tak, jakby licencji nie było wcale.

Podpisane bajty stanowią postać kanoniczną dokumentu zgodną ze standardem RFC 8785 z pominięciem pola signatures, dzięki czemu białe znaki i kolejność elementów w pliku nie mają znaczenia. Zmiana pojedynczego znaku w nazwie licencjobiorcy, datach lub uprawnieniu tworzy inny dokument, który nie przechodzi weryfikacji.

Klucze publiczne używane podczas sprawdzania znajdują się w pliku głównych certyfikatów zaufania (trust-roots) wbudowanym w każdy obraz podczas kompilacji wydania. Żadna zmienna środowiskowa, flaga ani montowanie nie może wskazać innego pliku. Gdy Adverant zastępuje klucz podpisujący, stary klucz podpisuje nowy, a kolejne podpisane wydanie zawiera już nowy klucz. Licencja podpisana nowym kluczem przechodzi weryfikację w wydaniu, które go zawiera, więc po zmianie klucza przed zaimportowaniem licencji może być konieczna aktualizacja systemu (zob. rozdział 2.17, Rozwiązywanie problemów).

Typy, edycje i sposób rozliczania licencji

Pole type określa, z jakiego rodzaju umowy pochodzi licencja:

  • alpha: licencja dla kanału wydawniczego alpha, czyli taka, jaką posiada Harrow.
  • evaluation: wersja próbna edycji Enterprise utrzymywana na własnej infrastrukturze (self-hosted). Działa przez maksymalnie 30 dni, dla maksymalnie 5 nazwanych osób (metryka named-seat), z wartością grace_days ustawioną na 0. Format odrzuca licencję ewaluacyjną z jakimkolwiek okresem prolongaty.
  • commercial: licencja objęta umową.

Pole metric zapisuje sposób rozliczania licencji: per-environment (klaster produkcyjny Harrow to jedno środowisko), per-core lub named-seat. Adverant wycenia licencję; sam dokument zawiera jedynie jednostkę miary oraz ilość.

Wartość edition licencji to enterprise dla każdej instalacji Enterprise. Format akceptuje również team, gdzie licencja przyznaje grupę team, a nigdy enterprise-base.

Grupy funkcji, dodatki i pakiety domenowe

To, z czego użytkownicy mogą korzystać w ramach licencji, jest wymienione według grup funkcji przy użyciu identyfikatorów z macierzy edycji. Licencja Harrow przyznaje enterprise-base (role niestandardowe, zatwierdzenia metodą czterech oczu, długie przechowywanie dzienników audytu, logowanie firmowe z wymuszaniem i synchronizacją katalogów, jednostki biznesowe, strony operatora oraz resztę podstawy edycji Enterprise) oraz map-and-geoai. Obejmuje ona dodatek mail oraz pakiet domenowy logistics-and-maritime.

Macierz określa reguły dotyczące tego, co z czym się łączy, a system wydawania licencji Adverant sprawdza je przed podpisaniem dokumentu. Każdy dodatek i każdy pakiet wymaga enterprise-base. Niektóre pakiety wymagają dodatków: pakiet Logistics and maritime wymaga Map and GeoAI, pakiety Insurance oraz Capital markets and asset management wymagają Decision rooms and sealed records, a pakiet Legal and professional services wymaga Decision rooms oraz Mail. Ekrany telefoniczne każdego pakietu wymagają również dodatku Mobile apps.

Każde uprawnienie ma określony zasięg:

  • deployment: grupa ma zastosowanie do całej instalacji, dla każdej znajdującej się na niej organizacji.
  • tenant: grupa ma zastosowanie wyłącznie do organizacji wymienionych w scope.tenants. Licencja z uprawnieniem ograniczonym do dzierżawcy musi wymieniać co najmniej jedną organizację, a lista organizacji bez żadnego uprawnienia ograniczonego do dzierżawcy zostaje odrzucona.

Załóżmy, że zespół pilotażowy Harrow działa jako druga organizacja na tej samej instalacji i tylko ta organizacja ma posiadać moduł Ideas. Uprawnienie miałoby postać { "feature_group": "ideas", "scope": "tenant" }, z identyfikatorem organizacji pilotażowej w scope.tenants. Gdyby licencja została zaimportowana przed utworzeniem tej organizacji, odpowiedź z importu uwzględniłaby ją w tenants_without_organisation, a uprawnienie objęłoby ją z chwilą utworzenia organizacji.

Administrator może zawęzić zasięg działania grupy. Dodanie grupy jest możliwe wyłącznie za pomocą licencji od Adverant.

Licencja i to, co odblokowuje
Licencja i to, co odblokowuje
Strona licencji wymienia każdą grupę funkcji wraz ze sposobem jej ochrony i zakresem. Grupy, których licencja nie obejmuje, pozostają na liście wyszarzone, aby użytkownicy widzieli, jakie funkcje istnieją.

Okres obowiązywania: ostrzeżenie i okres karencji

Obiekt term wyznacza cztery daty w kalendarzu. Od starts_on do ends_on licencja obowiązuje. Pole warn_days określa, jak wcześnie zaczyna się wyświetlanie ostrzeżenia, a grace_days – jak długo wszystko nadal działa po dacie końcowej. Licencje wydawane przez Adverant mają po 30 dni dla każdego z tych okresów, chyba że umowa stanowi inaczej. Licencja ewaluacyjna zawsze ma grace_days równe 0.

Dla powyższej licencji Harrow kalendarz wygląda następująco:

Daty Stan
1 stycznia 2027 r. do 1 grudnia 2027 r. VALID
2 grudnia 2027 r. do 31 grudnia 2027 r. WARN
1 stycznia 2028 r. do 30 stycznia 2028 r. GRACE
Od 31 stycznia 2028 r. RESTRICT

Ostatni dzień okresu obowiązywania, ends_on, jest nadal dniem w stanie WARN. Dzień po nim to GRACE lub RESTRICT, gdy nie ma okresu prolongaty.

Sześć stanów

Za każdym razem, gdy licencja jest odczytywana, instalacja ponownie oblicza jej stan na podstawie dokumentu i bieżącej daty. Nic nie jest buforowane po przekroczeniu granicy dnia, dzięki czemu wygaśnięcie następuje punktualnie bez konieczności uruchamiania zaplanowanego zadania.

Stan Kiedy Co mogą robić użytkownicy
ABSENT Nie zaimportowano licencji lub dokument został odrzucony Poziom podstawowy Community. Obszary Enterprise są widoczne jako zapowiedzi z informacją, kto może je włączyć.
VALID Od starts_on do ends_on minus warn_days Każda przyznana grupa jest aktywna.
WARN Ostatnie warn_days dni okresu obowiązywania Uprawnienia są aktywne, a administratorzy widzą w produkcie baner z datą końcową.
GRACE Po ends_on, przez grace_days dni Uprawnienia są aktywne, z powiadomieniem LICENCE_IN_GRACE na stronie Today oraz na stronie licencji.
RESTRICT Po okresie prolongaty Nie można rozpocząć żadnej nowej pracy w ramach licencjonowanej grupy. Bieżąca praca zostaje dokończona, odczyt i eksport nadal działają, a poprawki bezpieczeństwa wciąż są dostarczane.
TERMINATE Adverant unieważnił licencję Artefakty Enterprise przestają być oferowane. Poziom podstawowy Community oraz eksport danych pozostają dostępne.

W każdym stanie bieżąca praca jest kontynuowana, poprawki bezpieczeństwa wciąż docierają, eksporty pozostają czytelne i nic nie jest usuwane. W stanie RESTRICT osoba próbująca rozpocząć nową pracę w ramach funkcji Enterprise widzi planszę odmowy z kodem LICENCE_LOCKED oraz imieniem i nazwiskiem osoby mogącej odnowić licencję.

Pozioma oś czasu z pięcioma pasmami od lewej do prawej: VALID (od starts_on), WARN (ostatnie warn_days okresu obowiązywania), GRACE (grace_days po ends_on), RESTRICT (po okresie prolongaty). Pod pasmami trzy opisane znaczniki: starts_on, ends_on oraz ends_on + grace_days. Osobne pole poniżej osi czasu, połączone przerywaną strzałką z dowolnym pasmem, ma etykietę TERMINATE (podpisana lista unieważnień wymienia licencję). Drugie pole skrajnie po lewej stronie, poza osią czasu, ma etykietę ABSENT (brak licencji lub licencja odrzucona: poziom podstawowy Community).
Stany licencji na osi kalendarza.

Jak wyznaczana jest bieżąca data

Zegar może się mylić i może też zostać celowo cofnięty. Dlatego instalacja nigdy nie polega wyłącznie na odczycie zegara. Bieżąca data to późniejszy z dwóch momentów: czas zegara systemowego oraz zapisany próg dolny (floor), będący najpóźniejszym momentem, jaki instalacja dotąd odnotowała. Próg ten przesuwa się do przodu przy każdym imporcie i każdym odczycie stanu, ale nigdy samoczynnie się nie cofa. Cofnięcie zegara o miesiąc nie przywraca wygasłej licencji do stanu VALID; licencja w stanie RESTRICT pozostaje w stanie RESTRICT.

Gdy zegar wskazuje czas wcześniejszy niż zapisany próg dolny, stan zawiera powiadomienie LICENCE_CLOCK_BEHIND_FLOOR i jest odczytywany według dnia tego progu. Jeśli zegar faktycznie spieszył (węzeł uruchomił się z błędną datą i próg dolny został przesunięty do przodu), należy poprosić Adverant o token resetowania czasu. Jest to mały podpisany dokument powiązany z identyfikatorem Państwa instalacji oraz jednorazową wartością nonce, zawierający znacznik czasu floor_to. Importuje się go przez API za pomocą następującego żądania:

curl --fail-with-body -X POST https://auth.harrow.example/api/v1/installation/licence/time-reset \
  -H "Authorization: Bearer <access-token>" \
  -H "Content-Type: application/json" \
  --data-binary @harrow-time-reset.json

<access-token> to token dostępu administratora instalacji. Token zostaje zastosowany, gdy oba podpisy przejdą weryfikację, identyfikator instalacji jest zgodny z Państwa instalacją, a wartość nonce nie została wcześniej użyta. Odrzucony token niczego nie zmienia, więc nigdy nie można go użyć do unieważnienia prawidłowej licencji. Token, którego wartość nonce została już użyta, zostaje odrzucony z kodem LICENCE_CLOCK_BEHIND_FLOOR.

Występowanie o licencję

Licencje zamawia się i pobiera z konta Adverant pod adresem https://account.adverant.ai. To, kto w Państwa organizacji może przypisywać wdrożenia i pobierać licencje, ustawia się na stronie konta Organisation and team roles.

Adverant musi wiedzieć, dla której instalacji przeznaczona jest licencja – istnieją trzy sposoby, aby tę informację przekazać.

Jednorazowy kod – dla instalacji z ekranem. Instalacja wyświetla jednorazowy kod oraz swój odcisk klucza (fingerprint). Na stronie Claim a deployment wklejają Państwo kod, a następnie porównują odcisk klucza grupa po grupie z tym, co wyświetla instalacja. Gdy każda grupa się zgadza, przypisują Państwo instalację do swojej organizacji, a licencja pojawia się na koncie.

Klucz przypisania (claim key) – dla urządzenia typu appliance lub urządzenia brzegowego (edge). Urządzenia te nie mają ekranu, na którym mogłyby wyświetlić kod. Numer seryjny i klucz przypisania są wydrukowane na opakowaniu oraz w zamówieniu od producenta sprzętu. Należy wprowadzić je pojedynczo na stronie Enter a claim key lub przeciągnąć plik zamówienia od producenta, aby przypisać wiele urządzeń naraz. Każdy klucz jest sprawdzany względem rejestru wysłanego do Państwa sprzętu w Adverant, a klucz z cudzego zamówienia zostaje odrzucony.

Podpisane żądanie licencji – dla instalacji bez połączenia ze światem zewnętrznym. To ścieżka, z której korzysta Harrow. W instalacji administrator tworzy plik żądania w sekcji This installation, Licence. Jest to oświadczenie typu licence-request wskazujące identyfikator instalacji, podpisane własnym kluczem Ed25519 instalacji. Tomás wynosi je na zatwierdzonym nośniku, upuszcza na stronie Offline exchange i pobiera zwrócony plik licencji. Licencja działa wyłącznie na instalacji, która wygenerowała żądanie.

Wymiana offline
Wymiana offline
Wymiana offline dla instalacji bez połączenia zewnętrznego. Każdy plik przenoszony przez granicę sieci jest podpisany, dzięki czemu plik zmodyfikowany po drodze zostaje odrzucony, a każda wymiana jest rejestrowana wraz z informacją o tym, kto jej dokonał.
Dwie kolumny, lewa oznaczona jako „Instalacja w Harrow (brak internetu)”, a prawa jako „Konto Adverant”. Na górze po lewej: pole „Plik żądania licencji, podpisany kluczem instalacji”. Strzałka oznaczona jako „przeniesiony na nośniku” przechodzi do pola w prawej kolumnie „Strona wymiany offline”. Poniżej znajduje się pole „Plik licencji, podpisany dwoma kluczami Adverant”. Strzałka oznaczona jako „przeniesiony z powrotem na nośniku” wraca do pola w lewej kolumnie „Import: konsola, nexusctl lub API”, a stamtąd prowadzi w dół do pola „Sprawdzony na instalacji względem wbudowanych głównych certyfikatów zaufania”.
Jak licencja trafia do instalacji bez połączenia zewnętrznego.

Importowanie licencji

Istnieją trzy drogi wejścia i wszystkie prowadzą do tego samego punktu końcowego w usłudze nexus-auth. Zaimportować licencję może wyłącznie administrator instalacji: właściciel lub administrator całej organizacji będącej właścicielem instalacji (zalogowany do niej) albo pełny administrator platformy. Każda inna osoba zostaje odrzucona jeszcze przed odczytaniem pliku.

W konsoli

W nowej instalacji krok Import the licence jest jednym z sześciu punktów kontrolnych na stronie Six things before anyone signs in. Gdy upuszczą Państwo plik na stronie, konsola sprawdza go w ramach instalacji w trybie offline i wyświetla listę grup funkcji wraz ze sposobem ochrony każdej z nich oraz okresem obowiązywania.

Późniejsze importy odbywają się przez sekcję This installation, Licence: należy użyć opcji Import a new licence lub Import a renewed licence, gdy obecna licencja wygasła. Instalacja Community przechodząca na edycję Enterprise korzysta ze strony From Community to Enterprise. Strona ta najpierw odczytuje licencję i pokazuje, co zostanie pobrane oraz co się zmieni, zanim cokolwiek nastąpi. Nic nie jest pobierane, dopóki ktoś nie wybierze opcji Fetch and switch on. Wówczas komponenty Enterprise są pobierane z registry.adverant.ai przy użyciu tokenu pobierania (pull token) instalacji, każdy z nich jest weryfikowany względem klucza wydania Adverant, a grupy włączają się jedna po drugiej. Po zakończeniu jest to nadal ta sama instalacja, z tymi samymi ludźmi, plikami, przepływami pracy i kanałami.

Zaimportuj licencję
Zaimportuj licencję
Importowanie licencji podczas konfiguracji. Prawidłowy plik wyświetla listę swoich grup funkcji; kopia z dwoma zmienionymi wierszami jest pokazywana jako brakująca z kodem LICENCE_SIGNATURE_INVALID, a dotychczas obowiązująca licencja pozostaje nienaruszona.
Z Community do Enterprise
Z Community do Enterprise
Przenoszenie instalacji Community do edycji Enterprise. Licencja została odczytana i uznana za autentyczną, a strona wyświetla listę elementów do pobrania oraz zmian, zanim ktokolwiek naciśnie przycisk Fetch and switch on.

Za pomocą nexusctl

nexusctl licence import harrow-2027.licence.json

Polecenie importuje plik bez zmian i wypisuje bieżący stan licencji. Dodanie flagi --explain powoduje wypisanie operacji, które zostałyby wykonane, bez ich faktycznego uruchamiania.

Przez API

curl --fail-with-body -X POST https://auth.harrow.example/api/v1/installation/licence \
  -H "Authorization: Bearer <access-token>" \
  -H "Content-Type: application/json" \
  --data-binary @harrow-2027.licence.json

Plik należy przesłać dokładnie w takiej postaci, w jakiej otrzymali go Państwo od Adverant. Nie należy go formatować na nowo ani opakowywać w inny obiekt: treść żądania (body) stanowi sam dokument. Ścieżka nie przyjmuje parametrów zapytania (query string), a treść przekraczająca 1 MiB zostaje odrzucona. Element najwyższego poziomu wskazujący organizację lub osobę zostaje odrzucony z kodem TENANT_NOT_A_PARAMETER lub ACTOR_NOT_A_PARAMETER, ponieważ licencja instalacji należy do instalacji będącej własnością organizacji powiązanej z tokenem.

Prawidłowy import zwraca odpowiedź 201. Treść odpowiedzi zawiera widok licencji (jej identyfikator, bieżący stan, licencjobiorcę, edycję, okres obowiązywania, uprawnienia oraz grupy funkcji), liczbę organizacji, które obecnie ją posiadają, oraz liczbę wymienionych dzierżawców, którzy nie mają jeszcze utworzonej organizacji. Licencja, jej skrót SHA-256 oraz wiersze księgi dla każdej organizacji są zapisywane w jednej transakcji, a sam import jest rejestrowany w dzienniku audytu.

Towarzyszą temu dwie ścieżki odczytu:

  • GET /api/v1/installation/licence/state zwraca stan obliczany na nowo przy każdym odczycie. Administrator otrzymuje pełny widok. Każdy inny członek organizacji w danej instalacji otrzymuje wyłącznie powiadomienie: stan, kod powiadomienia (LICENCE_ENDS_SOON, LICENCE_IN_GRACE lub LICENCE_CLOCK_BEHIND_FLOOR) oraz daty wskazane w powiadomieniu. Zwykły członek nigdy nie widzi licencjobiorcy, okresu obowiązywania ani grup, ponieważ informacje te należą do właściciela instalacji.
  • GET /api/v1/installation/licence/document zwraca zaimportowany dokument w postaci surowej dla administratorów. Każdy moduł Enterprise pobiera go i ponownie sprawdza podpisy za pomocą własnego, wkompilowanego weryfikatora, dzięki czemu zmodyfikowana usługa tożsamości nie może włączyć grupy, której licencja nie przyznaje.

Każda odmowa

Odrzucony import niczego nie zmienia – nawet progu dolnego zegara – a odmowa zostaje zapisana w dzienniku audytu.

Kod HTTP Znaczenie Co należy zrobić
LICENCE_FORMAT_INVALID 422 Plik nie jest licencją, którą ta kompilacja potrafi odczytać: nie jest to format JSON, jest niezgodny ze schematem, daty są w złej kolejności lub grupa została wymieniona dwukrotnie. Prześlij plik dokładnie w takiej postaci, w jakiej przekazał go Adverant.
LICENCE_SIGNATURE_INVALID 422 Brakuje jednego z dwóch podpisów lub plik został zmieniony po podpisaniu. Poproś Adverant o ponowne przesłanie pliku i nie edytuj go.
LICENCE_ROOT_UNKNOWN 422 Plik został podpisany kluczem, którego nie ma w głównych certyfikatach zaufania tego wydania. Poproś o licencję podpisaną dla certyfikatów głównych tego wydania lub zaktualizuj system.
LICENCE_MATRIX_MISMATCH 422 Licencja została wystawiona względem macierzy edycji, której ta kompilacja nie odczytuje, lub przyznaje grupę nieznaną w katalogu tej kompilacji. Zaktualizuj system do wydania, które ją odczytuje, lub poproś o licencję wystawioną dla bieżącego wydania.
LICENCE_OTHER_INSTALLATION 409 Licencja została wydana dla innego identyfikatora instalacji. Poproś o licencję dla tożsamości tej instalacji.
LICENCE_REVOKED 403 Adverant wycofał tę licencję. Poproś Adverant o nową licencję.
LICENCE_LOCKED 403 Okres obowiązywania licencji jeszcze się nie rozpoczął: bieżąca data jest wcześniejsza niż starts_on. Zaimportuj ją ponownie w pierwszym dniu obowiązywania lub później.
TRANSITION_NOT_PERMITTED 409 Licencja o tym identyfikatorze została już wcześniej zaimportowana. Poproś Adverant o nową licencję, jeśli warunki muszą ulec zmianie.
RECORD_NOT_FOUND 404 Instalacja nie została jeszcze zadeklarowana, więc nie ma tożsamości, względem której można przeprowadzić weryfikację. Dokończ pierwszy krok konfiguracji administratora, a następnie zaimportuj licencję.
VALIDATION_FAILED 400 Nie udało się odczytać treści żądania, jej rozmiar przekracza 1 MiB lub żądanie zawierało parametry zapytania. Wyślij sam plik jako treść żądania, bez parametrów zapytania.

Instalacja wykonuje sprawdzenia w ustalonej kolejności, a pierwszy napotkany błąd określa zwracany kod. Brakująca połowa podpisu jest zgłaszana przed nieznanym kluczem, a dokument, którego podpisy nie przejdą weryfikacji, nie jest dalej odczytywany – dlatego zmodyfikowany plik, który jednocześnie wskazuje inną instalację, nadal zwraca kod LICENCE_SIGNATURE_INVALID.

Odnowienie

Odnowienie to nowa licencja z nowym identyfikatorem licence_id. Importuje się ją w taki sam sposób jak pierwszą. Zaczyna obowiązywać natychmiast, niezależnie od stanu, jaki osiągnęła poprzednia licencja: ze stanu WARN, GRACE lub RESTRICT instalacja od razu wraca do stanu licencjonowanego i nic nie wymaga ponownej instalacji. Adverant może również wydać zmienioną licencję w trakcie okresu obowiązywania, na przykład w celu dodania modułu Decision rooms – taką licencję importuje się dokładnie tak samo.

Dwukrotne zaimportowanie tej samej licencji zostaje odrzucone z kodem TRANSITION_NOT_PERMITTED.

Unieważnienie

Adverant wycofuje licencję, podpisując listę unieważnień (revocation list). Lista posiada numer sequence i wymienia każdy wycofany identyfikator licencji wraz z czasem i powodem unieważnienia. Listy mają charakter zbiorczy: każda kolejna zawiera wszystkie identyfikatory unieważnione wcześniej. Importuje się ją w taki sam sposób jak licencję:

curl --fail-with-body -X POST https://auth.harrow.example/api/v1/installation/licence/revocations \
  -H "Authorization: Bearer <access-token>" \
  -H "Content-Type: application/json" \
  --data-binary @revocations-12.json

Lista, której numer kolejny nie jest wyższy niż ostatnio zaimportowanej, zostaje odrzucona z kodem TRANSITION_NOT_PERMITTED, dzięki czemu starszej listy nie można podstawić w miejsce nowszej. Lista, której nie da się odczytać lub która nie przechodzi weryfikacji, zostaje odrzucona z takimi samymi kodami jak licencja. Gdy lista wymienia Państwa licencję, jej stan zmienia się na TERMINATE.

Instalacja bez połączenia zewnętrznego dowiaduje się o unieważnieniu dopiero wtedy, gdy ktoś zaimportuje listę. W przypadku Harrow unieważnienie jest w równym stopniu kwestią umowy, co oprogramowania, a Tomás importuje każdą listę przesłaną przez Adverant przy kolejnym przenoszeniu danych.

Liczba stanowisk przekraczająca licencję

Liczba stanowisk w licencji stanowi zobowiązanie dotyczące skali wykorzystania, a Nexus traktuje jej przekroczenie jako ostrzeżenie, a nigdy jako blokadę dostępu. Gdy z systemu Nexus korzysta więcej osób, niż obejmuje licencja, administratorzy widzą na stronie People planszę SEATS_OVER_LICENCE. Wszyscy nadal mogą pracować. Plansza informuje, do kiedy należy uregulować sytuację (30 dni), pokazuje, skąd wzięły się dodatkowe osoby, i oferuje dwa rozwiązania: usunięcie osób, które nie potrzebują dostępu do systemu Nexus, lub zwrócenie się do Adverant o dodatkowe stanowiska (seats). Dodanie stanowisk to wrażliwa zmiana wymagająca zatwierdzenia przez drugą osobę, a dodatkowe stanowiska są uwzględniane w rocznym zestawieniu wykorzystania.

Stanowiska ponad licencję
Stanowiska ponad licencję
Więcej osób niż stanowisk. Synchronizacja katalogów dodała 143 współpracowników kontraktowych, a plansza daje 30 dni na usunięcie osób lub dodanie stanowisk, przy czym nikt nie zostaje zablokowany.

Zestawienie wykorzystania zawiera wyłącznie liczniki, a przed wysłaniem mogą Państwo przeczytać każdy jego wiersz. Harrow zapisuje je jako plik i wynosi przez mechanizm wymiany offline.

Wersje testowe

Licencja ewaluacyjna to licencja typu evaluation, uruchamiana ze strony Trials na koncie dla przypisanego wdrożenia. Trwa maksymalnie 30 dni, obejmuje najwyżej 5 nazwanych osób i nie ma okresu prolongaty. W dniu następującym po ends_on przechodzi bezpośrednio w stan RESTRICT: obszary Enterprise znów stają się zapowiedziami, ale nic, co utworzono podczas ewaluacji, nie zostaje usunięte. Przebiegi w module Ideas, przygotowane projekty polityk i reguły pocztowe zostają zachowane dokładnie w takim stanie, w jakim były, i otwierają się ponownie po zaimportowaniu licencji.

Organizacja może prowadzić jednocześnie jedną ewaluację utrzymywaną na własnej infrastrukturze (self-hosted).