Version 1.0.0-alpha.1senaste
Kapitel 2.13
Licenser
Vad en Nexus-licensfil innehåller, hur installationen kontrollerar den offline, de sex tillstånd den kan befinna sig i samt hur ni begär, importerar, förnyar och återkallar en licens.
Denna sida har översatts av AI från det engelska originalet. Om något är oklart är den engelska sidan referensen. Läs denna sida på engelska

Harrow Port Authority kör Nexus Enterprise på sitt eget Kubernetes-kluster vid harrow.example, utan någon väg från klustret till internet. Varje år förnyar Aoife Brennan, IT-chef, avtalet och Tomás Reilly, plattformsingenjören, bär en liten JSON-fil över det luftgapade nätverket och importerar den. Ingenting startas om, och licenssidan visar ett nytt slutdatum.
Det här kapitlet handlar om den filen. Kort sagt är en licens ett enda signerat JSON-dokument som är bundet till en enda installation. Installationen kontrollerar den själv, med publika nycklar som är inbakade i avbilden, och gör inget nätverksanrop för att göra det. En licens är aldrig ett Helm-värde och aldrig en monterad fil. Ni importerar den via konsolen, nexusctl eller applikationsprogrammeringsgränssnittet (API), och ingen annanstans.
Licensdokumentet
En licens är ett enda JSON-objekt i formatet nexus-licence/v1. Här är Harrows, med de två signaturvärdena förkortade.
{
"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>" }
}
}Varje fält är obligatoriskt och varje objekt i dokumentet är slutet. Ett fält som formatet inte anger avvisas, så ingenting kan följa med utanför signaturen.
| Fält | Vad den innehåller |
|---|---|
format |
Exakt nexus-licence/v1. Alla andra värden, inklusive en senare version, avvisas. |
licence_id |
Ett UUID (universally unique identifier) i gemener. En installation importerar varje licens-id en gång. |
issued_at |
Tidpunkten då Adverant utfärdade den, som YYYY-MM-DDThh:mm:ssZ. |
type |
alpha, evaluation eller commercial. |
channel |
Den utgivningskanal som den utfärdades för, till exempel alpha. Signeras och följer med; kontrollen förgrenar sig inte utifrån den. |
licensee.name |
1 till 200 tecken, signerade exakt som de är skrivna. Brennan och Brennán är två olika namn med två olika signaturer. |
licensee.customer_id |
Ert kund-id hos Adverant: gemener, siffror, ., _ och -. |
scope.deployment.installation_id |
Installationens identitet, skapad av dess nyckeltjänst vid den första installationen. |
scope.tenants |
Organisations-id:n, upp till 1 000. Tomt om inte någon tilldelning är begränsad till en klientorganisation (tenant-scoped). |
edition |
enterprise eller team. En Enterprise-licens ger alltid enterprise-base. |
grants |
1 till 500 {feature_group, scope}-par, där varje grupp namnges en gång. |
add_ons |
Tilläggs-id:n (add-on) från utgåvematrisen, upp till 100. Kan vara tomt. |
domain_packs |
Domänpakets-id:n från utgåvematrisen, upp till 100. Kan vara tomt. |
metric |
kind är per-environment, per-core eller named-seat; quantity är ett heltal från 1. |
term |
starts_on och ends_on är datum; warn_days och grace_days är heltal från 0 till 365. |
matrix |
Den version av utgåvematrisen som grupperna är skrivna mot, samt SHA-256-kontrollsumman för den matrisfilen, sparad för revision. |
signatures |
Två signaturer, ed25519 och p256. Det enda fältet som inte är signerat. |
Datum är kalenderdatum i UTC, och dagen måste existera: 2028-02-29 går bra och 2027-02-29 avvisas.
Två signaturer, båda krävs
Adverant signerar varje licens med två oberoende nycklar. Den ena signaturen är Ed25519. Den andra är ECDSA (Elliptic Curve Digital Signature Algorithm) på P-256-kurvan från NIST (US National Institute of Standards and Technology), vilket köpare som behöver amerikanska federala algoritmer efterfrågar. Båda skapas över samma byte, och båda måste verifieras. Ett dokument där den ena halvan saknas, eller där någondera halvan är felaktig, räknas som ingen licens alls.
De signerade byten är den kanoniska formen av dokumentet enligt RFC 8785 med signatures borttaget, så blanksteg och ordningen på fälten i er fil spelar ingen roll. Ett enda ändrat tecken i licenstagarens namn, datumen eller en tilldelning ger ett annat dokument, och då misslyckas valideringen.
De publika nycklar som kontrollen använder ligger i en fil för betrodda rötter (trust-roots) som bakas in i varje avbild när utgåvan byggs. Ingen miljövariabel, flagga eller montering pekar ut en annan fil. När Adverant byter ut en signeringsnyckel signerar den gamla nyckeln den nya, och nästa signerade utgåva innehåller den nya nyckeln. En licens som är signerad med en ny nyckel verifieras på en utgåva som innehåller den, så efter ett nyckelbyte kan ni behöva uppgradera innan ni importerar (se kapitel 2.17, Felsökning).
Typer, utgåvor och hur en licens räknas
Fältet type anger vilken typ av avtal licensen kommer från:
alpha: en licens för utgivningskanalen alpha, vilket är den typ som Harrow har.evaluation: en utvärderingsversion av Enterprise i egen regi. Den gäller i högst 30 dagar, för högst 5 namngivna personer (mätvärdenamed-seat), medgrace_dayssatt till 0. Formatet avvisar en utvärdering som har någon som helst respitperiod (grace).commercial: en avtalad licens.
Fältet metric registrerar hur licensen räknas: per-environment (Harrows produktionskluster är en miljö), per-core eller named-seat. Adverant lämnar prisuppgift; licensen innehåller endast måttet och antalet.
Licensens edition är enterprise för varje Enterprise-installation. Formatet accepterar även team, där licensen ger gruppen team och aldrig enterprise-base.
Funktionsgrupper, tillägg och domänpaket
Vad en licens låter användare använda listas per funktionsgrupp, med hjälp av id:na i utgåvematrisen. Harrows licens ger enterprise-base (anpassade roller, godkännande enligt fyra-ögon-principen, lång lagringstid för revisionsloggar, företagsinloggning med tvingande krav och katalogsynkronisering, affärsenheter, operatörssidorna och resten av Enterprise-basen) samt map-and-geoai. Den innehåller tillägget mail och domänpaketet logistics-and-maritime.
Matrisen har regler för vad som hör ihop, och Adverants utfärdandefunktion kontrollerar dem innan en licens signeras. Varje tillägg och varje paket kräver enterprise-base. Vissa paket kräver tillägg: paketet Logistik och sjöfart kräver Karta och GeoAI, paketet Försäkring samt paketet Kapitalmarknad och kapitalförvaltning kräver Beslutsrum och förseglade poster, och paketet Juridik och professionella tjänster kräver Beslutsrum och E-post. Telefonskärmarna i varje paket kräver dessutom tillägget Mobilappar.
Varje tilldelning har en omfattning (scope):
deployment: gruppen gäller för hela installationen, för varje organisation på den.tenant: gruppen gäller endast för de organisationer som anges iscope.tenants. En licens med en tilldelning som är begränsad till klientorganisationer (tenant-scoped) måste ange minst en organisation, och en lista över organisationer utan någon sådan tilldelning avvisas.
Anta att Harrows lotsningsteam kördes som en andra organisation på samma installation, och att endast den organisationen skulle ha Idéer (Ideas). Tilldelningen skulle då lyda { "feature_group": "ideas", "scope": "tenant" }, med lotsningsorganisationens id i scope.tenants. Om licensen importerades innan den organisationen fanns, skulle importsvaret räkna den under tenants_without_organisation, och tilldelningen skulle nå den så snart organisationen skapats.
En administratör kan begränsa vad en grupp når. Endast en licens från Adverant lägger till en grupp.
Löptiden: varning och respit
Fältet term sätter fyra datum i kalendern. Från starts_on till ends_on är licensen i kraft. warn_days anger hur tidigt varningen börjar, och grace_days hur länge allt fortsätter att fungera efter slutet. Licenser som Adverant utfärdar har 30 dagar av vardera om inte avtalet säger något annat. En utvärdering har alltid grace_days 0.
För Harrows licens ovan ser kalendern ut så här:
| Datum | Tillstånd |
|---|---|
| 1 januari 2027 till 1 december 2027 | VALID |
| 2 december 2027 till 31 december 2027 | WARN |
| 1 januari 2028 till 30 januari 2028 | GRACE |
| Från 31 januari 2028 | RESTRICT |
Den sista dagen av giltighetstiden, ends_on, är fortfarande en WARN-dag. Dagen efter den är GRACE, eller RESTRICT när det inte finns någon respitperiod.
De sex tillstånden
Varje gång licensen läses beräknar installationen dess tillstånd på nytt utifrån dokumentet och det aktuella datumet. Ingenting cachas över en dygnsgräns, så ett utgångsdatum träder i kraft i tid utan något schemalagt jobb.
| Tillstånd | När | Vad användare kan göra |
|---|---|---|
| ABSENT | Ingen licens importerad, eller så avvisades dokumentet | Community-basnivån. Enterprise-områden visas som förhandsvisningar med uppgift om vem som kan aktivera dem. |
| VALID | starts_on till ends_on minus warn_days |
Varje tilldelad grupp är berättigad. |
| WARN | De sista warn_days dagarna av giltighetstiden |
Berättigad, och administratörer ser en banner i produkten med slutdatumet. |
| GRACE | Efter ends_on, under grace_days dagar |
Berättigad, med meddelandet LICENCE_IN_GRACE på Idag (Today) och på licenssidan. |
| RESTRICT | Efter respitperioden | Inget nytt arbete kan startas under en licensierad grupp. Pågående arbete slutförs, läsningar och exporter fortsätter att fungera och säkerhetsuppdateringar fortsätter att komma in. |
| TERMINATE | Adverant återkallade licensen | Enterprise-artefakter slutar erbjudas. Community-basnivån och dataexport finns kvar. |
I varje tillstånd fortsätter pågående arbete att köras, säkerhetsuppdateringar fortsätter att komma in, exporter förblir läsbara och ingenting raderas. I RESTRICT ser en person som försöker starta nytt Enterprise-arbete en avvisningsskylt med koden LICENCE_LOCKED och namnet på den som kan förnya licensen.
Hur det aktuella datumet beräknas
En klocka kan gå fel, och en klocka kan ställas tillbaka med flit. Därför läser installationen aldrig enbart av klockan. Det aktuella datumet är den senare av två tidpunkter: systemklockan och en lagrad lägstanivå (floor), vilket är den senaste tidpunkt som installationen har sett. Lägstanivån flyttas framåt vid varje import och varje läsning av tillståndet, och den flyttas aldrig bakåt av sig själv. Att ställa tillbaka klockan en månad får inte en utgången licens att återgå till VALID; en RESTRICT-licens förblir RESTRICT.
När klockan visar en tidpunkt som är tidigare än lägstanivån, innehåller tillståndet meddelandet LICENCE_CLOCK_BEHIND_FLOOR och läses vid lägstanivåns dag. Om klockan faktiskt gick för fort (en nod startade med fel datum och lägstanivån flyttades fram), kan ni be Adverant om en token för tidsåterställning (time-reset token). Det är ett litet signerat dokument som är bundet till ert installations-id och ett engångsvärde (nonce), med en floor_to-tidpunkt. Ni importerar det via API:et med följande anrop:
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> är åtkomsttoken för en installationsadministratör. En token tillämpas när båda signaturerna verifieras, dess installations-id är ert och dess engångsvärde inte har använts. En avvisad token ändrar ingenting, så den kan aldrig användas för att avvisa en giltig licens. En token vars engångsvärde redan har använts avvisas med LICENCE_CLOCK_BEHIND_FLOOR.
Begära en licens
Licenser begärs och laddas ned från ert Adverant-konto på https://account.adverant.ai. Vem i er organisation som får göra anspråk på driftsättningar och ladda ned licenser ställs in på kontots sida för organisations- och teamroller.
Adverant behöver veta vilken installation licensen gäller för, och det finns tre sätt att meddela det.
En engångskod, för en installation med skärm. Installationen visar en engångskod och sitt fingeravtryck. På sidan Gör anspråk på en driftsättning (Claim a deployment) klistrar ni in koden och jämför sedan fingeravtrycket grupp för grupp med vad installationen visar. När varje grupp stämmer överens gör ni anspråk på den för er organisation, och licensen levereras till kontot.
En anspråksnyckel (claim key), för en hårdvaruenhet (appliance) eller en kantenhet (edge device). Dessa har ingen skärm som kan visa en kod. Serienumret och en anspråksnyckel är tryckta på förpackningen och i utrustningstillverkarens beställning. Ange dem en i taget på sidan Ange en anspråksnyckel (Enter a claim key), eller släpp tillverkarens beställningsfil för att göra anspråk på många samtidigt. Varje nyckel kontrolleras mot Adverants register över vad som har levererats till er, och en nyckel från någon annans beställning avvisas.
En signerad licensbegäran, för en installation utan extern anslutning. Detta är Harrows väg. På installationen skapar en administratör en begärandefil under Den här installationen, Licens (This installation, Licence). Det är ett utlåtande av typen licence-request som namnger installations-id:t, signerat med installationens egen Ed25519-nyckel. Tomás tar ut den på ett godkänt lagringsmedium, släpper den på sidan Offline-utbyte (Offline exchange) och laddar ned licensfilen som kommer tillbaka. Licensen fungerar endast på den installation som skapade begäran.
Importera en licens
Det finns tre vägar in, och de når alla samma slutpunkt på nexus-auth. Endast en installationsadministratör kan importera: en ägare eller administratör för hela den organisation som äger installationen, inloggad på den, eller en fullständig plattformsadministratör. Alla andra avvisas innan filen läses.
I konsolen
På en ny installation är Importera licensen (Import the licence) en av de sex kontrollerna under Sex saker innan någon loggar in (Six things before anyone signs in). När ni släpper filen på sidan kontrollerar konsolen den på installationen, offline, och listar dess funktionsgrupper med hur var och en är skyddad samt giltighetstiden.
Senare importer går via Den här installationen, Licens (This installation, Licence): använd Importera en ny licens (Import a new licence), eller Importera en förnyad licens (Import a renewed licence) när den nuvarande har löpt ut. En Community-installation som går över till Enterprise använder Från Community till Enterprise (From Community to Enterprise). Den sidan läser licensen först och visar vad som kommer att hämtas och vad som ändras, innan någonting sker. Ingenting hämtas förrän någon väljer Hämta och aktivera (Fetch and switch on). Enterprise-delarna kommer då från registry.adverant.ai med installationens hämttoken (pull token), var och en kontrolleras mot Adverants utgåvenyckel, och grupperna aktiveras en i taget. Det är samma installation efteråt, med samma personer, filer, arbetsflöden och kanaler.
Med nexusctl
nexusctl licence import harrow-2027.licence.jsonKommandot importerar filen oförändrad och skriver ut licensens aktuella tillstånd. Lägg till --explain för att skriva ut de åtgärder som det skulle köra utan att köra 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.jsonSkicka filen exakt så som Adverant gav den till er. Omformatera den inte och kapsla inte in den i ett annat objekt: meddelandekroppen (body) är dokumentet. Vägen tar ingen frågesträng (query string), och en meddelandekropp på mer än 1 MiB avvisas. Ett fält på toppnivå som namnger en organisation eller en person avvisas med TENANT_NOT_A_PARAMETER eller ACTOR_NOT_A_PARAMETER, eftersom installationens licens tillhör den installation som ägs av organisationen för den aktuella token.
En godkänd import svarar 201. Meddelandekroppen innehåller licensvyn (dess id, dess aktuella tillstånd, licenstagaren, utgåvan, giltighetstiden, tilldelningarna och funktionsgrupperna), hur många organisationer som nu innehar den, och hur många listade klientorganisationer (tenants) som ännu inte har någon organisation. Licensen, dess SHA-256-kontrollsumma och huvudboksraderna (ledger rows) för varje organisation skrivs i en enda transaktion, och importen registreras i revisionsloggen.
Två läsvägar hör till den:
GET /api/v1/installation/licence/statesvarar med tillståndet, omberäknat vid varje läsning. En administratör får hela vyn. Alla andra medlemmar i en organisation på installationen får endast meddelandet: tillståndet, meddelandekoden (LICENCE_ENDS_SOON,LICENCE_IN_GRACEellerLICENCE_CLOCK_BEHIND_FLOOR) och de datum som meddelandet anger. En medlem ser aldrig licenstagaren, giltighetstiden eller grupperna, eftersom dessa tillhör installationens ägare.GET /api/v1/installation/licence/documentsvarar med det importerade dokumentet i råformat för administratörer. Varje Enterprise-modul hämtar det och kontrollerar signaturerna igen med sin egen inkompilerade verifierare, så att en modifierad identitetstjänst inte kan aktivera en grupp som licensen inte tilldelar.
Varje avvisning
En avvisad import ändrar ingenting, inte ens klockans lägstanivå, och avvisningen registreras i revisionsloggen.
| Kod | HTTP | Betydelse | Vad du ska göra |
|---|---|---|---|
LICENCE_FORMAT_INVALID |
422 | Filen är inte en licens som det här bygget kan läsa: inte JSON, inte enligt schemat, datum i fel ordning eller en grupp som namnges två gånger. | Skicka filen exakt så som Adverant gav den till er. |
LICENCE_SIGNATURE_INVALID |
422 | En av de två signaturerna saknas, eller så har filen ändrats efter signeringen. | Be Adverant om filen igen, och redigera den inte. |
LICENCE_ROOT_UNKNOWN |
422 | Den är signerad med en nyckel som den här utgåvans betrodda rötter inte innehåller. | Be om en licens som är signerad för den här utgåvans rötter, eller uppgradera. |
LICENCE_MATRIX_MISMATCH |
422 | Den är skriven mot en utgåvematris som det här bygget inte läser, eller så tilldelar den en grupp som byggets katalog inte känner till. | Uppgradera till en utgåva som läser den, eller be om en licens som är skriven mot den här utgåvan. |
LICENCE_OTHER_INSTALLATION |
409 | Den utfärdades för ett annat installations-id. | Be om en licens för den här installationens identitet. |
LICENCE_REVOKED |
403 | Adverant har dragit tillbaka den här licensen. | Be Adverant om en ny licens. |
LICENCE_LOCKED |
403 | Licensen har inte börjat gälla: det aktuella datumet är före starts_on. |
Importera den igen på eller efter dess första dag. |
TRANSITION_NOT_PERMITTED |
409 | En licens med det här id:t har redan importerats. | Be Adverant om en ny licens om villkoren måste ändras. |
RECORD_NOT_FOUND |
404 | Installationen har inte deklarerats ännu, så den har ingen identitet att kontrollera mot. | Slutför det första administratörssteget och importera sedan. |
VALIDATION_FAILED |
400 | Meddelandekroppen kunde inte läsas, är över 1 MiB, eller så hade anropet en frågesträng. | Skicka enbart filen som meddelandekropp, utan frågesträng. |
Installationen utför kontrollerna i en fast ordning, och det första felet avgör koden. En saknad signaturhalva rapporteras före en okänd nyckel, och ett dokument vars signaturer inte godkänns läses aldrig vidare, så en manipulerad fil som även anger en annan installation svarar ändå LICENCE_SIGNATURE_INVALID.
Förnyelse
En förnyelse är en ny licens med ett nytt licence_id. Importera den på samma sätt som den första. Den träder i kraft omedelbart, oavsett vilket tillstånd den gamla hade nått: från WARN, GRACE eller RESTRICT går installationen direkt tillbaka till licensierat läge, och ingenting behöver installeras om. Adverant kan också utfärda en ändrad licens mitt under giltighetstiden, till exempel för att lägga till Beslutsrum, och ni importerar den på samma sätt.
Att importera samma licens två gånger avvisas med TRANSITION_NOT_PERMITTED.
Återkallelse
Adverant drar tillbaka en licens genom att signera en spärrlista (revocation list). Listan har ett sequence-nummer och anger varje tillbakadraget licens-id med uppgift om när och varför. Listorna är kumulativa: var och en innehåller alla id:n som har återkallats före den. Ni importerar den på samma sätt 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 lista vars sekvensnummer inte är högre än den senast importerade avvisas med TRANSITION_NOT_PERMITTED, så en gammal lista kan inte läggas tillbaka i stället för en nyare. En lista som inte kan läsas eller inte kan verifieras avvisas med samma koder som en licens. Så snart en lista namnger er licens är dess tillstånd TERMINATE.
En installation utan extern anslutning får endast kännedom om en återkallelse när någon importerar listan. För Harrow är återkallelse en fråga om avtal lika mycket som om programvara, och Tomás importerar varje lista som Adverant skickar vid nästa överföring.
Platser utöver licensen
Licensens kvantitet är ett löfte om användning, och Nexus behandlar ett överskridande som en varning, aldrig som en utelåsning. När fler personer använder Nexus än vad licensen täcker, ser administratörerna skylten SEATS_OVER_LICENCE på sidan Personer (People). Alla fortsätter att arbeta. Skylten anger när det senast ska vara åtgärdat (30 dagar), visar varifrån de extra personerna kom och erbjuder de två lösningarna: ta bort personer som inte behöver Nexus, eller be Adverant om fler platser (seats). Att lägga till platser är en känslig ändring som kräver en andra person, och de extra platserna räknas med i den årliga användningsrapporten.
Användningsrapporten innehåller endast räknare, och ni kan läsa varje rad innan den skickas iväg. Harrow sparar den som en fil och tar ut den via offline-utbytet.
Utvärderingar
En utvärdering är en licens av typen evaluation, som startas från kontots sida Utvärderingar (Trials) för en driftsättning som man har gjort anspråk på. Den varar i högst 30 dagar, täcker högst 5 namngivna personer och har ingen respitperiod. Dagen efter ends_on går den direkt till RESTRICT: Enterprise-områden återgår till förhandsvisningar och ingenting som skapats under utvärderingen raderas. Idékörningar, utkast till policyer och e-postregler behålls exakt som de var, och de öppnas igen så snart en licens importeras.
En organisation kör en utvärdering i egen regi åt gången.




