Documentación
ISPConfig
Provibr gestiona las cuentas de hosting de ISPConfig mediante la API remota del panel. El agente se conecta de salida a su instalación de ISPConfig, así que no hay puertos entrantes ni VPN. Esta página cuenta qué tiene de distinto ISPConfig y qué hace la integración.
Una cuenta es un sitio web
ISPConfig separa el cliente (el cliente final, con un acceso y un conjunto de límites) del web_domain (el sitio web). Una cuenta de hosting de Provibr es un sitio web, identificado por su dominio. Para crear un sitio web hace falta un propietario, así que Provibr crea un cliente nuevo y un sitio web debajo, y elimina ambos de nuevo cuando se borra la cuenta. El agente deriva el acceso del cliente a partir del dominio, de modo que siempre vuelve a encontrar al propietario.
Qué necesita el agente
Cuatro campos, indicados una sola vez al conectar la integración:
- La dirección del panel: la URL https completa, incluido el puerto (8080 por defecto).
- Un usuario remoto: creado en System → Remote Users, limitado a las funciones de cliente y de sitios.
- La contraseña de ese usuario remoto.
- La huella TLS del panel: recomendada, porque una instalación nueva es autofirmada.
El certificado
ISPConfig escucha en el puerto 8080 sobre TLS, y una instalación nueva presenta un certificado autofirmado. Al fijar su huella, el agente puede estar seguro de que llega al panel. Se lee con una orden de shell desde cualquier máquina que alcance el panel:
openssl s_client -connect <host>:8080 </dev/null 2>/dev/null | \
openssl x509 -noout -fingerprint -sha256Si se pone un certificado propio en el nombre de host del panel, por ejemplo con Let's Encrypt, su cadena se valida y la huella puede quedar vacía. Allí esa es la mejor opción, porque un certificado así se renueva con regularidad y uno fijado habría que reemplazarlo cada vez.
Paquetes
Un paquete de ISPConfig es una plantilla de cliente, lo mismo a lo que se refiere un plan de Provibr. Fija los límites que recibe un cliente: cuántos sitios web, cuánto disco y tráfico, qué servicios.
Se elige un paquete por su nombre en el formulario de pedido, y se cambia después sin interrupción. Cambiarlo mueve los límites del cliente de una vez.
El ciclo de vida de la cuenta
Crear una cuenta son dos pasos detrás de una sola orden: un cliente y un sitio web debajo. A partir de ahí, la cuenta se comporta como cualquier otra cuenta de hosting:
- Crear: un cliente con el paquete elegido, y un sitio web con su dominio y su cuota.
- Suspender y reactivar: el sitio web pasa a estar fuera de línea y vuelve, de forma reversible.
- Cambiar de paquete: asignar otra plantilla de cliente.
- Eliminar: el cliente y su sitio web, limpiados juntos.
Suspender
Suspender cambia el indicador de activo del sitio web. El sitio pasa a estar fuera de línea; el acceso del cliente permanece. Provibr lee el mismo indicador que escribe, de modo que el panel y lo que se ve nunca se separan.
Consumo
ISPConfig informa del consumo: disco por sitio web frente a su cuota, y tráfico del mes en curso. Ambos aparecen en las gráficas igual que para una máquina virtual.
Importar
Las cuentas que se crearon en ISPConfig fuera de Provibr se pueden importar: la integración enumera los sitios web que el panel conoce, y se eligen los que se quiere adoptar. Las cuentas que no se crearon a través de Provibr se dejan intactas hasta que se haga.