Como configurar o cliente ACME no servidor web Nginx no Linux
Para iniciar a configuração é necessário que o seu certificado SSL já esteja emitido e que o cliente ACME DigiCert já esteja instalado no seu servidor.
Caso ainda não tenha instalado o cliente ACME, siga as instruções em:
Como utilizar a automação de certificados SSL/TLS ACME
Para iniciar a configuração, primeiro copie as credenciais ACME obtidas no Portal no Cliente (https://cp.activeweb.com.br):
- Entre no pedido de certificado SSL que deseja automatizar;
- Clique no botão Credenciais ACME;
- Clique em Gerar/Atualizar credenciais ACME;
- Copie as informações EAB KEY, EAB HMAC e DIRECTORY URL;
Crie um arquivo de configuração em /var/digicert/acme-client/config/ , por exemplo dc-acme-seusite.toml, com o seguinte conteúdo:
# Basic ACME settings
directory_url = ""
eab_key = ""
eab_hmac = ""
email = ""
# Certificate defaults
[certificate]
key_type = "RSA"
key_size = 2048
# Challenge preferences
[challenge]
type = "http-01"
handler_name = "nginx"
# Installer preferences
[installer]
handler_name = "nginx"
handler_args = "identifier=seusite.com.br"
# Service settings
[service]
log_level = "info"
auto_renew = true
auto_ari_renew = false
auto_renew_days = 10
Guia de configuração do arquivo .toml
Deve ser criado um arquivo de configuração para cada pedido de certificado SSL. Cada certificado SSL possui suas próprias credenciais ACME.
# Basic ACME settings
Em directory_url , eab_key e eab_hmac informe, dentro das aspas duplas, os respectivos valores obtidos nas credencias ACME do Portal do Cliente.
Em email informe o seu e-mail de cadastro ou qualquer outro e-mail que utilize.
# Certificate defaults
Não é necessário alterar os valores.
# Challenge preferences
Aqui é configurado a forma de validação do seu certificado SSL. Sempre que um certificado é emitido, reemitido ou renovado, é necessário passar pelo processo de validação.
Para que a automação do certificado SSL seja possível, é necessário executar o processo de validação novamente no seu servidor, através do cliente ACME.
Em type informe http-01 ou dns-01
Em handler_name informe nginx .
Para os certificados SSL de validação empresarial OV e EV, como a empresa já está validada, o cliente ACME executa de forma 100% automatizada a validação de propriedade do domínio (DV) utilizando o método http-01 ou dns-01. A validação da empresa OV e EV tem validade, consulte nossa equipe para saber quando é necessário renovar a validação da sua empresa.
# Installer preferences
Para que o cliente ACME faça a instalação automática do certificado SSL no servidor Nginx, dentro da configuração correta:
- em
handler_nameinformenginx. - em
handler_argsinforme o domínio (FQDN) configurado no Nginx, da seguinte forma, por exemplo:handler_args = "identifier=seusite.com.br"
# Service settings
Em auto_renew_days configure o número de dias, antes do vencimento do certificado SSL, que o cliente ACME fará a renovação e instalação automática no seu servidor.
Para os certificados SSL do tipo OV e EV, basta manter ativa a validação da sua empresa com a certificadora, para emitir automaticamente o certificado SSL apenas com a validação do domínio.
Executando o cliente ACME
Após a criação do arquivo de configuração .toml, execute o comando abaixo para ativar o cliente ACME no seu servidor.
Exemplo para um certificado SSL que não seja do tipo Multi Domínio ou WildCard (para ativar a opção com www):
dc-acme request enroll \
--config /var/digicert/acme-client/config/dc-acme-seusite.toml \
--cn "seusite.com.br" \
--sans "www.seusite.com.br"
Caso não necessite o certificado SSL com a opção com www, o parâmetro --sans não é necessário.
O parâmetro --cn deve indicar o endereço principal (Common Name) do certificado SSL.
Para um certificado SSL do tipo Multi Domínio, informe todos os endereços adicionais SANs utilizando o parâmetro --sans, por exemplo:
dc-acme request enroll \
--config /var/digicert/acme-client/config/dc-acme-seusite.toml \
--cn "seusite.com.br" \
--sans "www.seusite.com.br,mail.seusite.com.br,sistema.seusite.com.br"
Para um certificado SSL do tipo WildCard, inclua também o domínio raiz utilizando o parâmetro --sans, por exemplo:
dc-acme request enroll \
--config /var/digicert/acme-client/config/dc-acme-seusite.toml \
--cn "*.seusite.com.br" \
--sans "seusite.com.br"
Após executar o cliente ACME, caso não apareça nenhum erro, serão mostrado as mensagens abaixo, indicando que a configuração, emissão e instalação do certificado SSL foram concluídas com sucesso no seu servidor:
Validating handlers with server...
Handler validation successful
Initiating certificate enrollment (this may take a few minutes)...
Certificate enrollment successful. Request ID: 1
Concluído com sucesso a configuração e execução do cliente ACME, antes do vencimento do certificado SSL o cliente ACME vai validar, emitir e instalar um novo certificado SSL automaticamente no seu servidor, até a validade do plano contratado.
Atualizado em: 28/10/2026
Obrigado!
