cPanel e WHM

Un token API di WHM, non una password e non un accesso cPanel. Lo crei in WHM stesso e viaggia come una normale intestazione a ogni chiamata dell’agente.

• Host: l’indirizzo di WHM, https compreso. Se omette la porta, Provibr inserisce 2087.
• Utente WHM: l’account a cui appartiene il token, di norma root.
• Token API: creato in Manage API Tokens dentro WHM e mostrato una sola volta.
• Impronta TLS: facoltativa, e su un server cPanel di norma la lasci vuota. La sezione qui sotto spiega il perché.

openssl s_client -connect <host>:2087 </dev/null 2>/dev/null | \
  openssl x509 -noout -fingerprint -sha256

Il token si crea in WHM, con l’utente a cui apparterrà. Provibr non lo vede mai più dopo il salvataggio: viene inviato una sola volta al suo agente e sigillato nella cassaforte di quell’agente, e la piattaforma conserva solo i nomi dei campi.

1. 01Acceda a WHM come l’utente a cui deve appartenere il token, di norma root.
2. 02Apra Development e poi Manage API Tokens.
3. 03Generi un token e gli dia un nome che indichi che appartiene a Provibr, così da riconoscerlo in seguito quando vorrà revocarlo.
4. 04Copi il token prima di lasciare la pagina. WHM lo mostra una volta e non può mostrarlo di nuovo; perderlo significa crearne uno nuovo.

La porta 2087 è quella cifrata, e un server cPanel porta di solito un certificato di un’autorità pubblica che il pannello rinnova da sé, all’incirca ogni novanta giorni. In questo caso ordinario il campo dell’impronta resta vuoto e l’agente verifica il certificato come farebbe un browser.

Lo compili solo quando il server presenta un certificato per cui nessuna autorità pubblica garantisce, il che in pratica significa una propria autorità di certificazione interna. Rilevi l’impronta dall’host dell’agente, così da fissare esattamente ciò che l’agente vedrà, e la rilevi di nuovo ogni volta che quel certificato viene sostituito.

Non ce ne sono. Un WHM decide da sé su quale macchina finisce un account e quale indirizzo riceve, quindi non le resta nulla da scegliere. La scheda delle impostazioni esiste comunque, perché è anche il punto in cui si rinviano le credenziali.

Un pacchetto WHM è la descrizione che il pannello stesso dà di un account: quota disco, banda mensile, quanti sottodomini e caselle di posta, quale elenco di funzioni. Non è un piano Provibr né un sistema operativo. È un nome a cui facciamo riferimento, e il suo contenuto può cambiare sul suo server senza che ce ne accorgiamo.

La pagina dell’integrazione può leggere l’elenco dei pacchetti con il loro contenuto, così sceglie tra ciò che il server ha davvero invece di digitare un nome a memoria. I pacchetti si creano in WHM; Provibr non li crea.

Un piano web fissa un pacchetto su un’integrazione e gli dà un nome scelto da lei. Ordinare con un piano prevale sulla scelta di un pacchetto sciolto, e la scelta sciolta resta disponibile per i casi che un piano non copre.

Un server cPanel applica le quote disco soltanto se il file system su cui risiedono gli account supporta le quote. Senza di esso WHM accetta il pacchetto, accetta il numero e non applica nulla.

Il test di connessione lo segnala. Legge gli account sul server e dice se le loro quote vengono davvero applicate, accanto alla versione di WHM e ai conteggi. Su un server senza account non c’è nulla da misurare, e lo dichiara invece di tirare a indovinare.

È anche il motivo per cui Provibr legge il limite di disco dall’account e non dal pacchetto. Ciò che l’account dichiara è ciò che vale; il numero nel pacchetto è ciò che qualcuno aveva in mente.

Attivare le quote è lavoro sul server e non in Provibr: il file system va montato con le quote utente e gli account vanno rianalizzati. Quello che serve dipende dal file system e da come è stata installata la macchina, quindi il suo fornitore di hosting o la documentazione di cPanel è il posto giusto.

Un account di hosting è una normale riga server di tipo server web. Il suo identificativo è il nome utente cPanel, e il dominio principale, il pacchetto, l’occupazione disco e la banda arrivano a ogni rilevazione.

• Creare un account richiede un nome utente, un dominio principale, un indirizzo di contatto, un pacchetto e una password.
• I nomi utente seguono la regola di WHM stesso: iniziano con una lettera, poi lettere e cifre, al massimo sedici caratteri. Niente trattini e niente trattini bassi.
• La password non viene registrata da nessuna parte. Resta solo il fatto che ne ha fornita una; il valore viaggia separatamente.
• Poi può sospendere, riattivare, cambiare pacchetto ed eliminare. Non c’è console, perché un account di hosting non ne ha una.
• Nessun risultato viene creduto sulla parola. WHM conferma una modifica con una pagina di output di processo invece che con il nuovo stato, quindi ogni modifica termina rileggendo l’account.

La scheda di importazione elenca gli account presenti sul pannello e le permette di portare in Provibr quelli che vuole. Gli account già noti vengono mostrati ma non sono selezionabili di nuovo, così vede il quadro intero e non uno filtrato.

L’occupazione disco e la banda viaggiano con la rilevazione ordinaria, quindi un account ottiene un grafico dei consumi senza attivare nient’altro. La banda è un totale mensile che il server azzera da sé, perciò compare come numero sull’account e non come linea sul grafico.

• Amministrare il server stesso non esiste. Provibr crea, modifica e rimuove account su un WHM gestito da lei; i servizi, le zone DNS, l’instradamento della posta e le impostazioni del pannello restano dove sono.
• Non c’è console. Un account di hosting non è una macchina, quindi non c’è nulla a cui agganciare un terminale.
• Caselle di posta, database e DNS dentro un account appartengono a cPanel. Provibr crea l’account e lo consegna; quello che succede dentro riguarda il suo cliente e il pannello.
• Gli account rivenditore non sono modellati. Provibr parla con WHM come un unico operatore, e un token di un rivenditore vede un mondo più piccolo di root. Quel caso non è stato misurato e qui non viene descritto.