Un sistema di chiavi di licenza software per il codice sorgente svolge tre compiti: dimostra che un acquirente ha comprato il prodotto, registra dove il prodotto è installato e permette al tuo codice di adattare il proprio comportamento all’edizione posseduta dall’acquirente. Non rende impossibile copiare un codice sorgente leggibile, e cercare di ottenere questo risultato di solito danneggia più gli acquirenti onesti che i pirati. L’approccio che funziona meglio per la maggior parte dei venditori è semplice: chiedere la chiave una sola volta nell’installer, verificarla sul server tramite un’API di licenze, associarla al dominio dell’installazione e poi farsi da parte.
Questa guida spiega come funziona e come aggiungerlo al tuo prodotto. Fa parte della nostra guida più ampia su come vendere il codice sorgente della tua web app o del tuo SaaS. Su AppTrovo ogni vendita genera automaticamente una chiave di licenza, con attivazione per dominio e un’API di verifica delle licenze, quindi non devi costruire tu il server delle licenze, ma solo il piccolo controllo lato client nel tuo installer.
Se ti serve solo il riferimento dell’API, vai direttamente alla guida all’integrazione delle licenze. Continua a leggere per le motivazioni, i compromessi e un piano di test.
Cosa può proteggere davvero una chiave di licenza?
Quando vendi codice sorgente leggibile, una persona determinata può sempre rimuovere un controllo di licenza. Essere onesti su questo ti aiuta a progettare qualcosa di utile invece di qualcosa di fastidioso.
| Un sistema di chiavi di licenza può | Un sistema di chiavi di licenza non può |
|---|---|
| Confermare che un acquirente ha un acquisto valido prima dell’installazione | Impedire a qualcuno di eliminare il controllo da un codice leggibile |
| Registrare su quali domini è attivata una licenza | Impedire a un acquirente di condividere un file ZIP |
| Comunicare al tuo codice quale edizione possiede l’acquirente | Sostituire un contratto di licenza chiaro |
| Mostrare se supporto e aggiornamenti sono attivi | Garantire il pagamento in ogni caso |
| Darti una documentazione pulita quando gestisci supporto o contestazioni | Compensare un prodotto di cui gli acquirenti non si fidano |
Pensa alla chiave di licenza come a una ricevuta con un indirizzo sopra, non come a un lucchetto. La maggior parte di chi acquista software gestionale è onesta e vuole restare dalla parte giusta della licenza, soprattutto quando aggiornamenti e supporto dipendono da essa. La chiave rende facile la strada onesta.
Dovresti offuscare o codificare il tuo codice?
Alcuni venditori cercano di proteggere gli script PHP codificandoli o offuscandoli. Per un marketplace di codice sorgente, di solito è un errore:
- Gli acquirenti pagano per il sorgente. Il motivo per cui scelgono un’app self-hosted è la possibilità di leggerla, verificarla e modificarla. I file codificati eliminano questo valore.
- Gli encoder aggiungono requisiti di hosting come loader speciali, che causano installazioni fallite e ticket.
- L’offuscamento nasconde i bug anche a te e rende impossibile la revisione di sicurezza da parte dell’acquirente.
- Raramente ferma la pirateria. Le copie pirata dei prodotti codificati circolano comunque.
Investi lo sforzo in ciò che rende conveniente pagare: aggiornamenti, supporto, documentazione e funzionalità dell’edizione Commercial. È proprio ciò che una copia pirata non riceve mai.
Come funziona l’attivazione per dominio
L’attivazione per dominio associa una chiave di licenza ai luoghi in cui il prodotto è installato. Su AppTrovo il flusso è questo:
- L’acquirente acquista il prodotto e riceve una chiave di licenza univoca (un UUID).
- Durante l’installazione, il tuo installer invia dal server la chiave e il dominio dell’installazione all’API di verifica delle licenze.
- Se la chiave è valida e c’è uno slot di attivazione libero, il dominio viene registrato sulla licenza e la risposta lo conferma.
- Eseguire di nuovo l’installer sullo stesso dominio non consuma un altro slot.
- Se l’acquirente passa a un nuovo server o dominio, disattiva il vecchio dominio dalla propria dashboard e attiva quello nuovo. Vedi gestire le attivazioni dei domini.
Ogni licenza ha un numero limitato di slot di attivazione, e la risposta della verifica ti dice quanti sono in uso (activations_used) e quanti disponibili (activations_limit). Questo limite consente a un acquirente di avere un sito di produzione e una copia di staging senza doverti chiedere nulla, scoraggiando al tempo stesso le installazioni su decine di domini non collegati. Ciò che la licenza consente dal punto di vista legale è definito dai termini di licenza, non dal numero di slot.
Verificare una volta o contattare il server di continuo?
Esistono tre strategie comuni per decidere quando il tuo codice controlla la licenza. Questa scelta conta più di qualsiasi altra decisione sulle licenze, perché stabilisce se le licenze possono mandare in errore il sito di produzione di un acquirente.
| Strategia | Come funziona | Rischio per gli acquirenti | Raccomandazione |
|---|---|---|---|
| Verifica una sola volta all’installazione | L’installer controlla la chiave; poi l’app funziona normalmente | Molto basso; un problema di rete colpisce solo l’installer | Impostazione predefinita consigliata |
| Ricontrollo periodico | Un job pianificato verifica la chiave ogni giorno o ogni settimana | Medio; interruzioni, firewall o limiti di frequenza possono causare falsi errori | Da evitare, salvo validi motivi |
| Controllo a ogni richiesta | Ogni caricamento di pagina chiama il server delle licenze | Alto; rallenta ogni pagina e rende il tuo server un singolo punto di guasto | Da non usare |
La guida all’integrazione di AppTrovo raccomanda la verifica una tantum: dopo che l’installer è andato a buon fine, il prodotto scrive un marcatore “installato” e non chiama mai più l’API. L’app di produzione di un acquirente non dovrebbe mai smettere di funzionare perché un server delle licenze non era raggiungibile durante un problema di rete.
Come aggiungere un controllo di licenza al tuo installer
L’API di verifica è una singola richiesta GET a /api/v1/licenses/verify con il parametro license_key e, facoltativamente, il tuo product_slug e il domain dell’installazione. Inviare lo slug del prodotto è consigliato, perché garantisce che la chiave appartenga al tuo prodotto e non a un altro. Ecco il flusso dell’installer, passo dopo passo:
- Chiedi la chiave. Aggiungi al tuo installer web un passaggio di licenza con un solo campo. L’acquirente non dovrebbe dover digitare il nome di un prodotto o modificare file di configurazione; imposta lo slug del prodotto nella tua configurazione prima di creare lo ZIP.
- Verifica sul server. Chiama l’API dal tuo backend con un timeout breve e la verifica SSL attiva. Non verificare mai da JavaScript nel browser e non inserire mai segreti nel codice lato client.
- Invia il dominio. Passa l’host dell’installazione, così l’attivazione viene registrata su di esso.
- Gestisci la risposta. Se
validè true, salva localmente ciò che ti serve: l’edizione dalicense_type, il nome del licenziatario e le date del supporto se la tua area di amministrazione le mostra. Se è false, mostra ilfailure_reasonin un linguaggio semplice e lascia che l’acquirente riprovi. - Segna l’installazione come completata. Scrivi il marcatore di installazione e prosegui con i passaggi del database e dell’utente amministratore. Anche la funzione PHP version_compare() torna utile in seguito, se la tua area di amministrazione confronta la versione installata con l’ultima release. Da qui in poi non viene eseguito alcun codice di licenza.
Per i prodotti Laravel esiste un SDK installer pronto all’uso, con un controller di installazione già fatto e un piccolo middleware che controlla soltanto la presenza del marcatore di installazione. L’elenco completo dei parametri, i campi della risposta e i motivi di errore si trovano nell’articolo sull’API di verifica delle licenze e nella guida all’integrazione. L’API ha un limite di frequenza (120 richieste al minuto per IP al momento in cui scriviamo), un motivo in più per non effettuare il controllo a ogni richiesta.
Conserva il risultato in modo sicuro
Tratta la chiave di licenza come qualsiasi altra credenziale: tienila fuori dalle directory pubbliche, fuori dai log e fuori dal frontend. L’OWASP Secrets Management Cheat Sheet offre indicazioni generali sulla gestione di chiavi e token nelle applicazioni.
Limita le funzionalità per edizione, non per dominio
I prodotti AppTrovo sono disponibili esattamente in due edizioni: un’edizione Community gratuita e con funzionalità limitate (gli acquirenti possono usarla in produzione, senza supporto dell’autore) e una licenza Commercial a pagamento che sblocca tutte le funzionalità. Non esiste un terzo livello. La risposta della verifica ti dice quale delle due possiede l’acquirente in license_type (community o commercial, più developer per le tue chiavi di test).
- Basati su
license_type, non sullo slug dell’oggetto edizione. Lo slug interno dell’edizione Commercial è un identificatore permanente che non riporta la parola “commercial”, quindilicense_typeè il campo pensato per abilitare o limitare le funzionalità. - Salva l’edizione durante l’installazione nella tabella delle impostazioni e leggila localmente durante l’esecuzione.
- Decidi con chiarezza cosa include ciascuna edizione e dichiaralo nella scheda del prodotto. Limiti nascosti che compaiono dopo l’installazione sembrano un inganno.
La risposta include anche product.retired. Se un giorno ritiri un prodotto, le licenze esistenti continuano a essere verificate e la tua area di amministrazione può mostrare un avviso discreto che non sono previsti ulteriori aggiornamenti.
Gestisci sviluppo, staging e cambi di server
Un sistema di licenze che ignora i flussi di lavoro reali genera ticket. Prevedi questi casi:
- Sviluppo locale. Gli acquirenti installano prima su
localhosto su un dominio.test. Decidi se il tuo installer lo conta come attivazione; molti venditori saltano il dominio per gli host locali. - Copie di staging. Gli slot di attivazione esistono proprio perché un sito di staging non richieda una seconda licenza. Menzionalo nella tua documentazione.
- Migrazioni di server. Documenta i passaggi: disattivare il vecchio dominio nella dashboard, spostare i file, rieseguire il passaggio di licenza o l’installer sul nuovo dominio.
- Agenzie che installano per i clienti. Spiega quale dominio va attivato e chi deve conservare la chiave. Rimanda ai termini di licenza per l’uso per conto dei clienti.
Testa la tua integrazione prima di inviare il prodotto
Non possiedi una licenza a pagamento del tuo stesso prodotto, quindi AppTrovo permette a ogni autore di generare una licenza di test per sviluppatori gratuita dalla pagina di modifica del prodotto. Si attiva solo su domini locali come localhost, 127.0.0.1 o host che terminano in .test o .local, scade dopo 30 giorni e può essere prorogata. I nuovi autori che non hanno ancora un prodotto possono usare una licenza sandbox per provare il flusso. Esegui questi scenari:
| Scenario | Come provocarlo | Risultato atteso |
|---|---|---|
| Chiave valida, nuovo dominio | Installazione da zero su localhost | L’installer prosegue e salva l’edizione |
| Chiave valida, stesso dominio di nuovo | Riesegui l’installer sullo stesso host | L’installer prosegue; nessuna attivazione aggiuntiva consumata |
| Nessuno slot libero | Attiva il numero massimo di domini locali, poi uno in più | Messaggio chiaro che spiega come disattivare un dominio |
| Chiave non valida | Inserisci un UUID casuale | Errore chiaro; l’installer resta sul passaggio di licenza |
| Chiave scaduta | Usa una chiave di test scaduta | Messaggio chiaro “la licenza è scaduta” |
| Errore di rete | Blocca l’host dell’API sulla tua macchina | Errore comprensibile con un pulsante per riprovare, non una pagina vuota |
Prima di creare il pacchetto, rimuovi tutti i flag di bypass per lo sviluppo che hai aggiunto durante i test e assicurati che l’URL base dell’API punti all’ambiente di produzione.
Scrivi il passaggio di licenza pensando alle persone
La schermata della licenza è spesso la prima cosa che un acquirente vede dopo aver caricato i tuoi file. Alcuni dettagli la rendono più accogliente:
- Spiega agli acquirenti dove trovare la chiave (per gli acquirenti di AppTrovo, la sezione Licenze della loro dashboard).
- Accetta la chiave con o senza spazi attorno, e rimuovili.
- Traduci i motivi di errore dell’API in passi successivi: “Questa chiave non ha slot di attivazione liberi. Disattiva dalla dashboard un dominio che non usi più, poi riprova.”
- Inserisci un link alla tua pagina di risoluzione dei problemi per gli errori di licenza. La nostra guida alla documentazione che riduce i ticket di supporto mostra come scrivere queste voci.
Domande frequenti
Devo costruire un mio server delle licenze per vendere codice?
Non su AppTrovo. Ogni vendita genera una chiave di licenza, gli acquirenti gestiscono le attivazioni dei domini dalla propria dashboard e tu verifichi le chiavi tramite l’API di verifica delle licenze. Il tuo lavoro si limita a un piccolo passaggio di licenza nell’installer. Se vendi anche sul tuo sito, ti servirà una soluzione di licenze separata per quelle vendite.
Una chiave di licenza può fermare la pirateria degli script PHP?
Nessun controllo di licenza può impedire del tutto a qualcuno di modificare un codice sorgente leggibile. Però conferma gli acquisti, registra le installazioni e collega gli acquirenti ad aggiornamenti e supporto. Alla maggior parte della pirateria si risponde meglio rendendo il prodotto a pagamento chiaramente più prezioso, grazie ad aggiornamenti, supporto e funzionalità Commercial.
Cosa succede se il server delle licenze non è raggiungibile durante l’installazione?
Con lo schema della verifica una tantum, ne risente solo l’installer. Mostra un errore comprensibile con la possibilità di riprovare e conserva i dati inseriti dall’acquirente. Una volta installata, l’app non dipende mai dal server delle licenze, quindi un’interruzione successiva non può comprometterla.
Come fa un acquirente a spostare la licenza su un nuovo dominio?
Disattiva il vecchio dominio dalla propria dashboard, liberando lo slot di attivazione, e poi esegue il passaggio di licenza sul nuovo dominio. Documentalo nella tua guida all’installazione o alla migrazione, così gli acquirenti non dovranno contattarti.
L’edizione Community dovrebbe richiedere una chiave di licenza?
Anche le licenze Community hanno una chiave, e la risposta della verifica le indica come community. Usare lo stesso flusso di installazione per entrambe le edizioni mantiene il tuo codice più semplice e ti permette di abilitare le funzionalità Commercial quando un acquirente acquista in seguito la Licenza Commerciale e inserisce la nuova chiave.