Skip to main content

관리형 자동화를 위한 사용자 지정 애플리케이션 설정

CertCentral 관리형 자동화는 가장 널리 사용되는 웹 서버 애플리케이션을 즉시 지원합니다.

CertCentral은 또한 "사용자 지정 애플리케이션" 옵션을 통해 타사 ACME 클라이언트 구성을 허용하여 기본적으로 지원되지 않는 추가 애플리케이션에 대한 인증서 관리를 확장하도록 유연성을 제공합니다.

사용자 지정 애플리케이션에 대해 관리형 자동화를 사용하려면 다음 단계를 따르세요.

Step 1: Install DigiCert agent

Custom automations require an active DigiCert agent on the server. The agent coordinates automation requests received from CertCentral and calls your custom shell script to handle certificate lifecycle events for the custom application.

For detailed instructions about how to deploy DigiCert agents on your servers, see ACME 자동화 에이전트 설치 및 활성화.

타사 ACME 클라이언트 설정

In addition to a DigiCert agent, the server must have a third-party ACME client installed. Your custom automation script invokes the ACME client to request certificates from CertCentral and install them for your custom Linux or Windows application.

CertCentral 관리형 자동화는 업계 표준 ACME 프로토콜을 지원하는 모든 타사 클라이언트와 함께 작동합니다.

Step 3: Create shell script

You need a shell script to drive the third-party ACME client on your server. During an automation event, the DigiCert agent calls this shell script to invoke the ACME client, which then requests the certificate from CertCentral and installs it for your custom application.

The shell script contains the ACME client command to request and install certificates for your custom application using the parameters expected by the CertCentral ACME service. Command syntax varies based on which third-party ACME client you use. Check the software provider's guidelines for more information.

Below are examples of shell scripts to enable CertCentral managed automation for a custom application via third-party ACME clients Certbot (Linux) and Win-ACME (Windows):

예 1. 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

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

Variable definitions at the top of these shell scripts set the required ACME request parameters:

  • These must match up with the ACME arguments you configure for the custom application in CertCentral.

  • During an automation event, values for these arguments are supplied to the shell script by the local DigiCert agent that calls it.

Commands used in the shell script:

  • Must include all mandatory parameters.

  • Must not exceed 512 characters.

  • Must not include special directives like rm -rf or rmdir

The shell script filename:

  • Must end with .bat or .sh

  • Must not exceed 255 characters.

관리형 자동화 설정 구성

CertCentral 자동화 관리 메뉴를 사용하여 사용자 지정 애플리케이션에 대한 구성을 완료합니다.

  1. CertCentral 계정의 왼쪽 메인 메뉴에서 자동화 > 자동화 관리로 이동합니다.

  2. 자동화 관리 보기에서 사용자 지정 애플리케이션과 동일한 인증서 호스트에서 실행 중인 로컬 ACME 에이전트의 이름을 선택합니다.

  3. 오른쪽의 에이전트 구성 패널에서 IP/포트 구성 섹션으로 이동합니다.

  4. 사용자 지정 애플리케이션의 IP 주소와 포트 번호를 찾습니다. 애플리케이션 이름으로 사용자 지정(Custom)을 선택합니다.

  5. 클라이언트 명령 경로 필드에 타사 ACME 클라이언트를 호출할 셸 스크립트의 전체 디렉터리 경로를 제공합니다.

    예:

    • Windows: G:\certcentral\agent\custom_automation_1.bat

    • Linux: /home/certcentral/agent/custom_automation_1.sh

  6. 클라이언트 명령 인수 필드에서 사용할 일반 ACME 인수를 지정합니다.

    예:

    {acmeDirectoryUrl} {hosts} {email} {key} {extActKid} {extActHmac}

    유의 사항:

    • 각 인수는 여기에 표시된 대로 정확하게 입력해야 합니다.

    • 인수의 순서는 셸 스크립트에서 사용되는 방식과 일치해야 합니다.

    • 자동화 이벤트 중에 이러한 인수에 필요한 값은 선택한 자동화 프로필에서 자동으로 가져옵니다.

    CertCentral 관리형 자동화에서 지원하는 ACME 인수에 대한 설명:

    • {acmeDirectoryUrl} – ACME 디렉터리 URL 설정.

    • {hosts} – 인증서 호스트 세부 정보.

    • {email} – 알림용 이메일 주소.

    • {key} – 키 알고리즘(RSA 또는 ECC).

    • {extActKid} – URL에 사용되는 외부 계정 키 식별자.

    • {extActHmac} – 응답 서명을 위한 HMAC 키.

  7. 저장을 선택하여 업데이트된 자동화 설정을 적용합니다.

다음 단계

사용자 지정 애플리케이션을 설정한 후 다른 관리 대상 애플리케이션과 동일한 방식으로 해당 애플리케이션에 대한 인증서 자동화를 관리할 수 있습니다.

이 섹션의 내용: