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

このラボは、生徒ごとに自分専用の SPIFFE のトラストドメインを渡します。SPIFFE は、動いているプログラム、つまりワークロードに、共有のパスワードの代わりに ID を与えるための標準で、SPIRE はその ID を配るソフトウェアです。生徒の Ubuntu VM では、SPIRE のサーバー、SPIRE のエージェント、1ノードの Kubernetes クラスター k3s が動き、生徒は本物の spire-server、spire-agent、kubectl のコマンドで作業します。

ワークロードを登録し、SVID と呼ばれる寿命の短い証明書を取得し、ID のない呼び出し側をサービスが TLS のハンドシェイクで断るのを見て、名前空間とサービスアカウントで Kubernetes の Pod に ID を与えます。生徒のコンピューターには何もインストールせず、他の生徒と共有するものもありません。

生徒が学ぶこと

ワークロードが動いている間に証明する ID が、ファイルに写したシークレットより安全な理由。SPIFFE ID とトラストドメインとは何か、X.509-SVID と JWT-SVID がそれをどう運ぶか。エージェントが自分のマシンをサーバーに証明するしくみ(ノードのアテステーション、ここでは x509pop)と、呼び出してきたプロセスが何者かを調べるしくみ(ワークロードのアテステーション、Unix ユーザーと Kubernetes の Pod による)。正しいセレクターでワークロードを登録する方法、二つのサービスが SVID と SPIFFE ID の許可リストで相互 TLS を使う方法、SVID のローテーションとトラストドメインのフェデレーション。モジュール「SPIFFE と SPIRE によるワークロードID」はこのラボで進めます。

マシンの中身

SPIRE バージョン 1.15.5 と k3s バージョン 1.35 で、ラボの setup が GitHub にある各プロジェクトの公開リリースからインストールします。ファイルはリリースが公開しているチェックサムで固定され、それ以外のファイルは受け付けません。SPIRE のサーバーとエージェントは VM のシステムサービスとして、トラストドメイン lab.test で動き、Pod は各 Pod にマウントしたソケットでエージェントに届きます。ラボのために Python で書いた小さなサービス billing と catalogue が、それぞれ15秒ごとに自分の SVID を取得し、相互 TLS で応えます。Unix ユーザーがワークロードを表します。

生徒の VM が届くのは Ubuntu のパッケージアーカイブ、PyPI、npm、GitHub で、イメージのレジストリには届きません。そのため、すべての Pod は k3s に付属するイメージ busybox で動きます。

ブラウザーで動かす

VM ラボは、モジュールのラボタスクとして設定し、サンプルはラボのページにあります。マシンは CPU 2つ、メモリ 2 GB、ディスク 10 GB を求めます。

  1. ラボを追加する. 担当するモジュールでタスクを追加し、Ubuntu VM ラボのカードを選びます。ページには compose ファイルの代わりに、マシンの短い説明が表示されます。
  2. サンプルから始める. ページには、すぐ使えるラボが用意されています。Workload identity with SPIFFE and SPIRE を選びます。サンプルを使うとテキストが置き換わり、元に戻すで自分のテキストを取り戻せます。
  3. 公開して自分用のコピーを起動する. 公開してから開始を押します。VM の初回起動時に、ラボの setup スクリプトが GitHub の公開リリースから SPIRE と k3s(合わせて約 300 MB)をインストールし、spirelab コマンド、小さなサービス二つ、作業する Deployment、README を書きます。数分後にはすべて使えるようになります。
  4. ターミナルを開く. ターミナルを開き、サーバーとエージェントが健全だと表示されるまで spirelab status を実行して、ホームフォルダーの README.md を読みます。4つの部分に分けて何をするかが書かれていて、答えは書かれていません。

誰が動かせるか

k3s には 2 GB が必要で、学校や大学のアカウントのマシンにはそれがあります。無料アカウントのマシンは 1 GB なので、setup は k3s なしで SPIRE をインストールし、そう表示します。Pod の部分以外はすべて動きます。アカウントのない訪問者は Ubuntu のアーカイブにしか届かないので、SPIRE をダウンロードできません。ラボは学校や大学のクラスに設定してください。

このラボの基本レッスン

Workload Identity Basics は、この Ubuntu VM のラボで行う小さなレッスンです。導入、「できる」で書いた目標、キーワード、スターター、各ポイントのあとの確認、よくある間違い、最後の確認があり、各ステップの実行ボタンがコマンドをマシンのターミナルに入力します。生徒は SPIRE の状態を尋ね、誰も登録していないワークロードが何も受け取らないのを見て、それを登録し、SVID を取得し、その中の SPIFFE ID を OpenSSL で読みます。

このレッスンは自分用のユーザーを使い、ラボ本来のタスクは生徒に残すので、答えは渡しません。

採点の仕組み

ラボにはチェックがあります。保存されたマシンのコピーを新しく起動して実行し、SPIRE と k3s を待って、ファイルではなくそれらに問い合わせます。ユーザー billing はちょうど ID spiffe://lab.test/billing を、ユーザー orders はちょうど spiffe://lab.test/orders を受け取る必要があります。ユーザー visitor と、チェックが作る誰も見たことのない名前のユーザーは、何も受け取ってはいけません。orders は相互 TLS で billing を呼ぶことを許可され、visitor はハンドシェイクで断られる必要があります。名前空間 payments の Deployment reports はその ID を受け取り、チェックが同じサービスアカウントで新しい名前で起動する Pod も同じ ID を受け取り、名前空間の既定のアカウントの Pod は何も受け取ってはいけません。チェックの出力の1行目に、合格しなかった理由が出ます。

  1. 配る. 他のタスクと同じようにラボを割り当てます。希望すれば期限も付けられます。生徒ごとに専用の VM が用意され、セッションをまたいで保たれ、SPIRE の登録はそのディスクにあります。
  2. チェックを実行する. クラス一覧で生徒の行にあるチェックを実行を押します。保存されたマシンのコピー(保存し直されません)を起動し、SPIRE とクラスターを待って問い合わせ、合格したか、何を出力したか、いつ実行したかを表示します。結果は生徒には伝わりません。
  3. 採点する. チェックの出力の1行目を読みます。ID を二つ受け取るユーザーがいる、billing が許可していない呼び出し側だ、別のアカウントの Pod にも届くエントリーがある、など何が正しくないかが書かれています。足りなければ理由を添えて差し戻します。

GitHub の定義ファイル

このファイルはラボの定義の全てで、プラットフォームが実行するのと同じテキストです。サイズ、setup スクリプト、spirelab コマンド、SPIRE の設定、二つのサービス、作業する Deployment、README、チェックが入っています。コピーしてワークロードや許可リストを変えれば、もっと長いラボが作れます。

このラボを試す、そして費用

無料の個人アカウントで、このラボの基本レッスンに取り組めます。毎月、ほとんどのレッスンに足りる無料クレジットがあり、カードは要りません。クラスで使う場合、学校は最初の365日間、生徒50人まで無料で、その後は生徒1人あたりの年額です。すべてのラボが含まれ、教職員は無料です。

よくある質問

ワークロードIDのラボにライセンスは必要ですか?
必要ありません。SPIRE と k3s は Apache 2.0 ライセンスのオープンソースで、生徒の VM が起動するときに各プロジェクト自身のリリースからダウンロードされます。私たちは何も配布しません。
SPIRE がクラスターの中ではなく VM の上で動くのはなぜですか?
生徒の VM はイメージのレジストリに届かないので、SPIRE のコンテナイメージを取ってこられません。サーバーとエージェントをノードのサービスとして動かすのも、本物の配置のしかたです。エージェントは、自分の Pod の中で動くときとまったく同じように、kubelet に尋ねて Pod を証明します。
フェデレーションはラボに含まれますか?
モジュールで説明し、フェデレーションの相手のサーバーが取ってくる形式でトラストバンドルを見せますが、ラボのトラストドメインは一つなので、フェデレーションは設定しません。
生徒は何かを壊せますか?
壊せるのは自分のコピーだけです。その中の ID はすべてラボ自身のトラストドメインのもので、ラボの初回起動時に作られ、外の何からも信頼されません。VM が届くのは Ubuntu のアーカイブ、PyPI、npm、GitHub だけです。
このラボは本物の生徒用 VM でテストしましたか?
実際のダウンロードを含む setup、レッスンのコマンド、そしていくつもの間違え方を試したチェックは、SPIRE と k3s が動く本物の Ubuntu 26.04 で、VM の代わりのコンテナの中で実行しました。systemd からサービスを起動し、プラットフォームのネットワークプロキシを備えた、実際に起動した生徒用 VM では、授業の前に一度試すことをお勧めします。