Establecer una aplicación personalizada para la automatización administrada

La automatización administrada de CertCentral admite las aplicaciones de servidor web más populares de manera diferente.

CertCentral también ofrece la flexibilidad de extender la administración de certificados para aplicaciones adicionales no admitidas de manera nativa al permitir la configuración de clientes ACME de terceros a través de la opción "personalizar aplicación".

Para habilitar la automatización administrada para una aplicación personalizada, siga estos pasos:

Deploy DigiCert agent
Install and configure a DigiCert agent on the server system. The agent coordinates automation requests sent from Trust Lifecycle Manager.
Configurar un cliente ACME de terceros
En el host del certificado, instale y configure su cliente ACME de terceros preferido.
Crear un script shell
En el host del certificado, cree un script de ayuda que CertCentral pueda usar para invocar un cliente ACME de terceros.
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.
Realizar la configuración de la automatización administrada
En CertCentral, use el menú Administrar automatización para configurar el script shell para usar con la aplicación personalizada.

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 un cliente ACME de terceros

La automatización administrada de CertCentral funciona con cualquier cliente externo que admita el protocolo ACME estándar del sector.

Siga las pautas del proveedor para instalar y configurar su cliente ACME de terceros preferido en el host del certificado.

Crear un script shell

CertCentral requiere un script shell en el host del certificado para invocar el cliente ACME de terceros. Durante un evento de automatización, el agente de DigiCert llama al script shell para invocar al cliente, que, a su vez, procura e instala el certificado.

El script shell debe incluir los comandos de automatización básicos para el cliente ACME de terceros. La sintaxis de comando variará según el cliente ACME de terceros que se use. Verifique las pautas del proveedor del software para obtener más información.

A continuación, hay ejemplos de scripts shell usados para adquirir certificados de DigiCert a través de clientes externos como Certbot EFF (Linux) y Win-ACME (Windows):

ejemplo 1. Certbot EFF (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

ejemplo 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%

Las definiciones variables en la parte superior de estos scripts shell se leen en los argumentos ACME requeridos:

Esto debe coincidir con los argumentos ACME que usted configura para la aplicación personalizada en CertCentral.
Durante un evento de automatización, los valores para estos argumentos los proporciona el agente de automatización de DigiCert que llama al script shell.

Comandos usados en el script shell:

Debe incluir todos los parámetros obligatorios.
No debe superar los 512 caracteres.
No debe incluir directivas especiales como rm -rf o rmdir

El nombre del archivo script shell:

Debe terminar con .bat o .sh
No debe superar los 255 caracteres.

Realizar la configuración de la automatización administrada

Use el menú Administrar automatización de CertCentral para completar la configuración para su aplicación personalizada:

En la cuenta de CertCentral, en el menú principal izquierdo, vaya a Automatización > Administrar automatización.
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.
  Aviso
  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 ejemplo:
  {acmeDirectoryUrl} {hosts} {email} {key} {extActKid} {extActHmac}
  Tenga en cuenta lo siguiente:
  - Cada argumento se debe ingresar exactamente como se muestra aquí.
  - El orden de los argumentos debe coincidir con cómo se usan en su script shell.
  - Durante un evento de automatización, los valores requeridos para estos argumentos se obtienen automáticamente desde el perfil de automatización seleccionado.
  Explicación de los argumentos ACME admitidos por la automatización administrada de CertCentral:
  - {acmeDirectoryUrl}: configuración de URL de directorio ACME.
  - {hosts}: detalles del host del certificado.
  - {email}: dirección de correo electrónico para notificaciones.
  - {key}: algoritmo de la clave (RSA o ECC).
  - {extActKid}: identificador clave de cuenta externa usado en la URL.
  - {extActHmac}: clave HMAC para firmar la respuesta.
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.
Desde la vista Administrar automatización, seleccione el Nombre del agente ACME local que se ejecuta en el mismo host de certificado como la aplicación personalizada.

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.

En esta sección: