AlmaLinux 9でCertbotとBINDを使う証明書管理
AlmaLinux 9でCertbotのRFC 2136 DNSプラグインを使い、BINDのDNS-01認証で
chinaz.orgと*.chinaz.orgの証明書を取得・更新する手順です。
ドメイン名、DNSサーバーアドレス、メールアドレスは環境に合わせてください。
この手順はSELinuxがすでに無効な環境を前提とし、SELinuxを無効化する設定変更は行いません。
状態はgetenforceで確認してください。EnforcingまたはPermissiveの場合は、この手順をそのまま適用せず、
SELinuxを有効に保ったまま必要なポリシーとファイルコンテキストを設定してください。
秘密鍵やTSIG共有鍵を文書、コマンド履歴、チケット、共有ログに記録しないでください。
以前の文書に掲載されていたTSIG鍵は漏えいしたものとして失効・交換してください。
1. パッケージのインストール
CertbotとDNSプラグインはEPELから導入します。EPELの依存パッケージ用にCRBを有効化します。
# dnf install -y dnf-plugins-core epel-release
# dnf config-manager --set-enabled crb
# dnf install -y certbot python3-certbot-dns-rfc2136 bind bind-utils
# certbot --version
DNSサーバーとCertbotが別ホストの場合、BIND関連パッケージはDNSサーバー側に、
Certbotとプラグインは証明書を管理するホスト側にインストールします。
導入元・パッケージ・利用可能なsystemd unitは環境ごとに確認してください。
2. BINDのTSIG鍵とゾーン設定
2.1 TSIG鍵の作成
BIND DNSサーバー上で鍵ファイルを生成します。秘密値は出力表示や文書への転記を避けてください。
# install -d -o root -g named -m 0750 /etc/named/keys
# umask 077
# tsig-keygen -a hmac-sha256 certbot-key > /etc/named/keys/certbot-key
# chown root:named /etc/named/keys/certbot-key
# chmod 0640 /etc/named/keys/certbot-key
/etc/named/keys/certbot-keyにはBIND形式のkey定義が生成されます。
ファイルを開いてsecret値をコピーする場合は、安全な管理経路を使い、作業後にクリップボード等から消去してください。
鍵ファイルをnamed.confに直接貼り付けず、設定にincludeします。
2.2 DNSゾーンの準備
Certbotからの更新対象を専用の子ゾーン_acme-challenge.chinaz.orgに分離します。
named.confで鍵を読み込み、ゾーン内のTXTレコードだけに更新権限を与えます。
既存のview構成がある場合は、適切なview内にzone定義を追加してください。
include "/etc/named/keys/certbot-key";
view "local" {
// 既存の設定
zone "_acme-challenge.chinaz.org" {
type primary;
file "dynamic-dns/_acme-challenge.chinaz.org.zone";
update-policy {
grant certbot-key name _acme-challenge.chinaz.org. TXT;
};
};
};
複数viewで同じゾーンを提供する場合は、既存設計に合わせてin-view等を設定します。
allow-transferが必要な場合は、セカンダリDNSの最新IPだけをACLで許可します。
不必要なゾーン転送許可や広範なDNS更新許可を追加しないでください。
子ゾーンのファイルを作成します。
# install -d -o named -g named -m 0750 /var/named/dynamic-dns
# vi /var/named/dynamic-dns/_acme-challenge.chinaz.org.zone
$TTL 1D
@ IN SOA ns.chinaz.org. hostmaster.chinaz.org. (
2026110801 ; serial: increment when editing this zone file
3600 ; refresh
600 ; retry
1209600 ; expire
60 ; minimum
)
IN NS ns.chinaz.org.
# chown named:named /var/named/dynamic-dns/_acme-challenge.chinaz.org.zone
# chmod 0640 /var/named/dynamic-dns/_acme-challenge.chinaz.org.zone
親のchinaz.orgゾーンに_acme-challenge IN NS ns.chinaz.org.の委任を追加し、
内部・公開の親ゾーンとセカンダリDNSの内容を同期します。親ゾーンを変更した場合はSOA serialを更新します。
DNS-01が公開検証できるよう、委任先がインターネットから到達可能で、UDP/TCP 53が必要な範囲で許可されていることを確認します。
RFC 2136更新の送信元はCertbotホストに限定してください。
2.3 構文確認とBIND起動
# named-checkzone _acme-challenge.chinaz.org /var/named/dynamic-dns/_acme-challenge.chinaz.org.zone
# named-checkconf /etc/named.conf
# named-checkconf -z /etc/named.conf
# systemctl enable --now named
# systemctl status named --no-pager
AlmaLinux 9の標準サービスはnamed.serviceです。独自にchroot構成を導入している場合は、
その構成に応じたサービス名と設定ファイルを確認してください。
2.4 RFC 2136更新の確認
BINDサーバー上でテスト用TXTレコードを追加・確認・削除します。
# nsupdate -k /etc/named/keys/certbot-key
> server 127.0.0.1
> zone _acme-challenge.chinaz.org.
> update add _acme-challenge.chinaz.org. 60 TXT "certbot-test"
> send
> quit
# dig @127.0.0.1 TXT _acme-challenge.chinaz.org
テストレコードを削除します。
# nsupdate -k /etc/named/keys/certbot-key
> server 127.0.0.1
> zone _acme-challenge.chinaz.org.
> update delete _acme-challenge.chinaz.org. TXT "certbot-test"
> send
> quit
3. Certbotの認証情報設定
Certbotホストに、DNSサーバー上で作成したものと同じTSIG鍵を安全な経路で設定します。
次のファイルは秘密情報を含むためrootだけが読めるようにします。
# install -o root -g root -m 0600 /dev/null /etc/letsencrypt/rfc2136.ini
# vi /etc/letsencrypt/rfc2136.ini
dns_rfc2136_server = 210.136.17.172
dns_rfc2136_port = 53
dns_rfc2136_name = certbot-key.
dns_rfc2136_secret = <新しく生成したTSIG秘密鍵>
dns_rfc2136_algorithm = HMAC-SHA256
dns_rfc2136_serverは子ゾーンを管理するDNSサーバーのCertbotホストから到達可能なアドレスにします。
view構成の場合、Certbotホストからの問い合わせが子ゾーンを持つviewに入り、
そのサーバーが子ゾーンの権威DNSとして応答することを確認してください。
dns_rfc2136_secretはTSIG鍵ファイル内のsecret値に置き換えます。設定後、権限を再確認します。
# chown root:root /etc/letsencrypt/rfc2136.ini
# chmod 0600 /etc/letsencrypt/rfc2136.ini
# stat -c '%U %G %a %n' /etc/letsencrypt/rfc2136.ini
4. 証明書の取得
初回はstagingで動作を確認してから本番証明書を取得します。
メールアドレスは更新通知を受け取れるものに置き換えてください。
# certbot certonly --dry-run --dns-rfc2136 \
--dns-rfc2136-credentials /etc/letsencrypt/rfc2136.ini \
--email admin@example.org --agree-tos \
-d chinaz.org -d '*.chinaz.org'
dry-runが成功したら、本番取得を実行します(--dry-runを外します)。
# certbot certonly --dns-rfc2136 \
--dns-rfc2136-credentials /etc/letsencrypt/rfc2136.ini \
--email admin@example.org --agree-tos \
-d chinaz.org -d '*.chinaz.org'
# certbot certificates
証明書名は既存証明書などの状態により異なる場合があります。certbot certificatesで確認した
/etc/letsencrypt/live/<証明書名>/を各サービスの設定に使用してください。
ワイルドカード証明書はDNS-01認証が必要です。
5. サービスで証明書を使用
以下は証明書名がchinaz.orgの場合の例です。実際のパスに合わせて設定し、
各サービス固有の設定検査を行ってからreloadします。
Apache(/etc/httpd/conf.d/ssl.conf):
SSLCertificateFile /etc/letsencrypt/live/chinaz.org/fullchain.pem
SSLCertificateKeyFile /etc/letsencrypt/live/chinaz.org/privkey.pem
Postfix(/etc/postfix/main.cf):
smtpd_tls_cert_file = /etc/letsencrypt/live/chinaz.org/fullchain.pem
smtpd_tls_key_file = /etc/letsencrypt/live/chinaz.org/privkey.pem
Dovecot(/etc/dovecot/conf.d/10-ssl.conf):
ssl_cert = </etc/letsencrypt/live/chinaz.org/fullchain.pem
ssl_key = </etc/letsencrypt/live/chinaz.org/privkey.pem
秘密鍵を一般ユーザーに読めるよう変更せず、各サービスの実行ユーザーとログで
アクセス拒否の有無を確認してください。
6. 自動更新と反映
Certbotの更新timer名はパッケージの提供元・版により異なることがあるため、実機で確認します。
cronや独自timerを重複して有効化しないでください。
# systemctl list-unit-files 'certbot*'
certbot-renew.timerが提供される場合の例です。実機に存在するtimer名を使用します。
# systemctl enable --now certbot-renew.timer
# systemctl status certbot-renew.timer --no-pager
# systemctl list-timers --all | grep certbot
# certbot renew --dry-run
証明書更新後にサービスを反映する場合は、deploy hookを使います。使用していないサービスの行は削除してください。
# install -d -m 0755 /etc/letsencrypt/renewal-hooks/deploy
# vi /etc/letsencrypt/renewal-hooks/deploy/10-reload-services.sh
#!/bin/bash
set -euo pipefail
systemctl reload-or-restart httpd
systemctl reload-or-restart postfix
systemctl reload-or-restart dovecot
# chown root:root /etc/letsencrypt/renewal-hooks/deploy/10-reload-services.sh
# chmod 0750 /etc/letsencrypt/renewal-hooks/deploy/10-reload-services.sh
更新後はtimer、renew service、各サービスのログを確認します。
# journalctl -u certbot-renew.service --since today --no-pager
# certbot certificates
7. バックアップとトラブル対応
/etc/letsencryptには秘密鍵とアカウント情報が含まれます。バックアップする場合は暗号化し、
アクセス制限された保管先に保存してください。平文アーカイブを共有領域に置かないでください。
復元時は所有者と権限を確認します。
更新に失敗した場合はCertbotとBINDのログ、時刻同期、名前解決、公開側の委任、
TCP/UDP 53の到達性、TSIG鍵名・秘密値・アルゴリズム、認証ファイル権限を確認します。
DNS更新中にゾーンファイルや.jnlファイルを直接削除しないでください。
# journalctl -u named --since today --no-pager
# journalctl -u certbot-renew.service --since today --no-pager
# namei -l /etc/named/keys/certbot-key
