ACME

どのようなものか

ACME（Automatic Certificate Management
Environment）は、プログラムが認証局へ証明書を要求し、要求した名前を
管理していることを証明し、期限切れ前に新しい証明書を取得するためのプ
ロトコルです。途中で、人がフォームに記入したり、確認メールに応答した
りすることはありません。2019年3月にRFC
8555として標準化され、多くの人はLet's Encryptという認証局を通して
使っています。

クライアントは、どの証明書の鍵とも分けて保持する自身のアカウント鍵を
用意し、その鍵ですべての要求に署名します。証明書の取得は、サーバー上
の五つのリソースを通ります。

```text
newAccount   アカウント鍵を一度だけ登録する
newOrder     証明書の対象とする名前を列挙する
authz        名前ごとの認可に、チャレンジの選択肢を示す
finalize     すべて検証済みになったら証明書署名要求を送る
certificate  発行された証明書チェーンを取得してインストールする
```

チャレンジは、クライアントが名前の管理権限を示す方法です。サーバーが
トークンを渡し、クライアントはアカウント鍵のフィンガープリントと結び
付け、そのアカウントに固有の証明を作ります。それを、名前を管理する人
だけが置ける場所に公開します。重要なチャレンジは三種類です。

  *
http-01は、対象の名前の`/.well-known/acme-challenge/<token>`に、値を
ファイルとして提供します。認証局の最初の要求は、必ずポート80への平文
HTTPで届きます。

  *
dns-01は、その名前の下の`_acme-challenge`のTXTレコードに、値のハッ
シュを置きます。三つのうち、`*.example.com`のようなワイルドカードの
管理権限を証明できるのは、これだけです。

  * tls-alpn-01は、2020年2月のRFC
8737で追加され、専用のALPNプロトコルを使うTLSハンドシェイク中に、
ポート443で応答します。ポート443を持ち、ポート80を使えないリバースプ
ロキシに適しています。

2025年6月に公開されたRFC 9773は、ACME Renewal
Information（ARI）を追加しました。認証局が、発行した各証明書の更新を
推奨する期間を公開し、クライアントは推測せずに、その推奨期間を問い合
わせます。例えば一斉失効の前に、誰も設定ファイルを編集することなく、
認証局が更新を前倒しできます。

なぜ重要なのか

証明書を手動で更新し続けられるかは、もはや好みの問題ではありません。
日付で条件が決まっています。

CA/Browser
Forumは、公に信頼されるすべての認証局が従うルールを定めています。
2025年4月に採択したSC-081v3は、2026年3月15日以降に発行する証明書の有
効期間を200日以下に制限します。2027年3月15日から100日、2029年3月15日
から47日に短縮します。ドメインの管理権限の証明を再利用できる期間も、
現在の200日から100日、最終的には10日だけに短縮します。最終段階では、
有効期間の三分の二が経過した時点で更新する場合、約一か月ごとに新しい
証明書が必要で、ほぼ毎回、新しいチャレンジが必要になります。

Let's
Encryptは、それより先を進んでいます。現在の標準の証明書は90日間有効
ですが、2027年2月10日から64日、認可の再利用期間は10日となり、2028年2
月16日からは45日、再利用期間は7時間になります。自身の発表で、手動更
新は推奨しないと述べています。また、2025年6月4日に期限の通知メールを
廃止しており、更新忘れを知らせる安全網もなくなりました。

手動更新を選べないため、ACMEが標準となります。残る判断は、各部分をど
こに置くかです。

  * チャレンジ。
ポート80で応答する単一サーバーなら、http-01から簡単に始められます。
ワイルドカード、同じ名前の背後にある複数サーバー、インターネットから
到達できないホストでは、dns-01の追加設定に価値があります。ポート443
を持ち、ポート80を使えないプロキシには、tls-alpn-01が適します。

  * クライアント。
ウェブサーバー内に置く、その横で動かして新しい証明書をインストールす
るフックを設ける、または別のマシンで検証を集中して行い、証明書をコ
ピーする方法があります。

  * 監視するもの。 更新を行うクライアント自身が故障した場面なので、
その外側で、更新されていないことに気付く必要があります。

実際の活用例

当社はDevOpsエンジニアとして、ApacheとNginxの両方がトラフィックを処
理するUbuntu
Linuxホスト上の、百のDockerアプリケーションから、証明書に関する手作
業を取り除きました。各証明書の発行、期限切れ前の更新、デプロイまで、
全手順をACMEが行いました。誰かが日付を覚えていることに頼る手順はなく
なり、百のアプリケーションすべてで有効な証明書を維持し、手作業も不要
になりました。

デプロイは、その重要性を見落としやすい手順です。ApacheとNginxは、起
動または再読み込み時に証明書を読み、そのコピーを提供し続けます。新し
いファイルを書くだけのクライアントでは、訪問者から見えるものは何も更
新されません。両者が同じサーバー群で動く場合は、新しい証明書が届いた
後、それぞれの再読み込みが必要です。

自社サイトでは、クライアントをウェブサーバーに含める、別の構成を使っ
ています。Caddy自体がLet's
Encryptからサイトの証明書を更新します。CaddyはACMEに標準対応し、別の
ツールが不要なため、忘れる可能性のあるデプロイ手順がありません。

問題が起きるところ

ブラウザーでは正常に開けるのに、チャレンジが時間切れか404になりま
す。
http-01の要求はポート80に届き、その経路のどこかに問題があります。443
だけを開けるファイアウォールやクラウドのセキュリティグループ、80・
443以外へ移すリダイレクト、トークンを受け取っていないサーバーへ送る
ロードバランサーなどです。Let's
Encryptは、最大十回、かつこの二つのポートへのリダイレクトだけをたど
ります。ポート80を開け、すべてのバックエンドまたは共有ストレージから
チャレンジのパスを提供し、ポート80を使えない場合はdns-01に切り替えま
す。

ウェブサーバー上のDNS API鍵が、ゾーン全体を書き換えられます。
ワイルドカードにはdns-01が必要なので、クライアントはTXTレコードを作
る手段が必要です。最も簡単に取得できる認証情報は、アカウントが所有す
るすべてのレコードを変更できるものであることが少なくありません。ウェ
ブサーバーに侵入されると、メールも他のすべての名前も転送され得ます。
事業者が提供する場合は`_acme-challenge`レコードだけに限定した認証情
報を使う、CNAMEで`_acme-challenge`をチャレンジ専用のゾーンへ向ける、
または別のマシンで検証して証明書をコピーします。DNS変更の反映には時
間がかかるため、チャレンジの準備完了を認証局へ伝える前に、最大一時間
ほど待つ必要がある場合もあります。

再デプロイ後の新しいコンテナーに証明書がありません。
各コンテナーが起動時に証明書を要求し、自身のファイルシステムにだけ保
持すると、再起動のたびに再要求します。再デプロイが多かったり、一度に
多数を起動したりすると、認証局のレート制限で追加の注文が拒否されま
す。RFC
8555は、このエラーに`rateLimited`という名前を付けています。Let's
Encryptは、最悪の場合、どのインスタンスも証明書を得られないと警告し
ています。証明書と鍵を永続ストレージに保持し、新しいインスタンスは、
注文前に、そこにある有効な証明書を使います。

更新タイマーが固定されているため、有効期間の短縮後に期限切れになりま
す。
例えば90日証明書に合わせ、60日ごとに更新するジョブです。64日証明書で
は余裕が四日、45日証明書では、タイマーの起動より約二週間前に期限が切
れます。RFC
9773は、固定間隔を、認証局が有効期間を変更する妨げとなる習慣の一つに
挙げています。クライアントが対応する場合はARIを有効にします。Let's
Encryptは、少なくとも一日二回確認し、安全策として有効期間の三分の一
が残る時点で更新することを勧めています。

クライアントは成功と報告しても、訪問者には古い証明書が見えます。
新しいファイルはディスクにありますが、ウェブサーバーへ再読み込みを指
示していないか、フックが複数のうち一台だけを再読み込みしています。古
い証明書は期限まで使われ続けます。クライアントのデプロイフックから再
読み込みし、ファイルではなく、外部から実際に提供中の証明書を監視しま
す。

```sh
openssl s_client -connect example.com:443 -servername example.com \
    </dev/null 2>/dev/null | openssl x509 -noout -enddate
```

参考資料

  * RFC 8555：Automatic Certificate Management
Environment（ACME）：アカウント、注文、認可、http-01とdns-01のチャレ
ンジを規定します。

  * RFC 9773：ACME Renewal
Information（ARI）拡張：認証局が各証明書の更新を推奨する期間を規定し
ます。

  * RFC 8737：ACME TLS Application-Layer Protocol
Negotiation（ALPN）チャレンジ拡張：すべてポート443で応答するtls-
alpn-01を規定します。

  * チャレンジの種類：Let's Encrypt自身が、三種類とその制限を比較し
ています。

  * 証明書の有効期間を45日に短縮：Let's Encryptの短縮日程と、更新に
関する助言です。

  * SC-081v3の投票：200日、100日、47日の制限を定める、CA/Browser
Forumの投票です。

hこのページのウェブ版	URL:https://engineer.company/ja/glossary/acme/	engineer.company	70
