cPanel y WHM

Un token de API de WHM, no una contraseña ni un acceso de cPanel. Se crea en el propio WHM y viaja como una cabecera normal en cada llamada que hace el agente.

• Host: la dirección de WHM, incluido https. Si se omite el puerto, se rellena el 2087.
• Usuario de WHM: la cuenta a la que pertenece el token, normalmente root.
• Token de API: creado en Manage API Tokens dentro de WHM, y mostrado una sola vez.
• Huella TLS: opcional, y en un servidor cPanel lo habitual es dejarla vacía. La sección siguiente explica por qué.

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

El token se crea en WHM, con el usuario al que va a pertenecer. Provibr no vuelve a verlo después: se envía una sola vez al agente y queda sellado en su almacén cifrado, y la plataforma conserva únicamente los nombres de los campos.

1. 01Iniciar sesión en WHM con el usuario al que debe pertenecer el token, normalmente root.
2. 02Abrir Development y después Manage API Tokens.
3. 03Generar un token y darle un nombre que deje claro que pertenece a Provibr, para poder reconocerlo más adelante si hay que revocarlo.
4. 04Copiar el token antes de salir de la página. WHM lo muestra una vez y no puede volver a mostrarlo; perderlo obliga a crear uno nuevo.

El puerto 2087 es el cifrado, y un servidor cPanel suele llevar un certificado de una autoridad pública que el propio panel renueva cada noventa días aproximadamente. En ese caso habitual el campo de la huella se deja vacío y el agente comprueba el certificado igual que lo haría un navegador.

Solo hay que rellenarlo cuando el servidor presenta un certificado por el que no responde ninguna autoridad pública, lo que en la práctica significa una autoridad de certificación interna propia. La huella se toma desde el host del agente, para registrar exactamente lo que el agente va a ver, y hay que volver a tomarla cada vez que se sustituya ese certificado.

No hay ninguno. Un WHM decide por su cuenta en qué máquina acaba una cuenta y qué dirección recibe, así que no queda nada que elegir. La pestaña de ajustes sigue existiendo, porque ahí también se reenvían las credenciales.

Un paquete de WHM es la descripción que el propio panel hace de una cuenta: cuota de disco, tráfico mensual, cuántos subdominios y buzones y qué lista de funciones. No es un plan de Provibr ni un sistema operativo. Es un nombre al que hacemos referencia, y su contenido puede cambiar en el servidor sin que nos enteremos.

La página de la integración puede leer la lista de paquetes con su contenido, de modo que se elige entre lo que el servidor tiene de verdad en vez de escribir un nombre de memoria. Los paquetes se crean en WHM; Provibr no los crea.

Un plan web fija un paquete en una integración y le da un nombre propio. Pedir con un plan tiene prioridad sobre elegir un paquete suelto, y la elección suelta sigue disponible para los casos que un plan no cubre.

Un servidor cPanel solo aplica cuotas de disco cuando el sistema de archivos donde viven las cuentas admite cuotas. Sin eso, WHM acepta el paquete, acepta la cifra y no aplica nada.

La prueba de conexión avisa de esto. Lee las cuentas del servidor y dice si sus cuotas se están aplicando de verdad, junto a la versión de WHM y los recuentos. En un servidor sin cuentas no hay nada que medir, y así lo indica en lugar de suponerlo.

Es también el motivo por el que Provibr lee el límite de disco de la cuenta y no del paquete. Lo que declara la cuenta es lo que rige; la cifra del paquete es lo que alguien pretendía.

Activar las cuotas es trabajo del servidor y no de Provibr: hay que montar el sistema de archivos con cuotas de usuario y volver a analizar las cuentas. Lo que eso exige depende del sistema de archivos y de cómo se instaló la máquina, así que el proveedor de hosting o la documentación de cPanel es el sitio adecuado.

Una cuenta de hosting es una fila de servidor normal del tipo servidor web. Su identificador es el nombre de usuario de cPanel, y su dominio principal, su paquete, su consumo de disco y su tráfico llegan con cada sondeo.

• Crear una cuenta requiere un nombre de usuario, un dominio principal, una dirección de contacto, un paquete y una contraseña.
• Los nombres de usuario siguen la regla del propio WHM: empiezan por una letra, después letras y dígitos, como máximo dieciséis caracteres. Sin guiones ni guiones bajos.
• La contraseña no queda registrada en ninguna parte. Solo consta que se facilitó una; el valor viaja aparte.
• Después se puede suspender, reanudar, cambiar de paquete y eliminar. No hay consola, porque una cuenta de hosting no tiene.
• Ningún resultado se cree por su propia palabra. WHM confirma un cambio con una página de salida de procesos en lugar del estado nuevo, así que cada cambio termina releyendo la cuenta.

La pestaña de importación muestra las cuentas del panel y permite incorporar a Provibr las que interesen. Las cuentas ya conocidas aparecen pero no se pueden seleccionar otra vez, de modo que se ve el cuadro completo y no uno filtrado.

El consumo de disco y el tráfico llegan con el sondeo habitual, así que una cuenta obtiene una gráfica de consumo sin activar nada más. El tráfico es un total mensual que el propio servidor reinicia, así que se muestra como una cifra en la cuenta y no como una línea en la gráfica.

• Gestionar el servidor en sí no existe. Provibr crea, modifica y elimina cuentas en un WHM que gestiona otra persona; los servicios, las zonas DNS, el enrutado de correo y los ajustes del propio panel se quedan donde están.
• No hay consola. Una cuenta de hosting no es una máquina, así que no hay nada a lo que enganchar un terminal.
• Los buzones, las bases de datos y el DNS dentro de una cuenta son de cPanel. Provibr crea la cuenta y la entrega; lo que ocurre dentro queda entre el cliente y el panel.
• Las cuentas de revendedor no están modeladas. Provibr habla con WHM como un único operador, y un token de un revendedor ve un mundo más pequeño que root. Ese caso no se ha medido y no se describe aquí.