Configuração Domínio Personalizado

Metadados

• Documento: CUSTOM_DOMAIN_CLIENT_SETUP
• Versao: v1.1.0
• Status: ACTIVE
• Classificacao: CLIENT-SHAREABLE
• Owner: Customer Success + Engineering
• Aprovador: CTO
• Ultima revisao: 2026-03-11
• Proxima revisao: 2026-06-11

1. Objetivo

Orientar clientes Quiker na configuracao de dominio personalizado com foco em DNS e comportamento de redirect.

2. Como funciona

• A URL canonica Quiker continua ativa como fallback oficial.
• O dominio personalizado deve apenas redirecionar para a URL canonica do hub.
• O redirect deve ser 301 (ou 308), com preservacao de path e query string.
• O destino deve ser sempre https.

Exemplo:

• Dominio personalizado: hub.cliente.com
• URL canonica Quiker: https://meu-hub.quiker.com.br
• Resultado esperado: https://hub.cliente.com/ofertas?utm=abc redireciona para https://meu-hub.quiker.com.br/ofertas?utm=abc

3. Informacoes necessarias antes da configuracao

Solicite ao time Quiker:

1. Host personalizado que sera configurado (ex.: hub.cliente.com).
2. URL canonica de destino do hub (ex.: https://meu-hub.quiker.com.br).

Exemplo:

• Origem: hub.cliente.com
• Destino: https://meu-hub.quiker.com.br

4. Passo a passo generico (qualquer provedor DNS)

1. Defina o host de origem que o cliente deseja usar.

• Exemplo: hub.cliente.com

2. Crie o registro DNS desse host na zona correta.

• Se for subdominio, normalmente use CNAME.
• Se for dominio raiz (cliente.com), use A/AAAA (ou ALIAS/ANAME, conforme provedor).
• Em caso de subzona delegada (ex.: dev.cliente.com), confirme que o registro foi criado na zona delegada correta.

3. Configure no provedor de hosting/proxy/regra web um redirect permanente.

• Tipo: 301 (ou 308).
• Origem: https://<host-customizado>/*
• Destino: https://<hub-canonico-quiker>/$1
• Preservar query string: habilitado.

4. Habilite HTTPS no dominio de origem.

• Instale certificado TLS valido para o host customizado no provedor utilizado para redirect.
• Se o cliente nao habilitar HTTPS na origem, https://host-customizado podera falhar.

5. Requisitos tecnicos obrigatorios

1. Status do redirect: 301 ou 308.
2. Destino obrigatoriamente em https.
3. Preservar path e query.
4. URL canonica do hub deve ser a informada pela Quiker.

6. Validacao obrigatoria

Executar apos propagacao DNS e configuracao do redirect:

dig +short hub.cliente.com A
dig +short hub.cliente.com CNAME
curl -I http://hub.cliente.com/
curl -I "http://hub.cliente.com/teste?utm=abc"
curl -I https://hub.cliente.com/
curl -I "https://hub.cliente.com/teste?utm=abc"

Resultado esperado:

1. DNS resolve (dig retorna IP/alias/cname).
2. curl retorna 301 ou 308.
3. Header Location aponta para a URL canonica correta.
4. path e query sao preservados.
5. Sem loop e sem cadeia incorreta de redirects.

7. Erros comuns e correcao

1. Could not resolve host

• Registro foi criado na hosted zone errada (ex.: zona principal em vez de subzona delegada).
• Aguardar propagacao DNS.

2. Retorno 302 em vez de 301/308

• Ajustar regra no provedor para redirect permanente.

3. https nao funciona no dominio personalizado

• Certificado TLS nao configurado no provedor que responde pelo host de origem.
• Regra de redirect foi aplicada apenas para http.

4. Redirect sem path/query

• Ajustar regra para preservar caminho e parametros.

5. Redirect para hub errado

• Revisar URL canonica informada pela Quiker.

8. Checklist final para envio ao time Quiker

Enviar evidencias:

1. Host personalizado configurado.
2. URL canonica configurada como destino.
3. Print da configuracao DNS (registro criado).
4. Print da configuracao da regra de redirect.
5. Saida dos comandos curl -I (com Location visivel).
6. Confirmacao de 301 (ou 308) com preservacao de path/query.