証明書の自動化ラボ:プライベート CA で ACME、短命の TLS 証明書、自動更新を学ぶ

このラボは、生徒ひとりひとりに専用の小さな TLS 証明書の世界を渡します。ACME を話すプライベートな認証局(CA)があります。ACME は、人が入力しなくてもプログラムが証明書を受け取るためのプロトコルです。ほかに、その CA から自分の証明書を受け取って更新する Web サーバー、手で証明書を求めるための step のコマンドライン、証明書を読むための OpenSSL のある Python があります。公開の証明書の寿命は、2026 年 3 月から最長 200 日、2029 年 3 月からは 47 日になるので、更新は自動でなければなりません。生徒はここで、そのしくみを見ます。

これは攻撃用のラボではありません。どのコピーも、インターネットにも他の生徒にもつながらず、中のものはどのブラウザーにも信頼されていません。CA はラボを最初に起動したときに、自分の鍵を作ります。Web ページはないので、すべて横のターミナルで入力します。CA が署名する証明書の寿命は 24 時間なので、更新は一年に一度ではなく、毎日の出来事です。

生徒が学ぶこと

openssl x509 で証明書を読む方法(サブジェクト代替名にある名前、発行者、日付、ルートまでのチェーン、そして openssl verify での確認)。ACME の注文がアカウントから証明書のダウンロードまでどう進むか(CA のディレクトリ、注文、チャレンジ、ファイナライズ)。http-01 のチャレンジが、管理している名前では通り、管理していない名前では失敗すること。いつ更新するか(寿命の三分の二、step certificate needs-renewal、ジッター、ACME Renewal Information)。失効は調べるクライアントにしか効かず、短い寿命ならどのクライアントでも盗まれた鍵を限れる理由。そして、今出ている証明書の探査、台帳、警告による大規模な更新の運用です。ネットワークセキュリティ、システム管理、DevOps の授業に向いており、モジュール「短命の証明書と ACME による自動化」はこのラボで進めます。

ブラウザーで実行する

ラボは ca、shop、client、python の四つのサービスを起動し、それぞれが healthy になるまで待ちます。その時点で、Web サーバーはもう CA に証明書を求め終えています。ターミナルからは、docker exec に続けてサービスの名前を書くと、それぞれに届きます。

  1. コンテナーのページを開く. バーの「つくる」を開き、「コンテナーを実行」を選びます。ページは誰でも開けて、Git ラボと SQL ラボはアカウントなしで起動できます。ほかのラボには無料アカウントが必要です。アカウントを作成してサインインし、「起動」を押します。
  2. ラボを探す. 「サンプルラボ」のカードにすべてのサンプルが並んでいます。Certificates: ACME and automatic renewalを探します。
  3. 「起動」を押す. 「起動」はそのまま1回の操作で実行します。「先にファイルを編集」は compose ファイルを開くので、起動する前に変更できます。
  4. 開く. ラボのページで「ターミナルを開く」を押します。ラボには Web ページがないので、「ブラウザーで」の下にリンクはありません。docker exec client curl -sS --cacert /ca/certs/root_ca.crt https://shop と入力すると、店はラボ自身の CA の証明書を使って、HTTPS で答えます。続けて docker exec python python3 steps/read_shop.py と入力すると、有効な名前、発行者、24 時間の寿命が表示されます。

本物とモデル

本物のもの: CA(step-ca)とその ACME のディレクトリ、アカウントと注文、http-01 で証明書を受け取って更新する Web サーバー(Caddy)、step のクライアントで手で求める証明書、誰も答えない名前と別のサーバーが持つ名前での http-01 の失敗、OpenSSL で読んで確かめるチェーン、更新の確認、そして失効と、その後に CA が断る更新です。Python のモデルで、ページでもそう書いているもの: dns-01 は、生徒が TXT レコードを足せる DNS サーバーがラボにないからです。ACME Renewal Information(RFC 9773)は、ラボの CA がまだ対応していないからです。どちらも作り話の値で、プロトコル自身の決まりに従います。シリアル番号と日付は証明書を発行するたびに変わるので、スクリプトは日付ではなく寿命と決まりを表示します。

生徒に提出させるもの

短い報告書です。openssl で読んだ店の証明書(サブジェクト、名前、発行者、寿命、チェーン)、自分で求めた証明書、更新が要ると答える確認と要らないと答える確認、失効とその後に CA が断った更新、そして短命の証明書がなぜ失効の役目を果たすのかを一文で書きます。よい一文は、ほとんどのクライアントは失効を調べないので、どのクライアントでも盗まれた鍵を止められるのは期限だけだと述べています。

A basic lesson on this lab

Certificate Automation Basics は、このラボで進める小さなレッスンです。生徒は CA の ACME のディレクトリを読み、店を HTTPS で取ってきてその証明書を読み、手で証明書を求め、管理していない名前が断られるのを見て、証明書に更新が要るかを確かめます。

無料の個人アカウントは、ホームにある Basics モジュールでこれを使えます。どの学校もライブラリーの Basics フォルダーからコピーでき、新しい学校には DevOps Labs (Sample) というモジュールに入っています。わざと小さくしてあり、ラボで進めるレッスンとは何かを先生に見せ、あとはラボが担います。変更するには、ご自分のモジュールにコピーしてください。

GitHub のコード

compose ファイルに Dockerfile はありません。公開されている標準イメージを、バージョンを固定して動かします。CA とクライアントには step-ca(Apache-2.0)、Web サーバーには Caddy(Apache-2.0)、そして OpenSSL の入った公式の Python イメージで、メモリは合わせて 384 MB です。どれも私たちは配布していません。CA は鍵を名前つきボリュームに保存するので、停止する前に発行した証明書も、起動した後にまだ検証を通ります。ほかのサービスが読むのは、そのルートだけです。steps/ のスクリプトは、compose ファイル自身が決まった文から書き出します。ラボはインターネットへの出口を持たず、鍵もパスワードも持ちません。CA が最初に起動したときに、ランダムに自分で作ります。

課題にする

何を提出するかを、課題に書いてください。

  1. ラボを作る. モジュールで課題を追加し、「コンテナーラボ」のカードを選んでから「GitHub リポジトリ」を選びます。https://github.com/mitsurutech/lab-acme-lab とブランチ main を指定します。compose ファイルは既定の compose.yaml です。変更したい場合は、先にリポジトリをフォークしてください。
  2. 公開して試す. 「公開」すると、確認したコミットに固定されるので、あとでリポジトリを変更しても、すでに出したラボは変わりません。まず自分のコピーを起動してください。
  3. 配布する. ほかの課題と同じように配布します。期限を付けることもでき、課題には何をするか、何を提出するかを書いておきます。
  4. 提出物を採点する. 生徒のコピーを開いて提出された内容を確認し、採点します。足りない場合は理由を書いて差し戻します。

このラボを試す、そして費用

無料の個人アカウントで、このラボの基本レッスンに取り組めます。毎月、ほとんどのレッスンに足りる無料クレジットがあり、カードは要りません。クラスで使う場合、学校は最初の365日間、生徒50人まで無料で、その後は生徒1人あたりの年額です。すべてのラボが含まれ、教職員は無料です。

よくある質問

このラボの証明書が 24 時間しかもたないのは、なぜですか。
それがラボの CA 自身の既定だからです。おかげで、生徒は更新を一年に一度ではなく、一回の授業の中で見られます。公開の証明書も同じ方向に進んでいます。2026 年 3 月から 200 日、2027 年 3 月から 100 日、2029 年 3 月から 47 日です。
ブラウザーは店の証明書を信頼しますか。
いいえ。信頼すべきでもありません。ルートはこのラボのコピーだけのもので、最初に起動したときに作られました。ラボの中では、curl と OpenSSL に --cacert と -CAfile でそれを信頼させます。会社が自分のプライベートな CA で行うことと、まったく同じです。
dns-01 と ARI が本物ではなくモデルなのは、なぜですか。
dns-01 には、生徒が TXT レコードを足せる DNS サーバーが要りますが、ラボにはありません。ACME Renewal Information には、それに対応した CA が要りますが、ラボの CA はまだ対応していません。どちらもプロトコル自身の決まりで Python で計算するので、値は本物のクライアントが計算するものと同じです。
失効した証明書が、まだ検証を通るのは、なぜですか。
step certificate verify は、ほとんどのクライアントと同じく、署名と日付を調べ、証明書が失効したかを CA に聞きません。CA 自身は覚えているので、その後に更新を断ります。このすき間こそがレッスンの要点です。どのクライアントでも盗まれた鍵を止められるのは、期限だけです。