Debian 13 講座 / HTTPS証明書とCertbot更新を検証する

Debian 13でHTTPSを運用するには、証明書の発行だけでなく、名前、信頼チェーン、有効期限、そしてウェブサーバーによって実際に提供される証明書も確認する必要があります。公開ドメインと外部検証経路が整ったら、Certbotで発行および更新を設定できます。また、そのような条件がないラボ用VMでは、ローカルのテスト証明書機関(CA)で同じ検証フローを学ぶことができます。このコースでの実行検証は後者の方法を使用しており、公開証明書の発行成功と混同しないよう区別されています。

公開発行とローカルテストCAラボを分ける

HTTPSは、TLS(Transport Layer Security)でHTTP通信を保護する方法です。証明書にはサーバーの公開鍵や使用する名前などの情報が含まれ、証明書発行機関(CA)によって署名されます。クライアントは、信頼できるCAにチェーンされているか、接続名が証明書と一致しているか、有効期限内であるかを確認します。

ACME(Automatic Certificate Management Environment)は、ドメインの管理権を確認し、証明書の発行と更新を自動化するためのプロトコルです。Certbotはこれを利用するクライアントです。ローカルで作成したCAは、デフォルトではインターネットブラウザから信頼されず、公開サイトの証明書の代わりにはなりません。

方法 要件 このコースの検証範囲
Certbotによる公開証明書の発行 検証方法に応じた制御可能な実際のドメイン、DNS/外部アクセス 公式文書とインストール済みオプションを確認する条件付き操作手順です。実際の発行は行われませんでした。
ローカルテスト CA sudoを使用できる専用のDebian VM、Nginx・OpenSSL・curl 信頼性と名前検証、HTTPS レスポンス、証明書の再発行、リロードを直接検証しました。

Let's Encrypt の チャレンジタイプガイド では、HTTP-01 がポート 80 経由でドメインを通じてトークンに外部アクセスすることを要求することを説明しています。VM のポート 8443 のみを開くことや、ローカルのhostsファイルを変更するだけでは、この条件を満たしません。DNS-01 では公開 DNS TXT レコードの管理権限が必要です。自動更新には適切な DNS プラグインと、慎重に範囲を限定した API 権限が必要です。

インストール済みバージョンと実際の更新タイマーを確認する

実習のために、前回の講義で使用した Nginx が正常に稼働している VM を使用し、ポート 8443 と以下の専用パスが空であることを確認してください。既存の公開サイトがあるサーバーでは、設定、証明書、およびキーを安全にバックアップし、変更の範囲を定義してから進めてください。

sudo apt update
sudo apt install nginx openssl curl certbot python3-certbot-nginx
openssl version
certbot --version
sudo nginx -t
ss -ltn
systemctl cat certbot.timer certbot.service
systemctl list-timers certbot.timer --no-pager

検証用VMはOpenSSL 3.5.7、Certbot 4.0.0、およびNginx 1.26.3を使用しました。Debianパッケージでは、certbot.timerは1日に2回の基準時刻にランダムな遅延を加える設定で、Persistent=trueでした。certbot.serviceは更新処理を一度実行して終了するoneshot型のサービスです。インストール方法が異なる場合、タイマー名やスケジュールも異なる可能性があるため、実際の設定を確認してください。

timerがアクティブであるということは、スケジュールが有効になっていることを意味します。証明書が存在することや更新/展開が成功したことを意味するものではありません。このVMでのcertbot certificatesの結果は「No certificates found」でした。また、以降のローカルOpenSSL証明書は自動的にCertbot管理対象として登録されるわけではありません。

ローカルCAを作成し、HTTPSテストサイトを完成させる

リストにある各専用ラボパスが存在しない場合にのみ、ブロック全体を実行してください。CAキーとサーバーキーはルート専用パスに置き、クライアントが読み取れる公開CA証明書のみを別の公開パスに保持してください。システムまたはブラウザの信頼ストアには追加しないでください。秘密鍵はパスフレーズなしで生成されますが、700のディレクトリと600のファイル権限で制限されます。この方法は短期間のローカル練習用です。

管理者権限で明示的にsudo bashを実行し、内部コマンドを単一のルートシェルで実行してください。CAは3日間有効とし、最初のサーバー証明書は1日間有効とし、SAN(Subject Alternative Name)にlab26.testを含めます。この名前はローカルテスト専用です。

sudo bash <<'ROOT'
set -euo pipefail
for p in /var/lib/lf-tls26 /etc/nginx/lf-tls26 /etc/nginx/sites-available/lf-tls26 /etc/nginx/sites-enabled/lf-tls26 /usr/local/sbin/lf-tls26-deploy; do
  if test -e "$p" || test -L "$p"; then echo "Existing: $p" >&2; exit 1; fi
done
install -d -m 755 /var/lib/lf-tls26 /var/lib/lf-tls26/public
install -d -m 700 /var/lib/lf-tls26/private /etc/nginx/lf-tls26
umask 077
openssl req -x509 -newkey rsa:2048 -noenc -sha256 -days 3 -subj '/CN=LF Lab 26 Test CA' -addext 'basicConstraints=critical,CA:TRUE' -addext 'keyUsage=critical,keyCertSign,cRLSign' -keyout /var/lib/lf-tls26/private/ca.key -out /var/lib/lf-tls26/public/ca.crt
chmod 644 /var/lib/lf-tls26/public/ca.crt
openssl req -new -newkey rsa:2048 -noenc -subj '/CN=lab26.test' -keyout /etc/nginx/lf-tls26/server.key -out /var/lib/lf-tls26/private/server.csr
cat > /var/lib/lf-tls26/private/leaf.ext <<'EXT'
basicConstraints=critical,CA:FALSE
keyUsage=critical,digitalSignature,keyEncipherment
extendedKeyUsage=serverAuth
subjectAltName=DNS:lab26.test
EXT
openssl x509 -req -in /var/lib/lf-tls26/private/server.csr -CA /var/lib/lf-tls26/public/ca.crt -CAkey /var/lib/lf-tls26/private/ca.key -set_serial 0x26 -days 1 -sha256 -extfile /var/lib/lf-tls26/private/leaf.ext -out /etc/nginx/lf-tls26/server.crt
cat > /etc/nginx/sites-available/lf-tls26 <<'CONF'
server {
    listen 127.0.0.1:8443 ssl;
    server_name lab26.test;
    ssl_certificate /etc/nginx/lf-tls26/server.crt;
    ssl_certificate_key /etc/nginx/lf-tls26/server.key;
    default_type text/plain;
    return 200 "TLS LAB 26\n";
}
CONF
ln -s /etc/nginx/sites-available/lf-tls26 /etc/nginx/sites-enabled/lf-tls26
nginx -t
systemctl reload nginx
sleep 1
ROOT

生成されたファイルの中で、ca.key と server.key は秘密鍵であり、ca.crt と server.crt は公開証明書です。Common Name(CN)を設定するだけで名前の検証が十分だと考えないでください。SAN も確認してください。サーバー証明書の拡張には、それが CA ではないことと、サーバー認証用であることが指定されています。秘密鍵へのアクセスに関する設定と条件についても、Nginx HTTPS 設定ドキュメント に説明されています。

設定を確認してリロードした後、Debian VM上で通常のユーザーとしてリクエストを行います。リロード直後に接続が失敗する場合は、少し時間を置いて再度試し、ssおよびサービスのログを確認してください。--resolve オプションは、このリクエストに対してのみ名前をアドレスにマッピングし、DNSを変更しません。また、--cacert は、このリクエストに対してのみテストCAを信頼させます。

curl --noproxy '*' -fsS --cacert /var/lib/lf-tls26/public/ca.crt --resolve lab26.test:8443:127.0.0.1 https://lab26.test:8443/

期待される応答は TLS LAB 26 です。この成功は、ループバック、指定されたCA、および指定された名前の条件下での検証に基づくものであり、パブリックDNSや通常のブラウザの信頼チェックの結果を反映するものではありません。

信頼エラーと名前の不一致を区別する

以下の最初のリクエストでは、テスト用CAを指定せず、2つ目のリクエストではCAを指定しますが、証明書に含まれていないIPアドレスに接続してください。どちらのコマンドも失敗することが予想されます。set -e が有効になっていない新しい通常のシェルでこの比較を実行し、各リクエストの直後に終了コードを読み取ってください。errexit シェルでは echo が実行される前に終了する可能性があります。

curl --noproxy '*' -sS --resolve lab26.test:8443:127.0.0.1 https://lab26.test:8443/
echo "curl exit: $?"
curl --noproxy '*' -sS --cacert /var/lib/lf-tls26/public/ca.crt https://127.0.0.1:8443/
echo "curl exit: $?"

検証では、両方のケースとも curl の終了コード 60 が返されましたが、最初のものは信頼されていない発行者によるもので、2つ目は名前の不一致によるものでした。数値だけでまとめるのではなく、エラーメッセージも確認してください。-k で検証をオフにして成功した結果は、証明書信頼チェックには使用できません。

次のように、ファイル自体のチェーン、名前、有効期限を確認します。サーバー証明書のパスはルート専用ディレクトリ内にあるため、sudoを使用します。

sudo openssl verify -CAfile /var/lib/lf-tls26/public/ca.crt -verify_hostname lab26.test /etc/nginx/lf-tls26/server.crt
sudo openssl x509 -in /etc/nginx/lf-tls26/server.crt -noout -serial -dates -ext subjectAltName
sudo openssl x509 -in /etc/nginx/lf-tls26/server.crt -noout -checkend 3600

-checkend 3600 は、今後3,600秒以内に期限が切れるかどうかを確認し、期限が近い場合はゼロでないステータスを返します。これだけではチェーンや名前の検証は行われません。OpenSSL x509 オプションの説明 に従い、日付、SAN、チェーンのチェック目的を区別します。

証明書ファイルとNginxが提供する証明書を比較する

サーバー証明書を交換しても、稼働中の Nginx が新しい証明書を提供することを保証することはできません。まず、新しい接続で提供される証明書のシリアル番号を確認してください。-servername は TLS の SNI(Server Name Indication)を通して目的のサーバー名を渡します。このコマンドは証明書を見るためのもので、実際の信頼性および名前の検証は、前段の curl および openssl verify によって行われます。

openssl s_client -connect 127.0.0.1:8443 -servername lab26.test < /dev/null 2>/dev/null | openssl x509 -noout -serial -fingerprint -sha256

この置換比較は、必ず新しいラボで一度だけ実行してください。繰り返し試行する際には、最初の server-before.crt を上書きせずに保持してください。これらの証明書は意図的に数日後に期限切れとなるため、正しいシステム時計を使用し、必要に応じて専用ラボを再生成してください。

初期のシリアル番号は16進数で26です。次に、同じテストCAおよびCSR(Certificate Signing Request:証明書署名要求)を使用して、2日間の有効期間でシリアル番号27の新しい証明書を作成し、検証が完了したら、同じディレクトリ内のファイル名を置き換えます。この比較は、ACME更新ではなく、展開ステップを別途確認するローカル再発行です。

sudo bash <<'ROOT'
set -euo pipefail
umask 077
cp -a /etc/nginx/lf-tls26/server.crt /var/lib/lf-tls26/private/server-before.crt
openssl x509 -req -in /var/lib/lf-tls26/private/server.csr -CA /var/lib/lf-tls26/public/ca.crt -CAkey /var/lib/lf-tls26/private/ca.key -set_serial 0x27 -days 2 -sha256 -extfile /var/lib/lf-tls26/private/leaf.ext -out /etc/nginx/lf-tls26/server.next.crt
openssl verify -CAfile /var/lib/lf-tls26/public/ca.crt -verify_hostname lab26.test /etc/nginx/lf-tls26/server.next.crt
mv /etc/nginx/lf-tls26/server.next.crt /etc/nginx/lf-tls26/server.crt
ROOT

上記のブロックを完了した直後、ファイルのシリアル番号は27ですが、新しい接続で受信した証明書はまだ26でした。これは、ファイル保存の成功と展開の成功が異なることの証拠です。このステップでは、既知の正常な server-before.crt が保持されていました。

以下の専用デプロイスクリプトは、設定検査が成功した場合にのみNginxをリロードします。この手順では、準備段階でこの名前のファイルがまだ存在しないことを確認しました。これは、運用サーバー上の既存スクリプトを上書きするためには使用されません。

sudo tee /usr/local/sbin/lf-tls26-deploy > /dev/null <<'HOOK'
#!/bin/sh
set -eu
/usr/sbin/nginx -t
/usr/bin/systemctl reload nginx
HOOK
sudo chmod 700 /usr/local/sbin/lf-tls26-deploy
sudo /usr/local/sbin/lf-tls26-deploy
openssl s_client -connect 127.0.0.1:8443 -servername lab26.test < /dev/null 2>/dev/null | openssl x509 -noout -serial -fingerprint -sha256
curl --noproxy '*' -fsS --cacert /var/lib/lf-tls26/public/ca.crt --resolve lab26.test:8443:127.0.0.1 https://lab26.test:8443/

検証中、リロード後、新しい接続のシリアル番号が27に変更され、HTTPレスポンスは正常でした。旧ワーカーの終了には時間がかかる場合があるため、少し待ち、新しい接続で再確認してください。構成チェックが失敗した場合、リロードは実行されず、ファイル/キーの対応やパス/権限を調査します。この手順用の証明書を復元する際は、保存されている server-before.crt を server.crt にコピーし、検証、リロード、証明書提供のチェックを同じ順序で実行してください。

公開ドメインの準備後にCertbotを使用する

この手順は実際のドメインを運用する場合にのみ適用されます。127.0.0.1:8443のローカルサイトとは別に、ドメインのIPv4 Aおよび公開されているIPv6 AAAAレコードは正しいサーバーを指している必要があり、使用するすべてのパスでポート80のHTTP-01アクセスが可能である必要があります。また、間違ったIPv6アドレス、プロキシ、CDN、ファイアウォール、NAT設定がないか確認してください。他のネットワークからのドメインアクセスを確認し、Nginxサイトのserver_nameを実際のドメインに合わせて調整してください。

Certbotのドライランでもステージングサービスに接続し、一時的にウェブサーバーを調整・再読み込みする場合があります。まず、関連するサイト設定をバックアップしてください。nginx -t やステージング検証が失敗した場合は、運用環境での発行を試みる前に停止して修正してください。以下のコマンドは、エラー後に一括で実行するためのものではありません。

以下は、すでに準備されたNginxサイトに適用される条件付きコマンドです。管理しているドメインと連絡用のメールアドレスを入力し、まず実際のサーバー上で設定をバックアップしてください。--dry-run はステージング検証を試行するため、外部の条件がないVM上で実行する必要はありません。

read -r -p "Real domain you control: " domain
read -r -p "Certificate contact email: " email
sudo nginx -t
sudo certbot certonly --nginx --dry-run -d "$domain" --email "$email" --agree-tos

ステージング証明書は一般のクライアントから信頼されません。Let’s Encrypt のステージング手順 に従い、まず検証エラーを解決してから、本番発行に進んでください。ドライランが成功しても、本番用証明書は保存されません。通常の条件下では、以下のコマンドにより本番用証明書が発行され、Nginx の設定が変更されるため、変更内容を確認する必要があります。

sudo certbot --nginx -d "$domain" --email "$email" --agree-tos --redirect
sudo certbot certificates
sudo nginx -t
curl -I "https://$domain/"

出力された証明書を使用して、実際の証明書名とliveディレクトリ内のパスを確認してください。Nginx は、サーバー証明書および必要な中間証明書を含む fullchain.pem と、対応する privkey.pem にリンクされている必要があります。ファイルが存在することを確認するだけで検証を終了しないでください。外部の HTTPS レスポンスを確認し、提供された証明書の名前、発行者、有効期限を確認してください。

運用更新の確認は、sudo certbot renew --dry-run で実行されます。インストールされているバージョン 4.0.0 のヘルプによると、デフォルトのドライランではデプロイフックは実行されず、--run-deploy-hooks を追加する必要があります。Nginx プラグインが処理する再適用に加えて独自のデプロイフックを設定している場合は、対象と重複リロードを確認し、フックを含むテストはメンテナンス範囲内で実施する必要があります。

certbot --help all | less
sudo certbot renew --dry-run
systemctl list-timers certbot.timer --no-pager
sudo journalctl -u certbot.service -n 50 --no-pager

更新するものが何もなくて何も行わずに終了した結果は、更新が成功した証拠にはなりません。まず、実際に管理されている証明書があるかどうかを確認し、必要なタイミングで更新結果、展開結果、および新しい接続の証明書を別々に記録してください。プラグインとフックの意味については、Certbot公式使用ガイド を参照してください。ただし、インストールされているバージョンのヘルプおよび実際の設定を確認することを優先してください。

ローカルTLSラボのみを削除する

パブリックなCertbot設定を構成した読者は、このクリーンアップセクションをパブリックサイトに適用してはいけません。以下のブロックは、以前に作成されたlf-tls26のリンクを削除し、その後チェックしてリロードし、8443リスナーが消えた場合にのみ専用の秘密鍵、証明書およびディレクトリを削除します。トラストストアは変更されていないため、システムCAを削除する必要もありません。

sudo bash <<'ROOT'
set -euo pipefail
rm -- /etc/nginx/sites-enabled/lf-tls26
nginx -t
systemctl reload nginx
sleep 1
if ss -ltnH | grep -q '127.0.0.1:8443'; then echo 'TLS listener remains' >&2; exit 1; fi
rm -- /etc/nginx/sites-available/lf-tls26 /usr/local/sbin/lf-tls26-deploy /etc/nginx/lf-tls26/server.crt /etc/nginx/lf-tls26/server.key
rm -- /var/lib/lf-tls26/private/ca.key /var/lib/lf-tls26/private/server.csr /var/lib/lf-tls26/private/leaf.ext /var/lib/lf-tls26/private/server-before.crt /var/lib/lf-tls26/public/ca.crt
rmdir /etc/nginx/lf-tls26 /var/lib/lf-tls26/private /var/lib/lf-tls26/public /var/lib/lf-tls26
ROOT

検証用VM上では、専用HTTPSサイト、キー、CA、およびデプロイスクリプトが削除され、元のNginxデフォルト設定のハッシュは保持されました。Certbotパッケージとアクティブなタイマーは残っていましたが、管理されている証明書はありませんでした。この状態は、パブリック証明書の自動更新操作と同じものとは見なされません。