ACME なら誰も打ち込まずに証明書が届く
ACME とは、人が関わらずに、プログラムが CA から証明書を受け取るためのプロトコルです。正式な名前は Automatic Certificate Management Environment で、RFC 8555 で定められています。
ACME がなければ、47 日の証明書は、名前ごとに数週間おきに人が更新することを意味します。ACME があれば、更新はひとりでに動く仕事になります。
このレッスンのゴール
メモ
アカウントから証明書のダウンロードまで、ACME の注文の手順を説明することができる。
キーワード
| ことば | いみ |
|---|---|
| ディレクトリ | CA が出す ACME のアドレスの一覧 |
| アカウント | CA がクライアントを見分けるための鍵ペア |
| 注文(オーダー) | 一枚の証明書とその名前を求める依頼 |
| 認可(オーソリゼーション) | 一つの名前を証明したことの CA 側の記録 |
| ファイナライズ | すべての名前を証明した後に署名の依頼を送ること |
| CSR | 公開鍵を入れた証明書署名要求 |
学生が入力するセルは、このプレビューでは空白です。
すべてはディレクトリから始まる
クライアントが教えられるアドレスは、ディレクトリ一つだけです。それを読めば、ほかのアドレスがすべて見つかります。ノンスの取得、アカウントの作成、注文、失効、鍵の交換の行き先です。
ノンスとは、一度だけ使う数です。どの要求にも新しいノンスが付くので、古い要求を他人が送り直すことはできません。
ラボの CA のディレクトリを読む
docker exec client curl -s https://ca:9000/acme/acme/directory --cacert /ca/certs/root_ca.crtここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。
ディレクトリに並ぶもの
| 返事の中の名前 | クライアントが使う目的 |
|---|---|
| newNonce | 要求の前に新しいノンスをもらう |
| newAccount | アカウントの鍵を登録する |
| newOrder | いくつかの名前の証明書を求める |
| revokeCert | ある証明書をもう信頼しないよう伝える |
| keyChange | アカウントの鍵を新しいものに替える |
学生が入力するセルは、このプレビューでは空白です。
注文は五つの状態を進む
どの要求も、アカウントの鍵で署名します。クライアントはいくつかの名前の注文を出します。名前ごとに認可ができ、認可がチャレンジを示します。
注文は、すべての名前を証明するまで pending で、その後 ready になります。クライアントが CSR でファイナライズすると processing、そして valid になります。証明に失敗すると invalid です。
記録した注文を一手順ずつ表示する
docker exec python python3 steps/order.pyここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。
記録した注文から分かること
| 手順 | 状態 | 起きたこと |
|---|---|---|
| 1 new-account | account valid | クライアントの鍵がアカウントになった |
| 2 new-order | order pending | shop の証明書を求める |
| 3 と 4 authorization、challenge | pending、次に processing | クライアントが「見に来てください」と言う |
| 5 authorization | valid | CA が証明を取ってきて、一致した |
| 6 から 8 order、finalize、order | ready、processing、valid | CSR に署名された |
| 9 certificate | issued | クライアントがチェーンをダウンロードする |
学生が入力するセルは、このプレビューでは空白です。
よくある間違い
注意
CA がサーバーの鍵を作って送ってくると考える人が多いです。クライアントは自分で鍵ペアを作り、CSR に入れて公開鍵だけを送ります。秘密鍵がサーバーの外に出ることはありません。
本物の注文を出してみる
client コンテナには step コマンドがあり、CA の場所と信頼するルートを知っています。次の Run は、アカウントを作り、client という名前の証明書を注文し、http-01 で証明してファイナライズします。
チャレンジ、ready を待つところ、ファイナライズのそれぞれで done! と表示し、最後に client.crt と client.key の名前を出します。
client の証明書を注文する
docker exec client step ca certificate client client.crt client.key --provisioner acme --standalone --forceここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。
受け取ったものを見る
docker exec client step certificate inspect client.crt --shortここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。
自分の証明書を短く見る
短い表示には、Subject: client、Issuer: Lab Private CA Intermediate CA、Provisioner: acme が出ます。シリアル番号と日付は自分だけのもので、日付の差は一日です。
店は起動したときに、同じことを自分で行いました。ターミナルで docker logs shop を動かすと、アカウント、注文、チャレンジ、ファイナライズの行が見えます。時刻と ID は店だけのものです。