Base de Conhecimento

Certificado SSL wildcard: o que é e como emitir

  • ssl, wildcard, let's encrypt, certbot, dns-01
  • Usuários acharam útil: 0

Entenda o curinga de um nível, o domínio raiz à parte, a diferença para o certificado SAN, a emissão pelo DNS-01 com plugin ou modo manual e o cuidado com o token do DNS.

Por Redação Eleven Host · @robson.direitodigital · 19 de novembro de 2026 · 9 min de leitura

Arte da Eleven Host: janela de terminal com o título: Certificado SSL wildcard: o que é e como emitir

Capa da Redação Eleven Host para o guia: Certificado SSL wildcard: o que é e como emitir Arte: Eleven Host

Certificado SSL wildcard é o certificado com um asterisco no nome, como *.exemplo.com.br, que vale para vários subdomínios de um mesmo nível com um certificado só. No Let's Encrypt, ele é emitido pelo desafio DNS-01, com um registro TXT no DNS.

Pela FAQ do Let's Encrypt, certificado wildcard só sai pelo desafio DNS-01. Pela regra da RFC 9525, o asterisco vale para um único rótulo do nome. Na prática, o domínio raiz e os subdomínios de dois níveis ficam de fora e precisam entrar como nomes à parte.

O que é um certificado SSL wildcard

O certificado comum traz nomes fixos, como exemplo.com.br e www.exemplo.com.br. No wildcard, também chamado de curinga, o primeiro pedaço do nome é um asterisco, e o mesmo certificado passa a valer para loja.exemplo.com.br, blog.exemplo.com.br ou painel.exemplo.com.br.

Quando o nome aberto não bate com nenhum nome do certificado, o navegador mostra um aviso, assunto de Sua conexão não é particular: o que é e como resolver. O curinga é uma forma de cobrir vários subdomínios sem emitir um certificado por nome.

O Let's Encrypt anunciou o suporte a wildcard em 13/03/2018, já com validação pelo DNS.

A VPS, servidor virtual com mensalidade, está à venda na Eleven Host. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver VPS

O que o curinga cobre e o que não cobre

A regra de como o cliente compara um nome com curinga está na RFC 9525, de novembro de 2023, que substituiu a RFC 6125. Ela aceita o curinga só com um único asterisco ocupando sozinho o rótulo mais à esquerda do nome.

A mesma RFC diz que um curinga corresponde a um único rótulo. Na prática, com *.exemplo.com.br no certificado:

  • Cobre: loja.exemplo.com.br, blog.exemplo.com.br e www.exemplo.com.br, que têm um rótulo no lugar do asterisco.
  • Não cobre: a.b.exemplo.com.br, que tem dois rótulos no lugar do asterisco.
  • Não cobre: exemplo.com.br, o domínio raiz, que não tem rótulo nenhum ali.

Por isso recomendamos pedir o curinga junto com o domínio raiz, como dois nomes no mesmo certificado. Um nome de dois níveis precisa de outro curinga, como *.loja.exemplo.com.br, ou do nome exato.

Wildcard ou certificado com vários nomes (SAN)

Segundo a FAQ do Let's Encrypt, um mesmo certificado pode conter vários nomes diferentes pelo mecanismo Subject Alternative Name, o SAN. Assim, um único certificado pode listar exemplo.com.br, www.exemplo.com.br e loja.exemplo.com.br, cada um escrito por extenso.

A escolha depende de como os subdomínios mudam:

  • Wildcard: recomendamos quando há muitos subdomínios de um nível, ou quando eles são criados e apagados com frequência, como ambientes de teste.
  • SAN com nomes listados: recomendamos quando os nomes são poucos e fixos, quando há subdomínios em níveis diferentes ou domínios diferentes no mesmo certificado, ou quando o provedor de DNS não oferece API.
  • Os dois juntos: o curinga e o domínio raiz no mesmo pedido, como no exemplo de emissão pelo DNS-01.

Pela página de tipos de desafio do Let's Encrypt, o desafio HTTP-01 não emite certificados wildcard.

Como emitir um certificado wildcard pelo DNS-01

A página de tipos de desafio do Let's Encrypt explica o DNS-01 assim: o cliente ACME, como o Certbot, recebe um token e cria um registro TXT, derivado desse token e da chave da conta, no nome _acme-challenge. seguido do seu domínio. O Let's Encrypt consulta o DNS e, achando o registro, valida o pedido.

A mesma página cita como vantagens o wildcard e o uso com vários servidores web, e como desvantagens o risco de guardar credenciais de API no servidor e o fato de nem todo provedor de DNS oferecer API.

1. Confira se o seu DNS tem plugin do Certbot

Com o Certbot instalado, a documentação dele diz que dá para obter um certificado wildcard com os plugins de DNS, que não vêm na instalação padrão e precisam ser instalados à parte. A documentação lista, entre outros, certbot-dns-cloudflare, certbot-dns-route53 e certbot-dns-rfc2136, e há também plugins de terceiros. Recomendamos instalar o plugin do provedor onde fica a zona DNS do domínio, seguindo a documentação daquele plugin.

2. Crie uma credencial com escopo só de DNS

No exemplo do plugin da Cloudflare, a documentação pede um token de API com a permissão Zone:DNS:Edit apenas para as zonas que vão receber certificado. A Global API Key aparece lá como alternativa não recomendada, por acessar a API de todos os domínios da conta.

3. Grave o arquivo de credenciais

O plugin lê o token de um arquivo INI. O formato da documentação, com um valor de exemplo, é este:

dns_cloudflare_api_token = 0123456789abcdef0123456789abcdef01234567

A documentação usa o caminho ~/.secrets/certbot/cloudflare.ini e sugere restringir o acesso ao arquivo com um comando como chmod 600. Um exemplo de comando, depois de criar a pasta e o arquivo:

chmod 600 ~/.secrets/certbot/cloudflare.ini

4. Peça o certificado

A documentação do Certbot diz que a opção -d indica os nomes e que, para vários nomes, a opção se repete. Um exemplo de comando com o curinga e o domínio raiz, com o asterisco entre aspas simples para o terminal não o interpretar:

sudo certbot certonly --dns-cloudflare --dns-cloudflare-credentials ~/.secrets/certbot/cloudflare.ini -d exemplo.com.br -d '*.exemplo.com.br'

Troque o domínio pelo seu e confira as opções na documentação do plugin instalado. No plugin da Cloudflare, a espera pela propagação é a opção --dns-cloudflare-propagation-seconds, com padrão de 10 segundos.

Sem plugin: o modo manual

Sem plugin para o seu DNS, a documentação do Certbot descreve o modo manual, com --manual e --preferred-challenges para escolher o desafio. Um exemplo de comando:

sudo certbot certonly --manual --preferred-challenges dns -d exemplo.com.br -d '*.exemplo.com.br'

O Let's Encrypt aconselha limpar registros TXT antigos desse nome, porque respostas grandes demais são recusadas.

Renovação: modo manual x plugin

Pela FAQ do Let's Encrypt, os certificados padrão valem 90 dias, e a recomendação é renovar a cada 60 dias.

A documentação do Certbot diz que certificados criados com --manual não têm renovação automática, a menos que se use um script de autenticação, a opção --manual-auth-hook. Sem esse script, o comando não pode ser automatizado num agendamento. Com um plugin de DNS, a renovação usa o mesmo plugin e as mesmas opções da emissão, guardados em /etc/letsencrypt/renewal/, a menos que você indique outros.

O comando certbot renew tenta renovar os certificados que já estão prontos para isso. Para testar se as próximas renovações vão dar certo, o Certbot oferece o --dry-run. Um exemplo de comando:

sudo certbot renew --dry-run

Para ver se a renovação está agendada, a documentação manda procurar certbot renew no crontab do sistema ou nos timers do systemd, com systemctl list-timers.

Para rodar algo só depois de uma renovação bem-sucedida, existe a opção --deploy-hook, que executa um comando uma vez para cada certificado emitido, inclusive nas renovações. Como exemplo, o comando do hook pode ser o que recarrega o seu servidor web; recomendamos conferir depois se o servidor passou a usar o certificado novo.

Onde ficam os arquivos

Segundo a documentação do Certbot, as chaves e os certificados ficam em /etc/letsencrypt/live/ seguido do nome do certificado. O fullchain.pem reúne os certificados, incluindo o do servidor, e o privkey.pem é a chave privada.

No servidor web, o certificado e a chave são indicados por esse par de arquivos. Depois de ativar o certificado no servidor web, recomendamos abrir cada subdomínio e ver se alguma imagem ou script ainda carrega por HTTP, problema explicado em Conteúdo misto: o que é e como corrigir no site.

Resumo do certificado wildcard

  • Cobertura: um nível de subdomínio; o domínio raiz entra como nome à parte.
  • Validação: no Let's Encrypt, só pelo DNS-01, com registro TXT em _acme-challenge.
  • Com plugin de DNS: emissão e renovação pelo Certbot, com token de escopo restrito.
  • Modo manual: sem renovação automática, a menos que haja um script de autenticação.
  • Depois: certbot renew --dry-run para testar a renovação.

Cuidados com a credencial do DNS

A página de tipos de desafio do Let's Encrypt alerta que colocar as credenciais completas da API do DNS no servidor web aumenta muito o estrago se o servidor for invadido. Ela recomenda credenciais com escopo mais restrito ou fazer a validação a partir de outro servidor. A documentação do plugin da Cloudflare pede para proteger o token como a senha da conta.

Recomendamos um token só com permissão de DNS das zonas necessárias, quando o provedor permitir, o arquivo de credenciais com permissão restrita e a revogação do token que deixar de ser usado. Como o mesmo certificado e a mesma chave privada servem vários subdomínios, recomendamos também guardar o privkey.pem com o mesmo cuidado em cada servidor para onde ele for copiado.

Uma lista dos nomes em uso

Recomendamos manter num arquivo de texto os subdomínios ativos e a data de cada emissão, para comparar quando um nome novo for criado.

Antes dos subdomínios existe o domínio principal, e o registro dele pode ser feito na Eleven Host, em centenas de extensões. Buscar domínio

Perguntas frequentes

O certificado wildcard cobre o domínio raiz?

Não. Pela regra da RFC 9525, o asterisco corresponde a um único rótulo, e o domínio raiz não tem rótulo nesse lugar. Por isso recomendamos incluir o raiz como segundo nome no mesmo pedido.

Dá para emitir wildcard no Let's Encrypt pelo HTTP-01?

Não. A FAQ do Let's Encrypt diz que a emissão de wildcard tem de usar o desafio DNS-01, e a página de tipos de desafio confirma que o HTTP-01 não emite certificados wildcard.

O certificado wildcard renova sozinho?

Com um plugin de DNS, o Certbot renova usando o mesmo plugin e as mesmas opções da emissão, desde que o comando certbot renew seja executado. No modo manual, pela documentação, não há renovação automática sem um script de autenticação.

Esta resposta lhe foi útil?

Artigos Relacionados