Resolución de problemas de DNS de White Label

La mayoría de los problemas de DNS de White Label Lite se deben a una de cuatro causas: falta el registro, su valor no coincide con la tabla Branding, hay un proxy habilitado o el paso del certificado requiere atención.

Empieza por la tabla DNS for your brand de la pestaña Branding del dominio. Es la referencia definitiva para el nombre de host y el destino. No copies un destino CNAME de un artículo antiguo, otra cuenta o una herramienta de comprobación de DNS.

Ruta rápida

1. Abre Branding y copia el host, el tipo y el valor de la dirección afectada.
2. Crea o corrige ese registro en el proveedor de DNS que aloja la zona DNS activa.
3. Mantén el registro en modo solo DNS si el proveedor ofrece una opción de proxy.
4. Vuelve a Branding y selecciona Verify DNS. Comparte la dirección únicamente cuando su estado sea Active.

Cómo comprobar el DNS sin terminal

Antes de investigar cualquier otro problema, compara el registro de tu proveedor de DNS con la fila de Branding:

• Host o Name
• Type, que es CNAME para un host personalizado de dashboard o webmail
• Value o Target
• La opción de proxy, que debe estar desactivada para un host personalizado que utilice Cloudflare

Utiliza la acción Verify DNS de Branding después de guardar el registro. Esta pone en cola una nueva comprobación y la página muestra el estado resultante.

Para hacer una comprobación independiente, usa un servicio público de consulta DNS o pide a tu proveedor que consulte el nombre de host completo como CNAME. La respuesta debe coincidir exactamente con el campo Value actual de Branding. Una herramienta pública puede confirmar lo que detecta, pero no sustituye al estado Active de la plataforma.

No necesitas un terminal para completar la configuración. Si utilizas uno, consulta el nombre de host completo y compara el CNAME devuelto con el valor mostrado en Branding.

El estado indica "Pending DNS"

Pending DNS significa que la plataforma todavía no ha encontrado el registro esperado para ese host. Selecciona Verify DNS después de corregir un registro y vuelve a la pestaña Branding cuando el estado se haya actualizado. Realiza estas comprobaciones en orden:

Has editado el proveedor de DNS equivocado. Confirma qué proveedor es autoritativo para el DNS de tu dominio. Es posible editar el panel del registrador cuando la zona DNS activa se aloja en otro lugar.

El destino CNAME no es el actual. Copia Value o Target de la tabla Branding. Elimina un registro antiguo que entre en conflicto en el mismo nombre de host únicamente después de verificar que ningún otro servicio lo utiliza.

El tipo de registro es incorrecto. Un host de dashboard o webmail necesita el registro CNAME que aparece en Branding. Un registro A o AAAA en el mismo nombre de host puede impedir el resultado esperado.

El nombre de host se ha introducido con un formato incorrecto. Algunos proveedores solo necesitan el prefijo, como dashboard; otros requieren el nombre de host completo. Sigue la indicación del campo del proveedor y compara el registro resultante con el host que aparece en Branding.

Si el registro coincide, déjalo sin cambios y vuelve a utilizar Verify DNS. Cambiar repetidamente un registro correcto puede prolongar el tiempo necesario para que todos los resolutores DNS vean la misma respuesta.

La nube naranja de Cloudflare impide el aprovisionamiento de SSL

Si utilizas Cloudflare como proveedor de DNS, verás un icono de nube junto a cada registro. Una nube naranja significa que Cloudflare actúa como proxy de la solicitud. El CNAME de un dashboard o webmail personalizado debe estar en modo solo DNS para que la plataforma pueda verificarlo y emitir su certificado.

Solución: selecciona la nube situada junto al CNAME del host personalizado afectado hasta que esté gris y guarda el registro. Vuelve a Branding y selecciona Verify DNS.

Esto se aplica al registro del host personalizado, no automáticamente a todos los demás registros del dominio. Si otro proveedor incluye una opción de proxy o CDN, desactívala para ese CNAME salvo que la tabla Branding indique lo contrario.

El estado indica "SSL could not be issued" y menciona CAA

Un registro CAA indica a los proveedores de certificados qué organizaciones pueden emitir un certificado para tu dominio. Modifícalo únicamente cuando el estado de Branding o el soporte identifiquen específicamente CAA como el bloqueo.

No cambies el CNAME y comprueba si el dominio ya tiene un registro CAA. Tu proveedor de DNS puede mostrarlo, o puedes consultar el dominio raíz mediante una herramienta independiente de DNS.

Si el registro debe permitir al emisor de certificados de la plataforma, añade el valor CAA exacto proporcionado por soporte o mostrado en las indicaciones actuales del producto. No elimines entradas CAA no relacionadas simplemente para superar este paso. Pueden coexistir varios registros CAA.

Para el proceso de certificados actual, el valor requerido normalmente es:

Type: CAA
Host: @
Value: 0 issue "letsencrypt.org"

Si no tienes registros CAA, no añadas ninguno solo como medida preventiva. Después de modificar un CAA, vuelve a Branding y selecciona Verify DNS.

El estado indica "SSL could not be issued" sin motivo

Es posible que el CNAME ya sea correcto. No lo elimines y vuelvas a crearlo repetidamente. En su lugar:

1. Confirma que el registro sigue coincidiendo con el host y el destino de Branding y que no utiliza un proxy.
2. Selecciona Verify DNS una vez.
3. Si el estado no cambia, contacta con el soporte e incluye el nombre de host, el estado mostrado y una captura de pantalla del registro DNS.

El trabajo con certificados no es un cambio que puedas solucionar editando un CNAME que ya es correcto. El equipo de soporte puede revisar el resultado en la plataforma sin pedirte que reveles las credenciales del proveedor de DNS.

El dominio estaba activo, pero su estado ha cambiado

Cuando un host está Active, está listo para funcionar. Si su estado cambia posteriormente:

• Vuelve a "Pending DNS": compara el CNAME actual con la tabla Branding. Es posible que el registro haya cambiado, se haya eliminado o haya empezado a utilizar un proxy.
• "SSL could not be issued": deja el CNAME coincidente sin cambios, selecciona Verify DNS y contacta con soporte si el estado persiste.
• Off: comprueba si se desactivó Branding para ese dominio o si la suscripción White Label está inactiva. Si ninguna opción lo explica, contacta con soporte.

Situaciones habituales

"He cambiado el CNAME y el estado sigue pendiente." Confirma que editaste el proveedor de DNS autoritativo y que el nuevo CNAME coincide exactamente con Branding. Después, utiliza Verify DNS. Evita alternar valores mientras la comprobación está en curso.

"He eliminado el CNAME antiguo del proveedor anterior, pero no se encuentra el nuevo." Si cambiaste de proveedor de DNS, asegúrate de que el registrador delega el dominio en los servidores de nombres del nuevo proveedor. Si no es así, pide al proveedor que aloja la zona DNS autoritativa que confirme el registro.

"Mi sitio principal utiliza un proxy. ¿Puede usarlo también el host personalizado?" Mantén el CNAME personalizado en modo solo DNS. El resto del dominio puede utilizar sus propias opciones de proxy siempre que el host concreto de Branding no pase por él.

"¿Puedo usar un CNAME comodín?" Configura el nombre de host concreto que aparece en Branding. Esto proporciona a la plataforma una dirección inequívoca para verificar y probar. No sustituyas el host de la tabla por un registro comodín.

"Quiero usar otro subdominio." Cambia la etiqueta en la pestaña Branding del dominio y guarda un host cada vez. Copia el nuevo CNAME de la tabla, prueba el nuevo host solo cuando alcance el estado Active y conserva la dirección antigua de los clientes hasta terminar la transición.

"Una red no puede ver el registro nuevo." Realiza una prueba desde otra red o pide al cliente afectado que vuelva a intentarlo más tarde. Si la tabla Branding indica Active y el host funciona en otros lugares, probablemente el retraso restante esté en la caché DNS de esa red.

Próximos pasos

• Configurar White Label Lite: los pasos de configuración originales si todavía no has terminado.
• Preguntas frecuentes sobre precios de White Label Lite: dudas relacionadas con la facturación.
• Cancelar White Label Lite: qué ocurre con tu dominio si cancelas.
• Registros DNS recomendados: una visión más amplia de los registros DNS que utiliza TrekMail.

Si el problema continúa, abre un ticket de soporte e incluye el nombre de host, el estado exacto de Branding, el proveedor de DNS y una captura de pantalla del registro. No envíes contraseñas ni tokens de API del proveedor de DNS.