KoaPanel
EN Provalo gratis
Tutte le sezioni del manuale

DocumentazioneWHMCS e chiavi API

WHMCS e chiavi API

KoaPanel si collega a WHMCS (8.x e 9.x) con il modulo ufficiale: quando un cliente ordina un hosting, WHMCS crea l'account sul pannello, lo sospende se la fattura non è pagata, lo aggiorna e lo elimina, e il cliente entra nel pannello con un clic dall'area clienti di WHMCS.

Chiavi API

WHMCS e gli altri sistemi di fatturazione usano una chiave API personale. La crei in Chiavi API (amministratori e rivenditori):

  • la chiave (kpk_…) si vede una sola volta: copiala subito;
  • agisce come te: la chiave di un rivenditore raggiunge solo i suoi account e i suoi pacchetti, entro la sua quota; per creare rivenditori da WHMCS serve la chiave di un amministratore;
  • si crea e si elimina solo accedendo al pannello (una chiave non può creare altre chiavi);
  • al massimo 300 richieste al minuto e 10 chiavi per account;
  • se l'account viene sospeso o eliminato, le sue chiavi smettono di funzionare;
  • nel Registro attività ogni operazione fatta con una chiave riporta «con API key …» e il sistema che l'ha usata.

Elimina subito una chiave che non usi più o che pensi sia stata vista da altri.

Collegare WHMCS

  1. Scarica il modulo da https://console.koapanel.app/updates/integrations/ ed estrailo nella cartella di WHMCS (modules/servers/koapanel).
  2. In WHMCS aggiungi un server: Hostname = il nome di questo pannello, Modulo KoaPanel, Password = la chiave API, SSL sì, porta 8443. Premi Test connessione.
  3. Crea i prodotti con il modulo KoaPanel: scegli un pacchetto del pannello oppure indica i limiti (siti, spazio, database, caselle); per un prodotto rivenditore scegli «Rivenditore» e il numero di account.

La guida completa per WHMCS è nel file README.md dentro lo zip del modulo.

Cosa fa WHMCS sul pannello

  • Crea l'account con nome utente e password del servizio (se la password è troppo debole il modulo ne genera una forte); ripetere la creazione non fa doppioni.
  • Sospende e riattiva l'account, con il motivo scritto in WHMCS.
  • Cambia pacchetto o la quota del rivenditore.
  • Elimina l'account e i suoi siti quando il servizio termina.
  • Accesso con un clic: WHMCS chiede al pannello un link di accesso monouso, valido 60 secondi; nell'area clienti ci sono anche i collegamenti diretti a File, WordPress, Email e Database. Un account sospeso non riceve link.
  • Una volta al giorno legge lo spazio usato di ogni account.

Rivendere licenze KoaPanel

Se sei un provider partner puoi vendere anche le licenze KoaPanel da WHMCS con il modulo koapanel_license e la chiave partner che ti dà KoaPanel.

Blesta e FOSSBilling

Oltre a WHMCS ci sono i moduli ufficiali per Blesta e FOSSBilling, con le stesse funzioni (creazione, sospensione, cambio piano, cambio password, eliminazione, accesso con un clic, rivenditori). Si scaricano gratis da https://console.koapanel.app/updates/integrations/ (koapanel-blesta-latest.zip, koapanel-fossbilling-latest.zip) e si collegano con una chiave API, come WHMCS; le istruzioni sono nel file README di ogni modulo. Per altri sistemi usa l'API.

Collegare KoaBilling già dall'installazione

Chi installa il pannello può scegliere il nome e farsi dare subito i dati per KoaBilling:

curl -fsSL https://get.koapanel.app | sudo bash -s -- \
  --hostname pannello.miodominio.it --email tu@miodominio.it --koabilling
  • --hostname è il nome del pannello: il certificato Let's Encrypt arriva in automatico se il nome punta già al server e la porta 80 è aperta. Se non è ancora così, il pannello riprova da solo e l'installazione finisce comunque.
  • --email è l'indirizzo per Let's Encrypt.
  • --koabilling crea una chiave API dell'amministratore. Alla fine l'installazione mostra indirizzo e chiave: incollali in KoaBilling, nel fornitore KoaPanel. La chiave si vede solo in quel momento e in /root/koapanel-install.log, leggibile solo da root: salvala e poi cancella il file.
  • --license attiva la licenza. Senza licenza, un pannello nuovo risponde (chiave compresa) solo dopo aver collegato l'account in Piano e licenza.

Da root sul server si può creare una chiave anche dopo: panel-agent apikey create --user admin --label KoaBilling. Le chiavi create così si vedono ed eliminano in Chiavi API come le altre.