Version 1.0.0-alpha.1aktuell
Kapitel 2.13
Lizenzen
Was eine Nexus-Lizenzdatei enthält, wie die Installation sie offline überprüft, welche sechs Status sie annehmen kann und wie Sie eine Lizenz anfordern, importieren, verlängern und widerrufen.
Diese Seite wurde mithilfe von KI aus dem englischen Original übersetzt. Bei Unklarheiten gilt die englische Seite als Referenz. Diese Seite auf Englisch lesen

Die Harrow Port Authority betreibt Nexus Enterprise auf ihrem eigenen Kubernetes-Cluster unter harrow.example, ohne Verbindung vom Cluster zum Internet. Jedes Jahr verlängert Aoife Brennan, Leiterin der IT, den Vertrag, und Tomás Reilly, der Plattform-Ingenieur, überträgt eine kleine JSON-Datei über die Sicherheitsschranke hinweg und importiert sie. Nichts wird neu gestartet, und die Lizenzseite zeigt ein neues Enddatum an.
Dieses Kapitel handelt von dieser Datei. Kurz gesagt ist eine Lizenz ein einzelnes signiertes JSON-Dokument, das an eine Installation gebunden ist. Die Installation überprüft es selbst mithilfe von öffentlichen Schlüsseln, die fest in das Image integriert sind, und führt dazu keinen Netzwerkaufruf durch. Eine Lizenz ist niemals ein Helm-Wert und niemals eine eingebundene Datei. Sie importieren sie über die Konsole, nexusctl oder die Programmierschnittstelle (API) und nirgendwo sonst.
Das Lizenzdokument
Eine Lizenz ist ein einzelnes JSON-Objekt im Format nexus-licence/v1. Hier ist die Lizenz von Harrow, wobei die beiden Signaturwerte gekürzt sind.
{
"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>" }
}
}Jedes Feld ist ein Pflichtfeld, und jedes Objekt im Dokument ist abgeschlossen. Ein Element, das im Format nicht aufgeführt ist, wird abgelehnt, sodass nichts außerhalb der Signatur mitgeschleust werden kann.
| Feld | Inhalt |
|---|---|
format |
Genau nexus-licence/v1. Jeder andere Wert, einschließlich einer späteren Version, wird abgelehnt. |
licence_id |
Eine kleingeschriebene UUID (Universally Unique Identifier). Eine Installation importiert jede Lizenz-ID einmal. |
issued_at |
Der Zeitpunkt, zu dem Adverant sie ausgestellt hat, als YYYY-MM-DDThh:mm:ssZ. |
type |
alpha, evaluation oder commercial. |
channel |
Der Release-Kanal, für den sie ausgestellt wurde, wie etwa alpha. Signiert und mitgeführt; die Prüfung verzweigt nicht anhand dieses Werts. |
licensee.name |
1 bis 200 Zeichen, exakt wie geschrieben signiert. Brennan und Brennán sind zwei verschiedene Namen mit zwei verschiedenen Signaturen. |
licensee.customer_id |
Ihre Kunden-ID bei Adverant: Kleinbuchstaben, Ziffern, ., _ und -. |
scope.deployment.installation_id |
Die Identität der Installation, die bei der Erstinstallation von ihrem Schlüsseldienst geprägt wird. |
scope.tenants |
Organisations-IDs, bis zu 1.000. Leer, sofern nicht eine Berechtigung mandantenbezogen ist. |
edition |
enterprise oder team. Eine Enterprise-Lizenz gewährt immer enterprise-base. |
grants |
1 bis 500 {feature_group, scope}-Paare, wobei jede Gruppe einmal genannt wird. |
add_ons |
Add-on-IDs aus der Editionsmatrix, bis zu 100. Kann leer sein. |
domain_packs |
Domänenpaket-IDs aus der Editionsmatrix, bis zu 100. Kann leer sein. |
metric |
kind ist per-environment, per-core oder named-seat; quantity ist eine ganze Zahl ab 1. |
term |
starts_on und ends_on sind Datumsangaben; warn_days und grace_days sind ganze Zahlen von 0 bis 365. |
matrix |
Die Version der Editionsmatrix, gegen die die Gruppen definiert wurden, sowie der SHA-256-Hash dieser Matrixdatei, aufbewahrt für Prüfzwecke. |
signatures |
Zwei Signaturen, ed25519 und p256. Das einzige Feld, das nicht signiert ist. |
Datumsangaben sind Kalenderdaten in UTC, und der Tag muss existieren: 2028-02-29 ist gültig und 2027-02-29 wird abgelehnt.
Zwei Signaturen, beide erforderlich
Adverant signiert jede Lizenz mit zwei unabhängigen Schlüsseln. Eine Signatur ist Ed25519. Die andere ist ECDSA (Elliptic Curve Digital Signature Algorithm) auf der P-256-Kurve des NIST (National Institute of Standards and Technology der USA), die von Käufern verlangt wird, welche Algorithmen gemäß US-Bundesstandards benötigen. Beide werden über dieselben Bytes erstellt, und beide müssen verifiziert werden können. Ein Dokument, bei dem eine Hälfte fehlt oder eine der beiden Hälften falsch ist, gilt als überhaupt keine Lizenz.
Die signierten Bytes entsprechen der kanonischen Form des Dokuments nach RFC 8785 ohne signatures, sodass Leerzeichen und die Reihenfolge der Elemente in Ihrer Datei keinen Unterschied machen. Ein einziges geändertes Zeichen im Namen des Lizenznehmers, in den Datumsangaben oder in einer Berechtigung ergibt ein anderes Dokument, und die Prüfung schlägt fehl.
Die öffentlichen Schlüssel, die für die Prüfung verwendet werden, befinden sich in einer Trust-Roots-Datei, die beim Erstellen des Releases fest in jedes Image integriert wird. Keine Umgebungsvariable, kein Flag und kein Mount verweist auf eine andere Datei. Wenn Adverant einen Signaturschlüssel ersetzt, signiert der alte Schlüssel den neuen, und das nächste signierte Release enthält den neuen Schlüssel. Eine mit einem neuen Schlüssel signierte Lizenz lässt sich auf einem Release verifizieren, das diesen Schlüssel enthält. Nach einem Schlüsselwechsel müssen Sie daher möglicherweise ein Upgrade durchführen, bevor Sie die Lizenz importieren können (siehe Kapitel 2.17, Fehlerbehebung).
Typen, Editionen und wie eine Lizenz gezählt wird
Das Feld type gibt an, aus welcher Art von Vereinbarung die Lizenz stammt:
alpha: eine Lizenz für den Alpha-Release-Kanal; dies ist die Art von Lizenz, über die Harrow verfügt.evaluation: eine selbst gehostete Testversion von Enterprise. Sie läuft höchstens 30 Tage lang für maximal 5 namentlich benannte Personen (Metriknamed-seat), wobeigrace_daysauf 0 gesetzt ist. Das Format lehnt eine Evaluierungslizenz mit jeglicher Kulanzfrist ab.commercial: eine vertraglich vereinbarte Lizenz.
Das Feld metric hält fest, wie die Lizenz gezählt wird: per-environment (der Produktions-Cluster von Harrow entspricht einer Umgebung), per-core oder named-seat. Adverant gibt den Preis im Angebot an; die Lizenz enthält lediglich die Maßeinheit und die Menge.
Das Lizenzfeld edition lautet enterprise für jede Enterprise-Installation. Das Format akzeptiert auch team, wobei die Lizenz die Gruppe team und niemals enterprise-base gewährt.
Funktionsgruppen, Add-ons und Branchenpakete
Was Personen mit einer Lizenz nutzen können, ist nach Funktionsgruppen unter Verwendung der IDs der Editionsmatrix aufgelistet. Die Lizenz von Harrow gewährt enterprise-base (benutzerdefinierte Rollen, Vier-Augen-Genehmigungen, lange Aufbewahrungsfristen für Audits, Unternehmensanmeldung mit Durchsetzung und Verzeichnissynchronisierung, Geschäftseinheiten, die Betreiberseiten und den Rest der Enterprise-Basis) sowie map-and-geoai. Sie umfasst das Add-on mail und das Domänenpaket logistics-and-maritime.
Die Matrix enthält Regeln darüber, was zusammenpasst, und das Ausstellungssystem von Adverant überprüft diese, bevor eine Lizenz signiert wird. Jedes Add-on und jedes Paket erfordert enterprise-base. Einige Pakete erfordern Add-ons: Das Paket „Logistik und Schifffahrt“ erfordert „Karten und GeoAI“, das Paket „Versicherungen“ und das Paket „Kapitalmärkte und Vermögensverwaltung“ erfordern „Entscheidungsräume und versiegelte Unterlagen“, und das Paket „Rechts- und Unternehmensberatung“ erfordert „Entscheidungsräume“ und „E-Mail“. Die Telefonansichten jedes Pakets erfordern außerdem das Add-on „Mobile Apps“.
Jede Berechtigung hat einen Geltungsbereich:
deployment: Die Gruppe gilt für die gesamte Installation, für jede darauf befindliche Organisation.tenant: Die Gruppe gilt nur für die inscope.tenantsaufgeführten Organisationen. Eine Lizenz mit einer mandantenbezogenen Berechtigung muss mindestens eine Organisation aufführen, und eine Liste von Organisationen ohne mandantenbezogene Berechtigung wird abgelehnt.
Nehmen wir an, das Lotsenteam von Harrow würde als zweite Organisation auf derselben Installation betrieben und nur diese Organisation sollte über Ideas verfügen. Die Berechtigung würde { "feature_group": "ideas", "scope": "tenant" } lauten, mit der ID der Lotsenorganisation in scope.tenants. Würde die Lizenz importiert, bevor diese Organisation existiert, würde die Importantwort sie unter tenants_without_organisation zählen, und die Berechtigung würde für sie greifen, sobald die Organisation angelegt wurde.
Ein Administrator kann einschränken, worauf sich eine Gruppe erstreckt. Nur eine Lizenz von Adverant fügt eine Gruppe hinzu.
Die Laufzeit: Vorwarnung und Kulanzfrist
Das Feld term legt vier Daten im Kalender fest. Von starts_on bis ends_on ist die Lizenz in Kraft. warn_days legt fest, wie früh die Warnung beginnt, und grace_days, wie lange nach dem Ende alles weiter funktioniert. Von Adverant ausgestellte Lizenzen beinhalten jeweils 30 Tage, sofern der Vertrag nichts anderes vorsieht. Eine Evaluierungslizenz hat immer den Wert grace_days 0.
Für die obige Lizenz von Harrow ergibt sich folgender Kalenderablauf:
| Daten | Zustand |
|---|---|
| 1. Januar 2027 bis 1. Dezember 2027 | VALID |
| 2. Dezember 2027 bis 31. Dezember 2027 | WARN |
| 1. Januar 2028 bis 30. Januar 2028 | GRACE |
| Ab 31. Januar 2028 | RESTRICT |
Der letzte Tag der Laufzeit, ends_on, ist noch ein WARN-Tag. Der Tag danach ist GRACE oder RESTRICT, wenn es keine Kulanzfrist gibt.
Die sechs Status
Jedes Mal, wenn die Lizenz gelesen wird, berechnet die Installation ihren Status anhand des Dokuments und des aktuellen Datums neu. Nichts wird über eine Tagesgrenze hinaus zwischengespeichert, sodass ein Ablauf pünktlich erfolgt, ohne dass ein geplanter Auftrag erforderlich ist.
| Zustand | Wann | Was Benutzer tun können |
|---|---|---|
| ABSENT | Keine Lizenz importiert oder das Dokument wurde abgelehnt | Die Community-Basis. Enterprise-Bereiche werden als Vorschau mit Angabe der Person angezeigt, die sie aktivieren kann. |
| VALID | starts_on bis ends_on abzüglich warn_days |
Jede gewährte Gruppe ist nutzungsberechtigt. |
| WARN | Die letzten warn_days Tage der Laufzeit |
Nutzungsberechtigt, und Administratoren sehen im Produkt ein Banner mit dem Enddatum. |
| GRACE | Nach ends_on, für grace_days Tage |
Nutzungsberechtigt, mit dem Hinweis LICENCE_IN_GRACE auf „Heute“ und auf der Lizenzseite. |
| RESTRICT | Nach der Kulanzfrist | Unter einer lizenzierten Gruppe können keine neuen Arbeiten begonnen werden. Laufende Arbeiten werden abgeschlossen, Lesevorgänge und Exporte funktionieren weiterhin, und Sicherheitskorrekturen treffen weiterhin ein. |
| TERMINATE | Adverant hat die Lizenz widerrufen | Enterprise-Artefakte werden nicht mehr angeboten. Die Community-Basis und der Datenexport bleiben erhalten. |
In jedem Status laufen begonnene Arbeiten weiter, Sicherheitskorrekturen treffen weiterhin ein, Exporte bleiben lesbar und nichts wird gelöscht. Im Status RESTRICT sieht eine Person, die versucht, neue Enterprise-Arbeiten zu starten, einen Ablehnungshinweis mit dem Code LICENCE_LOCKED und dem Namen der Person, die eine Verlängerung vornehmen kann.
Wie das aktuelle Datum ermittelt wird
Eine Uhr kann falsch gehen, und eine Uhr kann absichtlich zurückgestellt werden. Daher liest die Installation niemals die Uhr allein aus. Das aktuelle Datum ist der spätere von zwei Zeitpunkten: die Systemuhr und eine gespeicherte Untergrenze, welche der letzte Zeitpunkt ist, den die Installation gesehen hat. Die Untergrenze rückt bei jedem Import und jedem Lesen des Status vor und bewegt sich niemals von selbst zurück. Das Zurückstellen der Uhr um einen Monat bringt eine abgelaufene Lizenz nicht wieder auf VALID; eine Lizenz im Status RESTRICT bleibt auf RESTRICT.
Wenn die Uhr eine frühere Zeit als die Untergrenze anzeigt, trägt der Status den Hinweis LICENCE_CLOCK_BEHIND_FLOOR und wird mit dem Tag der Untergrenze gelesen. Wenn die Uhr tatsächlich vorgegangen ist (ein Knoten wurde mit dem falschen Datum gestartet und die Untergrenze wurde fortgeschrieben), bitten Sie Adverant um ein Token zum Zurücksetzen der Zeit. Dabei handelt es sich um ein kleines signiertes Dokument, das an Ihre Installations-ID und eine einmalige Nonce gebunden ist, mit einem floor_to-Zeitpunkt. Sie importieren es über die API mit dieser Anfrage:
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> ist das Zugriffstoken eines Installationsadministrators. Ein Token wird angewendet, wenn beide Signaturen verifiziert werden können, seine Installations-ID die Ihre ist und seine Nonce noch nicht verwendet wurde. Ein abgelehntes Token ändert nichts, sodass es niemals dazu verwendet werden kann, eine gültige Lizenz abzulehnen. Ein Token, dessen Nonce bereits verwendet wurde, wird mit LICENCE_CLOCK_BEHIND_FLOOR abgelehnt.
Anfordern einer Lizenz
Lizenzen werden über Ihr Adverant-Konto unter https://account.adverant.ai angefordert und heruntergeladen. Wer in Ihrer Organisation Bereitstellungen beanspruchen und Lizenzen herunterladen darf, wird auf der Seite „Organisations- und Teamrollen“ des Kontos festgelegt.
Adverant muss wissen, für welche Installation die Lizenz bestimmt ist, und es gibt drei Möglichkeiten, dies mitzuteilen.
Ein Einmalcode für eine Installation mit Bildschirm. Die Installation zeigt einen Einmalcode und ihren Fingerabdruck an. Auf der Seite „Bereitstellung beanspruchen“ fügen Sie den Code ein und vergleichen dann den Fingerabdruck Gruppe für Gruppe mit dem, was die Installation anzeigt. Wenn jede Gruppe übereinstimmt, beanspruchen Sie sie für Ihre Organisation, und die Lizenz wird im Konto bereitgestellt.
Ein Beanspruchungsschlüssel für eine Appliance oder ein Edge-Gerät. Diese haben keinen Bildschirm, um einen Code anzuzeigen. Die Seriennummer und ein Beanspruchungsschlüssel sind auf dem Karton und in der Bestellung des Geräteherstellers aufgedruckt. Geben Sie sie einzeln auf der Seite „Beanspruchungsschlüssel eingeben“ ein oder legen Sie die Bestelldatei des Herstellers ab, um viele auf einmal zu beanspruchen. Jeder Schlüssel wird mit den Aufzeichnungen von Adverant darüber abgeglichen, was an Sie versandt wurde, und ein Schlüssel aus der Bestellung einer anderen Partei wird abgelehnt.
Eine signierte Lizenzanforderung für eine Installation ohne Außenverbindung. Dies ist der Weg von Harrow. Auf der Installation erstellt ein Administrator unter „Diese Installation“, „Lizenz“ eine Anforderungsdatei. Es handelt sich um eine Erklärung der Art licence-request, die die Installations-ID nennt und mit dem eigenen Ed25519-Schlüssel der Installation signiert ist. Tomás trägt sie auf einem zugelassenen Datenträger nach draußen, legt sie auf der Seite „Offline-Austausch“ ab und lädt die zurückkommende Lizenzdatei herunter. Die Lizenz funktioniert nur auf der Installation, die die Anforderung erstellt hat.
Importieren einer Lizenz
Es gibt drei Wege hinein, und sie alle erreichen denselben Endpunkt auf nexus-auth. Nur ein Installationsadministrator kann importieren: ein Eigentümer oder Administrator der gesamten Organisation, der die Installation gehört und der daran angemeldet ist, oder ein uneingeschränkter Plattformadministrator. Jede andere Person wird abgelehnt, bevor die Datei gelesen wird.
In der Konsole
Auf einer neuen Installation ist „Lizenz importieren“ eine der sechs Prüfungen unter „Sechs Dinge, bevor sich jemand anmeldet“. Wenn Sie die Datei auf der Seite ablegen, überprüft die Konsole sie offline auf der Installation und listet ihre Funktionsgruppen mit der jeweiligen Schutzart und der Laufzeit auf.
Spätere Importe erfolgen über „Diese Installation“, „Lizenz“: Verwenden Sie „Neue Lizenz importieren“ oder „Verlängerte Lizenz importieren“, wenn die aktuelle abgelaufen ist. Eine Community-Installation, die zu Enterprise wechselt, verwendet „Von Community zu Enterprise“. Diese Seite liest zuerst die Lizenz und zeigt an, was abgerufen wird und was sich ändert, bevor irgendetwas geschieht. Nichts wird abgerufen, bis jemand „Abrufen und einschalten“ wählt. Die Enterprise-Bestandteile kommen dann von registry.adverant.ai mit dem Pull-Token der Installation, wobei jeder einzelne gegen den Release-Schlüssel von Adverant geprüft wird, und die Gruppen schalten sich nacheinander ein. Es ist danach dieselbe Installation mit denselben Personen, Dateien, Workflows und Kanälen.
Mit nexusctl
nexusctl licence import harrow-2027.licence.jsonDer Befehl importiert die Datei unverändert und gibt den aktuellen Status der Lizenz aus. Fügen Sie --explain hinzu, um die Operationen auszugeben, die er ausführen würde, ohne sie tatsächlich auszuführen.
Über die API
curl --fail-with-body -X POST https://auth.harrow.example/api/v1/installation/licence \
-H "Authorization: Bearer <access-token>" \
-H "Content-Type: application/json" \
--data-binary @harrow-2027.licence.jsonSenden Sie die Datei genau so, wie Adverant sie Ihnen übergeben hat. Formatieren Sie sie nicht um und betten Sie sie nicht in ein anderes Objekt ein: Der Body ist das Dokument. Die Route akzeptiert keinen Query-String, und ein Body von mehr als 1 MiB wird abgelehnt. Ein Element auf oberster Ebene, das eine Organisation oder eine Person nennt, wird mit TENANT_NOT_A_PARAMETER oder ACTOR_NOT_A_PARAMETER abgelehnt, da die Lizenz der Installation zu der Installation gehört, die im Besitz der Organisation des Tokens ist.
Ein erfolgreicher Import antwortet mit 201. Der Body enthält die Lizenzansicht (ihre ID, ihren aktuellen Status, den Lizenznehmer, die Edition, die Laufzeit, die Berechtigungen und die Funktionsgruppen), wie viele Organisationen sie nun halten und für wie viele aufgeführte Mandanten noch keine Organisation existiert. Die Lizenz, ihr SHA-256-Digest und die Hauptbuchzeilen für jede Organisation werden in einer einzigen Transaktion geschrieben, und der Import wird im Audit-Protokoll festgehalten.
Zwei Leserouten gehören dazu:
GET /api/v1/installation/licence/stategibt den Status zurück, der bei jedem Lesevorgang neu berechnet wird. Ein Administrator erhält die vollständige Ansicht. Jedes andere Mitglied einer Organisation auf der Installation erhält nur den Hinweis: den Status, den Hinweiscode (LICENCE_ENDS_SOON,LICENCE_IN_GRACEoderLICENCE_CLOCK_BEHIND_FLOOR) und die Daten, die der Hinweis nennt. Ein Mitglied sieht niemals den Lizenznehmer, die Laufzeit oder die Gruppen, da diese dem Eigentümer der Installation gehören.GET /api/v1/installation/licence/documentgibt für Administratoren das importierte Dokument im Rohformat zurück. Jedes Enterprise-Modul ruft es ab und prüft die Signaturen erneut mit seinem eigenen fest einkompilierten Verifizierer, sodass ein modifizierter Identitätsdienst keine Gruppe einschalten kann, die von der Lizenz nicht gewährt wird.
Jede Ablehnung
Ein abgelehnter Import ändert nichts, nicht einmal die Uhrzeit-Untergrenze, und die Ablehnung wird im Audit-Protokoll festgehalten.
| Code | HTTP | Bedeutung | Vorgehensweise |
|---|---|---|---|
LICENCE_FORMAT_INVALID |
422 | Die Datei ist keine Lizenz, die dieser Build lesen kann: kein JSON, nicht das richtige Schema, Daten in falscher Reihenfolge oder eine doppelt genannte Gruppe. | Senden Sie die Datei genau so, wie Adverant sie Ihnen übergeben hat. |
LICENCE_SIGNATURE_INVALID |
422 | Eine der beiden Signaturen fehlt, oder die Datei wurde nach dem Signieren geändert. | Fordern Sie die Datei erneut bei Adverant an und bearbeiten Sie sie nicht. |
LICENCE_ROOT_UNKNOWN |
422 | Sie ist mit einem Schlüssel signiert, der in den Trust-Roots dieses Releases nicht enthalten ist. | Fordern Sie eine Lizenz an, die für die Trust-Roots dieses Releases signiert ist, oder führen Sie ein Upgrade durch. |
LICENCE_MATRIX_MISMATCH |
422 | Sie wurde gegen eine Editionsmatrix erstellt, die dieser Build nicht liest, oder gewährt eine Gruppe, die der Katalog des Builds nicht kennt. | Führen Sie ein Upgrade auf ein Release durch, das sie lesen kann, oder fordern Sie eine Lizenz an, die für dieses Release erstellt wurde. |
LICENCE_OTHER_INSTALLATION |
409 | Sie wurde für eine andere Installations-ID ausgestellt. | Fordern Sie eine Lizenz für die Identität dieser Installation an. |
LICENCE_REVOKED |
403 | Adverant hat diese Lizenz zurückgezogen. | Fordern Sie bei Adverant eine neue Lizenz an. |
LICENCE_LOCKED |
403 | Die Lizenz hat noch nicht begonnen: Das aktuelle Datum liegt vor starts_on. |
Importieren Sie sie an oder nach ihrem ersten Tag erneut. |
TRANSITION_NOT_PERMITTED |
409 | Eine Lizenz mit dieser ID wurde bereits importiert. | Fordern Sie bei Adverant eine neue Lizenz an, falls sich die Bedingungen ändern müssen. |
RECORD_NOT_FOUND |
404 | Die Installation wurde noch nicht deklariert, sodass sie keine Identität hat, gegen die geprüft werden kann. | Schließen Sie den ersten Administratorschritt ab und importieren Sie dann. |
VALIDATION_FAILED |
400 | Der Body konnte nicht gelesen werden, ist größer als 1 MiB, oder die Anfrage enthielt einen Query-String. | Senden Sie die Datei allein als Body, ohne Query. |
Die Installation prüft in einer festen Reihenfolge, und der erste Fehler bestimmt den Code. Eine fehlende Hälfte wird vor einem unbekannten Schlüssel gemeldet, und ein Dokument, dessen Signaturen fehlschlagen, wird niemals weitergelesen, sodass eine manipulierte Datei, die zudem eine andere Installation nennt, dennoch mit LICENCE_SIGNATURE_INVALID antwortet.
Verlängerung
Eine Verlängerung ist eine neue Lizenz mit einer neuen licence_id. Importieren Sie sie auf dieselbe Weise wie die erste. Sie tritt sofort in Kraft, unabhängig davon, welchen Status die alte erreicht hatte: Von WARN, GRACE oder RESTRICT kehrt die Installation direkt zurück in den lizenzierten Zustand, und nichts muss neu installiert werden. Adverant kann auch während der Laufzeit eine geänderte Lizenz ausstellen, beispielsweise um Entscheidungsräume hinzuzufügen, und Sie importieren diese auf dieselbe Weise.
Das zweimalige Importieren derselben Lizenz wird mit TRANSITION_NOT_PERMITTED abgelehnt.
Widerruf
Adverant zieht eine Lizenz zurück, indem eine Widerrufsliste signiert wird. Die Liste hat eine sequence-Nummer und nennt jede zurückgezogene Lizenz-ID mit Zeitpunkt und Grund. Listen sind kumulativ: Jede enthält alle vor ihr widerrufenen IDs. Sie importieren sie auf dieselbe Weise wie eine Lizenz:
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.jsonEine Liste, deren Sequenznummer nicht höher ist als die der zuletzt importierten, wird mit TRANSITION_NOT_PERMITTED abgelehnt, sodass eine alte Liste nicht wieder anstelle einer neueren eingesetzt werden kann. Eine Liste, die nicht gelesen oder nicht verifiziert werden kann, wird mit denselben Codes wie eine Lizenz abgelehnt. Sobald eine Liste Ihre Lizenz nennt, lautet deren Status TERMINATE.
Eine Installation ohne Außenverbindung erfährt von einem Widerruf nur, wenn jemand die Liste importiert. Für Harrow ist der Widerruf ebenso sehr eine Frage des Vertrags wie der Software, und Tomás importiert jede von Adverant gesendete Liste beim nächsten Datentransfer.
Lizenzüberschreitung bei den Plätzen
Die Mengenangabe der Lizenz ist ein Nutzungsversprechen, und Nexus behandelt eine Überschreitung als Warnung, niemals als Aussperrung. Wenn mehr Personen Nexus nutzen, als die Lizenz abdeckt, sehen Administratoren auf der Seite „Personen“ den Hinweis SEATS_OVER_LICENCE. Alle können weiterarbeiten. Der Hinweis gibt an, bis wann dies behoben werden muss (30 Tage), zeigt, woher die zusätzlichen Personen kamen, und bietet die beiden Lösungen an: Personen entfernen, die Nexus nicht benötigen, oder bei Adverant weitere Plätze anfordern. Das Hinzufügen von Plätzen ist eine sensible Änderung, die eine zweite Person erfordert, und die zusätzlichen Plätze werden in der jährlichen Nutzungsabrechnung gezählt.
Die Nutzungsabrechnung enthält lediglich Zählerstände, und Sie können jede Zeile lesen, bevor sie das System verlässt. Harrow speichert sie als Datei und überträgt sie über den Offline-Austausch nach draußen.
Teststellungen
Eine Evaluierung ist eine Lizenz vom Typ evaluation, die über die Seite „Testversionen“ des Kontos für eine beanspruchte Bereitstellung gestartet wird. Sie dauert höchstens 30 Tage, deckt maximal 5 namentlich benannte Personen ab und hat keine Kulanzfrist. Am Tag nach ends_on wechselt sie direkt auf RESTRICT: Enterprise-Bereiche kehren zur Vorschauansicht zurück, und nichts, was während der Evaluierung erstellt wurde, wird gelöscht. Idea-Durchläufe, entworfene Richtlinien und E-Mail-Regeln bleiben genau so erhalten, wie sie waren, und lassen sich wieder öffnen, sobald eine Lizenz importiert wird.
Eine Organisation kann jeweils eine selbst gehostete Evaluierung gleichzeitig betreiben.




