certbot

Table of Contents

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

参考資料

コメントを残す

メールアドレスが公開されることはありません。 ※ が付いている欄は必須項目です