El mapeo de dominios personalizado en Document360 te permite reemplazar la URL predeterminada project-name.document360.com por un dominio que pertenece completamente a tu organización, como help.yourcompany.com. Mapear un dominio personalizado fortalece la identidad de tu marca y ofrece a los lectores una experiencia coherente y personalizada cuando visitan tu base de conocimientos. Document360 provisiona automáticamente un certificado SSL para tu dominio asignado, de modo que el sitio permanece seguro sin necesidad de configuraciones adicionales.
Cuándo usar mapeo de dominio personalizado
Utiliza mapeo de dominios personalizado cuando quieras que tu sitio de base de conocimiento viva bajo tu propia marca en lugar de un subdominio proporcionado por Document360.
- Quieres que los lectores accedan al contenido de soporte en una URL
help.yourcompany.comcomo en lugar de un subdominio de Document360. - Necesitas la verificación de Google Search Console para tu sitio de base de conocimientos, que solo está soportado en un dominio personalizado.
- Quieres una dirección web más corta y memorable para materiales de marketing o apoyo.
Antes de que empieces
- Un dominio proporcionado por Document360 y un dominio personalizado no pueden coexistir: mapear un dominio personalizado reemplaza al predeterminado.
- Necesitas acceso a la configuración DNS de tu registrador de dominio (por ejemplo, GoDaddy, Namecheap o Cloudflare) para añadir registros TXT y CNAME.
- Actualmente, Document360 solo soporta un dominio personalizado por proyecto.
Cómo editar el dominio predeterminado
A cada nuevo proyecto de Document360 se le asigna automáticamente un dominio predeterminado en el formato project-name.document360.com. Puedes personalizar esta dirección predeterminada antes o en lugar de mapear un dominio completamente personalizado.
- Navega a Configuración > Sitio de la base de conocimientos > Dominio personalizado.
- Haz clic en Editar dominio en el campo proporcionado por Document360. Aparece el cuadro de diálogo Editar subdominio .
- Introduce tu dominio preferido en el campo. El botón Actualizar permanece inactivo si el dominio no está disponible o ya está en uso, y se activa una vez que entras en un dominio disponible.
- Haz clic en Actualizar para actualizar la dirección web de tu base de conocimientos.
Cómo mapear un dominio personalizado
Mapear un dominio personalizado implica tres etapas: añadir el dominio en Document360, configurar los registros DNS con tu registrador y verificar la configuración.
Añadir el dominio personalizado en Document360
- Navega a Configuración > Sitio de la base de conocimientos Dominio personalizado.
- Haz clic en Añadir dominio.
- Introduce tu nombre de dominio personalizado en el campo Introduce tu dominio personalizado y haz clic en Ver configuración.
Tu dominio personalizado ahora se añade a Document360.
Configurar DNS con Document360
.png)
Configura el registro TXT en tu registrador de dominio
- Inicia sesión en tu registrador de dominios (por ejemplo, GoDaddy, Namecheap o Google Domains).
- Navega a la configuración de DNS y haz clic en Añadir nuevo registro.
- Selecciona Registro TXT como tipo de Registro.
- Introduce los datos de Host y Valor/Destino de Document360 en tu registrador de dominio.
- Haz clic en el icono de marcar para guardar los cambios.
- En Document360, haz clic en Verificar. El estado del registro TXT cambia de Pendiente a Verificado.
La verificación de registros DNS en Document360 puede tardar un tiempo en completarse.
Configura el registro CNAME en tu registrador de dominios
- Haz clic en Añadir nuevo registro y selecciona Registro CNAME como tipo de Registro.
- Introduce los datos de Host y Valor/Destino de Document360 en tu registrador de dominio.
.png)
- Haz clic en el icono de marcar para guardar los cambios. En Document360, el estado del registro CNAME cambia de Pendiente a Verificado.
Verificar configuración DNS
Document360 provisiona automáticamente un certificado SSL una vez completada la verificación DNS; Esto puede llevar un tiempo terminarlo.
- Haz clic en Reintentar verificación.
- Una vez verificado, aparece un mensaje de éxito y tu dominio personalizado se vuelve accesible.
.png)
- Haz clic en Ir a tu base de conocimientos para ver el cambio en la URL del sitio.
Tu dominio personalizado ahora está mapeado y accesible para los lectores.
Cómo configurar un dominio Apex
Un dominio Apex (también llamado dominio raíz) es un dominio sin subdominio, como abc.com en lugar de www.abc.com. Configurar un dominio Apex requiere pasos DNS adicionales en comparación con un subdominio estándar.
El aplanamiento DNS te permite usar un registro CNAME a nivel Apex, pero no todos los registradores de dominio lo soportan. Si tu registrador no soporta aplanamiento de DNS — GoDaddy, por ejemplo — puedes cambiar a un proveedor de DNS que sí lo permita, como Cloudflare, que ofrece aplanamiento de DNS en su plan gratuito.
Para más detalles, consulta la documentación de Cloudflare sobre el aplanamiento CNAME.
Uso de un certificado SSL personalizado
Document360 proporciona automáticamente un certificado SSL para tu dominio, con renovación sin interrupciones. Si prefieres instalar tu propio certificado, proporciona los siguientes detalles:
| Campo | Descripción |
|---|---|
| Nombre común (CN) | El nombre de dominio totalmente cualificado para el certificado. |
| Organización (O) | El nombre legal de tu organización. |
| Unidad Organizativa (OU) | El departamento o división dentro de tu organización. |
Los certificados SSL personalizados suelen ser válidos durante 90 días. Renueva tu certificado a tiempo y proporciona el certificado actualizado para que pueda reinstalarse en tu dominio.
Cómo actualizar el balanceador de carga
Un balanceador de carga distribuye el tráfico entrante de manera equitativa entre varios servidores, manteniendo tu sitio de base de conocimiento rápido y fiable durante periodos de alto tráfico y evitando que cualquier servidor se sobrecargue.
- Navega a Configuración > Sitio de la base de conocimientos en la barra de navegación izquierda del portal de la Base de Conocimientos.
- Navega a Dominio personalizado > Mapeo de dominio personalizado.
- Haz clic en Actualizar.
- Verifica la configuración personalizada de mapeo de dominios en Document360.
- Copia el registro CNAME generado en Document360.
- Configura el registro CNAME en tu registrador de dominio.
- Verifica de nuevo la configuración de mapeo de dominio personalizada en Document360. El estado cambia de Pendiente a Verificado.
Esta actualización no provoca inactividades, aunque recomendamos realizarla fuera del horario laboral. Contacta con el soporte de Document360 para recibir ayuda.
El balanceador de carga ahora está actualizado para tu sitio de base de conocimiento
Límites
| Límite | Valor | Notas |
|---|---|---|
| Dominios personalizados por proyecto | 1 | No se soporta un segundo dominio; Configura una redirección de un dominio a otro en su lugar. |
| Dominios por versión | No soportado | Cada versión utiliza un camino personalizable dentro del mismo dominio, no un dominio separado. |
| Validez de certificado SSL personalizado | 90 días | Renueva y vuelve a presentar el certificado antes de que caduque. |
| Verificación en Google Search Console | Se requiere dominio personalizado | La verificación no está soportada en un subdominio proporcionado por Document360. |
Mejores prácticas
- Utiliza enlaces relativos (por ejemplo,
/docs/article-name) en lugar de URLs completas en tu contenido, para que los enlaces no se rompan si cambias de dominio más adelante. - Si estás configurando un dominio Apex y tu registrador no soporta aplanamiento de DNS, cambia a un proveedor que sí lo haga, como Cloudflare, en lugar de evitar la limitación.
- Programa las actualizaciones del balanceador de carga fuera del horario laboral, aunque el proceso no cause inactividad, para minimizar cualquier riesgo durante el cambio.
- Renueva los certificados SSL personalizados antes de su expiración de 90 días para evitar una interrupción en el acceso seguro.
Registradores de dominio común
| Registrador | Referencia |
|---|---|
| NombreBarato | Artículo de apoyo |
| Domain.com | Artículo de apoyo |
| Google Domains | Artículo de apoyo |
| Anfitrión de Sueños | Artículo de apoyo |
| Flotar | Artículo de apoyo |
| GoDaddy | Artículo de apoyo |
| Cloudflare | Artículo de apoyo |
| Presentador azul | Artículo de apoyo |
Preguntas frecuentes
¿Necesito un certificado SSL para configurar un dominio personalizado?
No. Document360 proporciona automáticamente un certificado SSL cuando mapeas tu dominio personalizado. Si prefieres usar tu propio certificado, contacta con support@document360.com.
¿Se reflejará la URL personalizada del dominio en el correo de invitación enviado a los lectores?
Sí. Los correos de invitación enviados después de que el dominio personalizado se haya mapeado correctamente usarán ese dominio personalizado en sus enlaces.
¿Qué hago si el CNAME no se verifica tras actualizar el DNS?
Elimina la configuración actual del dominio personalizado, vuelve a añadir el dominio personalizado, actualiza el CNAME en tu DNS y confirma que se verifica correctamente.
¿Puedo configurar dos dominios personalizados para un solo sitio de la Knowledge Base?
No, pero puedes configurar una redirección de un dominio a otro para que los visitantes del primer dominio acaben en el segundo.
¿Qué es un dominio desnudo?
Un dominio desnudo no incluye el prefijo "www" — por ejemplo, example.com es desnudo, mientras que www.example.com no. La mayoría de los dominios incluyen "www" por defecto.
¿Qué es un registrador de dominio?
Un registrador de dominios es la empresa donde compras y gestionas tu nombre de dominio, como GoDaddy, Namecheap o Google Domains. Ahí actualizarás la configuración personalizada de tu dominio para conectarla a Document360.
¿Qué es un registro CNAME?
Un registro CNAME es una configuración DNS que conecta tu dominio personalizado, como help.yourcompany.com, a otra dirección, como el dominio predeterminado que proporciona Document360. Garantiza que los lectores accedan a tu base de conocimientos cuando escriban tu dominio personalizado.
¿Por qué necesito actualizar al nuevo balanceador de carga?
El nuevo balanceador de carga implementa la descarga SSL a nivel de balanceador de carga para reducir la carga del servidor y mejorar la seguridad, incluye un cortafuegos de aplicaciones web contra ataques comunes como la inyección SQL y el scripting entre sitios, y utiliza la gestión dinámica del tráfico para un mejor rendimiento.
¿Es posible crear un dominio separado para cada versión de mi proyecto?
No. Cada versión utiliza un camino personalizable dentro del dominio existente en lugar de un dominio separado.
¿Cambiar el dominio personalizado afectará al widget o a los enlaces de artículos existentes?
No. El widget se autentica usando un token API, por lo que sigue funcionando tras un cambio de dominio. Los enlaces de artículos en Document360 suelen ser relativos (por ejemplo, /docs/article-name), así que tampoco se romperán. Si has usado URLs completas en su lugar, revísalas y actualízalas manualmente — usar enlaces relativos es la mejor práctica para evitar esto.
¿Por qué veo el Error de Cloudflare 1014 – CNAME Cross-User Banned al configurar mi dominio personalizado?
Esto ocurre cuando tanto Document360 como tu dominio están alojados en Cloudflare, ya que Cloudflare bloquea los registros CNAME entre diferentes cuentas. En una cuenta de pago de Cloudflare, comprueba si "También prevenir subdominios" (retención de zona) está activada — deshábilo temporalmente, deja que el dominio lo verifique y luego vuelve a habilitarlo. En una cuenta gratuita, la retención de zona está desactivada por defecto; asegúrate de que tus registros CNAME se propaguen en un plazo de 7 días desde su generación en Document360 y, si la verificación sigue fallando, elimina y reconfigura el dominio personalizado. Si persisten los problemas, contacta con el soporte de Cloudflare, ya que la causa puede estar relacionada con la facturación.
¿Añadir un dominio personalizado cambia el enlace de mi portal de Document360?
No. La URL de tu portal se mantiene igual: el dominio personalizado solo se aplica al sitio de la Knowledge Base, no al portal de administración.
¿Puedo personalizar la estructura de las URLs de mi base de conocimientos?
No, la estructura de la URL es fija. Puedes configurar un dominio personalizado o modificar un slug de artículo, pero componentes clave como la versión del proyecto, el lenguaje y las rutas definidas por el sistema (por ejemplo, /docs/) no se pueden cambiar.
¿Cómo puedo conseguir una URL más limpia o fácil de usar para mi base de conocimientos?
El formato de la URL en sí es fijo, pero puedes hacerlo más limpio editando el subdominio predeterminado (a través de Configuración > Dominio personalizado > Editar dominio), configurando un dominio personalizado para reemplazar completamente el subdominio Document360, o renombrando tu proyecto con un nombre más corto, que también actualiza el subdominio predeterminado. No se permite eliminar el código del idioma de la URL, y la redirección a nivel de artículo no puede cambiar el formato de la URL en sí.
¿Por qué la verificación de Google Search Console no funciona para mi sitio de base de conocimientos?
La verificación en Google Search Console solo funciona en un dominio personalizado. Si tu sitio está en un subdominio de Document360, la verificación falla independientemente del método, ya que los subdominios de Document360 comparten el dominio raíz de la plataforma y verificarlos podría entrar en conflicto con la propia marca y SEO de Document360. Configura primero un dominio personalizado y luego completa la verificación usando cualquier método compatible.
¿Cambiar el subdominio proporcionado por Document360 afectará a mi configuración SSO o SCIM?
No. Cambiar el subdominio proporcionado por Document360 no afecta la autenticación SSO existente ni la configuración SCIM, aunque los usuarios que inicien sesión vía SSO deberán usar el subdominio actualizado después.