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

無料レッスン

ACME のチャレンジ: HTTP-01 と DNS-01

このレッスンのあとで: HTTP-01 や DNS-01 のチャレンジで出す値を計算し、ある名前にどのチャレンジが要るかを言うことができる。

65分のレッスンコマンド3件証明書の自動化ラボ:プライベート CA で ACME、短命の TLS 証明書、自動更新を学ぶ

CA は名前があなたのものだとどう確かめる?

ACME のチャレンジとは、CA が証明書に署名する前に、あなたがそのドメイン名を管理していると証明させる試験です。HTTP-01 は値を Web のアドレスに、DNS-01 は値を DNS のレコードに出させます。

選び方を間違えると、更新は夜中の三時に失敗します。

このレッスンのゴール

メモ

HTTP-01 や DNS-01 のチャレンジで出す値を計算し、ある名前にどのチャレンジが要るかを言うことができる。

キーワード

ことばいみ
サムプリントアカウントの鍵を表す短いハッシュ
キー認可CA の値、ピリオド、サムプリントをつないだもの
HTTP-0180 番ポートの決まったパスで出す証明
DNS-01TXT レコードで出す証明
TXT レコードただの文字列を入れる DNS のレコード
ワイルドカード*.shop.example のように一段の名前を覆う名前

学生が入力するセルは、このプレビューでは空白です。

どちらのチャレンジもキー認可を出す

CA はチャレンジごとにランダムな値を選びます。クライアントはそれを、アカウントの鍵のサムプリントとピリオドでつなぎます。こうしてできたものがキー認可です。

これを作れるのは、アカウントの鍵を持つ人だけです。出せば二つのことが一度に証明されます。名前を管理していることと、このアカウントの持ち主であることです。

HTTP-01 は 80 番ポートで出す

HTTP-01 では、CA が 80 番ポートで http://<name>/.well-known/acme-challenge/<value> を取りに来ます。返事はキー認可でなければなりません。

その名前ですでに届く Web サーバーに向いています。ワイルドカードは証明できず、80 番ポートが閉じていたり、名前が別の場所を指していたりすると失敗します。

Python で両方の証明を計算する

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

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

モデルの出力

行意味
key authorisation: e8Kq2LvX0n4RcT7wYb1mPz9hJd3s.jW5aL0b7Qm3x...CA の値、ピリオド、サムプリント
http://shop.example/.well-known/acme-challenge/e8Kq2LvX0n4R...HTTP-01 を取りに来る場所
_acme-challenge.shop.example TXT vmbbIVBfAfWejbz8l4MJ...DNS-01 のレコード
43 charactersパディングなしの base64url にした SHA-256 のハッシュ
*.shop.example dns-01 onlyワイルドカードには DNS-01 が要る

学生が入力するセルは、このプレビューでは空白です。

DNS-01 はハッシュを DNS に置く

DNS-01 では、クライアントがキー認可を SHA-256 でハッシュし、base64url にして _acme-challenge.<name> の TXT レコードに書きます。CA はそのレコードを調べます。

インターネットから届く必要がないので、内部のサーバーでも名前を証明できます。ワイルドカードを証明できるのは、このチャレンジだけです。その代わり、クライアントには DNS を変える鍵が要ります。

例: チャレンジを選ぶ

名前や状況チャレンジ理由
公開の Web サーバーの shop.exampleHTTP-0180 番ポートがもう開いている
*.shop.exampleDNS-01ワイルドカードは DNS でしか証明できない
外から届かない職員用のサーバーDNS-01CA がつなぎに来ることはない
80 番は閉じていて、443 番は開いているTLS-ALPN-01443 番の TLS で証明する三つ目のチャレンジ

学生が入力するセルは、このプレビューでは空白です。

よくある間違い

注意

サイトが HTTPS なので、HTTP-01 も 443 番で確かめると考える人が多いです。CA はいつも 80 番ポートで、ただの HTTP を取りに来ます。80 番を閉じると、HTTPS の設定がどれだけよくても HTTP-01 の更新はすべて失敗します。

HTTP-01 が二回失敗するのを見る

レッスン 2 では、CA が client コンテナに届いたので、client という名前は合格しました。今度は、自分のものではない名前を二つ求めます。

ラボには bank に答えるものがありません。shop には答えるものがありますが、そこの Web サーバーはあなたのクライアントではないので、あなたの証明は出せません。

誰も答えない名前を求める

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

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

ほかの誰かが出している名前を求める

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

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

二つの失敗の出力

名前最後の行の終わり起きたこと
bankThe server could not connect to validation target80 番ポートで誰も答えなかった
shopThe server will not issue certificates for the identifierあなたのクライアントではなく Caddy が答えたので、証明が違った

学生が入力するセルは、このプレビューでは空白です。

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

授業で使いますか?このモジュールを学生に割り当てると、教員用ガイド、自動採点つきの課題、学生ごとのラボを使えます。