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

無料レッスン

ACME プロトコルのしくみ

このレッスンのあとで: アカウントから証明書のダウンロードまで、ACME の注文の手順を説明することができる。

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

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-accountaccount validクライアントの鍵がアカウントになった
2 new-orderorder pendingshop の証明書を求める
3 と 4 authorization、challengepending、次に processingクライアントが「見に来てください」と言う
5 authorizationvalidCA が証明を取ってきて、一致した
6 から 8 order、finalize、orderready、processing、validCSR に署名された
9 certificateissuedクライアントがチェーンをダウンロードする

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

よくある間違い

注意

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 は店だけのものです。

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

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