Ir al contenido

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 usuario remoto es una cuenta aparte, no el administrador del panel. ISPConfig permite limitarlo exactamente a las funciones que usa Provibr, de modo que la credencial en la caja fuerte del agente puede ceñirse a las llamadas de cliente y de sitios, y a nada más.

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:

shell
openssl s_client -connect <host>:8080 </dev/null 2>/dev/null | \
  openssl x509 -noout -fingerprint -sha256
Los comandos y la salida del terminal están en inglés en todas partes, en el panel y en estas páginas. Un solo texto, una sola verdad: lo que se lee aquí es literalmente lo que devolverá su host.

Si 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.

La API remota no puede crear una plantilla de cliente, así que los paquetes se construyen en el propio panel de ISPConfig. Provibr solo se refiere a ellos por su nombre; un nombre que no reconoce se rechaza antes de crear nada.

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.

El indicador en la base de datos cambia al instante, pero la configuración del servidor web la reescribe la tarea por minuto del panel. Lo que Provibr muestra es el indicador de activo, y eso es coherente de inmediato.

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.

El consumo de disco se rellena una vez que ha corrido la tarea de monitorización del panel, así que en un sitio web nuevo todavía no hay lectura, y eso no es lo mismo que cero. El tráfico sale de una llamada para todos los sitios; el disco, de una llamada por cliente.

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.