Configuración de DNS y Dominio
Después de instalar el módulo, necesitas decidir cómo tus inquilinos accederán a su CRM. Esta es una de las decisiones más importantes para tu plataforma SaaS, así que expliquemos todas las opciones claramente.
Entender las Estructuras de URL
El módulo soporta tres formas diferentes para que los inquilinos accedan a su CRM. Esto es lo que parece cada una:
Opción 1: Modo Subdirectorio (Configuración Más Fácil)
https://tusitio.com/ws/nombre-del-inquilino
Ejemplo: Si tu dominio es micrm.com y un inquilino llamado "Acme Corp" se registra, accederán a su CRM en:
https://micrm.com/ws/acme-corp
Ventajas:
- No se necesita configuración DNS adicional
- Funciona en cualquier plan de hosting
- No se requiere SSL wildcard
- Configuración más simple
Desventajas:
- Apariencia menos "profesional" que un subdominio
- Los inquilinos no pueden usar dominios personalizados
Ideal para: Comenzar rápidamente, pruebas, despliegues pequeños.
Opción 2: Modo Subdominio
https://nombre-del-inquilino.tusitio.com
Ejemplo: Acme Corp accedería a su CRM en:
https://acme-corp.micrm.com
Ventajas:
- Apariencia profesional y con marca
- Cada inquilino siente que tiene su propia plataforma
- Estándar de la industria para plataformas SaaS
Desventajas:
- Requiere registro DNS wildcard
- Puede requerir SSL wildcard (¡pero tenemos soluciones!)
Ideal para: Despliegues SaaS profesionales, negocios que quieren impresionar a sus clientes.
Opción 3: Modo Dominio Personalizado
https://crm.dominio-propio-del-inquilino.com
Ejemplo: Acme Corp podría usar su propio dominio:
https://crm.acmecorp.com
Ventajas:
- Máxima personalización de marca para tus inquilinos
- Los inquilinos pueden usar el dominio de su propia empresa
- Mayor valor percibido
Desventajas:
- Cada inquilino necesita configurar su DNS
- Requiere más configuración por inquilino
Ideal para: Ofertas empresariales, planes premium, servicios de marca blanca.
Configurar el Modo Subdirectorio
Este es el modo predeterminado y no requiere casi ninguna configuración DNS.
Paso 1: Habilitar la Estructura de Subdirectorio
- Ve a SaaS Management → SuperAdmin Settings
- Haz clic en la pestaña MySQL Server Settings
- Establece "Use Subdir Structure '/ws/{tenant}'" en Yes
- Haz clic en Save Settings
Paso 2: ¡Eso es Todo!
En serio — si estás usando el modo subdirectorio, no se necesita configuración DNS. Los inquilinos serán accesibles automáticamente en tusitio.com/ws/slug-del-inquilino.
Configurar el Modo Subdominio
El modo subdominio requiere un registro DNS wildcard. Aquí te explicamos exactamente cómo configurarlo:
¿Qué es un Registro DNS Wildcard?
Un registro DNS wildcard es una entrada DNS especial que captura TODOS los subdominios y los apunta a tu servidor. En lugar de crear un registro DNS para cada inquilino individualmente (lo cual sería imposible), un solo registro wildcard los maneja todos.
Piénsalo como una redirección de correo: "Cualquier correo dirigido a cualquiercosa@tuempresa.com debe ir a la oficina principal."
Paso 1: Encontrar la Dirección IP de tu Servidor
Necesitas la dirección IP de tu servidor. Aquí te explicamos cómo encontrarla:
- cPanel: Mira en la parte superior del dashboard de tu cPanel — muestra tu IP
- VPS/Cloud: Revisa el dashboard de tu proveedor de hosting
- Línea de comandos: Ejecuta
curl ifconfig.meen tu servidor
Paso 2: Agregar el Registro DNS Wildcard
- Inicia sesión en tu registrador de dominio (donde compraste tu dominio — ej., Namecheap, GoDaddy, Cloudflare)
- Ve a la configuración DNS de tu dominio
- Agrega un nuevo Registro A con esta configuración:
| Campo | Valor |
|---|---|
| Type | A |
| Host/Name | * (solo un asterisco) |
| Value/Points to | La dirección IP de tu servidor (ej., 123.456.789.0) |
| TTL | Automático (o 3600) |
¡El asterisco (*) es importante! Debe ser exactamente * — no *.tusitio.com ni nada más. Solo el carácter de asterisco.
Paso 3: Esperar la Propagación DNS
Los cambios DNS no toman efecto instantáneamente. Necesitan "propagarse" por internet:
- Cloudflare: Usualmente instantáneo (dentro de 5 minutos)
- La mayoría de registradores: 15 minutos a 4 horas
- Algunos registradores: Hasta 24-48 horas (raro)
Puedes verificar si tu DNS se ha propagado usando dnschecker.org.
Paso 4: Deshabilitar el Modo Subdirectorio
- Ve a SaaS Management → SuperAdmin Settings
- Haz clic en la pestaña MySQL Server Settings
- Establece "Use Subdir Structure '/ws/{tenant}'" en No
- Haz clic en Save Settings
Ahora los inquilinos serán accesibles en nombre-del-inquilino.tusitio.com en lugar de tusitio.com/ws/nombre-del-inquilino.
Configurar Dominios Personalizados
Los dominios personalizados permiten a los inquilinos usar su propio dominio (como crm.suempresa.com) para acceder a su CRM. ¡Esta es una función premium que a tus inquilinos les encantará!
Cómo Funcionan los Dominios Personalizados
- Tú habilitas la función de Dominio Personalizado en el plan del inquilino
- El inquilino ingresa su dominio deseado en su dashboard
- El inquilino (o tú) apunta el DNS de su dominio a la IP de tu servidor
- El módulo detecta automáticamente el dominio y enruta el tráfico al inquilino correcto
Habilitar Dominios Personalizados
- Ve a SaaS Management → Plans
- Edita el plan donde quieres habilitar dominios personalizados
- En Advanced Features, cambia "Enable Custom Domain" a ON
- Guarda el plan
Activa "Enable Custom Domain" en la sección Advanced Feature de tu plan
Lo Que Tus Inquilinos Necesitan Hacer
Cuando un inquilino quiere usar un dominio personalizado, necesita agregar registros DNS apuntando a tu servidor. El módulo incluye una guía DNS integrada que los inquilinos pueden acceder con un clic:
La guía DNS integrada les dice a tus inquilinos exactamente qué registros DNS agregar — ¡no se necesitan tickets de soporte!
La guía les indica:
- Agregar un Registro A con su dominio apuntando a la IP de tu servidor
- Opcionalmente agregar una versión www
- Esperar la propagación DNS (hasta 48 horas)
Hoja de Referencia de Configuración DNS
Aquí tienes una referencia rápida para todos los registros DNS que puedas necesitar:
| Propósito | Tipo | Host/Name | Valor |
|---|---|---|---|
| Dominio principal | A | @ | IP de tu servidor |
| Versión www | A | www | IP de tu servidor |
| Subdominios wildcard | A | * | IP de tu servidor |
| Dominio personalizado del inquilino | A (en el DNS del inquilino) | @ | IP de tu servidor |
Probar tu Configuración DNS
Después de hacer cambios DNS, pruébalos:
- Abre un navegador y navega a un subdominio de prueba:
http://test123.tudominio.com - Si ves tu Perfex CRM (o una página de destino) — ¡el DNS funciona!
- Si ves un error — el DNS aún no se ha propagado. Espera e intenta de nuevo.
También puedes usar estas herramientas en línea para verificar:
- dnschecker.org — Verificar la propagación DNS a nivel mundial
- mxtoolbox.com/DNSLookup.aspx — Consulta DNS detallada
¿DNS configurado? ¡Genial! Ahora configura SSL para conexiones seguras. Dirígete a la guía de Configuración SSL a continuación.