Console Licenze

La sezione Licenze della Console Admin ti permette di creare policy, emettere e gestire chiavi, configurare l’automazione e monitorare l’utilizzo — tutto senza scrivere codice.

Accedi dalla barra laterale: Licensing → Policies | Keys | Usage | Automation.

Policy

Le policy definiscono le regole per una licenza: quali funzionalità sono incluse, quante postazioni/dispositivi sono consentiti, quando scade e come funziona la validazione.

Creare una Policy

1. Vai su Licensing → Policies e clicca New Policy
2. Step 1 — Inserisci un nome (es. “Pro Plan”) e uno slug (es. pro-plan)
3. Step 2 — Configura le dimensioni:
   • Key Format — Personalizza il prefisso, charset, numero/lunghezza dei segmenti e separatore. Un’anteprima live mostra il formato generato (es. VIG-XXXX-XXXX-XXXX-XXXX)
   • Seats — Abilita per limitare gli utenti concorrenti. Imposta un massimo predefinito
   • Devices — Abilita per limitare i dispositivi attivati. Imposta un massimo predefinito
   • Features — Abilita per definire un insieme di flag funzionalità (es. analytics, export, api-access)
   • Expiry — Abilita per impostare una scadenza predefinita in giorni
4. Step 3 — Scegli la modalità di validazione:
   • Online — Ogni validazione interroga l’API (ideale per SaaS)
   • Hybrid — Prima online, fallback JWT offline (ideale per desktop)
   • Offline — Solo JWT, nessuna rete necessaria (ideale per ambienti air-gapped)

Modificare una Policy

Dalla lista delle policy, clicca il menu ⋮ → Edit. Puoi modificare il nome, la modalità di validazione, le dimensioni, il periodo di grazia offline e il TTL di revoca.

Visualizzare i Dettagli della Policy

Clicca ⋮ → View per vedere la pagina di dettaglio completa della policy, che include:

• Stato, modalità di validazione e riepilogo delle dimensioni
• Configurazione della policy (grazia offline, TTL revoca, postazioni/dispositivi/scadenza predefiniti)
• Anteprima del formato chiave
• Tutte le chiavi emesse sotto questa policy

Chiavi

Emettere una Chiave

1. Vai su Licensing → Keys e clicca Issue Key
2. Seleziona una policy
3. Scegli il tipo di licenziatario (USER, ORG, DEVICE)
4. Opzionalmente inserisci un ID licenziatario e delle note
5. Clicca Issue Key

La chiave viene generata usando il formato definito nella policy (es. VIG-A8BC-D3EF-G4HJ-K5LM).

Funzionalità della Lista Chiavi

• Ricerca — Filtra per stringa chiave o ID licenziatario
• Filtro stato — Mostra solo chiavi Attive, Sospese, Scadute o Revocate
• Avvisi scadenza — Le chiavi in scadenza entro 7 giorni mostrano un badge ambra “In scadenza”
• Esportazione CSV — Scarica la lista completa delle chiavi in formato CSV
• Paginazione — Naviga attraverso grandi insiemi di chiavi

Azioni sulle Chiavi

Dal menu ⋮ su ogni chiave:

Pagina Dettaglio Chiave

Clicca View per vedere la pagina di dettaglio completa della chiave con tre schede:

• Entitlements — Informazioni licenziatario, funzionalità, scadenza, postazioni, policy, data di creazione
• Seats — Visualizza utenti assegnati, assegna nuove postazioni, rilascia postazioni
• Devices — Visualizza dispositivi attivati, rimuovi dispositivi

Tester di Validazione

Clicca Validate Key nella pagina delle chiavi per aprire il tester di validazione. Incolla qualsiasi chiave per testarla contro l’API — verifica se è valida e visualizza funzionalità, stato e scadenza.

Utilizzo

La pagina Licensing → Usage mostra statistiche aggregate:

• Card KPI: Totale policy, totale chiavi, attive, revocate, sospese, scadute
• Distribuzione policy: Quante chiavi sono emesse per ogni policy
• Chiavi recenti: Le ultime chiavi emesse con badge di stato

Automazione

Le regole di automazione collegano eventi di pagamento ad azioni sulle licenze. Quando un cliente paga, una chiave viene emessa automaticamente.

Creare una Regola

1. Vai su Licensing → Automation e clicca New Rule
2. Inserisci un nome per la regola
3. Scegli il provider (Stripe, PayPal o Manual)
4. Seleziona l’evento trigger (es. Checkout Completed)
5. Seleziona l’azione (es. Issue Key)
6. Opzionalmente collega una policy (obbligatoria per l’azione Issue Key)

Provider e Eventi Supportati

Configurazione Webhook

Perché l’automazione funzioni, devi configurare i webhook nel tuo provider di pagamento:

Stripe:

1. Vai su Stripe Dashboard → Developers → Webhooks
2. Aggiungi endpoint: https://your-auris-domain/api/licensing/webhooks/stripe
3. Seleziona gli eventi: checkout.session.completed, invoice.paid
4. Copia il signing secret in STRIPE_LICENSING_WEBHOOK_SECRET

PayPal:

1. Vai su PayPal Developer Dashboard → Webhooks
2. Aggiungi endpoint: https://your-auris-domain/api/licensing/webhooks/paypal
3. Imposta PAYPAL_LICENSING_WEBHOOK_SECRET e PAYPAL_LICENSING_WEBHOOK_ID