CA は名前があなたのものだとどう確かめる?
ACME のチャレンジとは、CA が証明書に署名する前に、あなたがそのドメイン名を管理していると証明させる試験です。HTTP-01 は値を Web のアドレスに、DNS-01 は値を DNS のレコードに出させます。
選び方を間違えると、更新は夜中の三時に失敗します。
このレッスンのゴール
メモ
HTTP-01 や DNS-01 のチャレンジで出す値を計算し、ある名前にどのチャレンジが要るかを言うことができる。
キーワード
| ことば | いみ |
|---|---|
| サムプリント | アカウントの鍵を表す短いハッシュ |
| キー認可 | CA の値、ピリオド、サムプリントをつないだもの |
| HTTP-01 | 80 番ポートの決まったパスで出す証明 |
| DNS-01 | TXT レコードで出す証明 |
| 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.example | HTTP-01 | 80 番ポートがもう開いている |
| *.shop.example | DNS-01 | ワイルドカードは DNS でしか証明できない |
| 外から届かない職員用のサーバー | DNS-01 | CA がつなぎに来ることはない |
| 80 番は閉じていて、443 番は開いている | TLS-ALPN-01 | 443 番の 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ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。
二つの失敗の出力
| 名前 | 最後の行の終わり | 起きたこと |
|---|---|---|
| bank | The server could not connect to validation target | 80 番ポートで誰も答えなかった |
| shop | The server will not issue certificates for the identifier | あなたのクライアントではなく Caddy が答えたので、証明が違った |
学生が入力するセルは、このプレビューでは空白です。