クリーム色の背景、色付き表示、高コントラスト、大きな文字のほうが読みやすいですか?配色と文字を選ぶと、すべてのページに一度で反映されます。

無料レッスン

証明書の自動化の基本

レッスン全体が無料でインタラクティブです。ここで読むことも、「ラボを開始」を押してライブラボで実際に実行することもできます。アカウントは不要です。

コンテナラボ読了目安 15分コマンド7個

鍵のマークが期限切れにならないのはなぜ?

鍵のマークがつく Web サイトは、どれも証明書を見せています。そして、どの証明書にも終わりの日があります。公開の証明書が使える期間は、もうすぐ最長 47 日になります。何千枚もの証明書を手で更新する人はいないので、古いものが切れる前に、プログラムが新しいものを求めます。このラボで、そのしくみを見ます。

このレッスンが終わると

メモ

プライベートな認証局に ACME で証明書を求め、いつ更新が要るかを確かめることができます。

キーワード

  • 証明書:shop のような名前と公開鍵を結び付け、署名したファイル。
  • 認証局(CA):申し込みを確かめて、証明書に署名するサービス。
  • ACME:人が関わらずに、プログラムが CA に証明書を求めるためのプロトコル。
  • チャレンジ:求めた名前をあなたが管理していると証明させるために、CA が出す試験。
  • チェーン:あなたの証明書と、その上にある CA の証明書を、信頼するルートまでつないだもの。
  • 更新:古い証明書が終わる前に、新しい証明書を受け取ること。

はじめに:もう知っていること

メモ

頭の中で答えましょう。1. HTTPS の S は何を足しますか。2. Web サイトが名乗るとおりのサイトだと、誰が決めますか。3. 頼りにしているものが、誰も気づかないうちに期限切れになると、どうなりますか。答え: 暗号化と、サーバーが誰かの確認です。ブラウザーが信頼している認証局です。動かなくなります。しかも、たいてい一番困るときにです。

始める前に

メモ

レッスンの上のバーにある ラボを起動 を押し、動いていると表示されるまで待ちます。コンテナは ca、shop、client、python の四つで、ターミナルからは docker exec <名前> でそれぞれの中でコマンドを一つ動かします。下の 実行 ボタンは、それぞれのコマンドをラボのターミナルに、同じセッションの中で順番に入力します。様子を見たいときや自分で入力したいときは、バーの ターミナルを開く を押します。

CA は ACME のアドレスをディレクトリに並べる

ACME のクライアントは、まず CA のディレクトリを読みます。アドレスの短い一覧です。このコマンドは、ラボ自身のルートを信頼して、curl でそれを求めます。返事には newNonce、newAccount、newOrder、revokeCert、keyChange が並びます。仕事ごとに一つのアドレスです。クライアントは、ディレクトリのアドレスさえ知っていれば、ほかをすべて見つけられます。

コマンド
docker exec client curl -s https://ca:9000/acme/acme/directory --cacert /ca/certs/root_ca.crt

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

店はもう自分で証明書を受け取っている

店に証明書を渡した人はいません。店は起動したときに、ACME で CA に求め、shop という名前を管理していると証明しました。一つ目のコマンドは HTTPS でページを取ってきて、「The shop is open」と表示します。二つ目は証明書を読みます。有効なのは DNS:shop、発行者は Lab Private CA Intermediate CA、寿命は 24 時間です。サブジェクトは空ですが、それは大事な名前が名前の一覧のほうにあるからです。

コマンド
docker exec client curl -sS --cacert /ca/certs/root_ca.crt https://shop

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

コマンド
docker exec python python3 steps/read_shop.py

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

確認

ヒント

ここで curl に --cacert が要るのは、なぜですか。答え: ラボのルートは、あなたのコンピューターがもともと信頼しているものではありません。そこで、チェーンをどのルートで確かめるかを curl に教えます。付けないと、エラー 60 で断られます。

手で証明書を求める

今度はあなたがクライアントです。step はアカウントを作り、client という名前の注文を出し、少しの間 80 番ポートで待ち受けて http-01 のチャレンジに答え、署名の依頼を送ります。チャレンジ、待ち、仕上げのそれぞれで done! と表示し、書いた二つのファイル、client.crt と client.key の名前を出します。client という名前でうまくいくのは、CA がその名前を調べると、まさにこのコンテナに届くからです。

コマンド
docker exec client step ca certificate client client.crt client.key --provisioner acme --standalone --force

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

管理していない名前は断られる

ラボの中で誰も答えない名前、bank を求めます。CA は bank から証明を取ってこようとし、誰もいないので止まります。Unable to validate challenge: The server could not connect to validation target です。証明書は書き出されません。この断りこそが、チャレンジの意味のすべてです。

コマンド
docker exec client step ca certificate bank bank.crt bank.key --provisioner acme --standalone

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

更新が要るかを確かめる

needs-renewal は、寿命の三分の二が過ぎると、更新が要ると答えます。あなたの証明書はできたばかりなので、一つ目のコマンドは certificate does not need renewal と表示します。二つ目は、これから 25 時間のうちに終わるかを聞きます。24 時間のうちに終わるので、certificate needs renewal と表示します。更新の仕事は、タイマーでこの質問をくり返し、答えに従って動きます。

コマンド
docker exec client step certificate needs-renewal client.crt --verbose

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

コマンド
docker exec client step certificate needs-renewal client.crt --expires-in 25h --verbose

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

よくある間違い

注意

証明書があれば、その Web サイトは安全で正直だと考える人が多くいます。証明書が示すのは、鍵を持つ人が、CA が確かめたときにその名前を管理していたということだけです。だからこそ、確認は更新のたびにくり返され、寿命の短さが大事になります。

最後の確認

ヒント

前に戻らずに答えましょう。1. CA のアドレスを見つけるために、クライアントが最初に読むものは何ですか。2. CA は client という名前を確かめるために、何をしましたか。3. bank が断られたのは、なぜですか。4. needs-renewal が既定で更新が要ると答えるのは、いつですか。答え: ディレクトリです。その名前から HTTP で証明を取ってきました。その名前で誰も答えなかったからです。寿命の三分の二が過ぎた後です。

先生へ

ヒント

このレッスンは、ラボの中で進めるレッスンの小さな見本です。手順と実行ボタンがレッスンで、ラボは生徒ひとりひとりのコピーです。ラボは四つのコンテナです。ACME のあるプライベートな CA としての step-ca、自分の証明書を受け取って更新する Web サーバーとしての Caddy、step のクライアント、OpenSSL のある Python です。自動採点はなく、生徒は短い報告書を提出します。要点:1. ACME なら、人が関わらずにプログラムが証明書を受け取れる。2. チャレンジは名前を管理していることを証明する。3. 更新は寿命の三分の二が過ぎたときに要る。よくある間違い:証明書を、サイトが正直だという証拠として読むこと。シリアル番号と日付は生徒ごとに違いますが、寿命は変わりません。準備:ラボとブラウザー。ヒント:店の更新が今日から動かなくなったら、店はどうなるかを生徒に聞いてください。自分のモジュールにコピーして変更するか、レッスンビルダーのラボメニューから一から作ってください。

このラボとソースについて: 証明書の自動化ラボ:プライベート CA で ACME、短命の TLS 証明書、自動更新を学ぶ

授業で教えていますか?これらのレッスンを生徒に割り当て、採点と生徒ごとのラボを使えます。