Pular para o conteúdo
⚙️ HOW-TO

Configurar domínio customizado

Sirva o auth do seu produto em auth.seudomain.com.br em vez de auth.superdb.com.br.

O que é um domínio customizado

Por padrão, o endpoint de autenticação do SuperDB fica em auth.superdb.com.br. Com domínio customizado, você expõe o auth em um subdomínio do seu produto — por exemplo auth.acme.com.br.

Isso melhora a experiência do usuário (sem ver "superdb" na URL), permite branded emails e é exigido por algumas políticas de segurança corporativa.

Pré-requisitos

  • Plano Pro ou Scale (não disponível no Free).
  • Acesso ao painel DNS do seu domínio (Cloudflare, Route53, Registro.br, etc.).
  • O subdomínio ainda não pode ter outro registro CNAME ou A.

Configuração DNS

Adicione um registro CNAME no seu provedor DNS:

Registro DNS (exemplo: Cloudflare)
Tipo:   CNAME
Nome:   auth          (ou o subdomínio que preferir)
Valor:  auth.superdb.com.br
TTL:    Auto (ou 300 segundos)
Proxy:  Desativado (DNS only, nuvem cinza no Cloudflare)
⚠️

Cloudflare Proxy: Desative o proxy (nuvem cinza). Com proxy ativo, o certificado TLS do SuperDB não consegue ser emitido via Let's Encrypt.

Configuração no Admin UI

  1. Acesse admin.superdb.com.br → Settings → Branding.
  2. Em Custom Domain, insira o subdomínio completo: auth.acme.com.br
  3. Clique em Verificar DNS. O sistema confirma que o CNAME está propagado.
  4. Após verificação, clique em Ativar domínio.
  5. O certificado TLS via Let's Encrypt é emitido automaticamente em até 2 minutos.
  6. Atualize a Redirect URI nos seus OAuth providers para usar o novo domínio.

SSL automático

O SuperDB usa Let's Encrypt para emitir e renovar certificados TLS automaticamente. Nenhuma ação manual é necessária. O certificado é renovado 30 dias antes da expiração.

Troubleshooting

Verificação DNS falhou

A propagação de DNS pode levar de alguns minutos até 48 horas. Verifique o registro usando:

bash
dig CNAME auth.acme.com.br +short
# deve retornar: auth.superdb.com.br.

Certificado SSL não emitido

Let's Encrypt requer que o domínio seja acessível publicamente na porta 80. Se o servidor bloquear HTTP, o desafio ACME falha. Contate o suporte: contato@superdb.com.br.

Essa página ajudou?