Rocky Linux 9 一覧へ戻る トップ / Rocky Linux 9 / DNS-01移行
Rocky Linux 9 ・ Mail Server ・ トラブルシュート

🔑 Caddyリバースプロキシ環境でのSSL証明書自動更新(DNS-01移行)

リバースプロキシの導入でHTTP-01チャレンジが通らなくなった時に、DNS-01方式へ切り替えて自動更新を復活させる

Certbot DNS-01チャレンジ certbot-dns-mydnsjp systemd override

目次

  1. 1. 何が起きていたか
  2. 2. なぜHTTP-01が通らなくなったのか
  3. 3. 解決策:DNS-01チャレンジとは
  4. 4. 移行の全体手順
  5. 5. つまずいた点と教訓
  6. 6. 切り替え後の検証方法
  7. コマンド早見表
  8. 実機で確認した結果

1. 何が起きていたか

以前のガイド(SSL証明書とLet's Encrypt完全理解ガイド)では、「証明書の自動更新タイマーが動いていれば、何もしなくても証明書は最新に保たれる」と説明していました。実際、しばらくの間はその通りに機能していました。

ところが、サーバー構成にリバースプロキシ(Caddy)を前段に追加してから、自動更新タイマーの実行ログに失敗の記録が残るようになりました。証明書の有効期限が近づいているのにもかかわらず、更新が成立しない状態が続いていたのです。

2. なぜHTTP-01が通らなくなったのか

原因は、証明書取得時の「所有権の証明(チャレンジ)」の仕組みと、リバースプロキシの役割が衝突したことにありました。

【以前の構成】 外部 → 80番ポート → Apache(証明書管理ソフトが直接応答できる) ⇒ HTTP-01チャレンジが素通りで成立 【リバースプロキシ導入後の構成】 外部 → 80番ポート → Caddy(リバースプロキシ)→ Apache ⇒ 外部からの80番アクセスは、まずCaddyが受け取る ⇒ Caddy自身も独自のACME自動化ロジックを持っているため、 証明書管理ソフトが期待する応答経路に割り込みが発生し、 チャレンジが成立しなくなる

リバースプロキシを前段に置く構成そのものは、TLS終端の一元化やアクセス制御の観点で理にかなっています。問題は、「80番ポートを誰が受け止めるか」が変わったことで、証明書取得時の所有権証明の経路だけが成立しなくなったという点でした。

3. 解決策:DNS-01チャレンジとは

Let's Encryptの所有権証明には、HTTP-01以外にもう一つ方式があります。

方式証明の仕組みリバースプロキシの影響
HTTP-01指定されたURLに、Webサーバーが特定の内容で応答できるかを確認する影響を受ける(80番ポートの経路に依存)
DNS-01指定された内容を、そのドメインのDNSにTXTレコードとして追加できるかを確認する影響を受けない(Webサーバーの状態に一切依存しない)

DNS-01は「Webサーバーに何かを置けるか」ではなく「DNSレコードを操作できるか」で所有権を証明するため、手前にリバースプロキシが何台あっても関係ありません。条件は、利用しているDNSサービスに対応した証明書管理ソフトの拡張(プラグイン)が存在することです。

HTTP-01とDNS-01、リバースプロキシへの耐性の違い

DNS-01はWebサーバーの状態に依存しないため、リバースプロキシを何台挟んでも証明が成立する。

4. 移行の全体手順

DNS-01方式への切り替えは、大きく5つの作業に分かれます。

  1. デプロイフックの設定:証明書の更新に成功した直後に、メールサーバー(Postfix/Dovecot)を自動で再読み込み(reload)するよう設定する。
  2. DNSプロバイダ向けプラグインの導入と認証情報ファイルの作成:利用しているDNSサービス(今回は MyDNS.JP)に対応したcertbotプラグインを導入し、DNSレコードを操作するための認証情報ファイルを作成する。
  3. 自動更新タイマーが参照する実行パスの調整:プラグインをOS標準パッケージとは別の方法(pip等)で追加インストールした場合、既存の自動更新タイマーが参照している実行ファイルのパスとズレが生じることがある。systemdのドロップイン(上書き設定)で、タイマーが正しい実行ファイルを呼ぶよう修正する。
  4. リハーサル確認(dry-run):実際には証明書を発行せず、DNS-01チャレンジが最後まで成立するかを事前確認する。
  5. 本番反映:問題がなければ、実際に証明書を再発行し、デプロイフックでメールサーバーへ反映させる。

💡 認証情報ファイルの書式について

DNSプロバイダ向けのプラグインは、一般的なINI形式とは異なる独自のネスト構造(セクション内にドメインごとのサブセクションを持つ形式)を使うことがあります。導入前に、プラグインのヘルプ(certbot --help <プラグイン名>)や公式ドキュメントで正確なキー名・書式を確認してから作成するのが安全です。

5. つまずいた点と教訓

移行作業の中で、認証情報は正しいはずなのに「ログインに失敗した」というエラーでDNS-01チャレンジが失敗する事象が発生しました。

起きたこと

原因

パスワードに含まれる記号が、シェルの変数展開の過程で意図しない形で解釈され、ファイルに書き込まれた内容が本来のパスワードと異なるものになっていた。ファイルの見た目(マスクして表示した状態)では気づけない種類の不具合だった。

✅ 対処と教訓

シェルの変数展開を経由せず、入力された文字列をそのままファイルへ書き込む方法(対話的な入力を受け取り、エスケープ処理を介さずにファイルへ出力するスクリプト等)に切り替えたところ解消した。パスワードのように任意の記号を含み得る秘密情報を、シェルのヒアドキュメントで変数展開しながらファイルへ書き込む方法は避けるべきというのが今回の教訓。見た目上は正しく書き込めたように見えても、特定の記号が紛れ込んでいると正しく機能しない場合がある。

ヒアドキュメントの変数展開がパスワードを化けさせた罠

認証情報自体は正しくても、ファイルへの書き込み過程でシェルの変数展開が記号を化けさせることがある。

6. 切り替え後の検証方法

証明書を再発行した後は、実際にメールサーバーが新しい証明書を配信しているかを確認します。

IMAPS(受信)で配信中の証明書の有効期限を確認
echo | openssl s_client -connect localhost:993 -servername mail.your-domain.mydns.jp 2>/dev/null | openssl x509 -noout -dates
submission(送信、STARTTLS)側の確認
echo | openssl s_client -connect localhost:587 -servername mail.your-domain.mydns.jp -starttls smtp 2>/dev/null | openssl x509 -noout -dates

STARTTLSを使うポート(587番など)は、-starttls smtpを付けずに接続すると「証明書が見つからない」という結果になる点に注意が必要です(TLSが平文のやり取りの後から始まる方式のため)。

コマンド早見表

操作コマンド例
プラグインが認識されているか確認certbot --help <プラグイン名>
自動更新タイマーが参照している実行ファイルを確認systemctl show certbot-renew.service -p ExecStart
DNS-01でのリハーサル確認certbot certonly --dry-run --authenticator <プラグイン名> --dns-<provider>-credentials <認証情報ファイル> --cert-name <証明書名> -d <ドメイン>
本番反映(強制更新)certbot certonly --force-renewal --authenticator <プラグイン名> --dns-<provider>-credentials <認証情報ファイル> --cert-name <証明書名> -d <ドメイン> --deploy-hook '<再読み込みコマンド>'
現在の更新設定を確認cat /etc/letsencrypt/renewal/<証明書名>.conf

実機で確認した結果

移行作業を実施し、以下を確認しました。

お疲れ様でした!

リバースプロキシの導入は、セキュリティ・運用の両面でメリットが大きい一方、既存の自動化の前提を静かに崩すことがあります。「以前は動いていたはずの自動更新が、いつの間にか失敗するようになっていた」というのは、まさにその典型例でした。DNS-01方式は、Webサーバーの構成変更に影響されない証明書更新の手段として、覚えておく価値があります。

Rocky Linux 9 一覧へ戻る