Rivenditori e WHMCS

Come vendere hosting con LimePanel: l'area rivendita, il marchio, i clienti, l'automazione con WHMCS e il programma partner.

Due cose diverse#

• Rivenditori dentro il pannello: chi amministra il server crea dei rivenditori, che a loro volta creano clienti e account hosting con il proprio marchio, entro un contratto deciso dall'amministratore.
• Programma partner LimePanel: è un accordo commerciale con Digital Dept per chi acquista molte licenze del pannello (fornitori di hosting, agenzie). Lo trovi in fondo a questa pagina.

Le tre aree del pannello#

Dal selettore d'area in alto (o con Ctrl+K) passi da un'area all'altra. La striscia di colore e il percorso dicono sempre dove sei:

Creare un rivenditore#

Chi amministra il server crea i rivenditori in Server → Rivenditori e decide il loro contratto: quanti account, domini, caselle, spazio e traffico possono vendere, e quali pacchetti possono assegnare.

Il contratto del rivenditore#

Rivendita → Il mio contratto mostra una barra per ogni voce. Vicino al tetto la barra diventa ambra, al tetto rossa, e la creazione si ferma con un messaggio che dice quale voce è esaurita. Un pacchetto non compreso nel contratto non si può assegnare.

Il marchio#

Rivendita → Marchio: nome del prodotto, logo, colore d'accento, recapiti dell'assistenza e, se vuoi, un dominio tuo per il pannello. I tuoi clienti vedono il tuo marchio, anche nella pagina di accesso se entrano dal tuo dominio; i clienti degli altri rivenditori no.

Rivendita → Nameserver: i tuoi nameserver (per esempio ns1.tuaagenzia.it). Le zone dei tuoi clienti nascono con quelli. Ricordati i record glue presso il registrar.

Clienti e account#

1. Rivendita → Clienti → Nuovo cliente: nome ed email del titolare. La password iniziale si vede una volta sola; al primo accesso il cliente la cambia.
2. Nuovo account: in una sola schermata scegli dominio, cliente (nuovo o esistente) e uno dei pacchetti del tuo contratto. Nome utente e versione di PHP sono proposti da soli. La finestra mostra i passi reali (account, dominio, sito con DNS e posta) e alla fine la password del cliente e il pulsante per entrare nel suo pannello.

Ogni account è un utente di sistema isolato, con i limiti del pacchetto: siti, domini, database, caselle, spazio, CPU e memoria. I pacchetti di serie:

Disco e processi crescono in proporzione. L'amministratore del server può cambiarli in Server → Pacchetti.

Ogni dominio nuovo riceve la posta da solo (DKIM, mail.<dominio>, webmail). Un pacchetto creato senza «Comprende la posta elettronica» la esclude.

Entrare per conto del cliente#

Entra apre il pannello del cliente con un clic. Una fascia ricorda sempre che stai operando per conto suo; l'accesso scade da solo e resta nel registro attività.

Sospendere ed eliminare#

• Sospendi ferma i siti del cliente senza cancellare nulla. I siti rispondono 503 con l'intestazione Retry-After, così i motori di ricerca non indicizzano la pagina di cortesia. Riattiva li rimette come prima.
• Elimina toglie siti, zone, posta, FTP e operazioni pianificate e blocca l'utente. Home e database restano sul server finché chi lo amministra non decide altrimenti.

Tutto ciò che fai sui clienti finisce nel registro attività del server, con chi l'ha fatto e da dove.

Token API e webhook#

Rivendita → Token API e webhook (o Server → Token API e webhook per l'amministratore):

• i token hanno solo i permessi che scegli, una scadenza e le reti da cui possono essere usati; il segreto si vede una volta sola;
• i webhook inviano gli eventi dei tuoi clienti firmati con HMAC-SHA256 (intestazione X-LimePanel-Signature), con nuovi tentativi in caso di errore. La consegna è «almeno una volta»: usa il campo id dell'evento per scartare i doppioni.

Il modulo WHMCS#

Il modulo di provisioning per WHMCS crea, sospende, riattiva, cambia pacchetto, cambia password, apre il pannello con un clic ed elimina gli account LimePanel a partire dai servizi di WHMCS, e aggiorna spazio e traffico usati.

Installazione#

1. Copia la cartella modules/servers/limepanel del modulo nella cartella modules/servers di WHMCS.
2. Nel pannello (Server → Token API e webhook) crea un token con i permessi provisioning.run, plans.read, hosting.read e hosting.delete, limitato all'IP del server WHMCS. Copialo: si vede una volta sola.
3. In WHMCS, nella configurazione dei server, aggiungi un server di tipo LimePanel: nome del pannello, porta 8443, connessione sicura e il token nel campo Access Hash. «Prova connessione» deve rispondere OK.
4. Nel prodotto scegli il modulo LimePanel e il pacchetto: l'elenco arriva dal pannello.

Un rivenditore fa lo stesso dalla propria area: il modulo lavora solo sui suoi clienti e solo con i pacchetti che può vendere.

Con più server, aggiungi in WHMCS un server per ogni pannello, ciascuno con il suo token.

Come si comporta#

• Un'operazione risponde «success» solo dopo che il pannello ne ha verificato l'effetto: la creazione attende che il sito risponda, l'eliminazione che l'account risulti eliminato.
• Ripetere un'operazione è sicuro: la creazione è legata all'id del servizio WHMCS, e sospensioni, riattivazioni ed eliminazioni ripetute non fanno nulla.
• Per un cliente nuovo la password del pannello è quella del servizio WHMCS; un cliente già esistente tiene la sua.
• L'accesso con un clic apre una sessione del titolare senza secondo fattore: abilitando il modulo decidi che l'autenticazione di WHMCS basta. Il collegamento vale un minuto e una volta sola, ed è registrato.
• Il token non finisce mai nel registro dei moduli di WHMCS.
• Se la licenza del pannello è scaduta, il pannello ferma tutti i servizi e ogni richiesta da WHMCS riceve un errore chiaro finché la licenza non torna valida.

Programma partner#

Per fornitori di hosting e agenzie che usano molte licenze. Le condizioni economiche si concordano direttamente con noi.

Il programma comprende una licenza NFR (non rivendibile) gratuita per il laboratorio e, su richiesta, una fattura mensile riepilogativa.

La rivendita o la concessione di licenze LimePanel a terzi è ammessa solo con un accordo partner. Per aderire, scrivici dalla pagina Contatti.