Configura��o de DNS e Dom�nio
Depois de instalar o m�dulo, precisa de decidir como os seus inquilinos aceder�o ao seu CRM. Esta � uma das decis�es mais importantes para a sua plataforma SaaS. Explicamos todas as op��es de forma clara.
Compreender as Estruturas de URL
O m�dulo suporta tr�s formas diferentes de os inquilinos acederem ao seu CRM. Eis como cada uma funciona:
Op��o 1: Modo Subdiret�rio (Configura��o Mais F�cil)
https://yoursite.com/ws/tenant-name
Exemplo: Se o seu dom�nio for mycrm.com e um inquilino chamado "Acme Corp" se registar, aceder�o ao seu CRM em:
https://mycrm.com/ws/acme-corp
Vantagens:
- N�o � necess�ria configura��o DNS adicional
- Funciona em qualquer plano de alojamento
- N�o � necess�rio SSL wildcard
- Configura��o mais simples
Desvantagens:
- Menos "profissional" que um subdom�nio
- Os inquilinos n�o podem usar dom�nios personalizados
Ideal para: Come�ar rapidamente, testes, implanta��es pequenas.
Op��o 2: Modo Subdom�nio
https://tenant-name.yoursite.com
Exemplo: A Acme Corp acederia ao seu CRM em:
https://acme-corp.mycrm.com
Vantagens:
- Aspeto profissional e com marca
- Cada inquilino sente que tem a sua pr�pria plataforma
- Padr�o da ind�stria para plataformas SaaS
Desvantagens:
- Requer registo DNS wildcard
- Pode exigir SSL wildcard (mas temos alternativas!)
Ideal para: Implanta��es SaaS profissionais, empresas que querem impressionar clientes.
Op��o 3: Modo Dom�nio Personalizado
https://crm.tenant-own-domain.com
Exemplo: A Acme Corp poderia usar o seu pr�prio dom�nio:
https://crm.acmecorp.com
Vantagens:
- Marca m�xima para os seus inquilinos
- Os inquilinos podem usar o dom�nio da sua empresa
- Maior valor percebido
Desvantagens:
- Cada inquilino precisa de configurar o seu DNS
- Requer mais configura��o por inquilino
Ideal para: Ofertas enterprise, planos premium, servi�os white-label.
Configurar o Modo Subdiret�rio
Este � o modo padr�o e quase n�o requer configura��o DNS.
Passo 1: Ativar a Estrutura de Subdiret�rio
- V� a SaaS Management ? SuperAdmin Settings
- Clique no separador MySQL Server Settings
- Defina "Use Subdir Structure '/ws/{tenant}'" como Yes
- Clique em Save Settings
Passo 2: Pronto!
A s�rio ? se estiver a usar o modo subdiret�rio, n�o � necess�ria configura��o DNS. Os inquilinos ser�o acess�veis automaticamente em yoursite.com/ws/tenant-slug.
Configurar o Modo Subdom�nio
O modo subdom�nio requer um registo DNS wildcard. Eis como configur�-lo:
O que � um Registo DNS Wildcard?
Um registo DNS wildcard � uma entrada DNS especial que captura TODOS os subdom�nios e os aponta para o seu servidor. Em vez de criar um registo DNS para cada inquilino (o que seria imposs�vel), um registo wildcard trata de todos.
Pense nisso como um redirecionamento de correio: "Qualquer correio dirigido a qualquer coisa@yourcompany.com deve ir para o escrit�rio principal."
Passo 1: Encontrar o Endere�o IP do Servidor
Precisa do endere�o IP do seu servidor. Eis como encontr�-lo:
- cPanel: Veja no topo do seu painel cPanel ? mostra o seu IP
- VPS/Cloud: Verifique o painel do seu fornecedor de alojamento
- Linha de comandos: Execute
curl ifconfig.meno seu servidor
Passo 2: Adicionar o Registo DNS Wildcard
- Inicie sess�o no seu registrador de dom�nio (onde comprou o dom�nio ? ex.: Namecheap, GoDaddy, Cloudflare)
- V� �s defini��es DNS do seu dom�nio
- Adicione um novo Registo A com estas defini��es:
| Campo | Valor |
|---|---|
| Type | A |
| Host/Name | * (apenas um asterisco) |
| Value/Points to | Endere�o IP do seu servidor (ex.: 123.456.789.0) |
| TTL | Automatic (ou 3600) |
O asterisco (*) � importante! Deve ser exatamente * ? n�o *.yoursite.com ou outra coisa. Apenas o car�cter asterisco �nico.
Passo 3: Aguardar a Propaga��o DNS
As altera��es DNS n�o t�m efeito imediato. Precisam de "propagar" pela Internet:
- Cloudflare: Geralmente instant�neo (dentro de 5 minutos)
- A maioria dos registadores: 15 minutos a 4 horas
- Alguns registadores: At� 24?48 horas (raro)
Pode verificar se o seu DNS propagou em dnschecker.org.
Passo 4: Desativar o Modo Subdiret�rio
- V� a SaaS Management ? SuperAdmin Settings
- Clique no separador MySQL Server Settings
- Defina "Use Subdir Structure '/ws/{tenant}'" como No
- Clique em Save Settings
Agora os inquilinos ser�o acess�veis em tenant-name.yoursite.com em vez de yoursite.com/ws/tenant-name.
Configurar Dom�nios Personalizados
Os dom�nios personalizados permitem que os inquilinos usem o seu pr�prio dom�nio (como crm.theircompany.com) para aceder ao seu CRM. Esta � uma funcionalidade premium que os seus inquilinos v�o adorar!
Como Funcionam os Dom�nios Personalizados
- Ativa a funcionalidade Dom�nio Personalizado no plano do inquilino
- O inquilino introduz o dom�nio desejado no seu dashboard
- O inquilino (ou voc�) aponta o DNS do dom�nio para o IP do seu servidor
- O m�dulo deteta automaticamente o dom�nio e encaminha o tr�fego para o inquilino correto
Ativar Dom�nios Personalizados
- V� a SaaS Management ? Plans
- Edite o plano onde quer ativar dom�nios personalizados
- Em Advanced Features, ative "Enable Custom Domain" para ON
- Guarde o plano
Ativar "Enable Custom Domain" na sec��o Advanced Features do seu plano
O que os Seus Inquilinos Precisam de Fazer
Quando um inquilino quer usar um dom�nio personalizado, precisa de adicionar registos DNS que apontem para o seu servidor. O m�dulo inclui um guia DNS integrado que os inquilinos podem aceder com um clique:
O guia DNS integrado diz aos seus inquilinos exatamente quais registos DNS adicionar ? sem necessidade de bilhetes de suporte!
O guia diz-lhes para:
- Adicionar um Registo A com o dom�nio deles apontando para o IP do seu servidor
- Opcionalmente adicionar uma vers�o www
- Aguardar a propaga��o DNS (at� 48 horas)
Refer�ncia R�pida de Configura��o DNS
Refer�ncia r�pida para todos os registos DNS que pode precisar:
| Finalidade | Type | Host/Name | Value |
|---|---|---|---|
| Dom�nio principal | A | @ | IP do seu servidor |
| Vers�o www | A | www | IP do seu servidor |
| Subdom�nios wildcard | A | * | IP do seu servidor |
| Dom�nio personalizado do inquilino | A (no DNS do inquilino) | @ | IP do seu servidor |
Testar a Sua Configura��o DNS
Depois de fazer altera��es DNS, teste-as:
- Abra um browser e navegue para um subdom�nio de teste:
http://test123.yourdomain.com - Se vir o seu Perfex CRM (ou uma landing page) ? o DNS est� a funcionar!
- Se vir um erro ? o DNS ainda n�o propagou. Aguarde e tente novamente.
Tamb�m pode usar estas ferramentas online para verificar:
- dnschecker.org ? Verificar propaga��o DNS mundialmente
- mxtoolbox.com/DNSLookup.aspx ? Consulta DNS detalhada
DNS configurado? �timo! Agora configure SSL para conex�es seguras. Siga para o guia Configura��o SSL a seguir.