ファイルにパスワードを書かない
話し合う二つのプログラムは、ふつうパスワードを共有していて、それをどのサーバーのファイルにも写しています。そのファイルを写した人は、何年もそのプログラムになりすませます。ワークロードID は代わりに、動いているプログラムが本当に何者かを確かめてから、そのプログラムだけの寿命の短い ID を与えます。
このレッスンが終わると
メモ
ワークロードを登録し、SPIRE のエージェントからその ID を取得することができます。
キーワード
- ワークロード:サービスのような、動いているプログラム。
- SPIFFE ID:ワークロードの名前。たとえば spiffe://lab.test/reader。
- SVID:SPIFFE ID を運ぶ、寿命の短い証明書。
- SPIRE エージェント:マシンごとに動き、ワークロードを確かめて SVID を配るプログラム。
- 登録エントリー:どのワークロードがどの SPIFFE ID を得るかを決める決まり。
ウォームアップ:すでに知っていること
メモ
頭の中で答えましょう。1. Web サイトの証明書は何のためにありますか。2. 十台のサーバーに写したパスワードを変えにくいのはなぜですか。3. Unix ユーザーとは何ですか。もうすぐ 3 つとも必要になります。
始める前に
メモ
このレッスンの上にあるバーのラボを起動を押します。このラボは、SPIRE と小さな Kubernetes クラスターが入った、あなた専用の Ubuntu マシンまるごとなので、初回は起動に数分かかります。下の実行ボタンは、それぞれのコマンドをマシンのターミナルに順番に入力します。すべて同じセッションで動きます。様子を見たり、自分でコマンドを打ったりしたいときは、バーのターミナルを開く(新しいタブ)を押します。
SPIRE が動いている
このマシンでは、ID に署名する SPIRE のサーバーと、プログラムと話すエージェントが動いています。spirelab status は Server is healthy. と Agent is healthy.、トラストドメイン lab.test、そして k3s の準備ができているかを表示します。ここでは、Unix ユーザーの一人ひとりがワークロードを一つずつ表しています。
spirelab statusここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。
エントリーがなければ ID もない
ユーザー reader が、エージェントに自分の ID を求めます。誰も登録していないので、エージェントは確かめたうえで合うエントリーを見つけられず、何も渡しません。Run は no identity issued と表示します。
sudo -u reader spire-agent api fetch x509ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。
よくある間違い
注意
SPIRE はどのプログラムにも ID を与えると思っている人が多くいます。ID を受け取れるのは、エージェントが確かめたうえで、登録エントリーに合ったワークロードだけです。それ以外は何も受け取りません。
reader を登録して、もう一度求める
このエントリーは、このマシンのエージェントの上で Unix ユーザー reader が動かすプロセスに、spiffe://lab.test/reader を与えるという意味です。新しいエントリーが表示されます。エージェントは数秒のうちにそれを知るので、次の Run で十秒待ちます。そのあと取得すると、SPIFFE ID: spiffe://lab.test/reader と、一時間ほど離れた二つの時刻が表示されます。SVID は一時間有効で、エージェントが自分で更新します。
sudo spire-server entry create -parentID spiffe://lab.test/spire/agent/x509pop/spire-lab -spiffeID spiffe://lab.test/reader -selector unix:user:readerここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。
sleep 10ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。
sudo -u reader spire-agent api fetch x509ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。
チェック
ヒント
同じコマンドが、一回目は失敗して二回目はうまくいったのはなぜでしょうか。答え: 二回目には、ユーザー reader の登録エントリーがあったので、エージェントが SVID を渡したからです。
ID の正体は証明書
X.509 SVID は、名前が SPIFFE ID になっている、ふつうの証明書です。一つ目の Run で reader のフォルダーを作り、二つ目で reader の SVID、その秘密鍵、トラストバンドルをそこに書き出し、三つ目で証明書を OpenSSL で読みます。X509v3 Subject Alternative Name の下に URI:spiffe://lab.test/reader が出ます。秘密鍵はこのマシンで作られ、一度も外に出ていません。
sudo -u reader mkdir -p /tmp/readerここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。
sudo -u reader spire-agent api fetch x509 -write /tmp/readerここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。
openssl x509 -in /tmp/reader/svid.0.pem -noout -ext subjectAltNameここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。
ラボに進みましょう
ヒント
ワークロードを一つ登録し、その SVID を読みました。あなたのラボはもっと求めます。それぞれ ID を持つ二つのサービス、相互 TLS で一方がもう一方を呼べるようにすること、そして自分の ID を持つ Kubernetes の Pod です。ターミナルで cat README.md を実行して、ホームフォルダーの README.md を開きましょう。
最後のチェック
ヒント
見返さずに答えましょう。1. 登録エントリーは何をしますか。2. 登録される前、reader は何を受け取りましたか。3. その SVID はどれくらい有効でしたか。4. 証明書のどこに SPIFFE ID がありますか。答え:どのワークロードがどの SPIFFE ID を得るかを決める。何も受け取らなかった。約一時間。サブジェクト代替名の中に、URI として。
先生へ
ヒント
このレッスンは、ラボで進めるレッスンの小さな例です。手順と実行ボタンがレッスンで、ラボは生徒一人ひとりの専用コピーです。このレッスンは VM ラボで進めます。生徒一人ひとりが、SPIRE のサーバーとエージェント、1 ノードの k3s クラスターが入った自分専用の Ubuntu マシンを持ち、実行ボタンはそのターミナルに入力して、表示された結果を見せます。学習のポイント:1. ワークロードが ID を得るのは、エントリーが合うときだけ。2. エージェントは寿命の短い SVID を配り、自分で更新する。3. SVID は、サブジェクト代替名に SPIFFE ID を持つ証明書。よくある間違い:どのプログラムも ID を得ると思うこと。用意するもの:ラボとブラウザー。SPIRE だけなら 1 GB で動きますが、ラボの Pod の部分には学校のアカウントの 2 GB が必要です。ヒント:二回目の取得の前に、何がなぜ変わるかをクラスに尋ねましょう。ラボ自体には、作業を採点するチェックがあります。自分のモジュールにコピーして変更するか、レッスンビルダーのラボメニューから一から作ってください。