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

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

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

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

Deploy DigiCert agent
Install and configure a DigiCert agent on the server system. The agent coordinates automation requests sent from Trust Lifecycle Manager.
타사 ACME 클라이언트 설정
인증서 호스트에서 선호하는 타사 ACME 클라이언트를 설치하고 구성합니다.
셸 스크립트 생성
인증서 호스트에서 CertCentral이 타사 ACME 클라이언트를 호출할 때 사용할 수 있는 도우미 스크립트를 만듭니다.
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.
관리형 자동화 설정 구성
CertCentral에서 자동화 관리 메뉴를 사용하여 사용자 지정 애플리케이션과 함께 사용할 셸 스크립트를 구성합니다.

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.

타사 ACME 클라이언트 설정

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

소프트웨어 공급자의 지침에 따라 인증서 호스트에 선호하는 타사 ACME 클라이언트를 설치하여 구성합니다.

셸 스크립트 생성

CertCentral은 타사 ACME 클라이언트를 호출하기 위해 인증서 호스트의 셸 스크립트가 필요합니다. 자동화 이벤트 동안 DigiCert 에이전트는 셸 스크립트를 호출하여 클라이언트를 호출하고 클라이언트는 차례로 인증서를 받아 설치합니다.

셸 스크립트에는 타사 ACME 클라이언트에 대한 기본 자동화 명령이 포함되어야 합니다. 명령 구문은 사용되는 타사 ACME 클라이언트에 따라 다릅니다. 자세한 내용은 소프트웨어 제공사의 지침을 확인하십시오.

다음은 타사 클라이언트 EFF Certbot(Linux) 및 Win-ACME(Windows)를 통해 DigiCert 인증서를 받을 때 사용되는 셸 스크립트의 예입니다.

예 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

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

이러한 셸 스크립트의 맨 위에 있는 변수 정의는 필수 ACME 인수에 나타납니다.

이는 CertCentral에서 사용자 지정 애플리케이션에 대해 구성한 ACME 인수와 일치해야 합니다.
자동화 이벤트 동안 이들 인수에 대한 값은 셸 스크립트를 호출하는 로컬 DigiCert 자동화 에이전트에서 제공합니다.

셸 스크립트에서 사용되는 명령:

모든 필수 매개 변수를 포함해야 합니다.
512자 이하이어야 합니다.
rm -rf 또는 rmdir 같은 특수 지시문이 포함되어서 안 됩니다.

셸 스크립트 파일 이름:

.bat 또는 .sh로 끝나야 합니다.
255자 이하이어야 합니다.

관리형 자동화 설정 구성

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

CertCentral 계정의 왼쪽 메인 메뉴에서 자동화 > 자동화 관리로 이동합니다.
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.
  주의
  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.
  예:
  {acmeDirectoryUrl} {hosts} {email} {key} {extActKid} {extActHmac}
  유의 사항:
  - 각 인수는 여기에 표시된 대로 정확하게 입력해야 합니다.
  - 인수의 순서는 셸 스크립트에서 사용되는 방식과 일치해야 합니다.
  - 자동화 이벤트 중에 이러한 인수에 필요한 값은 선택한 자동화 프로필에서 자동으로 가져옵니다.
  CertCentral 관리형 자동화에서 지원하는 ACME 인수에 대한 설명:
  - {acmeDirectoryUrl} – ACME 디렉터리 URL 설정.
  - {hosts} – 인증서 호스트 세부 정보.
  - {email} – 알림용 이메일 주소.
  - {key} – 키 알고리즘(RSA 또는 ECC).
  - {extActKid} – URL에 사용되는 외부 계정 키 식별자.
  - {extActHmac} – 응답 서명을 위한 HMAC 키.
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.
자동화 관리 보기에서 사용자 지정 애플리케이션과 동일한 인증서 호스트에서 실행 중인 로컬 ACME 에이전트의 이름을 선택합니다.

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.

이 섹션의 내용: