Version 1.0.0-alpha.1seneste
Kapitel 2.13
Licenser
Hvad en Nexus-licensfil indeholder, hvordan installationen kontrollerer den offline, de seks tilstande den kan være i, og hvordan De anmoder om, importerer, fornyer og tilbagekalder en.
Denne side er oversat af AI fra den engelske original. Hvis noget er uklart, er den engelske side gældende. Læs denne side på engelsk

Harrow Port Authority kører Nexus Enterprise på sin egen Kubernetes-klynge på harrow.example, uden rute fra klyngen til internettet. Hvert år fornyer Aoife Brennan, IT-chef, kontrakten, og Tomás Reilly, platformsingeniøren, bærer en lille JSON-fil over kløften og importerer den. Intet genstarter, og licenssiden viser en ny slutdato.
Dette kapitel handler om den fil. Kort sagt er en licens ét signeret JSON-dokument, der er bundet til én installation. Installationen kontrollerer den selv med offentlige nøgler, der er indbygget i aftrykket, og foretager intet netværkskald for at gøre det. En licens er aldrig en Helm-værdi og aldrig en monteret fil. Du importerer den gennem konsollen, nexusctl eller applikationsprogrammeringsgrænsefladen (API), og intet andet sted.
Licensdokumentet
En licens er ét JSON-objekt i formatet nexus-licence/v1. Her er Harrows, med de to signaturværdier forkortet.
{
"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>" }
}
}Hvert felt er påkrævet, og hvert objekt i dokumentet er lukket. Et element, som formatet ikke oplistet, afvises, så intet kan følge med uden for signaturen.
| Felt | Hvad den indeholder |
|---|---|
format |
Præcis nexus-licence/v1. Enhver anden værdi, inklusive en senere version, afvises. |
licence_id |
En UUID (universally unique identifier) med små bogstaver. En installation importerer hvert licens-id én gang. |
issued_at |
Det tidspunkt, hvor Adverant udstedte den, som YYYY-MM-DDThh:mm:ssZ. |
type |
alpha, evaluation eller commercial. |
channel |
Den udgivelseskanal, den blev udstedt til, såsom alpha. Signeret og medbragt; kontrollen forgrener sig ikke på baggrund af den. |
licensee.name |
1 til 200 tegn, signeret præcis som skrevet. Brennan og Brennán er to forskellige navne med to forskellige signaturer. |
licensee.customer_id |
Dit kunde-id hos Adverant: små bogstaver, cifre, ., _ og -. |
scope.deployment.installation_id |
Installationens identitet, oprettet af dens nøgletjeneste ved den første installation. |
scope.tenants |
Organisations-id'er, op til 1.000. Tom, medmindre en tildeling er afgrænset til lejere (tenant-scoped). |
edition |
enterprise eller team. En Enterprise-licens tildeler altid enterprise-base. |
grants |
1 til 500 {feature_group, scope}-par, hvor hver gruppe er nævnt én gang. |
add_ons |
Tilføjelses-id'er fra udgavematricen, op til 100. Kan være tom. |
domain_packs |
Domænepakke-id'er fra udgavematricen, op til 100. Kan være tom. |
metric |
kind er per-environment, per-core eller named-seat; quantity er et heltal fra 1. |
term |
starts_on og ends_on er datoer; warn_days og grace_days er heltal fra 0 til 365. |
matrix |
Den version af udgavematricen, som grupperne er skrevet op imod, og SHA-256-værdien for den pågældende matrixfil, gemt til revision. |
signatures |
To signaturer, ed25519 og p256. Det eneste felt, der ikke er signeret. |
Datoer er kalenderdatoer i UTC, og dagen skal eksistere: 2028-02-29 er i orden, og 2027-02-29 afvises.
To signaturer, begge påkrævede
Adverant signerer hver licens med to uafhængige nøgler. Den ene signatur er Ed25519. Den anden er ECDSA (Elliptic Curve Digital Signature Algorithm) på P-256-kurven fra NIST (det amerikanske National Institute of Standards and Technology), som købere, der har brug for amerikanske føderale algoritmer, efterspørger. Begge er lavet over de samme bytes, og begge skal verificeres. Et dokument, hvor den ene halvdel mangler, eller hvor en af halvdelene er forkert, tæller slet ikke som en licens.
De signerede bytes er den kanoniske RFC 8785-form af dokumentet, hvor signatures er taget ud, så blanktegn og rækkefølgen af elementerne i din fil gør ingen forskel. Et enkelt ændret tegn i licenstagerens navn, datoerne eller en tildeling udgør et andet dokument, og det fejler.
De offentlige nøgler, som kontrollen bruger, ligger i en trust-roots-fil, der er indbygget i hvert aftryk ved udgivelsesbygningen. Ingen miljøvariabel, intet flag og ingen montering angiver en anden fil. Når Adverant udskifter en signeringsnøgle, signerer den gamle nøgle den nye, og den næste signerede udgivelse indeholder den nye nøgle. En licens, der er signeret med en ny nøgle, verificeres på en udgivelse, der indeholder den, så efter et nøgleskift skal du muligvis opgradere før import (se kapitel 2.17, Fejlfinding).
Typer, udgaver og hvordan en licens opgøres
Feltet type angiver, hvilken slags aftale licensen stammer fra:
alpha: en licens til alpha-udgivelseskanalen, hvilket er den slags, Harrow har.evaluation: en selvhostet prøveversion af Enterprise. Den løber i højst 30 dage for højst 5 navngivne personer (måleenhednamed-seat) medgrace_dayssat til 0. Formatet afviser en evaluering med nogen form for henstand.commercial: en kontraktbestemt licens.
Feltet metric registrerer, hvordan licensen opgøres: per-environment (Harrows produktionsklynge er ét miljø), per-core eller named-seat. Adverant giver tilbud på prisen; licensen indeholder kun måleenheden og antallet.
Licensens edition er enterprise for hver Enterprise-installation. Formatet accepterer også team, hvor licensen tildeler gruppen team og aldrig enterprise-base.
Funktionsgrupper, tilføjelser og domænepakker
Hvad en licens giver folk lov til at bruge, er oplistet efter funktionsgruppe ved hjælp af id'erne i udgavematricen. Harrows licens tildeler enterprise-base (tilpassede roller, godkendelser efter fire-øjne-princippet, lang opbevaring af revisionslogge, virksomhedslogin med håndhævelse og katalogsynkronisering, forretningsenheder, operatørsiderne og resten af Enterprise-basen) og map-and-geoai. Den indeholder tilføjelsen mail og domænepakken logistics-and-maritime.
Matricen har regler for, hvad der hører sammen, og Adverants udstedelse kontrollerer dem, før en licens signeres. Hver tilføjelse og hver pakke kræver enterprise-base. Nogle pakker kræver tilføjelser: Logistik- og søfartspakken kræver Kort og GeoAI, Forsikringspakken samt Kapitalmarkeds- og kapitalforvaltningspakken kræver Beslutningsrum og forseglede optegnelser, og pakken til Juridiske og liberale erhverv kræver Beslutningsrum og Mail. Telefonskærmbillederne i hver pakke kræver også tilføjelsen Mobilapps.
Hver tildeling har et omfang:
deployment: gruppen gælder for hele installationen, for hver organisation på den.tenant: gruppen gælder kun for de organisationer, der er oplistet iscope.tenants. En licens med en lejerafgrænset tildeling skal opliste mindst én organisation, og en liste over organisationer uden en lejerafgrænset tildeling afvises.
Antag, at Harrows lodsteam kørte som en anden organisation på den samme installation, og at kun den organisation skulle have Ideer. Tildelingen ville lyde { "feature_group": "ideas", "scope": "tenant" }, med lodsorganisationens id i scope.tenants. Hvis licensen blev importeret, før den organisation eksisterede, ville importsvaret tælle den under tenants_without_organisation, og tildelingen ville nå den, så snart organisationen blev oprettet.
En administrator kan indsnævre, hvad en gruppe dækker. Kun en licens fra Adverant tilføjer en gruppe.
Løbetiden: advarsel og henstand
Feltet term sætter fire datoer i kalenderen. Fra starts_on til ends_on er licensen i kraft. warn_days fastsætter, hvor tidligt advarslen starter, og grace_days hvor længe alt bliver ved med at fungere efter udløbet. Licenser, som Adverant udsteder, indeholder 30 dage af hver, medmindre kontrakten siger andet. En evaluering har altid grace_days 0.
For Harrows licens ovenfor ser kalenderen således ud:
| Datoer | Tilstand |
|---|---|
| 1. januar 2027 til 1. december 2027 | VALID |
| 2. december 2027 til 31. december 2027 | WARN |
| 1. januar 2028 til 30. januar 2028 | GRACE |
| Fra 31. januar 2028 | RESTRICT |
Den sidste dag i perioden, ends_on, er stadig en WARN-dag. Dagen efter er GRACE, eller RESTRICT, når der ikke er nogen henstand.
De seks tilstande
Hver gang licensen læses, genberegner installationen sin tilstand ud fra dokumentet og den aktuelle dato. Intet caches ud over et døgnskifte, så et udløb sker til tiden uden et planlagt job.
| Tilstand | Hvornår | Hvad folk kan gøre |
|---|---|---|
| ABSENT | Ingen licens importeret, eller dokumentet blev afvist | Community-bundniveauet. Enterprise-områder vises som smagsprøver med angivelse af, hvem der kan slå dem til. |
| VALID | starts_on til ends_on minus warn_days |
Hver tildelt gruppe har brugsret. |
| WARN | De sidste warn_days dage af perioden |
Brugsret, og administratorer ser et banner i produktet med slutdatoen. |
| GRACE | Efter ends_on, i grace_days dage |
Brugsret, med meddelelsen LICENCE_IN_GRACE på I dag og på licenssiden. |
| RESTRICT | Efter henstandsperioden | Intet nyt arbejde kan påbegyndes under en licenseret gruppe. Igangværende arbejde afsluttes, læsninger og eksporter bliver ved med at fungere, og sikkerhedsrettelser bliver ved med at komme. |
| TERMINATE | Adverant tilbagekaldte licensen | Enterprise-artefakter tilbydes ikke længere. Community-bundniveauet og dataeksport består. |
I enhver tilstand fortsætter igangværende arbejde med at køre, sikkerhedsrettelser bliver ved med at komme, eksporter forbliver læsbare, og intet slettes. I RESTRICT ser en person, der forsøger at starte nyt Enterprise-arbejde, et afvisningsskilt med koden LICENCE_LOCKED og navnet på den, der kan forny.
Sådan beregnes den aktuelle dato
Et ur kan gå forkert, og et ur kan stilles tilbage med vilje. Derfor aflæser installationen aldrig uret alene. Den aktuelle dato er det seneste af to tidspunkter: væguret og en gemt bundgrænse, som er det seneste tidspunkt, installationen har set. Bundgrænsen rykker frem ved hver import og hver tilstandsaflæsning, og den rykker aldrig tilbage af sig selv. At stille uret en måned tilbage bringer ikke en udløbet licens tilbage til VALID; en RESTRICT-licens forbliver RESTRICT.
Når uret viser et tidspunkt før bundgrænsen, bærer tilstanden meddelelsen LICENCE_CLOCK_BEHIND_FLOOR og aflæses på bundgrænsens dag. Hvis uret reelt er gået forud (en node startede op med den forkerte dato, og bundgrænsen blev rykket frem), skal du bede Adverant om et tidsnulstillingstoken. Det er et lille signeret dokument, der er bundet til dit installations-id og en engangs-nonce, med et floor_to-tidspunkt. Du importerer det gennem API'et med denne forespørgsel:
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> er adgangstokenet for en installationsadministrator. Et token anvendes, når begge signaturer verificeres, dets installations-id er dit, og dets nonce ikke er blevet brugt. Et afvist token ændrer intet, så det kan aldrig bruges til at afvise en gyldig licens. Et token, hvis nonce allerede er blevet brugt, afvises med LICENCE_CLOCK_BEHIND_FLOOR.
Anmodning om en licens
Licenser anmodes om og downloades fra din Adverant-konto på https://account.adverant.ai. Hvem i din organisation, der må gøre krav på udrulninger og downloade licenser, indstilles på kontoens side for organisations- og teamroller.
Adverant skal vide, hvilken installation licensen er til, og der er tre måder at fortælle det på.
En engangskode til en installation med en skærm. Installationen viser en engangskode og sit fingeraftryk. På siden Gør krav på en udrulning indsætter du koden og sammenligner derefter fingeraftrykket gruppe for gruppe med det, installationen viser. Når hver gruppe stemmer overens, gør du krav på den for din organisation, og licensen lander på kontoen.
En kravsnøgle til en appliance eller en edge-enhed. Disse har ingen skærm til at vise en kode. Serienummeret og en kravsnøgle er trykt på kassen og i udstyrsproducentens ordre. Indtast dem på siden Indtast en kravsnøgle én ad gangen, eller træk producentens ordrefil ind for at gøre krav på mange på én gang. Hver nøgle kontrolleres mod Adverants optegnelse over, hvad der blev sendt til dig, og en nøgle fra en andens ordre afvises.
En signeret licensanmodning til en installation uden forbindelse til omverdenen. Dette er Harrows vej. På installationen opretter en administrator en anmodningsfil under Denne installation, Licens. Det er en erklæring af typen licence-request, der angiver installations-id'et, signeret med installationens egen Ed25519-nøgle. Tomás bærer den ud på et godkendt medie, slipper den på siden Offline-udveksling og downloader den licensfil, der kommer tilbage. Licensen virker kun på den installation, der har oprettet anmodningen.
Import af en licens
Der er tre veje ind, og de når alle det samme slutpunkt på nexus-auth. Kun en installationsadministrator kan importere: en ejer eller administrator af hele den organisation, der ejer installationen, som er logget ind på den, eller en fuldgyldig platformsadministrator. Alle andre afvises, før filen læses.
I konsollen
På en ny installation er Importer licensen et af de seks punkter under Seks ting før nogen logger ind. Når du slipper filen på siden, kontrollerer konsollen den på installationen, offline, og oplister dens funktionsgrupper med, hvordan hver enkelt er beskyttet, samt perioden.
Senere importer sker gennem Denne installation, Licens: brug Importer en ny licens, eller Importer en fornyet licens, når den nuværende er udløbet. En Community-installation, der skifter til Enterprise, bruger Fra Community til Enterprise. Den side læser først licensen og viser, hvad der vil blive hentet, og hvad der ændres, før der sker noget. Intet hentes, før nogen vælger Hent og slå til. Enterprise-delene kommer derefter fra registry.adverant.ai med installationens pull-token, hvor hver enkelt kontrolleres mod Adverants udgivelsesnøgle, og grupperne slås til én ad gangen. Det er den samme installation bagefter, med de samme personer, filer, arbejdsgange og kanaler.
Med nexusctl
nexusctl licence import harrow-2027.licence.jsonKommandoen importerer filen uændret og udskriver licensens aktuelle tilstand. Tilføj --explain for at udskrive de handlinger, den ville køre, uden at køre dem.
Via API'et
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.jsonSend filen præcis, som Adverant gav dig den. Omformater den ikke, og pak den ikke ind i et andet objekt: brødteksten er dokumentet. Ruten tager ingen forespørgselsstreng, og en brødtekst på mere end 1 MiB afvises. Et element på øverste niveau, der angiver en organisation eller en person, afvises med TENANT_NOT_A_PARAMETER eller ACTOR_NOT_A_PARAMETER, fordi installationens licens tilhører den installation, som tokenets organisation ejer.
En vellykket import svarer 201. Brødteksten indeholder licensvisningen (dens id, dens aktuelle tilstand, licenstageren, udgaven, perioden, tildelingerne og funktionsgrupperne), hvor mange organisationer der nu har den, og hvor mange oplistede lejere der endnu ikke har nogen organisation. Licensen, dens SHA-256-kontrolsum og hovedbogsrækkerne for hver organisation skrives i én transaktion, og importen registreres i revisionsloggen.
To læseruter følger med den:
GET /api/v1/installation/licence/statesvarer med tilstanden, genberegnet ved hver læsning. En administrator får den fulde visning. Ethvert andet medlem af en organisation på installationen får kun meddelelsen: tilstanden, meddelelseskoden (LICENCE_ENDS_SOON,LICENCE_IN_GRACEellerLICENCE_CLOCK_BEHIND_FLOOR) og de datoer, som meddelelsen nævner. Et medlem ser aldrig licenstageren, perioden eller grupperne, fordi de tilhører installationens ejer.GET /api/v1/installation/licence/documentsvarer med det importerede dokument, råt, for administratorer. Hvert Enterprise-modul henter det og kontrollerer signaturerne igen med sin egen indkompilerede verifikator, så en modificeret identitetstjeneste ikke kan slå en gruppe til, som licensen ikke tildeler.
Enhver afvisning
En afvist import ændrer intet, ikke engang urets bundgrænse, og afvisningen registreres i revisionsloggen.
| Kode | HTTP | Betydning | Hvad du skal gøre |
|---|---|---|---|
LICENCE_FORMAT_INVALID |
422 | Filen er ikke en licens, som dette build kan læse: ikke JSON, ikke skemaet, datoer i forkert rækkefølge eller en gruppe nævnt to gange. | Send filen præcis, som Adverant gav dig den. |
LICENCE_SIGNATURE_INVALID |
422 | En af de to signaturer mangler, eller filen blev ændret efter signering. | Bed Adverant om filen igen, og rediger den ikke. |
LICENCE_ROOT_UNKNOWN |
422 | Den er signeret med en nøgle, som denne udgivelses trust roots ikke indeholder. | Bed om en licens, der er signeret til denne udgivelses roots, eller opgrader. |
LICENCE_MATRIX_MISMATCH |
422 | Den er skrevet op imod en udgavematrice, som dette build ikke læser, eller tildeler en gruppe, som buildets katalog ikke kender. | Opgrader til en udgivelse, der læser den, eller bed om en licens, der er skrevet op imod denne udgivelse. |
LICENCE_OTHER_INSTALLATION |
409 | Den blev udstedt til et andet installations-id. | Bed om en licens til denne installations identitet. |
LICENCE_REVOKED |
403 | Adverant har trukket denne licens tilbage. | Bed Adverant om en ny licens. |
LICENCE_LOCKED |
403 | Licensen er ikke begyndt: den aktuelle dato er før starts_on. |
Importer den igen på eller efter dens første dag. |
TRANSITION_NOT_PERMITTED |
409 | En licens med dette id er allerede blevet importeret. | Bed Adverant om en ny licens, hvis vilkårene skal ændres. |
RECORD_NOT_FOUND |
404 | Installationen er ikke blevet erklæret endnu, så den har ingen identitet at kontrollere op imod. | Afslut det første administratortrin, og importer derefter. |
VALIDATION_FAILED |
400 | Brødteksten kunne ikke læses, er over 1 MiB, eller forespørgslen havde en forespørgselsstreng. | Send filen alene som brødtekst, uden forespørgsel. |
Installationen kontrollerer i en fast rækkefølge, og den første fejl angiver koden. En manglende halvdel rapporteres før en ukendt nøgle, og et dokument, hvis signaturer fejler, læses aldrig videre, så en manipuleret fil, der også angiver en anden installation, svarer stadig LICENCE_SIGNATURE_INVALID.
Fornyelse
En fornyelse er en ny licens med et nyt licence_id. Importer den på samme måde som den første. Den træder i kraft med det samme, uanset hvilken tilstand den gamle havde nået: fra WARN, GRACE eller RESTRICT går installationen direkte tilbage til licenseret, og intet skal geninstalleres. Adverant kan også udstede en ændret licens midt i perioden, for eksempel for at tilføje Beslutningsrum, og den importerer du på samme måde.
Import af den samme licens to gange afvises med TRANSITION_NOT_PERMITTED.
Tilbagekaldelse
Adverant trækker en licens tilbage ved at signere en tilbagekaldelsesliste. Listen har et sequence-nummer og angiver hvert tilbagekaldt licens-id med tidspunkt og årsag. Listerne er kumulative: hver enkelt indeholder ethvert id, der er tilbagekaldt før den. Du importerer den på samme måde som en licens:
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.jsonEn liste, hvis sekvensnummer ikke er højere end den sidst importerede, afvises med TRANSITION_NOT_PERMITTED, så en gammel liste kan ikke sættes ind i stedet for en nyere. En liste, der ikke kan læses eller ikke verificeres, afvises med de samme koder som en licens. Når en liste nævner din licens, er dens tilstand TERMINATE.
En installation uden forbindelse til omverdenen får først kendskab til en tilbagekaldelse, når nogen importerer listen. For Harrow er tilbagekaldelse lige så meget et spørgsmål om kontrakt som om software, og Tomás importerer hver liste, som Adverant sender, ved næste overførsel.
Pladser ud over licensen
Licensens antal er et løfte om brug, og Nexus behandler en overskridelse af det som en advarsel, aldrig en udelukkelse. Når flere personer bruger Nexus, end licensen dækker, ser administratorer skiltet SEATS_OVER_LICENCE på siden Personer. Alle arbejder videre. Skiltet fortæller, hvornår det skal være bragt i orden (30 dage), viser hvor de ekstra personer kom fra, og tilbyder de to løsninger: fjern personer, der ikke har brug for Nexus, eller bed Adverant om flere pladser. Tilføjelse af pladser er en følsom ændring, der kræver en person nummer to, og de ekstra pladser tælles med i den årlige forbrugsopgørelse.
Forbrugsopgørelsen indeholder kun tællere, og du kan læse hver linje, før den sendes ud. Harrow gemmer den som en fil og bærer den ud gennem offline-udvekslingen.
Evalueringer
En evaluering er en licens af typen evaluation, startet fra kontoens side Prøveversioner for en udrulning, der er gjort krav på. Den varer højst 30 dage, dækker højst 5 navngivne personer og har ingen henstand. Dagen efter ends_on går den direkte til RESTRICT: Enterprise-områder vender tilbage til smagsprøver, og intet, der er oprettet under evalueringen, slettes. Idékørsler, udkast til politikker og mailregler bevares præcis, som de var, og de åbner igen, så snart en licens importeres.
En organisation kører én selvhostet evaluering ad gangen.




