Documentação do Automate Certificates
Emitir e renovar certificados
O Automate Certificates pede certificados à Let's Encrypt através de ACME v2. Esta página acompanha um certificado desde o pedido até à renovação.
Pedir um certificado
- Confirme que existe uma conta ACME registada em Settings.
- Na página Certificates, peça um certificado e introduza um ou mais nomes de domínio.
- Escolha o tipo de chave:
ECDSA-P256(a predefinida),ECDSA-P384,RSA-2048ouRSA-4096. - Escolha o tipo de desafio:
dns-01(o predefinido) ouhttp-01.
Um nome com caráter universal, como *.example.com, só pode ser validado com DNS-01. Para manter a sua própria chave privada, envie um pedido de assinatura de certificado PEM através da API; os domínios do pedido têm de corresponder.
Desafios DNS-01
Com DNS-01, o certificado permanece no estado issuing e a página mostra os registos TXT a publicar. Publique-os no prazo de 24 horas. Os registos são verificados de 5 em 5 minutos e a emissão conclui-se automaticamente quando ficarem visíveis. A aplicação web não escreve registos DNS por si. A resolução automática através da API da Cloudflare existe apenas na API e exige credenciais da Cloudflare; sem elas, a chamada devolve um erro com uma sugestão.
Desafios HTTP-01
Com HTTP-01, a própria aplicação serve a resposta ao desafio, e uma renovação HTTP-01 não exige qualquer ação da sua parte.
Renovação
- Uma tarefa agendada inicia cada renovação 30 dias antes da expiração.
- Uma renovação HTTP-01 conclui-se automaticamente.
- Uma renovação DNS-01 exige novos registos TXT de cada vez. Os administradores do espaço de trabalho recebem-nos por e-mail e na página Alerts, e é enviado um evento de webhook.
- Uma renovação falhada é repetida uma vez por dia. Cada falha gera um alerta e um evento de webhook com o respetivo motivo, e fica registada no registo de auditoria.
Implementar um certificado renovado
Implemente manualmente com Deploy na página Certificates. Para implementar automaticamente cada renovação, crie uma regra ou um agendamento através da API (POST /v1/automation/rules). Cada execução aparece em Deployments.
Importar, revogar e exportar
Pode importar um certificado existente, revogá-lo na CA e exportar um certificado em PEM ou PFX. A exportação de uma chave privada exige um administrador e fica registada no registo de auditoria.