Rocky Linux 10 講座 / HTTPS証明書を発行・更新・配備し、有効期限を監視する
Rocky Linux 10 で HTTPS を運用するには、証明書を発行するだけでなく、Web サーバーに適用し、自動更新を実行し、実際に提供される証明書と有効期限を監視する必要があります。このチュートリアルでは、別のテスト証明書機関を使って実際の ACME 発行と更新を再現し、DNS、ポート、パブリックサービスに適用する際に必要な信頼条件を区別します。
公開証明書とローカルテスト証明書の違い
HTTPSはTLS(Transport Layer Security)を使用してHTTP通信を保護します。認証局(Certificate Authority、CA)は、サイト名と公開鍵を結びつける証明書に署名し、クライアントは名前、有効期間、発行チェーンを確認します。ACME(Automated Certificate Management Environment)は、ドメインの管理権限の確認や証明書の発行・更新を自動化するプロトコルであり、Certbotはこれらの操作を行うクライアントです。
Let’s Encryptのチャレンジに関する公式説明 で説明されているように、パブリック HTTP-01 検証はポート 80 で認証ファイルをリクエストします。ドメインで使用される A・AAAA レコード、外部ファイアウォールおよびポートフォワーディング、そして実際のウェブサーバーパスはすべて正しく設定されている必要があります。自分の hosts ファイルを変更したり、Certbot のリッスンポートを他の番号に変更したりするだけでは、パブリック認証局の接続条件は変更されません。DNS-01 は DNS TXT レコードを通じて検証され、自動更新のためには DNS プロバイダの自動化方法が必要です。
| 環境 | 検証の範囲と信頼性 |
|---|---|
| この Pebble の実習 | VM内では、実際にテスト名とHTTP-01を検証します。これはプライベートテストCAであり、ブラウザによって一般的に信頼されるものではありません。 |
| Let’s Encrypt ステージング | パブリックDNSおよびアクセス条件でのテスト用に発行されます。テスト証明書は一般的に信頼される証明書ではありません。 |
| 本番認証局 | 実際のパブリックドメインおよびポリシー要件を満たすために発行されます。クライアントの信頼、名前、チェーン、および外部アクセスは個別に検証されます。 |
Let’s Encrypt ステージングガイド 本番発行の前にテストを行うことを推奨しており、開発用のローカルACMEサーバとしてPebbleを紹介しています。この演習は、パブリックドメインでのステージングまたは本番発行を用いた検証結果を反映するものではありません。
ツールとローカルACMEテスト環境の準備
別の Rocky Linux 10 仮想マシンで進めてください。元の検証環境環境は Rocky Linux 10.2、Python 3.12.15、Certbot 5.10.0、Pebble 2.10.3、Nginx 1.26.3、OpenSSL 3.5.8、SELinux Enforcing でした。以下の Pebble 配布ファイルは x86_64 用です。他の CPU アーキテクチャの場合は、対応する公式配布ファイルとチェックサムを選択してください。同じ名前の既存サイト、証明書、または練習用ファイルがあるサーバでそのまま実行しないでください。
この環境でのEPEL Certbotパッケージは、いくつかの依存関係がRocky 10.2のリポジトリと一致しないためインストールされませんでした。システムパッケージを強制的に置き換えることなく、Certbotは専用のPython仮想環境にインストールされました。 Certbotのインストールドキュメントでは pip方式は仮想環境を使用する限定的なサポート方式であることが確認できます。本番環境ではインストール方式と更新の管理方法を併せて決め、複数方式のCertbotを混在させないでください。
sudo dnf install python3 tar openssl nginx policycoreutils-python-utils
sudo ss -lntp
sudo bash <<'ROOT'
set -euo pipefail
test ! -e /root/lf-course26
test ! -e /usr/local/bin/lf-course26-pebble
for path in /etc/pki/tls/lf-course26 /etc/nginx/conf.d/lf-course26.conf /usr/local/sbin/lf-course26-deploy /usr/local/sbin/lf-course26-renew /etc/systemd/system/lf-course26-renew.service /etc/systemd/system/lf-course26-renew.timer; do
test ! -e "$path"
done
for port in 14000 15000 5001 5002 18426; do
listeners=$(ss -H -lnt "sport = :$port")
test -z "$listeners"
done
if grep -Eq '(^|[[:space:]])course26[.]test([[:space:]]|$)' /etc/hosts; then
printf 'The test hostname already exists in hosts. Stop.\n' >&2
exit 1
fi
install -d -m 0700 /root/lf-course26
cp -a /etc/hosts /root/lf-course26/hosts.before
cp -a /etc/nginx /root/lf-course26/nginx.before
python3 -m venv /root/lf-course26/venv
/root/lf-course26/venv/bin/python -m pip install 'certbot==5.10.0'
cd /root/lf-course26
curl -fL -o pebble.tar.gz https://github.com/letsencrypt/pebble/releases/download/v2.10.3/pebble-linux-amd64.tar.gz
printf '7e33cf3e426b67e9e647c44e8cc91683caa8ab331f7a99e5e27fcee291c4c7e2 pebble.tar.gz\n' | sha256sum -c -
tar -xzf pebble.tar.gz --strip-components=3
install -m 0755 pebble /usr/local/bin/lf-course26-pebble
restorecon /usr/local/bin/lf-course26-pebble
openssl req -x509 -newkey rsa:2048 -noenc -keyout api.key -out api.pem -days 2 -subj /CN=localhost -addext 'subjectAltName=DNS:localhost,IP:127.0.0.1'
chmod 0600 api.key
printf '\n127.0.0.1 course26.test # lf-course26\n' >> /etc/hosts
ROOT
実行前に、ポート14000、15000、5001、5002、18426が使用されていないこと、またcourse26.testが既存のホストエントリに含まれていないことを確認してください。内部のsudo bashは管理者権限で実行され、エラーが発生した場合は後続のコマンドが停止されます。配布アーカイブのSHA-256の期待値は、公式リリース情報と比較する必要があります。ハッシュ値が異なる場合は実行しないでください。
次の内容をsudoedit /root/lf-course26/pebble.jsonとして保存してください。APIアクセス証明書api.pemおよびその後のサイトに発行される証明書はそれぞれ異なります。両方のAPIはループバックアドレス上でのみ接続を受け入れ、システム全体のCAストアを変更することはありません。
{
"pebble": {
"listenAddress": "127.0.0.1:14000",
"managementListenAddress": "127.0.0.1:15000",
"certificate": "/root/lf-course26/api.pem",
"privateKey": "/root/lf-course26/api.key",
"httpPort": 5002,
"tlsPort": 5001,
"keyAlgorithm": "ecdsa",
"profiles": {
"default": {
"description": "Local course26 test",
"validityPeriod": 7776000
}
}
}
}
sudo systemd-run --unit=lf-course26-pebble --property=WorkingDirectory=/root/lf-course26 --setenv=PEBBLE_VA_NOSLEEP=1 --setenv=PEBBLE_AUTHZREUSE=0 /usr/local/bin/lf-course26-pebble -config /root/lf-course26/pebble.json
sudo curl --retry 3 --retry-connrefused --cacert /root/lf-course26/api.pem -fsS https://localhost:14000/dir
sudo curl --cacert /root/lf-course26/api.pem -fsS https://localhost:15000/roots/0 -o /root/lf-course26/issuer-root.pem
最初のクエリは ACME パスを含む JSON を返し、2 回目のクエリはテスト発行チェーンのルート証明書を保存します。PEBBLE_VA_NOSLEEP=1 は人工的な遅延のみを削除し、PEBBLE_AUTHZREUSE=0 は前回の認証結果の再利用を無効にして、繰り返し検証を確認します。常に検証を成功として扱うモードは使用しないでください。Pebble の認証局の状態は実行中にメモリに保存されるため、再起動後に以前のルート、アカウント、または発行状態が保持されていると仮定しないでください。再起動した場合は、新しいテスト環境の発行および信頼関係を再度確認してください。詳細な設定については、 Pebble 2.10.3 公式 README を参照してください。
systemdで実行されるバイナリを/rootに配置しようとした最初の試みは、実行段階での権限拒否により失敗しました。標準の実行パス/usr/local/binに配置し、コンテキストを復元した後、正常に実行されました。203/EXECが表示された場合には、ファイルパス、権限、SELinuxコンテキストとともにjournalctl -u lf-course26-pebbleを確認し、セキュリティ機能を無効化することで解決しないでください。
HTTP-01検証を通じてテスト証明書を発行する
sudo env REQUESTS_CA_BUNDLE=/root/lf-course26/api.pem /root/lf-course26/venv/bin/certbot certonly --standalone --http-01-address 127.0.0.1 --http-01-port 5002 --preferred-challenges http --server https://localhost:14000/dir --config-dir /root/lf-course26/config --work-dir /root/lf-course26/work --logs-dir /root/lf-course26/logs --cert-name course26 --register-unsafely-without-email --agree-tos --non-interactive -d course26.test
sudo openssl x509 -in /root/lf-course26/config/live/course26/cert.pem -noout -serial -dates -issuer -ext subjectAltName
sudo journalctl -u lf-course26-pebble -n 25 --no-pager
このコマンドは、ローカルのテストサーバ上にのみアカウントを作成し、一時的なスタンドアロンサーバがポート5002で認証ファイルを提供します。メールを省略するオプションはこのプライベートテストに限定されています。REQUESTS_CA_BUNDLEは、その実行のAPI TLS信頼性のためだけに使用されます。TLS検証をスキップするオプションは必要ありません。
元の検証ログでは、http://course26.test:5002/.well-known/acme-challenge/... を使用した3回の検証が記録されており、認証は完了し、証明書が発行されました。このポート5002はPebbleで設定されたテストポートです。このカスタムローカルポートは、任意のポートで公共のHTTP-01 CAが検証を行うことを意味するものではありません。
cert.pem はサイト証明書、chain.pem は中間証明書、fullchain.pem はサイト証明書と中間チェーン、privkey.pem は秘密鍵です。live 内のファイルは archive 内のバージョン管理されたファイルへのシンボリックリンクです。秘密鍵およびアカウントキーはウェブドキュメントパスや公開バックアップに配置しないでください。この設定ではテスト有効期間を90日に設定していますが、本番証明書の有効期間を一律と考えず、実際の notAfter を確認してください。
Nginxに適用し、名前とチェーンを確認する
テストサイトは 127.0.0.1:18426 からのみ提供されます。証明書は専用のTLSパスに展開され、Nginxが直接Certbotのストレージパスを露出させずに読み取ります。まず、新しいパスとポートが既存の設定で使用されていないことを確認してください。
sudo install -d -m 0700 /etc/pki/tls/lf-course26
sudo install -m 0644 /root/lf-course26/config/live/course26/fullchain.pem /etc/pki/tls/lf-course26/fullchain.pem
sudo install -m 0600 /root/lf-course26/config/live/course26/privkey.pem /etc/pki/tls/lf-course26/privkey.pem
sudo restorecon -Rv /etc/pki/tls/lf-course26
sudo semanage port -a -t http_port_t -p tcp 18426
サーバーブロック全体を sudoedit /etc/nginx/conf.d/lf-course26.conf に保存します。ポート80でデフォルトサイト構成を維持します。
server {
listen 127.0.0.1:18426 ssl;
server_name course26.test;
ssl_certificate /etc/pki/tls/lf-course26/fullchain.pem;
ssl_certificate_key /etc/pki/tls/lf-course26/privkey.pem;
location / {
default_type text/plain;
return 200 "LF26 HTTPS works\n";
}
}
sudo nginx -t && sudo systemctl start nginx
sudo curl --cacert /root/lf-course26/issuer-root.pem --resolve course26.test:18426:127.0.0.1 -sS -w 'HTTP %{http_code}\n' https://course26.test:18426/
Nginx がすでに実行中の場合は、start ではなく sudo systemctl reload nginx を使用して新しい設定を適用してください。この演習は停止状態から開始した場合に確認されました。LF26 HTTPS works と 200 が期待される結果です。--resolve は、このリクエストのアクセスアドレスのみを指定し、URL 名と TLS SNI (Server Name Indication) は維持します。--cacert は、このラボ用のテスト CA のみを指定し、通常のブラウザの信頼設定は変更しません。
実際の比較では、テストルートを指定せずに curl を実行すると、発行チェーンを信頼できないために終了コード 60 で失敗しました。テストルートを指定した場合でも、URL 名を wrong26.test に変更すると、証明書名の不一致により同じ終了コード 60 となります。原因を終了コードだけで区別せず、エラーメッセージも確認してください。TLS のネゴシエーションが成功したかどうか、およびクライアントに提示されたサーバーの識別情報の両方を検証してください。このテストでは相互 TLS クライアント認証は設定されていません。
実際の更新と配備フックを確認する
Certbot が新しい証明書ファイルを保存しても、別のパスにコピーされた Nginx の証明書は自動的に変更されません。更新成功後に実行されるデプロイフックが、コピー、コンテキストの復元、設定の確認、およびリロードを処理します。次の内容を sudoedit /usr/local/sbin/lf-course26-deploy として保存してください。このフックは、このラボのテスト名と保存パスに限定されています。
#!/bin/bash
set -euo pipefail
test "${RENEWED_LINEAGE:-}" = /root/lf-course26/config/live/course26
openssl x509 -in "$RENEWED_LINEAGE/cert.pem" -noout -checkend 0
openssl verify -CAfile /root/lf-course26/issuer-root.pem -untrusted "$RENEWED_LINEAGE/chain.pem" -verify_hostname course26.test "$RENEWED_LINEAGE/cert.pem"
BACKUP=$(mktemp -d /root/lf-course26/deploy-backup.XXXXXXXX)
cp -a /etc/pki/tls/lf-course26/fullchain.pem /etc/pki/tls/lf-course26/privkey.pem "$BACKUP/"
install -m 0644 "$RENEWED_LINEAGE/fullchain.pem" /etc/pki/tls/lf-course26/fullchain.pem
install -m 0600 "$RENEWED_LINEAGE/privkey.pem" /etc/pki/tls/lf-course26/privkey.pem
restorecon -R /etc/pki/tls/lf-course26
if ! nginx -t || ! systemctl reload nginx; then
install -m 0644 "$BACKUP/fullchain.pem" /etc/pki/tls/lf-course26/fullchain.pem
install -m 0600 "$BACKUP/privkey.pem" /etc/pki/tls/lf-course26/privkey.pem
nginx -t && systemctl reload nginx
exit 1
fi
openssl x509 -in "$RENEWED_LINEAGE/cert.pem" -noout -serial >> /root/lf-course26/deploy-serials.log
適用する前に、チェーン、名前、有効期限を確認し、既存のデプロイメントファイルを保護された場所に保存してください。設定チェックやリロードに失敗した場合は、以前のデプロイメントファイルに戻してエラーで終了してください。復元にも失敗した場合は、サービスログおよび実際の応答を確認する必要があり、自動回復が成功したとは見なされません。今回は、通常の証明書がデプロイされたパスで検証が実行され、この障害回復ブランチは意図的に再現されていません。
以下の内容を sudoedit /usr/local/sbin/lf-course26-renew として保存してください。仮想環境で Python を使用して Certbot コンソールスクリプトを実行してください。
#!/bin/bash
set -euo pipefail
export REQUESTS_CA_BUNDLE=/root/lf-course26/api.pem
exec /root/lf-course26/venv/bin/python /root/lf-course26/venv/bin/certbot renew --server https://localhost:14000/dir --config-dir /root/lf-course26/config --work-dir /root/lf-course26/work --logs-dir /root/lf-course26/logs --cert-name course26 --non-interactive --no-random-sleep-on-renew --deploy-hook /usr/local/sbin/lf-course26-deploy "$@"
sudo chmod 0750 /usr/local/sbin/lf-course26-deploy /usr/local/sbin/lf-course26-renew
sudo restorecon /usr/local/sbin/lf-course26-deploy /usr/local/sbin/lf-course26-renew
sudo /usr/local/sbin/lf-course26-renew --force-renewal
sudo openssl x509 -in /root/lf-course26/config/live/course26/cert.pem -noout -serial
sudo bash -o pipefail <<'BASH'
openssl s_client -connect 127.0.0.1:18426 -servername course26.test -verify_hostname course26.test -CAfile /root/lf-course26/issuer-root.pem -verify_return_error </dev/null | openssl x509 -noout -serial
BASH
--force-renewal は、このローカルテストで更新を確認するためのオプションです。本番の更新タイマーに強制更新を組み込まないでください。初期のシリアル番号は 4DFCA979CEB14834 であり、実際の更新後に保存され提供された番号は 4E9CBB509103CA00 でした。リロードコマンド直後の最初の接続では、以前の証明書が一時的に確認され、再接続後に保存された番号と提供された番号が一致していることが確認されました。コマンドの完了を確認しただけで、サービスアプリケーションが完了したと判断しないでください。
sudo bash <<'ROOT'
set -euo pipefail
sha256sum /root/lf-course26/config/live/course26/cert.pem > /root/lf-course26/dryrun-before.sha256
/usr/local/sbin/lf-course26-renew --dry-run --run-deploy-hooks
sha256sum -c /root/lf-course26/dryrun-before.sha256
ROOT
実際のシミュレーション更新は、HTTP-01とフックを正常に実行し、現在の証明書ハッシュは同じままでした。 --run-deploy-hooks でドライランに指定されたフックは、一時的なテスト証明書ではなく、現在有効な証明書を使用します。 操作やオプションは、 Certbotユーザーガイド でも確認できます。 成功したドライランは、現在のファイルが新しい証明書に置き換えられたことを意味するものではありません。
タイマー実行と有効期限の監視を分けて確認する
以下のサービスを sudoedit /etc/systemd/system/lf-course26-renew.service に保存してください。
[Unit]
Description=Local course26 certificate renewal test
[Service]
Type=oneshot
ExecStart=/usr/local/sbin/lf-course26-renew
次のタイマーを sudoedit /etc/systemd/system/lf-course26-renew.timer に保存します。OnActiveSec=3sは、この演習で短時間の予約実行を観察するための設定です。実際の運用サイクルでは、このテスト行を除き、サービス負荷と管理方針に従って実行時間と分散遅延を設定します。
[Unit]
Description=Local course26 renewal timer test
[Timer]
OnActiveSec=3s
OnCalendar=*-*-* 03,15:00:00
Persistent=true
Unit=lf-course26-renew.service
[Install]
WantedBy=timers.target
sudo systemctl daemon-reload
sudo systemctl start lf-course26-renew.timer
systemctl list-timers lf-course26-renew.timer --no-pager
systemctl show lf-course26-renew.service -p Result -p ExecMainStatus -p ActiveState
sudo journalctl -u lf-course26-renew.service -n 25 --no-pager
元の検証用タイマーの呼び出しは3秒後に発生し、最終状態は Result=success 、 ExecMainStatus=0 、および ActiveState=inactive でした。証明書はまだ更新時期ではなかったため、ログには再発行およびデプロイフックがスキップされたと記録されました。そのため、「タイマーが実行された」「更新を試みた」「新しい証明書を発行/配布した」は別々の確認項目です。ワンショットサービスが正常に終了した後に非アクティブであるのは正常です。「開始」はこの起動時の実行を指し、再起動時に自動実行するには別途enable設定が必要です。
sudo openssl x509 -in /root/lf-course26/config/live/course26/cert.pem -noout -enddate
sudo openssl x509 -in /root/lf-course26/config/live/course26/cert.pem -noout -checkend 604800
sudo openssl x509 -in /root/lf-course26/config/live/course26/cert.pem -noout -checkend 8640000
この試験証明書は7日以内に期限切れにならず、604,800秒の確認では終了コード0が返され、100日以内に期限切れになる場合、8,640,000秒の確認では終了コード1が返されます。後者は「すでに期限切れである」という意味ではありません。-checkend は指定された秒数内の期限を確認します。 OpenSSL x509 ドキュメントでオプションの意味を確認してください。 運用監視では、ローカルファイルだけでなく、実際に外部から提供される証明書もチェックし、障害が発生した場合には管理者が通知を受け取れるよう通知経路をテストする必要があります。
公開サービスに適用する際の条件
実際のドメインでは、プライベートテストCA、hostsエントリ、ポート5002の検証、およびループバックAPIは使用されません。以下のHTTP-01・webroot方式を使う場合は、まず公開DNSと外部からのポート80への接続を確認し、既存のウェブサーバーを維持したい場合は、webroot方式で認証ファイルを提供できます。操作用に別のCertbotパスおよび設定ディレクトリを準備し、テストアカウントやテスト証明書を運用証明書と混同しないでください。
- ドメインのAおよびAAAAレコードが実際のサーバーを指しており、外部からアクセス可能であることを確認してください。また、使用されていないIPv6レコードが誤ったサーバーを指していないことも確認してください。
- Nginxで、外部から
/.well-known/acme-challenge/テストファイルが正しいドキュメントパスで配信されていることを確認してください。隠しパスのブロック、認証要件、または誤ったリダイレクトは検証を妨げる可能性があります。 - まず、運用中のCertbotから
certonly --webroot -w /srv/example-webroot -d www.example.com --dry-runへの公開ステージング検証を行います。サンプルのWebルートとドメインを実際の値に置き換え、到達可能なアカウントのメールアドレスを入力し、CAの利用規約を確認してください。 - テストが成功した後、運用発行を実施し、フルチェーンと秘密鍵のパスをNginxに適用します。運用の更新フックは、実際のパス、名前、信頼チェーンに従って作成する必要があり、このチュートリアルのプライベートCAフックをそのまま再利用してはいけません。
- ポート443での外部レスポンス、名前、チェーン、有効期限、更新ドライランおよびデプロイメントフック、さらにタイマーの次回実行と直近の結果を確認してください。また、公開CAによって要求される発行および更新ポリシーや制限にも従ってください。
このセクションは、パブリックサービスへの切り替え条件に関するものです。今回のローカル検証は、実際に所有するドメインに対するDNS、インターネットファイアウォール、または公開証明書発行の確認とはみなせません。
テスト環境を停止し、既存の設定を復元する
テストを終了したら、まずタイマーとPebbleを停止します。作成したNginxファイルをバックアップ先に移動し、確認とリロードを行った後、既存のデフォルトサイトだけが残ります。
sudo systemctl stop lf-course26-renew.timer lf-course26-renew.service lf-course26-pebble.service
sudo mv /etc/nginx/conf.d/lf-course26.conf /root/lf-course26/lf-course26.conf.saved
sudo nginx -t && sudo systemctl reload nginx
sudo semanage port -d -p tcp 18426
sudo rm -- /etc/systemd/system/lf-course26-renew.service /etc/systemd/system/lf-course26-renew.timer
sudo systemctl daemon-reload
/etc/hostsでは、今回追加した行だけを削除してください。他の編集がない場合は、保護されたオリジナルと比較することで復元できます。また、所有権を確認した後、未使用のテスト実行ファイル、専用配布証明書、およびタイマー状態ファイルを削除し、他のサイトで使用されるファイルやルールは保持してください。秘密鍵やアカウント情報を保存する場合は、以前と同様にrootのみの権限で保護してください。
元の検証環境でのクリーンアップ後、Nginx、ファイアウォール設定、/etc/hosts、SELinuxローカルポリシーは演習前と同じで、既存のデフォルトサイトの内容も同じでした。SSHとfirewalldは有効のままで、SELinuxはEnforcingモードのままでした。テストAPI、HTTPSリスナー、およびスケジュールされたタスクは削除され、専用のログフォルダのみが0700の権限で保持されました。




