Documentazione

ISPConfig

Provibr gestisce gli account di hosting ISPConfig tramite l’API remota del pannello. L’agente si collega in uscita verso la sua installazione ISPConfig, quindi non ci sono porte in entrata né VPN. Questa pagina spiega che cosa ha di diverso ISPConfig e che cosa fa l’integrazione.

Un account è un sito web

ISPConfig separa il client (il cliente, con un accesso e un insieme di limiti) dal web_domain (il sito web). Un account di hosting Provibr è un sito web, identificato dal suo dominio. Per creare un sito web serve un proprietario, quindi Provibr crea un client nuovo e un sito web al di sotto, e li rimuove entrambi di nuovo quando Lei elimina l’account. L’agente ricava l’accesso del client dal dominio, così ritrova sempre il proprietario.

Che cosa serve all’agente

Quattro campi, inseriti una sola volta quando collega l’integrazione:

L’indirizzo del pannello: l’URL https completo, porta compresa (8080 per impostazione predefinita).
Un utente remoto: creato in System → Remote Users, limitato alle funzioni client e sites.
La password di quell’utente remoto.
L’impronta TLS del pannello: consigliata, perché un’installazione nuova è autofirmata.

L’utente remoto è un account a sé, non il suo amministratore del pannello. ISPConfig permette di limitarlo esattamente alle funzioni che Provibr usa, così la credenziale nella cassaforte dell’agente può restringersi alle chiamate client e sites e a nient’altro.

Il certificato

ISPConfig ascolta sulla porta 8080 in TLS, e un’installazione nuova presenta un certificato autofirmato. Ne fissi l’impronta perché l’agente possa essere certo di raggiungere il suo pannello. La si legge con un comando shell da qualsiasi macchina che raggiunge il pannello:

shell

openssl s_client -connect <host>:8080 </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 mette un certificato proprio sul nome host del pannello, per esempio con Let's Encrypt, la sua catena si verifica e può lasciare l’impronta vuota. Lì è la scelta migliore, perché un certificato del genere si rinnova con regolarità e uno fissato andrebbe sostituito ogni volta.

Pacchetti

Un pacchetto ISPConfig è un modello di cliente, la stessa cosa a cui si riferisce un piano Provibr. Fissa i limiti che riceve un client: quanti siti web, quanto disco e traffico, quali servizi.

Sceglie un pacchetto per nome nel modulo d’ordine e lo cambia in seguito senza interruzioni. Cambiarlo sposta i limiti del client in una volta sola.

L’API remota non può creare un modello di cliente, quindi i pacchetti li costruisce Lei stesso nel pannello ISPConfig. Provibr vi si riferisce soltanto per nome; un nome che non riconosce viene rifiutato prima che venga creato alcunché.

Il ciclo di vita dell’account

Creare un account sono due passi dietro un solo comando: un client e un sito web al di sotto. Da lì in poi l’account si comporta come ogni altro account di hosting:

Creare: un client con il pacchetto scelto, e un sito web con il suo dominio e la sua quota.
Sospendere e riattivare: il sito web va offline e torna, in modo reversibile.
Cambiare pacchetto: assegnare un altro modello di cliente.
Eliminare: il client e il suo sito web, ripuliti insieme.

Sospendere

Sospendere ribalta l’indicatore di attivo del sito web. Il sito va offline; l’accesso del client resta. Provibr legge lo stesso indicatore che scrive, così il pannello e ciò che Lei vede non divergono mai.

L’indicatore nel database si ribalta subito, ma la configurazione del server web viene riscritta dal processo al minuto del pannello. Ciò che Provibr mostra è l’indicatore di attivo, ed è coerente immediatamente.

Consumi

ISPConfig riferisce i consumi: il disco per sito web rispetto alla sua quota, e il traffico del mese in corso. Entrambi compaiono nei grafici come per una macchina virtuale.

Il consumo di disco viene riempito una volta eseguito il processo di monitoraggio del pannello, quindi su un sito web nuovo non c’è ancora una lettura, il che non è lo stesso di zero. Il traffico proviene da una sola chiamata per tutti i siti; il disco, da una chiamata per client.

Importare

Gli account creati in ISPConfig al di fuori di Provibr si possono importare: l’integrazione elenca i siti web che il pannello conosce, e Lei sceglie quali riprendere. Gli account che non ha creato tramite Provibr vengono lasciati intatti finché non lo fa.

IndietroCloudPanel AvantiPterodactyl