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アドレスとポート番号を見つけます。アプリケーション名として［カスタム］を選択します。

  5. ［クライアントコマンドのパス］フィールドに、サードパーティーACMEクライアントを起動するシェルスクリプトの完全なディレクトリパスを入力します。

    以下はその例です。

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

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

  6. ［クライアントコマンドの引数］フィールドで、使用する汎用引数を指定します。

    以下はその例です。

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

    以下に注意してください。

    • 各引数は、ここに記載されているとおり正確に入力する必要があります。

    • 引数の順序は、シェルスクリプトで使用される順序と一致する必要があります。

    • 自動化イベント中、選択された自動化プロファイルから、これらの引数に必須な値が自動的に取得されます。

    以下は、CertCentralのマネージド自動化でサポートされるACME引数の説明です。

    • {acmeDirectoryUrl} – ACMEディレクトリURL設定。

    • {hosts} – 証明書ホストの詳細。

    • {email} – 通知用のEメールアドレス。

    • {key} – 鍵のアルゴリズム（RSAまたはECC）。

    • {extActKid} – URLで使用される外部アカウントの鍵識別子。

    • {extActHmac} – 応答に署名するためのHMAC鍵。

  7. ［保存する］を選択して、更新された自動化設定を有効にします。

次のステップ

カスタムアプリケーションのセットアップ後は、他のマネージドアプリケーションと同じ方法でその証明書自動化を管理することができます。

このセクションの内容: