Referência de DNS e SSL
Registro DNS
O drawer "Novo subdomínio" mostra, no bloco "Aponte o subdomínio para a TagServer", duas abas. Crie os registros de uma opção ou da outra, nunca das duas.
| Opção | Registros | Valor | Observação |
|---|---|---|---|
| A / AAAA (aba padrão) | A (IPv4) e AAAA (IPv6) | os endereços da TagServer exibidos no app; copie com "Copiar A" e "Copiar AAAA" | o AAAA aparece só quando configurado; crie os dois registros quando o app mostrar os dois |
| CNAME | CNAME | tgsr.cc; copie com "Copiar CNAME" | tgsr.cc resolve para os mesmos endereços da aba A / AAAA |
Em todas as opções, o Host (Nome) é o subdomínio que você escolher, ex. tagserver ou metrics.
Qual escolher: um CNAME não pode coexistir com outros registros no mesmo nome. Se o host já tem outros registros, ou se é a raiz do domínio, use A / AAAA.
Exemplo com CNAME:
| Host | Tipo | Valor | Subdomínio completo |
|---|---|---|---|
metrics | CNAME | tgsr.cc | metrics.seu-site.com.br |
O mesmo registro em formato de arquivo de zona:
tagserver.seudominio.com IN CNAME tgsr.cc
Abaixo das abas, no bloco "Informe seu subdomínio", digite o subdomínio completo no campo "Informar subdomínio", ex. tagserver.seudominio.com. A plataforma normaliza o nome e mostra "Será enviado como: <nome normalizado>". O botão "Adicionar" fica desabilitado só enquanto o campo está vazio, enquanto o pedido é processado ou quando o campo tem erro de validação.
Cada subdomínio é único no TagServer: o mesmo subdomínio não pode ser vinculado a duas contas.
Verificar DNS
O botão "Verificar DNS" fica no cabeçalho da tela Subdomínios, ao lado de "Adicionar subdomínio", e não exige permissão de escrita. O diálogo pede um "Domínio" e confere se ele já aponta para a TagServer. Nada é cadastrado.
A mesma verificação roda nesse diálogo, em "Reverificar DNS" e de novo antes do pedido do certificado. Ela só passa quando todos os endereços para os quais o subdomínio resolve são da TagServer. As duas opções passam: os registros A / AAAA são os endereços da TagServer, e tgsr.cc resolve para eles.
Durante a checagem, o diálogo mostra duas etapas: "Consultando o DNS de <domínio>" e "Conferindo se todos os endereços são da TagServer".
| Resultado | O que aparece |
|---|---|
| Tudo certo com <domínio> | o botão "Adicionar este subdomínio" (exige permissão de escrita), que abre o drawer "Novo subdomínio" com o domínio já preenchido |
| Ainda não está certo | a mensagem do problema (tabela abaixo) e a seção "Quais registros criar?", com as mesmas abas A / AAAA e CNAME |
| Não foi possível verificar | a verificação em si não conseguiu rodar |
| Problema | Mensagem do app |
|---|---|
| Nenhum registro (ainda não criado ou não propagado) | "O domínio ainda não tem nenhum registro apontando para um endereço. Crie o registro e aguarde a propagação, que pode levar algumas horas." |
| Pelo menos um endereço não é da TagServer | "O domínio aponta para "<ip>", que não é da TagServer. Remova esse registro." (no plural quando são vários) |
Um registro antigo desse host apontando para outro lugar (ex. um AAAA antigo ao lado do registro novo) quebra o vínculo. Remova os registros antigos que apontam para outro lugar; registros A / AAAA com os endereços da TagServer estão corretos e ficam.
SSL
| Item | Valor |
|---|---|
| Emissão | automática, feita pela plataforma; nenhuma ação sua |
| Tecnologia | ACME (Let's Encrypt), HTTP-01, em processo (sem certbot) |
| Momento | em segundos, assim que o DNS do subdomínio (registros A / AAAA ou CNAME) resolve para a TagServer |
| Renovação | automática, agendada cerca de 29 dias antes do vencimento |
Com o certificado SSL ativo, a transmissão ao subdomínio é feita por HTTPS.
Tempos de propagação
| Etapa | Tempo | Controle |
|---|---|---|
| Propagação do DNS (A / AAAA ou CNAME) | de alguns minutos a algumas horas, conforme o provedor e o TTL | fora do TagServer |
| Emissão do SSL | segundos, após o DNS resolver | automática, pela plataforma |
Antes de vincular, confira o DNS com Verificar DNS. Para acompanhar a propagação em vários resolvedores, você também pode usar o dnschecker.org.
Status do subdomínio
Cada subdomínio na lista mostra um rótulo de status, com um ponto colorido opcional, em três estados:
| Status | Ponto | Significado |
|---|---|---|
| Ativo | verde | existe certificado e não há erro ativo |
| Emitindo | sem ponto | o certificado ainda não foi emitido |
| Erro | vermelho | o subdomínio tem um erro ativo |
A lista tem três colunas: Status (o rótulo acima), Subdomínio e uma coluna de ação sem rótulo. A coluna Subdomínio traz uma linha secundária:
| Condição | Linha secundária |
|---|---|
| Certificado em dia | "SSL válido até <data> - criado em <data>", uma barra de vida do certificado e "Renova automaticamente" |
| Renovação atrasada | "Renovação atrasada - expira em N dias" |
| Renovação atrasada, certificado já expirado | "Renovação atrasada - expirado" |
| Sem certificado e sem erro | "Emitindo certificado SSL..." |
| Erro ativo | a mensagem de erro (em fonte monoespaçada) seguida de "- desde <data>" |
A coluna de ação é um menu "..." com "Reverificar DNS", "Renovar SSL" e "Excluir".
Quando um ou mais subdomínios têm erro ativo, um banner de saúde aparece no topo da página, intitulado "N subdomínios com problema" (ou "1 subdomínio com problema"). Ele lista a mensagem de erro de cada subdomínio quebrado e, quando aplicável, "Certificado expira em N dias" ou "Certificado expirado". Sem nenhum subdomínio em erro, o banner não é exibido.
Duas ações manuais tratam do DNS/SSL:
- Reverificar DNS roda de novo a verificação descrita em Verificar DNS.
- Renovar SSL ("Renovar agora") força a renovação do certificado. Se o certificado ainda não está na janela de renovação, a plataforma responde que a renovação ainda não está na hora.
As duas ações exigem permissão de escrita. Para um membro sem essa permissão, o gatilho do menu "..." e os botões do banner aparecem desabilitados, com uma dica pedindo que ele fale com o dono da conta.
Em Rastreamento > Visão geral, a coluna "Estado" do subdomínio mostra "No ar" ou "Com erro", um resumo próprio dessa tela. Ela não tem botões de correção: as correções ficam na tela Subdomínios.
Durante a vinculação, a plataforma mostra um progresso em 3 etapas. Cada etapa mostra um spinner (pendente), um check (sucesso) ou um X com a mensagem de erro (erro):
| Etapa | Descrição |
|---|---|
| 1 | Checando a configuração do DNS |
| 2 | Vinculando subdomínio ao servidor |
| 3 | Finalizado com sucesso! |
Para a configuração guiada do primeiro subdomínio, veja Configurando o ambiente.