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

無料レッスン

SPIFFE ID、トラストドメイン、SVID

このレッスンのあとで: SPIFFE ID を読み、それを X.509 や JWT の SVID の中に見つけることができる。

70分のレッスンコマンド7件ワークロードIDのラボ:専用の Ubuntu VM で、k3s の上の SPIFFE と SPIRE、サービス間の mTLS

どのサービスも確かめられる名前

SPIFFE ID は、ワークロードの名前を spiffe://lab.test/basket のような URI で書いたものです。社内のどのサービスも、同じやり方でそれを読み、確かめられます。

共通の形がなければ、チームごとに勝手な名前を作ります。こちらはホスト名、あちらはアカウント名です。そうなると、誰が何を呼んでよいかを一つの決まりで書けません。

このレッスンのゴール

メモ

SPIFFE ID を読み、それを X.509 や JWT の SVID の中に見つけることができる。

キーワード

ことばいみれい
SPIFFE IDURI で書いたワークロードの名前spiffe://lab.test/basket
トラストドメインspiffe:// の直後の部分で、署名する権威一つ分lab.test
X.509-SVIDURI SAN に ID を入れた証明書
JWT-SVIDsub クレームに ID を入れた署名付きトークン
トラストバンドルあるトラストドメインの SVID を確かめる CA 証明書の集まり
登録エントリー合うワークロードに ID を与える決まり

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

SPIFFE ID は二つの部分でできている

spiffe:// の後に来るのがトラストドメインで、たとえば lab.test です。トラストドメインの中のものは、すべて一つの権威が署名します。続くのがパスで、たとえば /ns/demo/sa/printer です。その中のワークロードを名指します。

決まりは厳しいです。トラストドメインに使えるのは小文字、数字、点、ハイフン、下線です。ポート、ユーザー、クエリ、空の部分、. や ..、末尾のスラッシュは使えません。

例: 正しいか正しくないか

文字列正しいか理由
spiffe://lab.test/basketはいトラストドメイン lab.test、パス /basket
spiffe://lab.testはいパスのないトラストドメイン
spiffe://Lab.test/basketいいえトラストドメインに大文字がある
spiffe://lab.test/basket/いいえ末尾にスラッシュがある
spiffe://lab.test:8443/basketいいえポートは使えない
https://lab.test/basketいいえスキームは spiffe でなければならない

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

登録エントリーが ID を配る

ID を与えるのは登録エントリーです。エントリーには、SPIFFE ID、それを配ってよいエージェント(親 ID)、ワークロードが合わなければならないセレクターを書きます。エントリーはレッスン 4 でくわしく見ます。

次の二つの Run で、レッスンのワークロードを登録します。ユーザー catalogue は spiffe://lab.test/catalogue を、basket は spiffe://lab.test/basket を受け取ります。どちらも新しいエントリーを表示し、その Entry ID は複製ごとに違います。

catalogue を登録する

コマンド
sudo spire-server entry create -parentID spiffe://lab.test/spire/agent/x509pop/spire-lab -spiffeID spiffe://lab.test/catalogue -selector unix:user:catalogue

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

basket を登録する

コマンド
sudo spire-server entry create -parentID spiffe://lab.test/spire/agent/x509pop/spire-lab -spiffeID spiffe://lab.test/basket -selector unix:user:basket

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

X.509-SVID は寿命の短い証明書

X.509-SVID は、ふつうの証明書と一点だけ違います。名前が、SPIFFE ID を入れた URI SAN なのです。TLS のライブラリは、すでにその使い方を知っています。

登録の後に数秒待ってから、basket として取得します。Run は SPIFFE ID: spiffe://lab.test/basket を表示し、続けて SVID Valid After と SVID Valid Until を出します。二つの差は一時間と十秒です。時計のずれに備えて、SPIRE は証明書を十秒早く始めます。

basket の X.509-SVID を取得

コマンド
sudo -u basket spire-agent api fetch x509

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

basket のフォルダーを作る

コマンド
sudo -u basket mkdir -p /tmp/basket

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

SVID をファイルに書き出す

コマンド
sudo -u basket spire-agent api fetch x509 -write /tmp/basket

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

中の SPIFFE ID を読む

コマンド
openssl x509 -in /tmp/basket/svid.0.pem -noout -ext subjectAltName

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

ファイルは三つ、一つは秘密

書き出しの Run は三つのファイルを作ります。svid.0.pem は証明書、svid.0.key はその秘密鍵で basket しか読めません。bundle.0.pem はトラストバンドルです。OpenSSL は X509v3 Subject Alternative Name の下に URI:spiffe://lab.test/basket を表示します。

秘密鍵はこのマシンで作られ、一度もマシンの外に出ていません。

JWT-SVID は署名付きトークン

相互 TLS を使えない呼び出しもあります。たとえば、途中のプロキシが TLS を終わらせる場合です。そのときは、署名付きトークンの JWT-SVID を使います。sub クレームが SPIFFE ID で、aud クレームが受け取ってよい相手を名指します。

Run は token(spiffe://lab.test/basket): と、点で三つにつないだ長いトークンを表示し、続けてトラストドメインの JWT の鍵を出します。ここでのトークンの寿命は五分です。

catalogue 向けの JWT-SVID

コマンド
sudo -u basket spire-agent api fetch jwt -audience catalogue

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

よくある間違い

注意

JWT-SVID は新しいから安全だと考える人が多いです。JWT は、写した人なら誰でも期限まで使い回せます。できるところでは X.509-SVID と相互 TLS を使い、できないところでは相手を絞った短い JWT を使いましょう。

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

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