どのサービスも確かめられる名前
SPIFFE ID は、ワークロードの名前を spiffe://lab.test/basket のような URI で書いたものです。社内のどのサービスも、同じやり方でそれを読み、確かめられます。
共通の形がなければ、チームごとに勝手な名前を作ります。こちらはホスト名、あちらはアカウント名です。そうなると、誰が何を呼んでよいかを一つの決まりで書けません。
このレッスンのゴール
メモ
SPIFFE ID を読み、それを X.509 や JWT の SVID の中に見つけることができる。
キーワード
| ことば | いみ | れい |
|---|---|---|
| SPIFFE ID | URI で書いたワークロードの名前 | spiffe://lab.test/basket |
| トラストドメイン | spiffe:// の直後の部分で、署名する権威一つ分 | lab.test |
| X.509-SVID | URI SAN に ID を入れた証明書 | |
| JWT-SVID | sub クレームに 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 を使いましょう。