Add-on

Licenze granulari per i sistemi: servizi firewall e moduli per applicazione, acquistati su NethShop e verificati in tempo reale. Dietro ogni add-on c'è un entitlement, la licenza che abilita quell'add-on su quel sistema.

:::info ALPHA L'interfaccia degli add-on è attualmente in alpha. Il flusso di acquisto su NethShop è in fase di rilascio e alcune schermate potranno cambiare. :::

Panoramica

Un entitlement è una licenza che abilita un add-on su un sistema. Esistono due tipi:

• Service — un add-on del firewall NethSecurity, valido per l'intero sistema (es. Advanced Threat Shield, High Availability, Sandbox)
• Module — un add-on per una singola istanza applicazione di un cluster NethServer 8 (es. il modulo Chat per nethvoice1, ma non per nethvoice2)

Gli entitlements si acquistano su NethShop e compaiono sul sistema automaticamente all'attivazione della subscription. Il rinnovo estende la scadenza; l'annullamento della subscription revoca la licenza. Le funzionalità dell'appliance validano la licenza in tempo reale su My Nethesis (/auth): senza un entitlement attivo la funzionalità non viene erogata.

La tab Add-on

Ogni sistema di tipo noto (NethSecurity o NethServer 8) mostra una tab Add-on:

• Su un firewall la tabella elenca i servizi disponibili: quelli acquistati mostrano riferimento di pagamento, validità e prossimo rinnovo; gli altri offrono Buy on NethShop.
• Su un cluster la tabella è a due livelli: le istanze applicazione presenti sul sistema (dall'inventory) e, sotto ognuna, i moduli disponibili per quell'applicazione — acquistati o acquistabili per istanza.

Il pulsante Buy on NethShop apre lo shop con sistema (e istanza applicazione) già preselezionati: l'acquisto è legato al bersaglio giusto senza input manuale.

Trovare i sistemi che hanno un add-on

L'elenco dei sistemi ha un filtro Add-on: scegli uno o più add-on per tenere solo i sistemi che li possiedono. Il menu propone gli add-on presenti sui tuoi sistemi, e la corrispondenza conta solo le licenze valide in quel momento, quindi un add-on scaduto o annullato esclude il sistema. Il filtro vale anche per l'esportazione CSV e PDF, che porta quindi le stesse righe dell'elenco a schermo. Vedi Gestione Sistemi.

Ruoli e permessi

Capacità	Chi
Vedere entitlements e scadenze (read:entitlements)	Tutti i ruoli utente, nella propria gerarchia
Acquistare su NethShop / annullare una subscription (manage:entitlements)	Admin, Backoffice — e il personale Nethesis, su tutta la flotta
Gestire il catalogo, grant manuali, vista sull'intera flotta	Organizzazione Owner (Nethesis)

Distributori e reseller non possono auto-attivarsi add-on: tutto passa dallo shop.

Catalogo add-on (Nethesis)

La voce Add-on nel menu laterale è disponibile a chiunque abbia il permesso read:entitlements, ma la tab Configurazione con il catalogo dei tipi di add-on resta riservata all'organizzazione Owner. La creazione richiede il kind (Service o Module), l'applicazione di destinazione per i moduli (l'id si compone automaticamente, es. nethvoice + chat → nethvoice-chat), nome e descrizione. Un tipo appena creato è immediatamente acquistabile da tutti; regole di disponibilità opzionali possono riservarlo a ruoli o organizzazioni specifiche.

La cancellazione di un tipo è rifiutata finché esistono licenze che lo referenziano — comprese quelle revocate o scadute, conservate per audit. L'elenco del catalogo marca questi tipi con in_use, così l'azione di eliminazione è disabilitata invece di fallire.

Reportistica

GET /backend/api/entitlements/grants (con filtri per entitlement, organizzazione, origine, stato e finestra di scadenza) e GET /backend/api/entitlements/stats forniscono il report licenze: chi acquista vede la propria gerarchia — ogni modulo con scadenza e rinnovo — mentre l'organizzazione Owner vede l'intera flotta.

La pagina Add-on presenta gli stessi dati in forma di dashboard, nella tab Report: contatori di stato, add-on in scadenza, dettaglio per add-on, distribuzione dei rinnovi e trend di attivazione a 12 mesi (GET /backend/api/entitlements/report, più le slice paginate /report/organizations e /report/tiers). Ogni aggregato segue la stessa visibilità dell'elenco licenze: un distributore o un reseller vede le proprie organizzazioni, un customer solo i propri sistemi, l'organizzazione Owner l'intera flotta. La tabella per organizzazione non viene mostrata ai customer, che non hanno nulla sotto di sé.

Per gli sviluppatori

• Le licenze vivono in system_entitlements (una riga per sistema + entitlement + scope; i rinnovi aggiornano valid_until in place, le revoche conservano la riga per audit). Accanto sono conservati lo snapshot dell'acquisto (purchased_by) e il tier (variant), entrambi di sola visualizzazione.
• L'enforcement è servito da collect: GET /auth/service/<id>[?scope=<istanza>] con le credenziali Basic del sistema risponde 200 con licenza attiva, 403 senza. Gli id legacy (ng-*) sono risolti tramite legacy_alias del catalogo, quindi i feed dell'appliance continuano a chiamare i path storici senza modifiche. /auth-hash risponde alle stesse domande con Authorization: Bearer <sha256("<system_key>:<token>")>, hash che collect impara alla prima richiesta del sistema.
• Lo shop attiva e rinnova le licenze con POST /backend/api/entitlements/activate (idempotente, indirizzato per system_key) e le revoca con POST /backend/api/entitlements/deactivate.
• GET /backend/api/systems accetta un filtro ripetibile addon=<id catalogo> (più id corrispondono a uno qualsiasi di essi) e, con include_addons=true, aggiunge a ogni sistema la lista addons degli id di catalogo che possiede in quel momento. La lista è opt-in perché costa una query in più per pagina, inutile in una lettura massiva. Le scelte del filtro arrivano da GET /backend/api/filters/systems, che restituisce gli add-on presenti nella gerarchia del chiamante come coppie {id, display_name}; GET /backend/api/entitlements/catalog risolve qualsiasi id nel suo nome.