BejelentkezésBemutató kérése

2.13. fejezet

Licencek

Mit tartalmaz egy Nexus licencfájl, hogyan ellenőrzi azt a telepítés offline, milyen hat állapotban lehet, és hogyan lehet igényelni, importálni, megújítani és visszavonni.

Ezt az oldalt AI fordította az eredeti angol szövegből. Ha bármi nem egyértelmű, az angol nyelvű oldal az irányadó. Oldal olvasása angolul

19 perc olvasási idő

A Harrow Port Authority a Nexus Enterprise kiadást a saját Kubernetes fürtjén futtatja a harrow.example helyen, a fürtből az internetre vezető útvonal nélkül. Aoife Brennan, az informatikai vezető minden évben megújítja a szerződést, Tomás Reilly, a platformmérnök pedig átvisz egy kis JSON-fájlt a fizikai résen, és importálja azt. Semmi sem indul újra, a licencoldalon pedig megjelenik az új lejárati dátum.

Ez a fejezet erről a fájlról szól. Röviden: a licenc egyetlen aláírt JSON-dokumentum, amely egyetlen telepítéshez van kötve. A telepítés maga ellenőrzi azt a képfájlba beépített nyilvános kulcsokkal, és ehhez nem indít hálózati hívást. A licenc soha nem egy Helm-érték, és soha nem egy felcsatolt fájl. A konzolon, a nexusctl eszközön vagy az alkalmazásprogramozási felületen (API) keresztül importálhatja, sehol máshol.

A licencdokumentum

A licenc egyetlen, nexus-licence/v1 formátumú JSON-objektum. Íme a Harrow-é, a két aláírási érték lerövidítésével.

{
  "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>" }
  }
}

Minden mező kötelező, és a dokumentumban minden objektum zárt. A formátumban nem szereplő tagokat a rendszer elutasítja, így az aláíráson kívül semmi sem csúszhat be.

Mező Mit tartalmaz
format Pontosan nexus-licence/v1. Minden más értéket – beleértve egy későbbi verziót is – a rendszer elutasít.
licence_id Kisbetűs UUID (univerzálisan egyedi azonosító). Egy telepítés minden licencazonosítót egyszer importál.
issued_at Az a pillanat, amikor az Adverant kiállította, YYYY-MM-DDThh:mm:ssZ formátumban.
type alpha, evaluation vagy commercial.
channel A kiadási csatorna, amelyre kiállították, például alpha. Aláírva és továbbítva; az ellenőrzés nem ágazik el ez alapján.
licensee.name 1–200 karakter, pontosan a leírtak szerint aláírva. A Brennan és a Brennán két különböző név, két különböző aláírással.
licensee.customer_id Az Ön ügyfél-azonosítója az Adverantnál: kisbetűk, számjegyek, ., _ és -.
scope.deployment.installation_id A telepítés identitása, amelyet a kulcsszolgáltatása állít elő az első telepítéskor.
scope.tenants Szervezetazonosítók, legfeljebb 1000. Üres, kivéve, ha valamelyik jogosultság bérlői hatókörű.
edition enterprise vagy team. Egy Enterprise licenc mindig enterprise-base jogosultságot ad.
grants 1–500 {feature_group, scope} pár, minden csoport egyszer megnevezve.
add_ons Kiegészítőazonosítók a kiadási mátrixból, legfeljebb 100. Lehet üres.
domain_packs Szakterületi csomagazonosítók a kiadási mátrixból, legfeljebb 100. Lehet üres.
metric A kind értéke per-environment, per-core vagy named-seat; a quantity egy egész szám 1-től kezdődően.
term A starts_on és a ends_on dátumok; a warn_days és a grace_days egész számok 0-tól 365-ig.
matrix A kiadási mátrix verziója, amely alapján a csoportokat írták, valamint a mátrixfájl SHA-256 lenyomata, auditálási célból megőrizve.
signatures Két aláírás: ed25519 és p256. Az egyetlen mező, amely nincs aláírva.

A dátumok UTC szerinti naptári dátumok, és a napnak léteznie kell: a 2028-02-29 megfelelő, a 2027-02-29 értéket pedig a rendszer elutasítja.

Két aláírás, mindkettő kötelező

Az Adverant minden licencet két független kulccsal ír alá. Az egyik aláírás Ed25519. A másik ECDSA (elliptikus görbéken alapuló digitális aláírási algoritmus) a NIST (az Egyesült Államok Nemzeti Szabványügyi és Technológiai Intézete) P-256 görbéjén, amelyet az amerikai szövetségi algoritmusokat igénylő vásárlók kérnek. Mindkettő ugyanazokon a bájtokon készül, és mindkettő ellenőrzésének sikeresnek kell lennie. Az a dokumentum, amelynek az egyik fele hiányzik, vagy bármelyik fele hibás, egyáltalán nem számít licencnek.

Az aláírt bájtok a dokumentum RFC 8785 szerinti kanonikus formáját alkotják a signatures eltávolításával, így a szóközök és a tagok sorrendje a fájlban nem számít. Egyetlen megváltoztatott karakter a licencvevő nevében, a dátumokban vagy egy jogosultságban már egy másik dokumentumot eredményez, és az ellenőrzés sikertelen lesz.

Az ellenőrzés által használt nyilvános kulcsok egy megbízható gyökérkulcsokat tartalmazó (trust-roots) fájlban találhatók, amelyet a kiadás összeállításakor minden képfájlba beépítenek. Semmilyen környezeti változó, kapcsoló vagy felcsatolás nem nevezhet meg másik fájlt. Amikor az Adverant lecserél egy aláíró kulcsot, a régi kulcs aláírja az újat, és a következő aláírt kiadás már tartalmazza az új kulcsot. Az új kulccsal aláírt licenc ellenőrzése azon a kiadáson lesz sikeres, amely tartalmazza azt, így kulcscsere után előfordulhat, hogy az importálás előtt frissítenie kell a rendszert (lásd a 2.17. fejezetet, Hibaelhárítás).

Típusok, kiadások és a licenc számítási módja

A type megmondja, hogy a licenc milyen fajta megállapodásból származik:

  • alpha: az alfa kiadási csatornához szóló licenc; a Harrow is ilyennel rendelkezik.
  • evaluation: az Enterprise saját üzemeltetésű próbaverziója. Legfeljebb 30 napig fut, legfeljebb 5 megnevezett személy számára (named-seat metrika), 0-ra állított grace_days értékkel. A formátum elutasít minden olyan próbaverziót, amely bármilyen türelmi időt tartalmaz.
  • commercial: szerződéses licenc.

A metric rögzíti, hogyan történik a licenc számítása: per-environment (a Harrow éles fürtje egy környezetnek számít), per-core vagy named-seat. Az árat az Adverant adja meg; a licenc csak a mértékegységet és a mennyiséget tartalmazza.

A licenc edition értéke enterprise minden Enterprise telepítés esetén. A formátum elfogadja a team értéket is, ahol a licenc a team csoportot biztosítja, és soha nem a enterprise-base csoportot.

Funkciócsoportok, kiegészítők és szakterületi csomagok (domain pack)

Azt, hogy egy licenc mit enged használni, funkciócsoportonként soroljuk fel, a kiadási mátrix azonosítóinak használatával. A Harrow licence biztosítja az enterprise-base (egyéni szerepkörök, négy-szem-elvű jóváhagyások, hosszú távú naplómegőrzés, vállalati bejelentkezés kikényszerítéssel és címtár-szinkronizálással, üzleti egységek, az üzemeltetői oldalak és az Enterprise alap többi része) és az map-and-geoai csoportot. Tartalmazza a mail kiegészítőt és a logistics-and-maritime szakterületi csomagot.

A mátrix szabályokat tartalmaz arra vonatkozóan, hogy mi mivel tartozik össze, és az Adverant kiállító rendszere ellenőrzi ezeket a licenc aláírása előtt. Minden kiegészítőhöz és minden csomaghoz szükséges az enterprise-base. Egyes csomagokhoz kiegészítők szükségesek: a Logisztikai és tengerészeti csomaghoz a Térkép és GeoAI, a Biztosítási csomaghoz, valamint a Tőkepiaci és vagyonkezelési csomaghoz a Döntési szobák és zárolt rekordok, a Jogi és szakmai szolgáltatások csomaghoz pedig a Döntési szobák és a Levelezés szükséges. Minden csomag telefonos képernyőihez a Mobilalkalmazások kiegészítő is szükséges.

Minden jogosultságnak van egy hatóköre:

  • deployment: a csoport a teljes telepítésre érvényes, a rajta lévő minden szervezetre.
  • tenant: a csoport csak a scope.tenants mezőben felsorolt szervezetekre érvényes. A bérlői hatókörű jogosultsággal rendelkező licencnek legalább egy szervezetet fel kell sorolnia, a bérlői hatókörű jogosultság nélküli szervezetlistát pedig a rendszer elutasítja.

Tegyük fel, hogy a Harrow révkalauz csapata második szervezetként futna ugyanazon a telepítésen, és csak ez a szervezet rendelkezne az Ötletek funkcióval. A jogosultság értéke { "feature_group": "ideas", "scope": "tenant" } lenne, a révkalauz szervezet azonosítójával a scope.tenants mezőben. Ha a licencet még a szervezet létezése előtt importálnák, az importálási válasz a tenants_without_organisation alatt számolná el, és a jogosultság akkor érné el a szervezetet, amikor azt létrehozzák.

A rendszergazda szűkítheti, hogy egy csoport mire terjedjen ki. Csoportot kizárólag az Adveranttól származó licenc adhat hozzá.

A licenc és amit felold
A licenc és amit felold
A licencoldal felsorol minden funkciócsoportot azzal együtt, hogy milyen védelemmel rendelkezik, és mire terjed ki. Azok a csoportok, amelyeket a licenc nem tartalmaz, szürkén a listában maradnak, így látható, hogy mi létezik még.

Az érvényességi idő: figyelmeztetési és türelmi időszak

A term négy dátumot állít be a naptárban. A starts_on és a ends_on közötti időszakban a licenc hatályban van. A warn_days határozza meg, milyen korán kezdődik a figyelmeztetés, a grace_days pedig azt, hogy meddig működik tovább minden a lejárat után. Az Adverant által kiállított licencek mindkettőből 30 napot tartalmaznak, hacsak a szerződés másként nem rendelkezik. A próbaverzió grace_days értéke mindig 0.

A Harrow fenti licence esetében a naptár a következőképpen alakul:

Dátumok Állapot
2027. január 1. – 2027. december 1. VALID
2027. december 2. – 2027. december 31. WARN
2028. január 1. – 2028. január 30. GRACE
2028. január 31-től RESTRICT

Az időtartam utolsó napja, a ends_on, még WARN napnak számít. Az azt követő nap GRACE, vagy ha nincs türelmi idő, akkor RESTRICT.

A hat állapot

Minden alkalommal, amikor a rendszer beolvassa a licencet, a telepítés újraszámítja annak állapotát a dokumentumból és az aktuális dátumból. A naphatáron túl semmi sem marad a gyorsítótárban, így a lejárat pontosan időben, ütemezett feladat nélkül történik meg.

Állapot Mikor Mit tehetnek a felhasználók
ABSENT Nincs importálva licenc, vagy a dokumentumot a rendszer elutasította A Community alapszint. Az Enterprise területek előzetesként jelennek meg, feltüntetve, hogy ki kapcsolhatja be őket.
VALID starts_on – ends_on mínusz warn_days Minden megadott csoportra érvényes a jogosultság.
WARN Az időtartam utolsó warn_days napja Jogosult, és a rendszergazdák egy terméken belüli sávot látnak a lejárati dátummal.
GRACE A ends_on után, grace_days napig Jogosult, a LICENCE_IN_GRACE értesítéssel a Ma oldalon és a licencoldalon.
RESTRICT A türelmi időszak után Licencelt csoport alatt nem indítható új munka. A futó munkák befejeződnek, az olvasások és az exportálások továbbra is működnek, és a biztonsági javítások is folyamatosan érkeznek.
TERMINATE Az Adverant visszavonta a licencet Az Enterprise összetevők felkínálása megszűnik. A Community alapszint és az adatexportálás megmarad.

Minden állapotban igaz, hogy a futó munkák tovább futnak, a biztonsági javítások folyamatosan érkeznek, az exportálások olvashatók maradnak, és semmi sem törlődik. RESTRICT állapotban az a személy, aki új Enterprise munkát próbál indítani, egy elutasító panelt lát a LICENCE_LOCKED kóddal és annak a személynek a nevével, aki megújíthatja a licencet.

Vízszintes idővonal öt sávval balról jobbra: VALID (a starts_on dátumtól), WARN (az időtartam utolsó warn_days napja), GRACE (grace_days nap az ends_on után), RESTRICT (a türelmi idő után). A sávok alatt három feliratozott jelölő: starts_on, ends_on és ends_on + grace_days. Az idővonal alatt egy különálló doboz, amelyet bármelyik sávból egy szaggatott nyíl köt össze, TERMINATE felirattal (egy aláírt visszavonási lista megnevezi a licencet). Egy második doboz a bal szélen, az idővonalon kívül, ABSENT felirattal (nincs licenc, vagy elutasították: a Community alapszint).
A licencállapotok a naptár mentén.

Az aktuális dátum kiszámításának módja

Egy óra járhat rosszul, és szándékosan is visszaállíthatják. Ezért a telepítés soha nem csak önmagában az órát olvassa le. Az aktuális dátum két időpont közül a későbbi: a rendszeróra és egy tárolt alsó korlát, amely a telepítés által látott legutolsó időpont. Az alsó korlát minden importáláskor és minden állapotolvasáskor előrelép, és magától soha nem lép vissza. Az óra egy hónappal történő visszaállítása nem hoz vissza egy lejárt licencet VALID állapotba; a RESTRICT állapotú licenc RESTRICT marad.

Ha az óra az alsó korlátnál korábbi időt mutat, az állapot a LICENCE_CLOCK_BEHIND_FLOOR értesítést hordozza, és a rendszer az alsó korlát napja szerint olvassa ki. Ha az óra valóban előresietett (egy csomópont rossz dátummal indult el, és az alsó korlát előretolódott), kérjen az Adveranttól egy idő-visszaállító tokent. Ez egy kis aláírt dokumentum, amely az Ön telepítésazonosítójához és egy egyszer használatos nonce értékhez van kötve, egy floor_to időponttal. Az API-n keresztül importálhatja ezzel a kéréssel:

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

A <access-token> egy telepítési rendszergazda hozzáférési tokenje. A rendszer akkor alkalmazza a tokent, ha mindkét aláírás ellenőrzése sikeres, a benne szereplő telepítésazonosító az Öné, és a nonce értékét még nem használták fel. Az elutasított token semmin sem változtat, így soha nem használható fel egy érvényes licenc elutasítására. Azt a tokent, amelynek a nonce értékét már felhasználták, a rendszer LICENCE_CLOCK_BEHIND_FLOOR kóddal utasítja el.

Licenc igénylése

A licenceket az Adverant-fiókjából igényelheti és töltheti le a https://account.adverant.ai címen. Azt, hogy a szervezetében ki igényelhet példányokat és tölthet le licenceket, a fiók Szervezeti és csapatszerepkörök oldalán állíthatja be.

Az Adverantnak tudnia kell, melyik telepítéshez szól a licenc, és ezt háromféleképpen közölheti vele.

Egyszer használatos kód, képernyővel rendelkező telepítéshez. A telepítés megjelenít egy egyszer használatos kódot és annak ujjlenyomatát. A Példány igénylése oldalon illessze be a kódot, majd hasonlítsa össze az ujjlenyomatot csoportonként azzal, amit a telepítés mutat. Ha minden csoport egyezik, igényelje a szervezete számára, és a licenc megérkezik a fiókba.

Igénylőkulcs, célgéphez vagy peremhálózati eszközhöz. Ezeknek nincs képernyőjük a kód megjelenítéséhez. A sorozatszám és az igénylőkulcs a dobozra és a gyártói megrendelésre van nyomtatva. Adja meg őket egyesével az Igénylőkulcs megadása oldalon, vagy húzza be a gyártói megrendelésfájlt több eszköz egyszerre történő igényléséhez. A rendszer minden kulcsot összevet az Adverant nyilvántartásával arról, hogy mit szállítottak Önnek, a másvalaki megrendeléséből származó kulcsot pedig elutasítja.

Aláírt licenckérelem, külső kapcsolat nélküli telepítéshez. Ez a Harrow útvonala. A telepítésen a rendszergazda készít egy kérelemfájlt az Ez a telepítés, Licenc alatt. Ez egy licence-request típusú nyilatkozat, amely megnevezi a telepítésazonosítót, és a telepítés saját Ed25519 kulcsával van aláírva. Tomás jóváhagyott adathordozón kiviszi, behúzza az Offline csere oldalra, majd letölti a visszaérkező licencfájlt. A licenc kizárólag azon a telepítésen működik, amelyik a kérelmet készítette.

Offline csere
Offline csere
Offline csere külső kapcsolat nélküli telepítéshez. A fizikai résen áthaladó minden fájl alá van írva, így az útközben módosult fájlokat a rendszer elutasítja, és minden cserét felsorol a végrehajtó személy nevével együtt.
Két oszlop, a bal oldali felirata „Harrow telepítés (nincs internet)”, a jobb oldalié pedig „Adverant-fiók”. Balra fent: egy „A telepítési kulccsal aláírt licenckérelmi fájl” feliratú doboz. Egy „adathordozón átvíve” feliratú nyíl vezet át a jobb oldali oszlopban lévő „Offline csereoldal” dobozhoz. Alatta egy „Két Adverant-kulccsal aláírt licencfájl” feliratú doboz található. Egy „adathordozón visszavíve” feliratú nyíl tér vissza a bal oldali oszlop „Importálás: konzol, nexusctl vagy API” dobozához, onnan pedig lefelé a „A telepítésen ellenőrizve a beépített megbízhatósági gyökerek alapján” feliratú dobozhoz.
Hogyan jut el a licenc egy külső kapcsolat nélküli telepítéshez.

Licenc importálása

Három befelé vezető út van, és mindegyik ugyanazt a végpontot éri el a nexus-auth szolgáltatáson. Csak telepítési rendszergazda importálhat: a telepítést birtokló teljes szervezet tulajdonosa vagy rendszergazdája (bejelentkezve a telepítésbe), vagy egy teljes jogú platform-rendszergazda. Bárki mást a rendszer még a fájl beolvasása előtt elutasít.

A konzolon

Új telepítés esetén a Licenc importálása a hat ellenőrzési pont egyike a Hat teendő az első bejelentkezés előtt oldalon. Amikor behúzza a fájlt az oldalra, a konzol offline ellenőrzi azt a telepítésen, és felsorolja a funkciócsoportjait azok védelmi módjával és az érvényességi időtartammal együtt.

A későbbi importálások az Ez a telepítés, Licenc oldalon keresztül történnek: használja az Új licenc importálása lehetőséget, vagy a Megújított licenc importálása lehetőséget, ha a jelenlegi lejárt. Az Enterprise kiadásra áttérő Community telepítés a Community kiadásról Enterprise kiadásra oldalt használja. Ez az oldal először beolvassa a licencet, és megmutatja, mit fog letölteni és mi fog változni, mielőtt bármi történne. Semmi sem töltődik le, amíg valaki nem választja a Letöltés és bekapcsolás lehetőséget. Az Enterprise részek ekkor érkeznek meg a registry.adverant.ai címről a telepítés letöltési tokenjével, mindegyiket ellenőrzi a rendszer az Adverant kiadási kulcsával szemben, majd a csoportok egyesével bekapcsolnak. Utána is ugyanaz a telepítés marad, ugyanazokkal a személyekkel, fájlokkal, munkafolyamatokkal és csatornákkal.

Licenc importálása
Licenc importálása
A licenc importálása a beállítás során. Az eredeti fájl felsorolja a funkciócsoportjait; a két megváltoztatott sort tartalmazó másolat hiányzóként jelenik meg a LICENCE_SIGNATURE_INVALID kóddal, a már hatályban lévő licenc pedig érintetlen marad.
Váltás Communityről Enterprise-ra
Váltás Communityről Enterprise-ra
Community telepítés áthelyezése Enterprise kiadásra. A rendszer beolvasta és eredetinek találta a licencet, az oldal pedig felsorolja a letöltendő részeket és a változásokat, mielőtt bárki megnyomná a Letöltés és bekapcsolás gombot.

A nexusctl használatával

nexusctl licence import harrow-2027.licence.json

A parancs változatlanul importálja a fájlt, és kiírja a licenc aktuális állapotát. Adja hozzá a --explain kapcsolót, ha a végrehajtásuk nélkül szeretné kiíratni a futtatandó műveleteket.

Az API-n keresztül

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

Pontosan úgy küldje el a fájlt, ahogyan az Adveranttól kapta. Ne formázza át, és ne csomagolja be másik objektumba: a törzs maga a dokumentum. Az útvonal nem fogad el lekérdezési karakterláncot, az 1 MiB-nál nagyobb törzset pedig elutasítja. A szervezetet vagy személyt megnevező legfelső szintű tagokat a rendszer TENANT_NOT_A_PARAMETER vagy ACTOR_NOT_A_PARAMETER kóddal utasítja el, mivel a telepítés licence ahhoz a telepítéshez tartozik, amelyet a token szervezete birtokol.

A sikeres importálás válasza 201. A törzs tartalmazza a licencnézetet (az azonosítóját, az aktuális állapotát, a licencvevőt, a kiadást, az időtartamot, a jogosultságokat és a funkciócsoportokat), azt, hogy jelenleg hány szervezet rendelkezik vele, és hogy a felsorolt bérlők közül hánynak nincs még szervezete. A licenc, annak SHA-256 lenyomata és az egyes szervezetek főkönyvi sorai egyetlen tranzakcióban íródnak be, az importálást pedig rögzíti az auditnapló.

Két olvasási útvonal tartozik hozzá:

  • A GET /api/v1/installation/licence/state az állapotot adja vissza, minden olvasáskor újraszámítva. A rendszergazda a teljes nézetet kapja. A telepítésen lévő szervezet bármely más tagja csak az értesítést kapja meg: az állapotot, az értesítési kódot (LICENCE_ENDS_SOON, LICENCE_IN_GRACE vagy LICENCE_CLOCK_BEHIND_FLOOR) és az értesítésben megnevezett dátumokat. Egy egyszerű tag soha nem látja a licencvevőt, az időtartamot vagy a csoportokat, mivel ezek a telepítés tulajdonosához tartoznak.
  • A GET /api/v1/installation/licence/document az importált dokumentumot adja vissza nyers formában a rendszergazdák számára. Minden Enterprise modul lekéri azt, és újra ellenőrzi az aláírásokat a saját, befordított ellenőrzőjével, így egy módosított identitásszolgáltatás nem tud bekapcsolni olyan csoportot, amelyre a licenc nem ad jogosultságot.

Minden elutasítás

Az elutasított importálás semmin sem változtat, még az óra alsó korlátján sem, és az elutasítást rögzíti az auditnapló.

Kód HTTP Jelentés Teendők
LICENCE_FORMAT_INVALID 422 A fájl nem olyan licenc, amelyet ez az összeállítás olvasni tud: nem JSON, nem felel meg a sémának, a dátumok rossz sorrendben vannak, vagy egy csoport kétszer van megnevezve. Pontosan úgy küldje el a fájlt, ahogyan az Adveranttól kapta.
LICENCE_SIGNATURE_INVALID 422 A két aláírás egyike hiányzik, vagy a fájl az aláírás után megváltozott. Kérje el újra a fájlt az Adveranttól, és ne szerkessze azt.
LICENCE_ROOT_UNKNOWN 422 Olyan kulccsal írták alá, amelyet ennek a kiadásnak a megbízható gyökérkulcsai nem tartalmaznak. Kérjen egy, a kiadás gyökérkulcsaihoz aláírt licencet, vagy frissítse a rendszert.
LICENCE_MATRIX_MISMATCH 422 Olyan kiadási mátrix alapján íródott, amelyet ez az összeállítás nem tud olvasni, vagy olyan csoportra ad jogosultságot, amelyet az összeállítás katalógusa nem ismer. Frissítsen egy olyan kiadásra, amely tudja olvasni, vagy kérjen egy, ehhez a kiadáshoz írt licencet.
LICENCE_OTHER_INSTALLATION 409 Másik telepítésazonosítóra állították ki. Kérjen licencet ennek a telepítésnek az identitásához.
LICENCE_REVOKED 403 Az Adverant visszavonta ezt a licencet. Kérjen új licencet az Adveranttól.
LICENCE_LOCKED 403 A licenc érvényessége még nem kezdődött el: az aktuális dátum a starts_on előtt van. Importálja újra az első érvényességi napján vagy azután.
TRANSITION_NOT_PERMITTED 409 Ezzel az azonosítóval már importáltak licencet. Kérjen új licencet az Adveranttól, ha a feltételeknek változniuk kell.
RECORD_NOT_FOUND 404 A telepítést még nem deklarálták, így nincs identitása, amellyel szemben az ellenőrzés elvégezhető lenne. Fejezze be az első rendszergazdai lépést, majd importáljon.
VALIDATION_FAILED 400 A törzs nem olvasható, nagyobb 1 MiB-nál, vagy a kérés lekérdezési karakterláncot tartalmazott. Csak magát a fájlt küldje el törzsként, lekérdezés nélkül.

A telepítés rögzített sorrendben végez ellenőrzést, és az első hiba határozza meg a kódot. A hiányzó aláírásfelet az ismeretlen kulcs előtt jelenti a rendszer, a hibás aláírású dokumentumot pedig soha nem olvassa tovább, így egy manipulált fájl, amely ráadásul egy másik telepítést nevez meg, továbbra is LICENCE_SIGNATURE_INVALID választ ad.

Megújítás

A megújítás egy új licenc, új licence_id értékkel. Ugyanúgy importálja, mint az elsőt. Azonnal hatályba lép, bármilyen állapotot is ért el a régi: WARN, GRACE vagy RESTRICT állapotból a telepítés egyenesen visszatér licencelt állapotba, és semmit sem kell újratelepíteni. Az Adverant az időtartam közepén is kiállíthat módosított licencet – például a Döntési szobák hozzáadásához –, és azt is ugyanúgy kell importálnia.

Ugyanazon licenc kétszeri importálását a rendszer TRANSITION_NOT_PERMITTED kóddal utasítja el.

Visszavonás

Az Adverant visszavonási lista aláírásával von vissza egy licencet. A lista rendelkezik egy sequence számmal, és megnevez minden visszavont licencazonosítót a visszavonás idejével és okával együtt. A listák kumulatívak: mindegyik tartalmazza az összes korábban visszavont azonosítót. Ugyanúgy kell importálnia, mint egy licencet:

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

Azt a listát, amelynek sorszáma nem nagyobb a legutóbb importálténál, a rendszer TRANSITION_NOT_PERMITTED kóddal elutasítja, így egy régi lista nem tehető vissza egy újabb helyére. Az olvashatatlan vagy sikertelen ellenőrzésű listát a rendszer ugyanazokkal a kódokkal utasítja el, mint egy licencet. Amint egy lista megnevezi az Ön licencét, annak állapota TERMINATE lesz.

A külső kapcsolat nélküli telepítés csak akkor értesül a visszavonásról, ha valaki importálja a listát. A Harrow számára a visszavonás éppannyira szerződéses, mint szoftveres kérdés, és Tomás a következő átkeléskor importál minden olyan listát, amelyet az Adverant küld.

A licencet meghaladó felhasználói helyek

A licenc mennyisége egy használatra vonatkozó ígéret, és a Nexus a túllépését figyelmeztetésként, soha nem kizárásként kezeli. Amikor többen használják a Nexust, mint amennyit a licenc lefed, a rendszergazdák a SEATS_OVER_LICENCE panelt látják a Személyek oldalon. Mindenki zavartalanul dolgozhat tovább. A panel megmondja, mikorra kell rendezni a helyzetet (30 nap), megmutatja, honnan érkeztek a plusz személyek, és felkínálja a két megoldást: távolítsa el azokat, akiknek nincs szükségük a Nexusra, vagy kérjen az Adveranttól további helyeket. A helyek hozzáadása érzékeny módosítás, amelyhez egy második személy jóváhagyása is szükséges, a plusz helyeket pedig az éves használati kimutatás számolja el.

Licencen felüli helyek
Licencen felüli felhasználói helyek
Több személy, mint ahány hely van. A címtár-szinkronizálás 143 alvállalkozót adott hozzá, és a panel 30 napot ad a személyek eltávolítására vagy a helyek bővítésére, miközben senkit sem zár ki a rendszer.

A használati kimutatás kizárólag számlálókat tartalmaz, és Ön minden egyes sort elolvashat, mielőtt az elhagyná a rendszert. A Harrow fájlként menti el, és az offline cserén keresztül viszi ki.

Próbaverziók

A próbaverzió egy evaluation típusú licenc, amelyet a fiók Próbaverziók oldaláról indítanak el egy igényelt példányhoz. Legfeljebb 30 napig tart, legfeljebb 5 megnevezett személyre terjed ki, és nincs türelmi ideje. Az ends_on utáni napon egyenesen RESTRICT állapotba kerül: az Enterprise területek visszatérnek előzetes nézetbe, és a próbaverzió alatt létrehozott elemek közül semmi sem törlődik. Az ötletfuttatások, a piszkozatként mentett szabályzatok és a levelezési szabályok pontosan úgy maradnak, ahogy voltak, és újra megnyílnak, amint importálnak egy licencet.

Egy szervezet egyszerre egy saját üzemeltetésű próbaverziót futtathat.