Documentazione

CyberPanel

CyberPanel è un pannello di controllo open source per l’hosting web. Provibr dialoga con la sua API tramite le credenziali dell’amministratore principale e gestisce i siti che vi si trovano: crearli, sospenderli e riattivarli, spostarli in un altro pacchetto ed eliminarli.

Attivare l’accesso all’API

Su un CyberPanel appena installato l’API è disattivata, e vale anche per l’amministratore principale. Si attiva nel pannello, in Users, API Access, per l’utente admin. Non serve altro: Provibr accede con le credenziali che già possiede.

Se resta disattivata, ogni chiamata torna come API Access Disabled, qualunque cosa sia stata inserita. CyberPanel controlla quell’interruttore prima della password, quindi una password giusta dà esattamente la stessa risposta di una sbagliata. Tutto indica le credenziali, mentre il problema si trova una casella più in là.

L’amministratore principale deve chiamarsi admin

Una parte dell’API di CyberPanel rifiuta qualsiasi nome diverso da admin, ed è proprio la parte che elenca i siti sul pannello e riferisce a che punto è un sito nuovo. Provibr ha bisogno di entrambe le cose, quindi l’account da inserire qui sotto è quello che si chiama admin.

Non è un’impostazione ma un requisito, e viene da CyberPanel e non da noi: un amministratore rinominato non può essere usato per questa integrazione. Il test di connessione lo dice, così Lei lo scopre prima del primo ordine.

Che cosa chiede Provibr

Quattro campi. L’agente li custodisce nella propria cassaforte sul suo host; Provibr non può rileggerli.

L’indirizzo del pannello con la porta, per esempio https://panel.example.com:8090. Se la porta viene omessa, Provibr aggiunge la 8090. L’http in chiaro viene rifiutato: quella porta parla soltanto TLS.
Il nome dell’amministratore principale, cioè admin.
La password di quell’amministratore.
L’impronta SHA-256 del certificato, finché il pannello usa quello autofirmato.

CyberPanel non ha alcun token API che copra questi comandi: all’interno della sua API la via del token è attiva o meno a seconda dell’endpoint, e proprio i quattro comandi che creano, sospendono, cambiano pacchetto ed eliminano un sito richiedono la password. Qui sta dunque la password completa dell’amministratore principale, la stessa situazione di Webmin.

Il certificato

Ogni CyberPanel appena installato presenta lo stesso certificato autofirmato, intestato a www.example.com e firmato da CyberPanel stesso. Per questo un browser lo definisce errato anziché autofirmato, e la catena non viene mai verificata. Inserendo l’impronta, l’agente si fida di quel solo certificato invece di disattivare la verifica. La si legge da qualsiasi macchina che raggiunga il pannello:

shell

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

I comandi e l’output del terminale sono in inglese ovunque, nel pannello e in queste pagine. Un solo testo, una sola verità: quello che legge qui è letteralmente ciò che il suo host le restituirà.

Se sul nome host del pannello viene messo un certificato proprio, la catena si verifica da sola e il campo può restare vuoto. Lì è la scelta migliore, perché un certificato del genere viene sostituito ogni tanto e uno fissato andrebbe reinserito qui ogni volta.

Pacchetti

CyberPanel descrive in un pacchetto ciò che un sito può usare. Provibr legge quell’elenco e si riferisce a un pacchetto per nome; i pacchetti stessi si creano e si modificano in CyberPanel, non qui.

Un piano di hosting web in Provibr punta a un pacchetto di un’integrazione. È questo che il cliente ordina, e il prezzo lo stabilisce Lei.

Spostare un sito in un altro pacchetto cambia la registrazione e nient’altro. Misurato dall’interno del server con un pacchetto che portava limiti diversi: la quota disco è rimasta com’era e la configurazione del server web ha conservato i vecchi valori. Il pannello mostra il nome nuovo: quel nome va letto come registrazione e non come un limite che si sia spostato con esso.

Che cosa manda un ordine

Un sito su CyberPanel viene indicato dal proprio dominio, che è anche la sua identità in Provibr. Un ordine porta quattro cose:

Il dominio. Deve essere libero sul pannello, e tutto ciò che Provibr farà poi con questo server punta a esso.
Un indirizzo di contatto per il sito.
Il pacchetto in cui il sito viene collocato.
Una password per l’accesso al pannello che CyberPanel crea sotto il sito.

La creazione richiede su CyberPanel una cinquantina di secondi, di cui una ventina se ne vanno in un tentativo SSL che il pannello compie comunque. Provibr attende l’esito reale invece di credere alla prima risposta: quella arriva dopo circa tre secondi e non dice nulla, nemmeno se il dominio fosse ancora libero.

Sospendere e riattivare

Entrambe le cose hanno effetto subito: il pannello restituisce il nuovo stato e il suo elenco lo mostra all’istante. Provibr sospende un sito quando glielo si chiede e quando la capacità viene superata.

Su CyberPanel la sospensione è un espediente del server web e non un blocco dell’account. Il sito diventa irraggiungibile, ma FTP, posta e database continuano a funzionare e l’utente unix non viene bloccato. Questo differisce da DirectAdmin, e conta non appena la sospensione viene usata per far rispettare qualcosa.

Spazio su disco e traffico

CyberPanel è l’unico pannello di controllo in Provibr senza grafici dei consumi, e non è l’integrazione a ometterli: il pannello non li misura. Il traffico viene calcolato e poi buttato via, e il consumo di disco proviene da una cache rimasta vuota su un sito nuovo. Lo zero che ne esce non si distingue da un consumo davvero nullo.

Un grafico fermo a zero per sempre sembra una misura, ed è il motivo per cui non ce n’è alcuno. Ciò che un sito può usare è scritto nel suo pacchetto, e quel che CyberPanel sa comunque resta nel pannello stesso.

I siti che esistono già

I siti creati fuori da Provibr si possono importare dalla pagina dell’integrazione: l’agente elenca ciò che si trova sul pannello e Lei sceglie quali diventano un server in Provibr.

Un sito importato conta per la capacità da quel momento in poi, come ogni altro server web.

Che cosa non fa

Provibr gestisce siti, non il pannello: non installa CyberPanel, non lo aggiorna e non cambia impostazioni del server. Non c’è una console, e DNS, caselle di posta e database restano intatti. CyberPanel sa fare tutto questo da sé, e Provibr non lo comanda.

IndietroHestiaCP AvantiCloudPanel