Certificado SSL wildcard: o que é e como emitir
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

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.brewww.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-runpara 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.