Configurar um aplicativo personalizado para automação gerenciada

A automação gerenciada da CertCentral oferece suporte aos aplicativos de servidor da Web mais populares prontos para uso.

O CertCentral também oferece a flexibilidade de estender o gerenciamento de certificados para aplicativos adicionais não suportados nativamente, permitindo a configuração de clientes ACME de terceiros por meio da opção "aplicativo personalizado".

Para habilitar a automação gerenciada para um aplicativo personalizado, siga estas etapas:

Deploy DigiCert agent
Install and configure a DigiCert agent on the server system. The agent coordinates automation requests sent from Trust Lifecycle Manager.
Configurar cliente ACME de terceiros
No host do certificado, instale e configure seu cliente ACME de terceiros preferido.
Criar script de shell
No host do certificado, crie um script auxiliar que o CertCentral possa usar para invocar o cliente ACME de terceiros.
Add script details in Trust Lifecycle Manager
Configure the shell script details in Trust Lifecycle Manager so it knows how to find and execute the custom automation script.
Definir as configurações de automação gerenciada
No CertCentral, use o menu Gerenciar automação para configurar o script de shell a ser usado com o aplicativo personalizado.

Deploy DigiCert agent

Custom automations require that a DigiCert agent be installed and running on each server. The agent coordinates automation requests received from Trust Lifecycle Manager and calls your custom shell script to handle certificate lifecycle events for the custom application.

For detailed instructions about setting up a DigiCert agent, see Deploy and manage agents.

Configurar cliente ACME de terceiros

A automação gerenciada do CertCentral funciona com qualquer cliente de terceiros que suporte o protocolo ACME padrão do setor.

Siga as diretrizes do provedor de software para instalar e configurar seu cliente ACME de terceiros preferido no host do certificado.

Criar script de shell

O CertCentral requer um script de shell no host do certificado para invocar o cliente ACME de terceiros. Durante um evento de automação, o agente DigiCert chama o script de shell para invocar o cliente, que por sua vez adquire e instala o certificado.

O script de shell deve conter os comandos básicos de automação para o cliente ACME de terceiros. A sintaxe do comando irá variar dependendo de qual cliente ACME de terceiros é usado. Verifique as diretrizes do fornecedor do software para saber mais.

Abaixo estão exemplos de scripts de shell usados para adquirir certificados DigiCert por meio de clientes de terceiros EFF Certbot (Linux) e Win-ACME (Windows):

exemplo 1. EFF Certbot (Linux)

directoryuri=$1
host=$2
emailaddress=$3
eabkeyidentifier=$5
eabkeyhmac=$6
process_path=/usr/bin/apachectl
server_root=/etc/httpd
config_root=/etc/httpd/config
procCmdLine="/usr/bin/apachectl start"
acmeConfigDirectory="/etc/letsencrypt/"
certbot --server $directoryuri --config-dir $acmeConfigDirectory --eab-kid $eabkeyidentifier  --eab-hmac-key $eabkeyhmac --installer apache -m $emailaddress --force-renew --agree-tos --no-redirect --expand -d $host --no-verify-ssl --no-autorenew --pre-hook "$process_path stop" --post-hook $procCmdLine -n --apache-server-root $server_root --apache-vhost-root $config_root
returnCode=$?
echo "The command exit status : ${returnCode}"
exit $returnCode

exemplo 2. Win-ACME (Windows)

set SERVERURL=%1
set SANS=%2
set EMAIL=%3
set KEYALGO=%4
set EABKEY=%5
set EABHMAC=%6
set VALIDATIONMODE=--validation selfhosting
"wacs.exe" --baseuri %SERVERURL% --eab-key-identifier=%EABKEY% --eab-key=%EABHMAC% --target manual --host %SANS% --emailaddress %EMAIL% --force --accepttos --notaskscheduler %VALIDATIONMODE% --csr %KEYALGO% --store centralssl --centralsslstore  ./certs
set returnCode=%errorlevel%
EXIT /B %returnCode%

As definições de variáveis na parte superior desses scripts de shell são lidas nos argumentos ACME necessários:

Eles devem corresponder aos argumentos ACME que você configura para o aplicativo personalizado no CertCentral.
Durante um evento de automação, os valores para esses argumentos são fornecidos pelo agente de automação local da DigiCert que chama o script de shell.

Comandos usados no shell script:

Deve incluir todos os parâmetros obrigatórios.
Não deve exceder 512 caracteres.
Não deve incluir diretivas especiais como rm -rf ou rmdir

O nome do arquivo do script de shell:

Deve terminar com .bat ou .sh
Não deve exceder 255 caracteres.

Definir as configurações de automação gerenciada

Use o menu Gerenciar automação do CertCentral para concluir a configuração do seu aplicativo personalizado:

Na sua conta CertCentral, no menu principal à esquerda, vá para Automação > Gerenciar automação.
From the More actions dropdown at top, select Add script.
Fill out the Add script form:
1. Name: Enter a user-friendly name to use when referencing the script.
2. Operating system: Select the applicable operating system (Linux or Windows).
3. Script type: Select Custom automation.
4. Script filename: Enter the script's filename in or path relative to the local agent's packages sub-directory. The filename must start with ./ (Linux) or .\ (Windows) and cannot have any spaces in it. For example:
  - Linux: If your script is named "myscript.sh" and is stored directly in the agent's packages sub-directory, enter ./myscript.sh here. If you stored the script within an additional sub-directory called "custom-apps" in the packages sub-directory, enter ./custom-apps/myscript.sh instead.
  - Windows: If your script is named "myscript.bat" and is stored directly in the agent's packages folder, enter .\myscript.bat here. If you stored the script within an additional sub-folder called "custom-apps" in the packages folder, enter .\custom-apps\myscript.bat instead.
  Atenção
  Make sure there are no spaces in the filename for either Linux or Windows. The script will fail if the path or filename has spaces in it.
5. Command-line arguments: Enter a space-separated list of general ACME parameters to use with your custom automation script.
  Por exemplo:
  {acmeDirectoryUrl} {hosts} {email} {key} {extActKid} {extActHmac}
  Observe que:
  - Cada argumento deve ser inserido exatamente como mostrado aqui.
  - A ordem dos argumentos deve corresponder à forma como eles são usados em seu script de shell.
  - Durante um evento de automação, os valores necessários para esses argumentos são obtidos automaticamente do perfil de automação selecionado.
  Explicação dos argumentos ACME suportados pela automação gerenciada do CertCentral:
  - {acmeDirectoryUrl} – configurações de URL do diretório ACME.
  - {hosts} – Detalhes do host do certificado.
  - {email} – Endereço de e-mail para notificações.
  - {key} – Algoritmo de chave (RSA ou ECC).
  - {extActKid} – Identificador de chave de conta externa usado na URL.
  - {extActHmac} – Chave HMAC para assinar a resposta.
6. Description (optional): Enter an optional description for the script to help identify it when working with DigiCert agents and agent-based automations in Trust Lifecycle Manager.
Na exibição Gerenciar automação, selecione o Nome do agente ACME local em execução no mesmo host de certificado que o aplicativo personalizado.

Assign script to the applicable agent IP/port targets

To complete the custom automation configuration, assign the script to any DigiCert agents that will coordinate certificate lifecycle automation events for the custom application:

From the Trust Lifecycle Manager main menu, select Integrations > Agents.
Locate the local DigiCert agents on the systems where the custom application is running. Select each agent by name to view the details for it.
Select the pencil (edit) icon on the right of the agent details page to update the agent configuration.
In the IP/port targets section for the agent, locate any IP/port targets where the custom application is running and configure them as follows:
- Application: Select Custom.
- Custom automation script: Select the custom automation script by the name assigned to it in Trust Lifecycle Manager.
Select the Update button at bottom to save your changes.

What's next

After enabling managed automation for your custom application, you can schedule certificate lifeycle automation events for it as you would any other application in Trust Lifecycle Manager.

Nesta secção: