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

無料レッスン

ワークロードIDの基礎

レッスン全体が無料でインタラクティブです。ここで読むことも、「ラボを開始」を押してライブラボで実際に実行することもできます。アカウントは不要です。

仮想マシンラボ読了目安 13分コマンド8個

ファイルにパスワードを書かない

話し合う二つのプログラムは、ふつうパスワードを共有していて、それをどのサーバーのファイルにも写しています。そのファイルを写した人は、何年もそのプログラムになりすませます。ワークロード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 が必要です。ヒント:二回目の取得の前に、何がなぜ変わるかをクラスに尋ねましょう。ラボ自体には、作業を採点するチェックがあります。自分のモジュールにコピーして変更するか、レッスンビルダーのラボメニューから一から作ってください。

このラボとソースについて: ワークロードIDのラボ:専用の Ubuntu VM で、k3s の上の SPIFFE と SPIRE、サービス間の mTLS

授業で教えていますか?これらのレッスンを生徒に割り当て、採点と生徒ごとのラボを使えます。