AccediPrenota un briefing

Capitolo 2.13

Licenze

Cosa contiene un file di licenza di Nexus, come l'installazione lo verifica offline, i sei stati in cui può trovarsi e come richiederne, importarne, rinnovarne e revocarne uno.

Questa pagina è stata tradotta dall'IA a partire dall'originale in inglese. In caso di dubbi, fa fede la pagina in inglese. Legga questa pagina in inglese

19 minuti di lettura

Harrow Port Authority esegue Nexus Enterprise sul proprio cluster Kubernetes all'indirizzo harrow.example, senza alcuna rotta dal cluster verso Internet. Ogni anno Aoife Brennan, responsabile IT, rinnova il contratto e Tomás Reilly, il platform engineer, trasferisce manualmente un piccolo file JSON oltre l'isolamento di rete e lo importa. Non viene riavviato nulla e la pagina della licenza mostra una nuova data di scadenza.

Questo capitolo riguarda quel file. In breve, una licenza è un singolo documento JSON firmato e vincolato a una sola installazione. L'installazione lo verifica autonomamente, tramite chiavi pubbliche integrate nell'immagine, senza effettuare alcuna chiamata di rete. Una licenza non è mai un valore Helm né un file montato. La si importa tramite la console, nexusctl o l'interfaccia di programmazione delle applicazioni (API), e in nessun altro modo.

Il documento di licenza

Una licenza è un oggetto JSON nel formato nexus-licence/v1. Ecco quella di Harrow, con i due valori di firma abbreviati.

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

Ogni campo è obbligatorio e ogni oggetto nel documento è chiuso. Un attributo non elencato dal formato viene rifiutato, in modo che nulla possa essere aggiunto al di fuori della firma.

Campo Contenuto
format Esattamente nexus-licence/v1. Qualsiasi altro valore, inclusa una versione successiva, viene rifiutato.
licence_id Un UUID (identificatore univoco universale) in minuscolo. Un'installazione importa ciascun ID di licenza una sola volta.
issued_at L'istante in cui Adverant l'ha emessa, nel formato YYYY-MM-DDThh:mm:ssZ.
type alpha, evaluation o commercial.
channel Il canale di rilascio per cui è stata emessa, ad esempio alpha. Firmato e incluso nel file; la verifica non varia in base a questo valore.
licensee.name Da 1 a 200 caratteri, firmati esattamente come scritti. Brennan e Brennán sono due nomi diversi con due firme diverse.
licensee.customer_id Il Suo ID cliente presso Adverant: lettere minuscole, cifre, ., _ e -.
scope.deployment.installation_id L'identità dell'installazione, generata dal relativo servizio chiavi al momento della prima installazione.
scope.tenants ID delle organizzazioni, fino a 1.000. Vuoto a meno che qualche concessione non sia limitata a livello di tenant.
edition enterprise o team. Una licenza Enterprise concede sempre enterprise-base.
grants Da 1 a 500 coppie {feature_group, scope}, con ciascun gruppo nominato una sola volta.
add_ons ID dei componenti aggiuntivi (add-on) dalla matrice delle edizioni, fino a 100. Può essere vuoto.
domain_packs ID dei pacchetti di dominio (domain pack) dalla matrice delle edizioni, fino a 100. Può essere vuoto.
metric kind è per-environment, per-core o named-seat; quantity è un numero intero a partire da 1.
term starts_on e ends_on sono date; warn_days e grace_days sono numeri interi da 0 a 365.
matrix La versione della matrice delle edizioni rispetto alla quale sono definiti i gruppi e l'hash SHA-256 di tale file di matrice, conservati a fini di audit.
signatures Due firme, ed25519 e p256. L'unico campo che non viene firmato.

Le date sono date di calendario in UTC e il giorno deve esistere: 2028-02-29 è valido, mentre 2027-02-29 viene rifiutato.

Due firme, entrambe obbligatorie

Adverant firma ogni licenza con due chiavi indipendenti. Una firma è Ed25519. L'altra è ECDSA (Elliptic Curve Digital Signature Algorithm) sulla curva P-256 del NIST (il National Institute of Standards and Technology statunitense), richiesta dagli acquirenti che necessitano di algoritmi conformi agli standard federali statunitensi. Entrambe sono calcolate sugli stessi byte ed entrambe devono superare la verifica. Un documento con una delle due metà mancante, o con una qualsiasi delle due errata, equivale all'assenza totale di licenza.

I byte firmati corrispondono alla forma canonica RFC 8785 del documento priva di signatures, pertanto gli spazi bianchi e l'ordine degli attributi nel file non fanno alcuna differenza. Un singolo carattere modificato nel nome del licenziatario, nelle date o in una concessione produce un documento diverso e determina il fallimento della verifica.

Le chiavi pubbliche utilizzate per la verifica risiedono in un file trust-roots integrato in ciascuna immagine al momento della compilazione della release. Nessuna variabile d'ambiente, flag o mount può indicare un altro file. Quando Adverant sostituisce una chiave di firma, la vecchia chiave firma quella nuova e la successiva release firmata include la nuova chiave. Una licenza firmata con una nuova chiave supera la verifica su una release che la contiene; pertanto, dopo un cambio di chiave, potrebbe essere necessario eseguire l'aggiornamento prima dell'importazione (vedere il capitolo 2.17, Risoluzione dei problemi).

Tipi, edizioni e come viene conteggiata una licenza

Il campo type indica da quale tipo di contratto deriva la licenza:

  • alpha: una licenza per il canale di rilascio alpha, che è il tipo posseduto da Harrow.
  • evaluation: una versione di prova self-hosted di Enterprise. Dura al massimo 30 giorni, per un massimo di 5 utenti nominali (metrica named-seat), con grace_days impostato su 0. Il formato rifiuta qualsiasi valutazione che preveda un periodo di tolleranza.
  • commercial: una licenza contrattualizzata.

Il campo metric registra il modo in cui viene conteggiata la licenza: per-environment (il cluster di produzione di Harrow costituisce un singolo ambiente), per-core o named-seat. Adverant formula il preventivo di prezzo; la licenza riporta esclusivamente l'unità di misura e la quantità.

Il campo edition della licenza è enterprise per ogni installazione Enterprise. Il formato accetta anche team, nel qual caso la licenza concede il gruppo team e mai enterprise-base.

Gruppi di funzionalità, componenti aggiuntivi e pacchetti di dominio

Ciò che una licenza consente di utilizzare è elencato per gruppo di funzionalità, utilizzando gli ID della matrice delle edizioni. La licenza di Harrow concede enterprise-base (ruoli personalizzati, approvazioni a quattro occhi, conservazione prolungata degli audit, accesso aziendale con applicazione dei criteri e sincronizzazione della directory, unità aziendali, pagine operatore e il resto della base Enterprise) e map-and-geoai. Include il componente aggiuntivo mail e il pacchetto di dominio logistics-and-maritime.

La matrice prevede regole sulle combinazioni consentite e il sistema di emissione di Adverant le verifica prima che una licenza venga firmata. Ogni componente aggiuntivo e ogni pacchetto richiede enterprise-base. Alcuni pacchetti richiedono componenti aggiuntivi: il pacchetto Logistics and maritime richiede Map and GeoAI, il pacchetto Insurance e il pacchetto Capital markets and asset management richiedono Decision rooms and sealed records, mentre il pacchetto Legal and professional services richiede Decision rooms e Mail. Le schermate per telefono di ogni pacchetto richiedono inoltre il componente aggiuntivo Mobile apps.

Ogni concessione ha un ambito di validità (scope):

  • deployment: il gruppo si applica all'intera installazione, per ogni organizzazione presente su di essa.
  • tenant: il gruppo si applica solo alle organizzazioni elencate in scope.tenants. Una licenza con una concessione limitata a livello di tenant deve elencare almeno un'organizzazione, mentre un elenco di organizzazioni privo di concessioni a livello di tenant viene rifiutato.

Supponiamo che il team di pilotaggio di Harrow operi come seconda organizzazione sulla stessa installazione e che solo tale organizzazione debba disporre di Ideas. La concessione risulterebbe { "feature_group": "ideas", "scope": "tenant" }, con l'ID dell'organizzazione di pilotaggio in scope.tenants. Se la licenza venisse importata prima dell'esistenza di tale organizzazione, la risposta di importazione la conteggerebbe sotto tenants_without_organisation e la concessione diventerebbe effettiva una volta creata l'organizzazione.

Un amministratore può restringere l'ambito di applicazione di un gruppo. Solo una licenza emessa da Adverant può aggiungere un gruppo.

Licenza e cosa sblocca
La licenza e cosa sblocca
La pagina della licenza elenca ogni gruppo di funzionalità indicando come è protetto e cosa copre. I gruppi non inclusi nella licenza rimangono nell'elenco, disattivati in grigio, in modo che gli utenti possano vedere cosa è disponibile.

La durata: preavviso e periodo di tolleranza

Il campo term fissa quattro date sul calendario. Da starts_on a ends_on la licenza è in vigore. warn_days stabilisce con quanto anticipo inizia l'avviso di scadenza e grace_days per quanto tempo tutto continua a funzionare dopo la scadenza. Le licenze emesse da Adverant prevedono 30 giorni per ciascuno di questi periodi, salvo diversa indicazione contrattuale. Una licenza di valutazione ha sempre grace_days pari a 0.

Per la licenza di Harrow sopra indicata, il calendario si articola come segue:

Date Stato
Dal 1° gennaio 2027 al 1° dicembre 2027 VALID
Dal 2 dicembre 2027 al 31 dicembre 2027 WARN
Dal 1° gennaio 2028 al 30 gennaio 2028 GRACE
Dal 31 gennaio 2028 RESTRICT

L'ultimo giorno di validità, ends_on, è ancora un giorno di WARN. Il giorno successivo passa a GRACE, oppure a RESTRICT in assenza di periodo di tolleranza.

I sei stati

Ogni volta che la licenza viene letta, l'installazione ricalcola il proprio stato a partire dal documento e dalla data corrente. Nulla viene memorizzato nella cache oltre il cambio di giorno, pertanto la scadenza scatta puntualmente senza bisogno di un processo pianificato.

Stato Quando Cosa possono fare gli utenti
ABSENT Nessuna licenza importata, oppure il documento è stato rifiutato Il livello base Community. Le aree Enterprise vengono mostrate come anteprime con l'indicazione di chi può attivarle.
VALID Da starts_on a ends_on meno warn_days Ogni gruppo concesso è abilitato.
WARN Gli ultimi warn_days giorni del periodo di validità Abilitato, e gli amministratori visualizzano un banner nel prodotto con la data di scadenza.
GRACE Dopo ends_on, per grace_days giorni Abilitato, con l'avviso LICENCE_IN_GRACE nella pagina Today e nella pagina della licenza.
RESTRICT Dopo il periodo di tolleranza Non è possibile avviare nuove attività nell'ambito di un gruppo soggetto a licenza. Le attività in corso vengono portate a termine, le letture e le esportazioni continuano a funzionare e gli aggiornamenti di sicurezza continuano ad arrivare.
TERMINATE Adverant ha revocato la licenza Gli artefatti Enterprise cessano di essere offerti. Rimangono disponibili il livello base Community e l'esportazione dei dati.

In ogni stato, le attività in corso proseguono, gli aggiornamenti di sicurezza continuano ad arrivare, le esportazioni restano leggibili e nulla viene eliminato. Nello stato RESTRICT, un utente che tenta di avviare una nuova attività Enterprise visualizza un riquadro di rifiuto con il codice LICENCE_LOCKED e il nome di chi può effettuare il rinnovo.

Una linea temporale orizzontale con cinque fasce da sinistra a destra: VALID (da starts_on), WARN (gli ultimi warn_days del periodo di validità), GRACE (grace_days dopo ends_on), RESTRICT (dopo il periodo di tolleranza). Sotto le fasce, tre indicatori etichettati: starts_on, ends_on e ends_on + grace_days. Un riquadro separato sotto la linea temporale, collegato da una freccia tratteggiata proveniente da qualsiasi fascia, è etichettato TERMINATE (un elenco di revoca firmato include la licenza). Un secondo riquadro all'estrema sinistra, esterno alla linea temporale, è etichettato ABSENT (nessuna licenza, oppure una licenza rifiutata: il livello base Community).
Gli stati della licenza lungo il calendario.

Come viene calcolata la data corrente

Un orologio può essere impreciso e può essere portato indietro intenzionalmente. Pertanto, l'installazione non si affida mai unicamente all'orologio di sistema. La data corrente corrisponde al più recente tra due istanti: l'orologio di sistema (wall clock) e una soglia minima memorizzata (floor), che rappresenta l'istante più recente osservato dall'installazione. La soglia minima avanza a ogni importazione e a ogni lettura dello stato, e non retrocede mai autonomamente. Portare indietro l'orologio di un mese non riporta una licenza scaduta allo stato VALID; una licenza in stato RESTRICT rimane RESTRICT.

Quando l'orologio segna un orario antecedente alla soglia minima, lo stato riporta l'avviso LICENCE_CLOCK_BEHIND_FLOOR e viene valutato al giorno corrispondente alla soglia minima. Se l'orologio è effettivamente andato avanti per errore (ad esempio, un nodo si è avviato con la data errata facendo avanzare la soglia minima), richieda ad Adverant un token di ripristino dell'ora (time-reset token). Si tratta di un piccolo documento firmato, vincolato all'ID della Sua installazione e a un nonce monouso, contenente un istante floor_to. Lo si importa tramite l'API con questa richiesta:

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> è il token di accesso di un amministratore dell'installazione. Un token viene applicato quando entrambe le firme superano la verifica, l'ID di installazione corrisponde al Suo e il relativo nonce non è ancora stato utilizzato. Un token rifiutato non modifica nulla, pertanto non può mai essere sfruttato per invalidare una licenza valida. Un token il cui nonce è già stato utilizzato viene rifiutato con LICENCE_CLOCK_BEHIND_FLOOR.

Richiedere una licenza

Le licenze vengono richieste e scaricate dal Suo account Adverant all'indirizzo https://account.adverant.ai. Le persone della Sua organizzazione autorizzate a rivendicare i deployment e a scaricare le licenze vengono definite nella pagina Organisation and team roles dell'account.

Adverant deve sapere a quale installazione è destinata la licenza ed esistono tre modi per comunicarlo.

Un codice monouso, per un'installazione dotata di schermo. L'installazione mostra un codice monouso e la relativa impronta digitale (fingerprint). Nella pagina Claim a deployment incolli il codice, quindi confronti l'impronta digitale gruppo per gruppo con quanto mostrato dall'installazione. Quando tutti i gruppi corrispondono, rivendichi l'installazione per la Sua organizzazione e la licenza sarà disponibile sull'account.

Una chiave di rivendicazione (claim key), per un'appliance o un dispositivo edge. Questi dispositivi non dispongono di uno schermo per mostrare un codice. Il numero di serie e una chiave di rivendicazione sono stampati sulla confezione e nell'ordine del produttore dell'apparecchiatura. Li inserisca uno alla volta nella pagina Enter a claim key, oppure trascini il file d'ordine del produttore per rivendicarne molteplici contemporaneamente. Ogni chiave viene verificata rispetto ai registri di Adverant relativi a quanto Le è stato spedito, e una chiave appartenente all'ordine di un altro cliente viene rifiutata.

Una richiesta di licenza firmata, per un'installazione priva di connessione verso l'esterno. Questa è la procedura seguita da Harrow. Sull'installazione, un amministratore genera un file di richiesta in This installation, Licence. Si tratta di una dichiarazione di tipo licence-request che indica l'ID dell'installazione, firmata con la chiave Ed25519 propria dell'installazione. Tomás la trasferisce all'esterno su un supporto approvato, la rilascia nella pagina Offline exchange e scarica il file di licenza restituito. La licenza funziona esclusivamente sull'installazione che ha generato la richiesta.

Scambio offline
Scambio offline
Lo scambio offline per un'installazione priva di connessione verso l'esterno. Ogni file che attraversa l'isolamento di rete è firmato, pertanto un file modificato lungo il tragitto viene rifiutato, e ogni scambio viene registrato con l'indicazione di chi lo ha effettuato.
Due colonne, quella di sinistra con l'etichetta "Installazione di Harrow (senza internet)" e quella di destra con l'etichetta "Account Adverant". In alto a sinistra: un riquadro "File di richiesta di licenza, firmato dalla chiave dell'installazione". Una freccia con l'etichetta "trasferito su supporto" passa al riquadro della colonna di destra "Pagina di scambio offline". Sotto di esso, un riquadro "File di licenza, firmato con due chiavi Adverant". Una freccia con l'etichetta "riportato su supporto" ritorna al riquadro della colonna di sinistra "Importazione: console, nexusctl o API", e da lì scende a un riquadro "Verificato sull'installazione rispetto alle radici di attendibilità integrate".
Come una licenza raggiunge un'installazione priva di connessione verso l'esterno.

Importare una licenza

Esistono tre modalità di ingresso e tutte raggiungono lo stesso endpoint su nexus-auth. Solo un amministratore dell'installazione può effettuare l'importazione: un proprietario o amministratore dell'intera organizzazione che possiede l'installazione, autenticato su di essa, oppure un amministratore completo della piattaforma. Chiunque altro viene rifiutato prima ancora che il file venga letto.

Nella console

Su una nuova installazione, Import the licence è uno dei sei controlli presenti nella pagina Six things before anyone signs in. Quando si rilascia il file sulla pagina, la console lo verifica sull'installazione, offline, ed elenca i relativi gruppi di funzionalità indicando come ciascuno è protetto e il periodo di validità.

Le importazioni successive avvengono tramite This installation, Licence: utilizzi Import a new licence, oppure Import a renewed licence quando quella corrente è scaduta. Un'installazione Community che passa a Enterprise utilizza From Community to Enterprise. Tale pagina legge innanzitutto la licenza e mostra cosa verrà scaricato e cosa cambierà, prima che avvenga qualsiasi operazione. Non viene scaricato nulla finché qualcuno non seleziona Fetch and switch on. I componenti Enterprise vengono quindi prelevati da registry.adverant.ai utilizzando il pull token dell'installazione, ciascuno verificato rispetto alla chiave di rilascio di Adverant, e i gruppi si attivano uno alla volta. Al termine, l'installazione rimane la stessa, con le stesse persone, gli stessi file, flussi di lavoro e canali.

Importa la licenza
Importa la licenza
Importazione della licenza durante la configurazione iniziale. Il file autentico elenca i propri gruppi di funzionalità; una copia con due righe modificate viene mostrata come assente con il codice LICENCE_SIGNATURE_INVALID e la licenza già in vigore non viene toccata.
Da Community a Enterprise
Da Community a Enterprise
Passaggio di un'installazione da Community a Enterprise. La licenza è stata letta e riconosciuta come autentica, e la pagina elenca i componenti da scaricare e le modifiche previste prima che qualcuno prema Fetch and switch on.

Con nexusctl

nexusctl licence import harrow-2027.licence.json

Il comando importa il file inalterato e stampa lo stato corrente della licenza. Aggiunga --explain per stampare le operazioni che verrebbero eseguite senza effettivamente avviarne l'esecuzione.

Tramite l'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.json

Invii il file esattamente come Adverant glielo ha fornito. Non lo riformatti e non lo racchiuda in un altro oggetto: il corpo della richiesta è il documento stesso. La rotta non accetta query string e un corpo superiore a 1 MiB viene rifiutato. Un attributo di primo livello che nomina un'organizzazione o una persona viene rifiutato con TENANT_NOT_A_PARAMETER o ACTOR_NOT_A_PARAMETER, poiché la licenza dell'installazione appartiene all'installazione posseduta dall'organizzazione associata al token.

Un'importazione andata a buon fine restituisce 201. Il corpo contiene la vista della licenza (il suo ID, lo stato corrente, il licenziatario, l'edizione, il periodo di validità, le concessioni e i gruppi di funzionalità), quante organizzazioni la detengono attualmente e quanti tenant elencati non hanno ancora un'organizzazione. La licenza, il relativo digest SHA-256 e le righe del registro (ledger) per ciascuna organizzazione vengono scritti in un'unica transazione e l'importazione viene registrata nel log di audit.

Ad essa si affiancano due rotte di lettura:

  • GET /api/v1/installation/licence/state restituisce lo stato, ricalcolato a ogni lettura. Un amministratore ottiene la vista completa. Qualsiasi altro membro di un'organizzazione presente sull'installazione ottiene solo l'avviso: lo stato, il codice di avviso (LICENCE_ENDS_SOON, LICENCE_IN_GRACE o LICENCE_CLOCK_BEHIND_FLOOR) e le date indicate nell'avviso. Un membro non vede mai il licenziatario, il periodo di validità o i gruppi, poiché tali informazioni appartengono al proprietario dell'installazione.
  • GET /api/v1/installation/licence/document restituisce il documento importato, in formato grezzo (raw), per gli amministratori. Ciascun modulo Enterprise lo recupera e verifica nuovamente le firme tramite il proprio verificatore compilato internamente, in modo che un servizio di identità modificato non possa attivare un gruppo non concesso dalla licenza.

Tutti i casi di rifiuto

Un'importazione rifiutata non modifica nulla, nemmeno la soglia minima dell'orologio, e il rifiuto viene registrato nel log di audit.

Codice HTTP Significato Cosa fare
LICENCE_FORMAT_INVALID 422 Il file non è una licenza leggibile da questa build: non è in formato JSON, non rispetta lo schema, presenta date non in ordine o un gruppo nominato due volte. Invii il file esattamente come Adverant glielo ha fornito.
LICENCE_SIGNATURE_INVALID 422 Manca una delle due firme, oppure il file è stato modificato dopo la firma. Richieda nuovamente il file ad Adverant e non lo modifichi.
LICENCE_ROOT_UNKNOWN 422 È firmato con una chiave non presente nei trust roots di questa release. Richieda una licenza firmata per le radici di attendibilità di questa release, oppure esegua l'aggiornamento.
LICENCE_MATRIX_MISMATCH 422 È stato generato rispetto a una matrice delle edizioni che questa build non è in grado di leggere, oppure concede un gruppo sconosciuto al catalogo della build. Esegua l'aggiornamento a una release in grado di leggerlo, oppure richieda una licenza generata per questa release.
LICENCE_OTHER_INSTALLATION 409 È stata emessa per un altro ID di installazione. Richieda una licenza per l'identità di questa installazione.
LICENCE_REVOKED 403 Adverant ha ritirato questa licenza. Richieda una nuova licenza ad Adverant.
LICENCE_LOCKED 403 La licenza non è ancora iniziata: la data corrente è antecedente a starts_on. La importi nuovamente a partire dal suo primo giorno di validità.
TRANSITION_NOT_PERMITTED 409 Una licenza con questo ID è già stata importata. Richieda una nuova licenza ad Adverant se è necessario modificare le condizioni.
RECORD_NOT_FOUND 404 L'installazione non è ancora stata dichiarata, pertanto non possiede un'identità rispetto alla quale eseguire la verifica. Completi il primo passaggio di amministrazione, quindi proceda con l'importazione.
VALIDATION_FAILED 400 Non è stato possibile leggere il corpo della richiesta, il corpo supera 1 MiB oppure la richiesta conteneva una query string. Invii esclusivamente il file come corpo della richiesta, senza alcuna query.

L'installazione esegue le verifiche secondo un ordine fisso e il primo errore rilevato determina il codice restituito. Una metà mancante della firma viene segnalata prima di una chiave sconosciuta e un documento le cui firme non superano la verifica non viene letto oltre; pertanto, un file manomesso che indica anche un'altra installazione restituisce comunque LICENCE_SIGNATURE_INVALID.

Rinnovo

Un rinnovo è una nuova licenza con un nuovo licence_id. La importi nello stesso modo della prima. Entra in vigore immediatamente, qualunque sia lo stato raggiunto da quella precedente: da WARN, GRACE o RESTRICT l'installazione torna direttamente allo stato con licenza valida e non è necessario reinstallare nulla. Adverant può anche emettere una licenza modificata a metà periodo, ad esempio per aggiungere Decision rooms, anch'essa importabile nello stesso modo.

L'importazione della stessa licenza per due volte viene rifiutata con TRANSITION_NOT_PERMITTED.

Revoca

Adverant ritira una licenza firmando un elenco di revoca (revocation list). L'elenco ha un numero sequence e indica ciascun ID di licenza ritirato insieme a data, ora e motivazione. Gli elenchi sono cumulativi: ciascuno riporta tutti gli ID revocati in precedenza. Lo si importa nello stesso modo di una licenza:

curl --fail-with-body -X POST https://auth.harrow.example/api/v1/installation/licence/revocations \
  -H "Authorization: Bearer <access-token>" \
  -H "Content-Type: application/json" \
  --data-binary @revocations-12.json

Un elenco il cui numero di sequenza non è superiore all'ultimo importato viene rifiutato con TRANSITION_NOT_PERMITTED, in modo che un vecchio elenco non possa sostituirne uno più recente. Un elenco illeggibile o che non supera la verifica viene rifiutato con gli stessi codici previsti per una licenza. Non appena un elenco include la Sua licenza, lo stato di quest'ultima diventa TERMINATE.

Un'installazione priva di connessione verso l'esterno viene a conoscenza di una revoca solo quando qualcuno importa l'elenco. Per Harrow, la revoca è una questione tanto contrattuale quanto software, e Tomás importa ogni elenco inviato da Adverant in occasione del successivo trasferimento offline.

Postazioni oltre il limite della licenza

La quantità indicata nella licenza rappresenta un impegno sull'utilizzo e Nexus tratta il suo superamento come un avviso, mai come un blocco (lock-out). Quando il numero di persone che utilizzano Nexus supera quanto coperto dalla licenza, gli amministratori visualizzano il riquadro SEATS_OVER_LICENCE nella pagina People. Tutti continuano a lavorare. Il riquadro indica entro quando regolarizzare la situazione (30 giorni), mostra da dove provengono le persone in eccesso e propone le due soluzioni: rimuovere le persone che non necessitano di Nexus oppure richiedere ad Adverant ulteriori postazioni (seats). L'aggiunta di postazioni è una modifica sensibile che richiede l'approvazione di una seconda persona, e le postazioni aggiuntive vengono conteggiate nel rendiconto annuale di utilizzo.

Postazioni oltre la licenza
Postazioni oltre la licenza
Più persone rispetto alle postazioni disponibili. La sincronizzazione della directory ha aggiunto 143 collaboratori esterni e il riquadro concede 30 giorni per rimuovere persone o aggiungere postazioni, senza bloccare l'accesso a nessuno.

Il rendiconto di utilizzo contiene esclusivamente contatori ed è possibile leggerne ogni riga prima che venga inviato all'esterno. Harrow lo salva come file e lo trasferisce all'esterno tramite lo scambio offline.

Valutazioni

Una valutazione è una licenza di tipo evaluation, avviata dalla pagina Trials dell'account per un deployment rivendicato. Dura al massimo 30 giorni, copre al massimo 5 utenti nominali e non prevede alcun periodo di tolleranza. Il giorno successivo a ends_on passa direttamente allo stato RESTRICT: le aree Enterprise tornano a essere mostrate come anteprime e nulla di quanto creato durante la valutazione viene eliminato. Le esecuzioni di Idea, le bozze delle policy e le regole di posta vengono conservate esattamente com'erano e tornano ad aprirsi non appena viene importata una licenza.

Un'organizzazione può eseguire una sola valutazione self-hosted alla volta.