Версия 1.0.0-alpha.1последно
Глава 2.13
Лицензи
Какво съдържа лицензионният файл на Nexus, как инсталацията го проверява офлайн, шестте състояния, в които може да се намира, и как да заявите, импортирате, подновите и оттеглите лиценз.
Тази страница е преведена от ИИ от английския оригинал. Ако нещо е неясно, английската страница е референтна. Прочетете тази страница на английски

Harrow Port Authority изпълнява Nexus Enterprise на собствен Kubernetes клъстер на harrow.example, без връзка от клъстера към интернет. Всяка година Aoife Brennan, ръководител на ИТ отдела, подновява договора, а Tomás Reilly, платформеният инженер, пренася малък JSON файл през въздушната междина и го импортира. Нищо не се рестартира, а страницата с лиценза показва нова крайна дата.
Тази глава е за този файл. Накратко, лицензът е един подписан JSON документ, обвързан с една инсталация. Инсталацията го проверява сама чрез публични ключове, вградени в образа, и не прави мрежови заявки за това. Лицензът никога не е стойност в Helm и никога не е монтиран файл. Импортирате го през конзолата, nexusctl или програмния интерфейс за приложения (API), и от никъде другаде.
Лицензионният документ
Лицензът е един JSON обект във формат nexus-licence/v1. Ето този на Harrow, като двете стойности на подписите са съкратени.
{
"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>" }
}
}Всяко поле е задължително и всеки обект в документа е затворен. Елемент, който не е описан във формата, се отхвърля, така че нищо не може да бъде добавено извън подписа.
| Поле | Какво съдържа |
|---|---|
format |
Точно nexus-licence/v1. Всяка друга стойност, включително по-нова версия, се отхвърля. |
licence_id |
UUID (универсално уникален идентификатор) с малки букви. Една инсталация импортира всеки идентификатор на лиценз по веднъж. |
issued_at |
Моментът, в който Adverant го е издал, като YYYY-MM-DDThh:mm:ssZ. |
type |
alpha, evaluation или commercial. |
channel |
Каналът на изданието, за който е издаден, например alpha. Подписан и пренесен; проверката не се разклонява спрямо него. |
licensee.name |
От 1 до 200 знака, подписани точно както са изписани. Brennan и Brennán са две различни имена с два различни подписа. |
licensee.customer_id |
Вашият клиентски идентификатор в Adverant: малки букви, цифри, ., _ и -. |
scope.deployment.installation_id |
Идентичността на инсталацията, създадена от нейната услуга за ключове при първото инсталиране. |
scope.tenants |
Идентификатори на организации, до 1,000. Празно, освен ако някое предоставено право не е с обхват на наемател. |
edition |
enterprise или team. Лицензът за Enterprise винаги предоставя enterprise-base. |
grants |
От 1 до 500 двойки {feature_group, scope}, като всяка група е посочена веднъж. |
add_ons |
Идентификатори на добавки от матрицата на изданията, до 100. Може да е празно. |
domain_packs |
Идентификатори на домейн пакети от матрицата на изданията, до 100. Може да е празно. |
metric |
kind е per-environment, per-core или named-seat; quantity е цяло число от 1 нагоре. |
term |
starts_on и ends_on са дати; warn_days и grace_days са цели числа от 0 до 365. |
matrix |
Версията на матрицата на изданията, спрямо която са записани групите, и SHA-256 хешът на този матричен файл, запазени за одит. |
signatures |
Два подписа, ed25519 и p256. Единственото поле, което не е подписано. |
Датите са календарни дати в UTC и денят трябва да съществува: 2028-02-29 се приема, а 2027-02-29 се отхвърля.
Два подписа, и двата задължителни
Adverant подписва всеки лиценз с два независими ключа. Единият подпис е Ed25519. Другият е ECDSA (Алгоритъм за цифров подпис с елиптични криви) върху кривата P-256 на NIST (Националния институт за стандарти и технологии на САЩ), който се изисква от купувачи, нуждаещи се от федерални алгоритми на САЩ. И двата се създават върху едни и същи байтове и и двата трябва да преминат проверка. Документ, в който липсва едната половина или някоя от половините е грешна, се счита за липса на лиценз.
Подписаните байтове представляват каноничната форма на документа по RFC 8785 с премахнат signatures, така че празните пространства и редът на елементите във Вашия файл нямат значение. Един-единствен променен знак в името на лицензополучателя, датите или предоставените права прави документа различен и проверката е неуспешна.
Публичните ключове, които проверката използва, се намират във файл с доверени корени (trust-roots), вграден във всеки образ при компилиране на изданието. Никоя променлива на средата, флаг или монтиране не може да посочи друг файл. Когато Adverant замени ключ за подписване, старият ключ подписва новия и следващото подписано издание съдържа новия ключ. Лиценз, подписан с нов ключ, се верифицира на издание, което го съдържа, така че след смяна на ключа може да се наложи да надстроите преди импортиране (вижте глава 2.17, Отстраняване на неизправности).
Типове, издания и как се отчита лицензът
Полето type указва от какъв вид споразумение произлиза лицензът:
alpha: лиценз за алфа канала на изданието – какъвто притежава Harrow.evaluation: самостоятелно хостван пробeн период на Enterprise. Той действа най-много 30 дни, за най-много 5 поименни потребители (метрикаnamed-seat), катоgrace_daysе зададено на 0. Форматът отхвърля пробен лиценз с какъвто и да е гратисен период.commercial: договорен лиценз.
Полето metric записва как се отчита лицензът: per-environment (продукционният клъстер на Harrow е една среда), per-core или named-seat. Adverant определя цената; лицензът съдържа само мярката и количеството.
Стойността на edition на лиценза е enterprise за всяка инсталация на Enterprise. Форматът приема и team, при което лицензът предоставя групата team, но никога enterprise-base.
Групи функции, добавки и браншови пакети
Това, което лицензът позволява на хората да използват, е изброено по групи функционалности чрез идентификаторите от матрицата на изданията. Лицензът на Harrow предоставя enterprise-base (персонализирани роли, одобрения по принципа на „четирите очи“, дългосрочно запазване на одитни записи, корпоративно вписване с принудително прилагане и синхронизиране на директории, бизнес единици, страници за оператори и останалата част от базата на Enterprise) и map-and-geoai. Той включва добавката mail и домейн пакета logistics-and-maritime.
Матрицата съдържа правила за това какво с какво се комбинира, а системата за издаване на Adverant ги проверява преди подписването на лиценза. Всяка добавка и всеки пакет изискват enterprise-base. Някои пакети изискват добавки: пакетът „Логистика и морско дело“ (Logistics and maritime) изисква „Карта и GeoAI“ (Map and GeoAI), пакетът „Застраховане“ (Insurance) и пакетът „Капиталови пазари и управление на активи“ (Capital markets and asset management) изискват „Зали за решения и запечатани записи“ (Decision rooms and sealed records), а пакетът „Правни и професионални услуги“ (Legal and professional services) изисква „Зали за решения“ (Decision rooms) и „Поща“ (Mail). Екраните за телефон на всеки пакет изискват и добавката „Мобилни приложения“ (Mobile apps).
Всяко предоставено право има обхват:
deployment: групата се прилага за цялата инсталация, за всяка организация в нея.tenant: групата се прилага само за организациите, изброени вscope.tenants. Лиценз с предоставено право с обхват на наемател трябва да изброява поне една организация, а списък с организации без право с обхват на наемател се отхвърля.
Да предположим, че лоцманският екип на Harrow работи като втора организация на същата инсталация и само тази организация трябва да разполага с Ideas. Предоставеното право би гласяло { "feature_group": "ideas", "scope": "tenant" }, с идентификатора на лоцманската организация в scope.tenants. Ако лицензът бъде импортиран преди тази организация да съществува, отговорът при импортиране ще я отчете под tenants_without_organisation, а правото ще стане достъпно за нея веднага след като организацията бъде създадена.
Администраторът може да ограничи обхвата на дадена група. Само лиценз от Adverant може да добави група.
Срокът: предупреждение и гратисен период
Полето term задава четири дати в календара. От starts_on до ends_on лицензът е в сила. warn_days задава колко по-рано започва предупреждението, а grace_days – колко дълго всичко продължава да работи след края. Лицензите, издавани от Adverant, включват по 30 дни за всяко от двете, освен ако в договора не е посочено друго. Пробният лиценз винаги има grace_days 0.
За горния лиценз на Harrow календарът изглежда по следния начин:
| Дати | Състояние |
|---|---|
| 1 януари 2027 до 1 декември 2027 | VALID |
| 2 декември 2027 до 31 декември 2027 | WARN |
| 1 януари 2028 до 30 януари 2028 | GRACE |
| От 31 януари 2028 | RESTRICT |
Последният ден от срока, ends_on, все още е ден със състояние WARN. Денят след него е GRACE, или RESTRICT, когато няма гратисен период.
Шестте състояния
Всеки път, когато лицензът се чете, инсталацията преизчислява състоянието му от документа и текущата дата. Нищо не се кешира след границата на деня, така че изтичането на срока настъпва точно навреме без планирана задача.
| Състояние | Кога | Какво могат да правят потребителите |
|---|---|---|
| ABSENT | Няма импортиран лиценз или документът е отхвърлен | Базово ниво Community. Зони от Enterprise се показват като предварителни изгледи с информация кой може да ги активира. |
| VALID | От starts_on до ends_on минус warn_days |
Всяка предоставена група е с активни права. |
| WARN | Последните warn_days дни от срока |
С активни права, а администраторите виждат банер в продукта с крайната дата. |
| GRACE | След ends_on, в продължение на grace_days дни |
С активни права, с известие LICENCE_IN_GRACE в Today и на страницата с лиценза. |
| RESTRICT | След гратисния период | Не може да се започва нова работа по лицензирана група. Текущата работа завършва, четенето и експортирането продължават да работят, а поправките за сигурност продължават да пристигат. |
| TERMINATE | Adverant е анулирал лиценза | Артефактите от Enterprise спират да се предлагат. Базовото ниво Community и експортирането на данни остават достъпни. |
Във всяко състояние текущата работа продължава да се изпълнява, поправките за сигурност продължават да пристигат, експортираните данни остават четими и нищо не се изтрива. При състояние RESTRICT потребител, който се опита да започне нова работа в Enterprise, вижда табела за отказ с код LICENCE_LOCKED и името на лицето, което може да поднови лиценза.
Как се изчислява текущата дата
Часовникът може да е неточен, а може и да бъде върнат назад умишлено. Затова инсталацията никога не разчита само на часовника. Текущата дата е по-късният от два момента: системният часовник и записаният минимум, който представлява най-късният момент, регистриран от инсталацията. Минимумът се измества напред при всяко импортиране и всяко прочитане на състоянието и никога не се връща назад от само себе си. Връщането на часовника с един месец назад не връща изтекъл лиценз обратно във VALID; лиценз в състояние RESTRICT си остава в RESTRICT.
Когато часовникът показва по-ранно време от минимума, състоянието носи известието LICENCE_CLOCK_BEHIND_FLOOR и се отчита спрямо деня на минимума. Ако часовникът наистина е избързал (възел е стартирал с грешна дата и минимумът е бил изместен напред), поискайте от Adverant токен за нулиране на времето. Това е малък подписан документ, обвързан с идентификатора на Вашата инсталация и еднократно число (nonce), съдържащ момент floor_to. Импортирате го през API със следната заявка:
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> е токенът за достъп на администратор на инсталацията. Токенът се прилага, когато и двата подписа са валидни, идентификаторът на инсталацията в него съвпада с Вашия и еднократното му число (nonce) не е било използвано. Отхвърленият токен не променя нищо, така че никога не може да се използва за отхвърляне на редовен лиценз. Токен, чието еднократно число вече е било използвано, се отхвърля с LICENCE_CLOCK_BEHIND_FLOOR.
Заявяване на лиценз
Лицензите се заявяват и изтеглят от Вашия профил в Adverant на адрес https://account.adverant.ai. Кой във Вашата организация може да заявява внедрявания и да изтегля лицензи, се задава на страницата „Роли в организацията и екипа“ (Organisation and team roles) на профила.
Adverant трябва да знае за коя инсталация е предназначен лицензът, като има три начина да го посочите.
Еднократен код, за инсталация с екран. Инсталацията показва еднократен код и своя пръстов отпечатък. На страницата „Заявяване на внедряване“ (Claim a deployment) поставяте кода, след което сравнявате пръстовия отпечатък група по група с това, което показва инсталацията. Когато всяка група съвпадне, я заявявате за Вашата организация и лицензът пристига в профила.
Ключ за заявяване, за специализирано или периферно устройство. Те нямат екран, на който да покажат код. Серийният номер и ключът за заявяване са отпечатани върху кутията и в поръчката от производителя на оборудването. Въведете ги един по един на страницата „Въвеждане на ключ за заявяване“ (Enter a claim key) или пуснете файла с поръчката от производителя, за да заявите много наведнъж. Всеки ключ се проверява спрямо записите на Adverant за това какво Ви е било доставено, а ключ от чужда поръчка се отхвърля.
Подписана заявка за лиценз, за инсталация без външна връзка. Това е подходът на Harrow. В инсталацията администратор създава файл със заявка в „Тази инсталация“ (This installation), „Лиценз“ (Licence). Това е изявление от вид licence-request, посочващо идентификатора на инсталацията и подписано със собствения Ed25519 ключ на инсталацията. Tomás го изнася на одобрен носител, пуска го на страницата „Офлайн обмен“ (Offline exchange) и изтегля върнатия лицензен файл. Лицензът работи само на инсталацията, която е създала заявката.
Импортиране на лиценз
Има три начина за внасяне и всички те достигат до една и съща крайна точка в nexus-auth. Само администратор на инсталацията може да импортира: собственик или администратор на цялата организация, която притежава инсталацията, вписан в нея, или пълен администратор на платформата. Всеки друг получава отказ още преди файлът да бъде прочетен.
В конзолата
При нова инсталация „Импортиране на лиценза“ (Import the licence) е една от шестте проверки в „Шест неща преди някой да се впише“ (Six things before anyone signs in). Когато пуснете файла на страницата, конзолата го проверява в инсталацията офлайн и изброява групите му от функционалности заедно с начина на защита на всяка от тях и срока.
Последващите импортирания преминават през „Тази инсталация“ (This installation), „Лиценз“ (Licence): използвайте „Импортиране на нов лиценз“ (Import a new licence) или „Импортиране на подновен лиценз“ (Import a renewed licence), когато текущият е изтекъл. Инсталация на Community, преминаваща към Enterprise, използва „От Community към Enterprise“ (From Community to Enterprise). Тази страница първо прочита лиценза и показва какво ще бъде изтеглено и какво се променя, преди да се случи каквото и да било. Нищо не се изтегля, докато някой не избере „Изтегли и включи“ (Fetch and switch on). След това компонентите за Enterprise се изтеглят от registry.adverant.ai с токена за изтегляне на инсталацията, като всеки от тях се проверява спрямо ключа на изданието на Adverant, а групите се включват една по една. След това инсталацията си остава същата – със същите потребители, файлове, работни потоци и канали.
С nexusctl
nexusctl licence import harrow-2027.licence.jsonКомандата импортира файла непроменен и извежда текущото състояние на лиценза. Добавете --explain, за да се изведат операциите, които тя би изпълнила, без реално да ги изпълнява.
Чрез 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Изпратете файла точно както Adverant Ви го е предоставил. Не го преформатирайте и не го обвивайте в друг обект: тялото на заявката е самият документ. Маршрутът не приема низ със заявка (query string), а тяло с размер над 1 MiB се отхвърля. Елемент от най-високо ниво, който посочва организация или лице, се отхвърля с TENANT_NOT_A_PARAMETER или ACTOR_NOT_A_PARAMETER, тъй като лицензът на инсталацията принадлежи на инсталацията, притежавана от организацията на токена.
Успешното импортиране връща отговор 201. Тялото съдържа изгледа на лиценза (неговия идентификатор, текущото му състояние, лицензополучателя, изданието, срока, предоставените права и групите функционалности), колко организации го притежават в момента и колко от изброените наематели все още нямат организация. Лицензът, неговият SHA-256 хеш и редовете в регистъра за всяка организация се записват в една транзакция, а импортирането се отбелязва в одитния дневник.
Към него има и два маршрута за четене:
GET /api/v1/installation/licence/stateвръща състоянието, преизчислявано при всяко четене. Администраторът получава пълния изглед. Всеки друг член на организация в инсталацията получава само известието: състоянието, кода на известието (LICENCE_ENDS_SOON,LICENCE_IN_GRACEилиLICENCE_CLOCK_BEHIND_FLOOR) и датите, посочени в известието. Обикновеният член никога не вижда лицензополучателя, срока или групите, тъй като те принадлежат на собственика на инсталацията.GET /api/v1/installation/licence/documentвръща импортирания документ в необработен вид за администраторите. Всеки модул на Enterprise го извлича и проверява подписите отново със собствения си компилиран верификатор, така че модифицирана услуга за идентичност да не може да включи група, която лицензът не предоставя.
Всеки отказ
Отхвърленото импортиране не променя нищо, дори минимума на часовника, а отказът се записва в одитния дневник.
| Код | HTTP | Значение | Какво да предприемете |
|---|---|---|---|
LICENCE_FORMAT_INVALID |
422 | Файлът не е лиценз, който тази компилация може да разчете: не е JSON, не отговаря на схемата, датите са в грешен ред или дадена група е посочена два пъти. | Изпратете файла точно както Adverant Ви го е предоставил. |
LICENCE_SIGNATURE_INVALID |
422 | Единият от двата подписа липсва или файлът е бил променен след подписването. | Поискайте файла от Adverant отново и не го редактирайте. |
LICENCE_ROOT_UNKNOWN |
422 | Подписан е с ключ, който доверените корени на това издание не съдържат. | Поискайте лиценз, подписан за корените на това издание, или надстройте. |
LICENCE_MATRIX_MISMATCH |
422 | Написан е спрямо матрица на изданията, която тази компилация не разчита, или предоставя група, която каталогът на компилацията не познава. | Надстройте до издание, което я разчита, или поискайте лиценз, написан спрямо това издание. |
LICENCE_OTHER_INSTALLATION |
409 | Издаден е за друг идентификатор на инсталация. | Поискайте лиценз за идентичността на тази инсталация. |
LICENCE_REVOKED |
403 | Adverant е оттеглил този лиценз. | Поискайте нов лиценз от Adverant. |
LICENCE_LOCKED |
403 | Лицензът още не е влязъл в сила: текущата дата е преди starts_on. |
Импортирайте го отново на или след първия му ден. |
TRANSITION_NOT_PERMITTED |
409 | Лиценз с този идентификатор вече е бил импортиран. | Поискайте нов лиценз от Adverant, ако условията трябва да се променят. |
RECORD_NOT_FOUND |
404 | Инсталацията все още не е декларирана, така че няма идентичност, спрямо която да се извърши проверката. | Завършете първата администраторска стъпка и след това импортирайте. |
VALIDATION_FAILED |
400 | Тялото не може да бъде прочетено, надвишава 1 MiB или заявката има низ със заявка (query string). | Изпратете само файла като тяло на заявката, без параметри на заявката. |
Инсталацията извършва проверките във фиксиран ред и първата грешка определя кода. Липсваща половина на подпис се докладва преди непознат ключ, а документ с невалидни подписи изобщо не се чете по-нататък, така че подправен файл, който освен това посочва друга инсталация, пак връща отговор LICENCE_SIGNATURE_INVALID.
Подновяване
Подновяването представлява нов лиценз с нов licence_id. Импортирайте го по същия начин като първия. Той влиза в сила веднага, независимо до какво състояние е стигнал старият: от WARN, GRACE или RESTRICT инсталацията се връща директно към лицензирано състояние и нищо не се нуждае от преинсталиране. Adverant може да издаде променен лиценз и по средата на срока, например за да добави „Зали за решения“ (Decision rooms), и вие го импортирате по същия начин.
Двукратното импортиране на един и същ лиценз се отхвърля с TRANSITION_NOT_PERMITTED.
Отмяна
Adverant оттегля лиценз чрез подписване на списък с анулирани лицензи. Списъкът има пореден номер sequence и посочва всеки оттеглен идентификатор на лиценз заедно с това кога и защо е оттеглен. Списъците са с натрупване: всеки от тях съдържа всички идентификатори, анулирани преди него. Импортирате го по същия начин като лиценз:
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Списък, чийто пореден номер не е по-голям от този на последно импортирания, се отхвърля с TRANSITION_NOT_PERMITTED, така че стар списък не може да бъде поставен обратно на мястото на по-нов. Списък, който не се чете или не преминава верификация, се отхвърля със същите кодове като лиценз. Веднага щом даден списък посочи Вашия лиценз, състоянието му става TERMINATE.
Инсталация без външна връзка научава за анулиране само когато някой импортира списъка. За Harrow анулирането е въпрос колкото на договор, толкова и на софтуер, а Tomás импортира всеки списък, който Adverant изпраща, при следващото пренасяне.
Места над лицензирания брой
Количеството в лиценза е обещание относно потреблението и Nexus третира надвишаването му като предупреждение, но никога като блокиране на достъпа. Когато повече хора използват Nexus, отколкото покрива лицензът, администраторите виждат табелата SEATS_OVER_LICENCE на страницата „Хора“ (People). Всички продължават да работят. Табелата указва докога да се коригира това (30 дни), показва откъде са дошли допълнителните потребители и предлага двете решения: премахване на хора, които не се нуждаят от Nexus, или заявяване на повече места от Adverant. Добавянето на места е чувствителна промяна, която изисква второ лице, а допълнителните места се отчитат в годишния отчет за потреблението.
Отчетът за потреблението съдържа само броячи и можете да прочетете всеки ред, преди да бъде изнесен. Harrow го запазва като файл и го изнася чрез офлайн обмена.
Тестови периоди
Пробният период представлява лиценз от тип evaluation, стартиран от страницата „Пробни периоди“ (Trials) на профила за заявено внедряване. Той продължава най-много 30 дни, покрива най-много 5 поименни потребители и няма гратисен период. На деня след ends_on преминава директно в RESTRICT: зоните от Enterprise се връщат към предварителни изгледи и нищо, създадено по време на пробния период, не се изтрива. Изпълненията в Ideas, черновите на политики и правилата за поща се запазват точно такива, каквито са били, и се отварят отново веднага след като бъде импортиран лиценз.
Една организация може да изпълнява само по един самостоятелно хостван пробен период в даден момент.




