Versjon 1.0.0-alpha.1nyeste
Kapittel 2.13
Lisenser
Hva en Nexus-lisensfil inneholder, hvordan installasjonen kontrollerer den frakoblet, de seks tilstandene den kan være i, og hvordan du ber om, importerer, fornyer og trekker tilbake en lisens.
Denne siden er oversatt med KI fra den engelske originalen. Hvis noe er uklart, er den engelske siden referansen. Les denne siden på engelsk

Harrow Port Authority kjører Nexus Enterprise på sin egen Kubernetes-klynge på harrow.example, uten noen rute fra klyngen til internett. Hvert år fornyer IT-sjefen Aoife Brennan kontrakten, og plattformingeniøren Tomás Reilly tar med seg en liten JSON-fil over det fysiske skillet og importerer den. Ingenting starter på nytt, og lisenssiden viser en ny sluttdato.
Dette kapittelet handler om den filen. Kort sagt er en lisens ett enkelt signert JSON-dokument som er bundet til én installasjon. Installasjonen kontrollerer dokumentet selv, med offentlige nøkler som er innebygd i avbildningen, og gjør ingen nettverkskall for å utføre dette. En lisens er aldri en Helm-verdi og aldri en montert fil. Du importerer den gjennom konsollen, nexusctl eller applikasjonsprogrammeringsgrensesnittet (API-et), og ingen andre steder.
Lisensdokumentet
En lisens er ett JSON-objekt i formatet nexus-licence/v1. Her er Harrows lisens, med de to signaturverdiene 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 obligatorisk, og hvert objekt i dokumentet er lukket. Et medlem som formatet ikke lister opp, blir avvist, slik at ingenting kan følge med utenfor signaturen.
| Felt | Hva den inneholder |
|---|---|
format |
Nøyaktig nexus-licence/v1. Enhver annen verdi, inkludert en senere versjon, blir avvist. |
licence_id |
En UUID (universelt unik identifikator) med små bokstaver. En installasjon importerer hver lisens-ID én gang. |
issued_at |
Tidspunktet da Adverant utstedte den, som YYYY-MM-DDThh:mm:ssZ. |
type |
alpha, evaluation eller commercial. |
channel |
Utgivelseskanalen den ble utstedt for, som alpha. Signert og inkludert; kontrollen forgrener seg ikke basert på den. |
licensee.name |
1 til 200 tegn, signert nøyaktig som skrevet. Brennan og Brennán er to forskjellige navn med to forskjellige signaturer. |
licensee.customer_id |
Din kunde-ID hos Adverant: små bokstaver, sifre, ., _ og -. |
scope.deployment.installation_id |
Installasjonens identitet, opprettet av dens nøkkeltjeneste ved første installasjon. |
scope.tenants |
Organisasjons-ID-er, opptil 1 000. Tom med mindre en tildeling er begrenset til leietaker. |
edition |
enterprise eller team. En Enterprise-lisens tildeler alltid enterprise-base. |
grants |
1 til 500 {feature_group, scope}-par, der hver gruppe nevnes én gang. |
add_ons |
Tilleggs-ID-er fra utgavematrisen, opptil 100. Kan være tom. |
domain_packs |
Domenepakke-ID-er fra utgavematrisen, opptil 100. Kan være tom. |
metric |
kind er per-environment, per-core eller named-seat; quantity er et heltall fra 1. |
term |
starts_on og ends_on er datoer; warn_days og grace_days er heltall fra 0 til 365. |
matrix |
Versjonen av utgavematrisen som gruppene er skrevet mot, og SHA-256-sjekksummen for den matrisefilen, lagret for revisjon. |
signatures |
To signaturer, ed25519 og p256. Det eneste feltet som ikke er signert. |
Datoer er kalenderdatoer i UTC, og dagen må eksistere: 2028-02-29 går fint og 2027-02-29 blir avvist.
To signaturer, begge påkrevd
Adverant signerer hver lisens med to uavhengige nøkler. Den ene signaturen er Ed25519. Den andre er ECDSA (Elliptic Curve Digital Signature Algorithm) på P-256-kurven fra NIST (US National Institute of Standards and Technology), som kjøpere som krever amerikanske føderale algoritmer ber om. Begge lages over de samme bytene, og begge må verifiseres. Et dokument der den ene halvdelen mangler, eller der en av halvdelene er feil, regnes som ingen lisens i det hele tatt.
De signerte bytene er den kanoniske RFC 8785-formen av dokumentet med signatures fjernet, så blanktegn og rekkefølgen på medlemmene i filen din spiller ingen rolle. Et enkelt endret tegn i lisensiatens navn, datoene eller en tildeling utgjør et annet dokument, og det feiler.
De offentlige nøklene kontrollen bruker, ligger i en fil med tillitsrøtter (trust-roots) som er innebygd i hver avbildning ved bygging av utgivelsen. Ingen miljøvariabel, flagg eller montering peker på en annen fil. Når Adverant bytter ut en signeringsnøkkel, signerer den gamle nøkkelen den nye, og neste signerte utgivelse inneholder den nye nøkkelen. En lisens signert med en ny nøkkel verifiseres på en utgivelse som inneholder den, så etter et nøkkelbytte må du kanskje oppgradere før du importerer (se kapittel 2.17, Feilsøking).
Typer, utgaver og hvordan en lisens telles
Feltet type sier hva slags avtale lisensen kommer fra:
alpha: en lisens for alfa-utgivelseskanalen, som er den typen Harrow har.evaluation: en selvvertet prøveversjon av Enterprise. Den varer i høyst 30 dager, for høyst 5 navngitte personer (måleenhetnamed-seat), medgrace_dayssatt til 0. Formatet avviser en evaluering med enhver form for henstandsperiode.commercial: en kontraktsfestet lisens.
Feltet metric registrerer hvordan lisensen telles: per-environment (Harrows produksjonsklynge er ett miljø), per-core eller named-seat. Adverant oppgir prisen; lisensen inneholder kun måleenheten og antallet.
Lisensens edition er enterprise for hver Enterprise-installasjon. Formatet godtar også team, der lisensen tildeler gruppen team og aldri enterprise-base.
Funksjonsgrupper, tillegg og domenepakker
Hva en lisens lar folk bruke, er listet opp etter funksjonsgruppe ved hjelp av ID-ene i utgavematrisen. Harrows lisens tildeler enterprise-base (egendefinerte roller, fire-øyne-godkjenninger, lang oppbevaring av revisjonslogger, bedriftspålogging med håndheving og katalogsynkronisering, forretningsenheter, operatørsidene og resten av Enterprise-basen) og map-and-geoai. Den inneholder tillegget mail og domenepakken logistics-and-maritime.
Matrisen har regler for hva som hører sammen, og Adverants utstedelsessystem kontrollerer dem før en lisens signeres. Hvert tillegg og hver pakke krever enterprise-base. Noen pakker krever tillegg: pakken Logistikk og maritim krever Kart og GeoAI, pakken Forsikring og pakken Kapitalmarkeder og kapitalforvaltning krever Beslutningsrom og forseglede oppføringer, og pakken Juridiske og profesjonelle tjenester krever Beslutningsrom og E-post. Telefonskjermbildene i hver pakke krever også tillegget Mobilapper.
Hver tildeling har et omfang:
deployment: gruppen gjelder for hele installasjonen, for hver organisasjon på den.tenant: gruppen gjelder bare for organisasjonene som er listet opp iscope.tenants. En lisens med en leietakerbegrenset tildeling må liste opp minst én organisasjon, og en liste over organisasjoner uten noen leietakerbegrenset tildeling blir avvist.
Anta at Harrows losteam kjørte som en andre organisasjon på samme installasjon, og at bare denne organisasjonen skulle ha Ideer. Tildelingen ville vært { "feature_group": "ideas", "scope": "tenant" }, med losorganisasjonens ID i scope.tenants. Hvis lisensen ble importert før den organisasjonen eksisterte, ville importsvaret telle den under tenants_without_organisation, og tildelingen ville nå den så snart organisasjonen ble opprettet.
En administrator kan snevre inn hva en gruppe når. Bare en lisens fra Adverant legger til en gruppe.
Perioden: varsel og henstand
Feltet term setter fire datoer i kalenderen. Fra starts_on til ends_on er lisensen gyldig. warn_days angir hvor tidlig varselet starter, og grace_days hvor lenge alt fortsetter å fungere etter sluttdatoen. Lisenser som Adverant utsteder, har 30 dager for hver av disse, med mindre kontrakten sier noe annet. En evaluering har alltid grace_days 0.
For Harrows lisens ovenfor ser kalenderen slik ut:
| Datoer | Tilstand |
|---|---|
| 1. januar 2027 til 1. desember 2027 | VALID |
| 2. desember 2027 til 31. desember 2027 | WARN |
| 1. januar 2028 til 30. januar 2028 | GRACE |
| Fra 31. januar 2028 | RESTRICT |
Den siste dagen i perioden, ends_on, er fortsatt en WARN-dag. Dagen etter er GRACE, eller RESTRICT når det ikke er noen henstandsperiode.
De seks tilstandene
Hver gang lisensen leses, beregner installasjonen tilstanden sin på nytt ut fra dokumentet og gjeldende dato. Ingenting mellomlagres over et døgnskille, så et utløp skjer til rett tid uten en planlagt jobb.
| Tilstand | Når | Hva folk kan gjøre |
|---|---|---|
| ABSENT | Ingen lisens importert, eller dokumentet ble avvist | Community-nivået. Enterprise-områder vises som smakebiter med informasjon om hvem som kan slå dem på. |
| VALID | starts_on til ends_on minus warn_days |
Hver tildelte gruppe har rettigheter. |
| WARN | De siste warn_days dagene av perioden |
Har rettigheter, og administratorer ser et banner i produktet med sluttdatoen. |
| GRACE | Etter ends_on, i grace_days dager |
Har rettigheter, med varselet LICENCE_IN_GRACE på I dag og på lisenssiden. |
| RESTRICT | Etter henstandsperioden | Ingen nytt arbeid kan starte under en lisensiert gruppe. Pågående arbeid fullføres, lesing og eksport fortsetter å fungere, og sikkerhetsoppdateringer fortsetter å komme. |
| TERMINATE | Adverant tilbakekalte lisensen | Enterprise-artefakter slutter å bli tilbudt. Community-nivået og dataeksport gjenstår. |
I alle tilstander fortsetter pågående arbeid å kjøre, sikkerhetsoppdateringer fortsetter å komme, eksporter forblir lesbare og ingenting slettes. I RESTRICT ser en person som prøver å starte nytt Enterprise-arbeid, en avvisningsplate med koden LICENCE_LOCKED og navnet på den som kan fornye.
Hvordan gjeldende dato beregnes
En klokke kan gå feil, og en klokke kan stilles tilbake med vilje. Derfor leser installasjonen aldri klokken alene. Gjeldende dato er det seneste av to tidspunkter: veggklokken og en lagret nedre grense, som er det siste tidspunktet installasjonen har sett. Den nedre grensen flyttes fremover ved hver import og hver tilstandslesing, og den flyttes aldri bakover av seg selv. Å stille klokken en måned tilbake bringer ikke en utløpt lisens tilbake til VALID; en RESTRICT-lisens forblir RESTRICT.
Når klokken viser et tidligere tidspunkt enn den nedre grensen, har tilstanden varselet LICENCE_CLOCK_BEHIND_FLOOR og leses på dagen for den nedre grensen. Hvis klokken faktisk gikk for fort (en node startet opp med feil dato og den nedre grensen ble flyttet fremover), kan du be Adverant om et tidsnullstillingstoken. Det er et lite signert dokument bundet til din installasjons-ID og en engangs-nonce, med et floor_to-tidspunkt. Du importerer det gjennom API-et med denne forespørselen:
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 tilgangstokenet til en installasjonsadministrator. Et token brukes når begge signaturene verifiseres, installasjons-ID-en er din og noncen ikke har blitt brukt. Et avvist token endrer ingenting, så det kan aldri brukes til å avvise en gyldig lisens. Et token hvis nonce allerede er brukt, avvises med LICENCE_CLOCK_BEHIND_FLOOR.
Be om en lisens
Lisenser forespørres og lastes ned fra Adverant-kontoen din på https://account.adverant.ai. Hvem i organisasjonen din som kan gjøre krav på distribusjoner og laste ned lisenser, angis på kontoens side for organisasjons- og teamroller.
Adverant må vite hvilken installasjon lisensen gjelder for, og det er tre måter å fortelle det på.
En engangskode, for en installasjon med skjerm. Installasjonen viser en engangskode og fingeravtrykket sitt. På siden Gjør krav på en distribusjon limer du inn koden, og sammenligner deretter fingeravtrykket gruppe for gruppe med det installasjonen viser. Når hver gruppe samsvarer, gjør du krav på den for organisasjonen din, og lisensen kommer inn på kontoen.
En kravnøkkel, for en applikasjonsboks eller en kantenhet. Disse har ingen skjerm for å vise en kode. Serienummeret og en kravnøkkel er trykt på esken og i utstyrsprodusentens bestilling. Skriv dem inn på siden Skriv inn en kravnøkkel én om gangen, eller slipp produsentens bestillingsfil for å gjøre krav på mange samtidig. Hver nøkkel sjekkes mot Adverants oppføring over hva som ble sendt til deg, og en nøkkel fra noen andres bestilling blir avvist.
En signert lisensforespørsel, for en installasjon uten forbindelse til omverdenen. Dette er Harrows rute. På installasjonen lager en administrator en forespørselsfil under Denne installasjonen, Lisens. Det er en erklæring av typen licence-request som oppgir installasjons-ID-en, signert med installasjonens egen Ed25519-nøkkel. Tomás tar den med ut på godkjente medier, slipper den på siden Frakoblet utveksling, og laster ned lisensfilen som kommer tilbake. Lisensen fungerer bare på installasjonen som opprettet forespørselen.
Importere en lisens
Det er tre veier inn, og de når alle det samme endepunktet på nexus-auth. Bare en installasjonsadministrator kan importere: en eier eller administrator for hele organisasjonen som eier installasjonen, som er logget inn på den, eller en full plattformadministrator. Alle andre blir avvist før filen leses.
I konsollen
På en ny installasjon er Importer lisensen et av de seks sjekkpunktene på Seks ting før noen logger inn. Når du slipper filen på siden, kontrollerer konsollen den på installasjonen, frakoblet, og lister opp funksjonsgruppene med hvordan hver enkelt er beskyttet, samt gyldighetsperioden.
Senere importer går gjennom Denne installasjonen, Lisens: bruk Importer en ny lisens, eller Importer en fornyet lisens når den nåværende har løpt ut. En Community-installasjon som går over til Enterprise, bruker Fra Community til Enterprise. Den siden leser lisensen først og viser hva som vil bli hentet og hva som endres, før noe skjer. Ingenting hentes før noen velger Hent og slå på. Enterprise-delene kommer deretter fra registry.adverant.ai med installasjonens hentetoken (pull token), der hver del sjekkes mot Adverants utgivelsesnøkkel, og gruppene slås på én etter én. Det er den samme installasjonen etterpå, med de samme personene, filene, arbeidsflytene og kanalene.
Med nexusctl
nexusctl licence import harrow-2027.licence.jsonKommandoen importerer filen uendret og skriver ut lisensens nåværende tilstand. Legg til --explain for å skrive ut operasjonene den ville kjørt, uten å kjøre dem.
Gjennom 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 nøyaktig slik Adverant ga den til deg. Ikke omformater den, og ikke pakk den inn i et annet objekt: meldingskroppen er dokumentet. Ruten tar ingen spørrestreng, og en meldingskropp på mer enn 1 MiB blir avvist. Et toppnivåmedlem som oppgir en organisasjon eller en person, avvises med TENANT_NOT_A_PARAMETER eller ACTOR_NOT_A_PARAMETER, fordi installasjonens lisens tilhører installasjonen som tokenets organisasjon eier.
En vellykket import svarer 201. Meldingskroppen inneholder lisensvisningen (ID-en, nåværende tilstand, lisensiaten, utgaven, gyldighetsperioden, tildelingene og funksjonsgruppene), hvor mange organisasjoner som nå har den, og hvor mange opplistede leietakere som ennå ikke har noen organisasjon. Lisensen, dens SHA-256-sjekksum og hovedbokradene for hver organisasjon skrives i én transaksjon, og importen registreres i revisjonsloggen.
To leseruter hører med:
GET /api/v1/installation/licence/statesvarer med tilstanden, beregnet på nytt ved hver lesing. En administrator får hele visningen. Ethvert annet medlem av en organisasjon på installasjonen får bare varselet: tilstanden, varselkoden (LICENCE_ENDS_SOON,LICENCE_IN_GRACEellerLICENCE_CLOCK_BEHIND_FLOOR) og datoene som varselet oppgir. Et medlem ser aldri lisensiaten, gyldighetsperioden eller gruppene, fordi disse tilhører installasjonens eier.GET /api/v1/installation/licence/documentsvarer med det importerte dokumentet, i råformat, for administratorer. Hver Enterprise-modul henter det og kontrollerer signaturene på nytt med sin egen innebygde verifikator, slik at en modifisert identitetstjeneste ikke kan slå på en gruppe som lisensen ikke tildeler.
Hver avvisning
En avvist import endrer ingenting, ikke engang den nedre grensen for klokken, og avvisningen registreres i revisjonsloggen.
| Kode | HTTP | Betydning | Hva du skal gjøre |
|---|---|---|---|
LICENCE_FORMAT_INVALID |
422 | Filen er ikke en lisens denne byggeversjonen kan lese: ikke JSON, ikke riktig skjema, datoer i feil rekkefølge eller en gruppe nevnt to ganger. | Send filen nøyaktig slik Adverant ga den til deg. |
LICENCE_SIGNATURE_INVALID |
422 | En av de to signaturene mangler, eller filen ble endret etter signering. | Be Adverant om filen på nytt, og ikke rediger den. |
LICENCE_ROOT_UNKNOWN |
422 | Den er signert med en nøkkel som denne utgivelsens tillitsrøtter ikke inneholder. | Be om en lisens signert for denne utgivelsens røtter, eller oppgrader. |
LICENCE_MATRIX_MISMATCH |
422 | Den er skrevet mot en utgavematrise som denne byggeversjonen ikke leser, eller tildeler en gruppe som byggeversjonens katalog ikke kjenner til. | Oppgrader til en utgivelse som leser den, eller be om en lisens skrevet mot denne utgivelsen. |
LICENCE_OTHER_INSTALLATION |
409 | Den ble utstedt for en annen installasjons-ID. | Be om en lisens for denne installasjonens identitet. |
LICENCE_REVOKED |
403 | Adverant har trukket tilbake denne lisensen. | Be Adverant om en ny lisens. |
LICENCE_LOCKED |
403 | Lisensen har ikke begynt å gjelde: gjeldende dato er før starts_on. |
Importer den på nytt på eller etter den første dagen. |
TRANSITION_NOT_PERMITTED |
409 | En lisens med denne ID-en er allerede importert. | Be Adverant om en ny lisens hvis vilkårene må endres. |
RECORD_NOT_FOUND |
404 | Installasjonen er ikke deklarert ennå, så den har ingen identitet å sjekke mot. | Fullfør det første administratortrinnet, og importer deretter. |
VALIDATION_FAILED |
400 | Meldingskroppen kunne ikke leses, er over 1 MiB, eller forespørselen hadde en spørrestreng. | Send filen alene som meldingskropp, uten spørring. |
Installasjonen kontrollerer i en fast rekkefølge, og den første feilen bestemmer koden. En manglende halvdel rapporteres før en ukjent nøkkel, og et dokument der signaturene feiler, leses aldri videre, slik at en manipulert fil som også oppgir en annen installasjon, likevel svarer LICENCE_SIGNATURE_INVALID.
Fornyelse
En fornyelse er en ny lisens med en ny licence_id. Importer den på samme måte som den første. Den trer i kraft med en gang, uansett hvilken tilstand den gamle hadde nådd: fra WARN, GRACE eller RESTRICT går installasjonen rett tilbake til lisensiert, og ingenting trenger å installeres på nytt. Adverant kan også utstede en endret lisens midt i perioden, for eksempel for å legge til Beslutningsrom, og du importerer den på samme måte.
Å importere den samme lisensen to ganger avvises med TRANSITION_NOT_PERMITTED.
Tilbakekalling
Adverant trekker tilbake en lisens ved å signere en tilbakekallingsliste. Listen har et sequence-nummer og oppgir hver tilbakekalte lisens-ID med når og hvorfor. Listene er kumulative: hver liste inneholder alle ID-er som er tilbakekalt før den. Du importerer den på samme måte som en lisens:
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 der sekvensnummeret ikke er høyere enn den forrige som ble importert, avvises med TRANSITION_NOT_PERMITTED, slik at en gammel liste ikke kan legges inn igjen i stedet for en nyere. En liste som ikke kan leses eller ikke verifiseres, avvises med de samme kodene som en lisens. Så snart en liste oppgir lisensen din, blir tilstanden TERMINATE.
En installasjon uten forbindelse til omverdenen får bare vite om en tilbakekalling når noen importerer listen. For Harrow er tilbakekalling like mye et spørsmål om kontrakt som om programvare, og Tomás importerer hver liste Adverant sender ved neste overføring.
Plasser utover lisensen
Lisensens antall er et løfte om bruk, og Nexus behandler overskridelser som en advarsel, aldri en utestengelse. Når flere personer bruker Nexus enn det lisensen dekker, ser administratorer platen SEATS_OVER_LICENCE på Personer-siden. Alle fortsetter å jobbe. Platen sier innen når dette må rettes opp (30 dager), viser hvor de ekstra personene kom fra, og tilbyr de to løsningene: fjern personer som ikke trenger Nexus, eller be Adverant om flere plasser. Å legge til plasser er en sensitiv endring som krever en person til, og de ekstra plassene telles med i den årlige bruksoppgaven.
Bruksoppgaven inneholder kun tellere, og du kan lese hver linje før den sendes ut. Harrow lagrer den som en fil og tar den med ut gjennom den frakoblede utvekslingen.
Evalueringer
En evaluering er en lisens av typen evaluation, startet fra kontoens Prøveversjoner-side for en distribusjon det er gjort krav på. Den varer i høyst 30 dager, dekker høyst 5 navngitte personer, og har ingen henstandsperiode. Dagen etter ends_on går den rett til RESTRICT: Enterprise-områder går tilbake til smakebiter, og ingenting som ble laget under evalueringen slettes. Idékjøringer, utkast til retningslinjer og e-postregler beholdes nøyaktig slik de var, og de åpnes igjen så snart en lisens blir importert.
En organisasjon kjører én selvvertet evaluering om gangen.




