PRコメントからKubernetesに訊く ~GitHub ActionsからA2Aエージェントをシークレットレスで繋ぐ~
A2Aエージェントを活用するにあたって、セキュリティの観点からどのように補強していったかを整理します。
1. 背景
まず現在の状況を分かりやすく整理します。私たちは main ブランチにマージする前に、 k8s クラスタ上の job の状態を把握する必要がありました。
そのため GitHub で PR を上げた状態で、複数の開発者が実際に k8s クラスタへ接続して各種リソースの状態を確認していました。しかし k8s クラスタに接続するたびに VPN へ繋ぐ必要があり、手作業でリソースをひとつずつ点検するのは非常に時間がかかり煩雑な作業です。(もちろんミスも起こりえます!)
そこで「GitHub PR のコメント欄から k8s クラスタの状態を確認できたらどうだろう?」と考え、kagent を導入していました。以下が簡単な運用アーキテクチャです。
- kagent は AI エージェントを Kubernetes の Pod として立ち上げてくれるツールです。
Agentリソース 1 つが Deployment・Service・ServiceAccount 1 つになります。 - エージェント同士、あるいは外部からエージェントに話しかける方式が A2A(Agent-to-Agent)プロトコルです。HTTP 上の JSON-RPC なので、GitHub Actions からも
curl一行で呼べます。
とはいえサードパーティ(GitHub)が k8s クラスタに接続するというのは、セキュリティ上かなり大きなリスクを伴う行為です。そこで私たちはセキュリティを強化する作業を進めました。今回はその過程を分かりやすく書き残しておきます。
すでに私たちが使っていたものは以下のとおりで、ある程度の前提知識が必要かもしれません。
- Istio / Cilium
- kagent
- Keycloak
- GitHub Actions
2. Secret ベースのアーキテクチャ (現在)
GitHub Actions が k8s クラスタ内のエージェントを呼ぶには、「自分は入ってよい呼び出し元である」ことを証明しなければなりません。まず思いつく構成は、API キー(あるいは client secret)をリポジトリ Secret に入れておくことです。
シンプルでちゃんと動きます。問題は 「キーを持っている人 = 入れる人」 という点です。
3. 問題点
3-1. 鍵をどこに置くのか
GitHub Actions が k8s クラスタにあるエージェントを呼ぶには、「入ってもいい」 ことを証明する何かが必要です。もっとも一般的な方法はこうです。
- パスワード(API キー、client secret)を 1 つ作る。
- それを GitHub リポジトリの Secret に入れておく。
- ワークフローがそのパスワードを取り出してリクエストに付ける。
この方式は、家の鍵を複製して郵便受けに入れておくのに近いです。
- 鍵は長く有効です。一度漏れると、誰がいつ使ったのか分からないまま使われ続けます。
- リポジトリにアクセスできる人、雑に書かれたワークフロー、うっかりログに出力された値。漏れる経路が多い。(Leak Risk)
- 定期的に入れ替える(ローテーション)必要があるのに、人がやる作業なので実際にはやられません。
3-2. 相手が AI エージェントなのでさらに危ない
通常の API は決まった処理しかしません。AI エージェントは「言葉で指示すればツールを選んで実際に行動する」プログラムです。キーが漏れれば、攻撃者は k8s クラスタに自然言語で命令できる窓口を手に入れます。
実際に確認した事例があります。「読み取り専用」のエージェントに参照ツール(k8s_get_resources)だけを与えたのですが、そのツールには output=json という引数がありました。エージェントに「Secret を json で取得して値を教えて」と指示したところ、テスト用 Secret の値がそのまま回答として出てきました。ツールサーバーが cluster-admin 権限で動いていたためです。
3-3. 「release ブランチの PR でだけ」という条件
私たちが求めていたのは、デプロイ直前の release/* → main の PR でだけ k8s クラスタに問い合わせられる状態でした。(どのブランチからでも kagent を使えるようにすると、いまの私たちの GPU リソースでは捌けないと判断したためです。) しかしキー方式ではこの条件を表現できません。キーは、どのリポジトリ・どのブランチ・どのワークフローで使われたのかを知らないからです。
整理すると、解決すべきことは 3 つです。
| 問題 | 問い |
|---|---|
| 長生きする秘密 | 保存した秘密なしで身元を証明できるか? |
| 呼び出し元の区別 | 「このリポジトリのこのワークフローが、release PR で」送ったと分かるか? |
| 入った後の被害 | 身元が正しくても、エージェントができることを減らせるか? |
4. シークレットレス構築 (ワークロードアイデンティティ with Keycloak)
結論はシンプルです。エージェントにアクセスするたびに発行される、短命の入館証を使います。
課題は次の 2 つです。
- どうやって入館証を毎回発行してもらうのか?
- 入館証の発行主体は誰で、どう検証するのか?
4-1. 入館証を毎回どう発行してもらうか?
GitHub Actions はワークフロー実行ごとに OIDC トークンを発行してくれます。ワークフローに権限を 1 行足すだけです。
permissions:
id-token: write # GitHub OIDC トークン
このトークンは GitHub が署名した JWT で、「いまのこの実行が何なのか」を含んでいます。
| claim | 値 (例) | 意味 |
|---|---|---|
iss |
https://token.actions.githubusercontent.com |
発行者 = GitHub |
aud |
https://auth.<ドメイン>/realms/a2a-lab |
このトークンの受け取り先 = 自分たちの Keycloak realm (リクエスト時に指定) |
sub |
repo:ken-0913@<owner-id>/a2a-ci-demo@<repo-id>:ref:refs/heads/main:job_workflow_ref:…/pr-ask.yml@refs/heads/main |
誰なのか (リポジトリ・ブランチ・ワークフローファイル) |
exp |
発行 + 5分 | 短い寿命 |
jti |
7595f28b-… |
トークン固有の番号 (再利用の防止に使う) |
リポジトリに置いた秘密がありません。トークンは実行中にのみ存在し、5 分後には使い道がなくなります。
4-2. 誰が発行しどう検証するか?
GitHub のトークンを k8s クラスタに直接信じさせることもできます。しかし私たちは Keycloak を間に挟みました。
-
権限を一箇所で管理: 「どの呼び出し元がどのエージェントを呼べるか」を Keycloak の role(
invoke)で管理します。エージェントごとにポリシーを直す必要がありません。 - 発行元が増えても同じ入館証: k8s クラスタ内の Pod(Kubernetes ServiceAccount トークン)と k8s クラスタ外の GitHub(OIDC トークン)が、どちらも同じ形式の Keycloak 入館証に変換されます。エージェントは Keycloak だけを信じればよくなります。
Keycloak 26.8 には federated client authentication があります。client secret の代わりに、外部の発行元が署名した JWT で client を認証する仕組みです。(RFC 7523 client_assertion)
設定は 2 つです。
// ① Identity Provider: GitHub OIDC を信頼する
{
"alias": "github-actions",
"providerId": "oidc",
"config": {
"issuer": "https://token.actions.githubusercontent.com",
"jwksUrl": "https://token.actions.githubusercontent.com/.well-known/jwks",
"supportsClientAssertions": "true",
"supportsClientAssertionReuse": "false" // jti は 1 回限り
}
}
// ② Client: この sub だけをこの client として認める
{
"clientId": "github-pr-ask",
"clientAuthenticatorType": "federated-jwt",
"attributes": {
"jwt.credential.issuer": "github-actions",
"jwt.credential.sub": "repo:ken-0913@<owner-id>/a2a-ci-demo@<repo-id>:ref:refs/heads/main:job_workflow_ref:ken-0913/a2a-ci-demo/.github/workflows/pr-ask.yml@refs/heads/main"
}
}
ワークフローは GitHub のトークンをそのまま Keycloak に提出します。
POST /realms/a2a-lab/protocol/openid-connect/token
grant_type=client_credentials
client_id=github-pr-ask
client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer
client_assertion=<GitHub OIDC トークン>
Keycloak が確認するもの: 署名(GitHub JWKS)・iss・aud(自分たちの realm か)・exp・sub が登録値と完全に一致するか・jti が初めて見るものか。すべて通れば 5 分間有効な access token を返します。
{ "azp": "github-pr-ask", "aud": "cluster-reader-agent",
"resource_access": { "cluster-reader-agent": { "roles": ["invoke"] } } }
同じ GitHub トークンをもう一度提出すると、こう拒否されます。
{ "error": "invalid_client", "error_description": "Token reuse detected" }
4-3. main のすべてのワークフローが同じ身元だった
デフォルトの sub はリポジトリ + ref だけです。つまり main で動くワークフローは何であれ同じ sub を受け取ります。点検用のワークフローだろうが、後から誰かが追加した別のワークフローだろうが、同じ入館証を受け取れてしまうということです。
GitHub リポジトリの OIDC 設定で、sub に ワークフローファイル(job_workflow_ref) を入れました。
gh api -X PUT repos/<owner>/<repo>/actions/oidc/customization/sub \
-F use_default=false \
-f 'include_claim_keys[]=repo' -f 'include_claim_keys[]=context' -f 'include_claim_keys[]=job_workflow_ref'
これで Keycloak client 1 つ = ワークフローファイル 1 つになります。点検用ワークフロー(a2a-check.yml)のトークンで PR コメント用の client(github-pr-ask)を騙ろうとすると拒否されます。
{ "error": "invalid_client", "error_description": "client_id parameter does not match …" }
4-4. 「release ブランチ」はトークンに入っていない
PR コメントで実行されるワークフロー(issue_comment イベント)には特徴があります。
- 常にデフォルトブランチ(main)のワークフローファイルで実行されます。PR ブランチのファイルではありません。
- そのため OIDC トークンの
subもref:refs/heads/mainになります。PR の head ブランチ(release/1.0)はトークンのどこにもありません。 - さらに Keycloak は
subを完全一致でしか比較しません。release/*のようなパターンは使えません。
つまり「release PR でだけ」は、身元(トークン)では表現できない条件です。そこで役割を分けました。
| 誰が | 何を保証するか |
|---|---|
| Keycloak | 「このトークンは このリポジトリの main にある pr-ask.yml が出したものだ」 |
pr-ask.yml (main 版) |
「release/* → main の PR で、コラボレーターが尋ねた」 |
肝は、PR の作成者がチェックのコードを変えられないという点です。PR の中で pr_ask.py のチェックを消しても、実行されるのは main 版です。そして sub の job_workflow_ref@refs/heads/main が、この事実をトークンでも裏づけてくれます。
コメント本文は信頼しない入力です。run: に ${{ github.event.comment.body }} を直接埋め込むとシェルインジェクションになります。環境変数だけで渡します。
ワークフロー — .github/workflows/pr-ask.yml(常に main 版が実行されます)
# PR コメント `/kagent <質問>` → ホームラボの kagent に A2A で問い合わせ → 回答を PR コメントに
# - issue_comment は常にデフォルトブランチ(main)のこのファイルで実行される。PR でこのファイルを変えても実行されるのは main 版
# - release/* → main の PR のみ、リポジトリのコラボレーターのコメントのみ (pr_ask.py が OIDC トークン要求の前にチェック)
# - Keycloak client github-pr-ask の sub = repo:…:context:ref:refs/heads/main:job_workflow_ref:…/pr-ask.yml@refs/heads/main
# - コメント本文は ${{ }} で run に埋め込まない(スクリプトインジェクション)。env だけで渡す
name: kagent-pr-ask
on:
issue_comment:
types: [created]
permissions:
contents: read
pull-requests: write # PR への結果コメント・リアクション (PR コメントは issues 権限では 403)
id-token: write # GitHub OIDC トークン
concurrency:
group: kagent-pr-ask-${{ github.event.issue.number }}
cancel-in-progress: false
jobs:
ask:
# startsWith は先頭の空白・改行(\r\n)があると失敗する → ここでは広く拾い、前後の空白を除いた判定は pr_ask.py が行う
if: github.event.issue.pull_request && contains(github.event.comment.body, '/kagent')
runs-on: ubuntu-latest
timeout-minutes: 10
steps:
- uses: actions/checkout@v4
- name: Ask kagent via A2A
run: python3 -E -s pr_ask.py
env:
GH_TOKEN: ${{ github.token }}
PR_NUMBER: ${{ github.event.issue.number }}
COMMENT_ID: ${{ github.event.comment.id }}
COMMENT_BODY: ${{ github.event.comment.body }}
AUTHOR_ASSOCIATION: ${{ github.event.comment.author_association }}
ワークフローの if: にはブランチの条件がありません。issue_comment イベントのペイロードには PR の head/base ブランチが含まれていないからです(issue.pull_request は URL がいくつか入っているだけです)。ブランチを知るには PR API を一度叩く必要があるため、判定は次のスクリプトが担います。
チェックのコード — pr_ask.py
"""PR コメント `/kagent <質問>` → ホームラボの kagent cluster-reader に A2A で問い合わせ、回答を PR コメントに書く。
issue_comment のワークフローは常にデフォルトブランチ(main)のファイルで実行される → PR 作成者はこのチェックのコードを変えられない。
OIDC トークンを受け取る前に、ここで止める:
1. コメント投稿者: OWNER / MEMBER / COLLABORATOR のみ
2. PR: オープンで、base = main, head = release/*, head リポジトリ = このリポジトリ (fork は拒否)
3. 質問: 空でなく 500 文字以下
Keycloak client github-pr-ask は、このワークフローファイル(pr-ask.yml)の main 実行だけを受け付ける (sub に job_workflow_ref を含む)。
コメント本文は信頼しない入力 — シェルには渡さず環境変数だけで受け取る。エージェントは読み取り専用。
"""
import json
import os
import re
import sys
from a2a_common import agent_card, github_oidc_token, http, keycloak_token, log, message_send
API = os.environ.get("GITHUB_API_URL", "https://api.github.com")
REPO = os.environ["GITHUB_REPOSITORY"]
PR = os.environ["PR_NUMBER"]
GH = {"Authorization": "Bearer " + os.environ["GH_TOKEN"], "Accept": "application/vnd.github+json"}
RELEASE = re.compile(r"^release/[A-Za-z0-9._-]+$")
ALLOWED_ASSOC = {"OWNER", "MEMBER", "COLLABORATOR"}
MAX_QUESTION = 500
def comment(body):
status, _ = http("POST", f"{API}/repos/{REPO}/issues/{PR}/comments",
json.dumps({"body": body}).encode(), {**GH, "Content-Type": "application/json"})
log("github.comment", status=status)
return status == 201
def react(content):
http("POST", f"{API}/repos/{REPO}/issues/comments/{os.environ['COMMENT_ID']}/reactions",
json.dumps({"content": content}).encode(), {**GH, "Content-Type": "application/json"})
def reject(reason):
log("rejected", reason=reason)
react("-1")
comment(f"🚫 **kagent 問い合わせ拒否** — {reason}")
return 1
def gate():
"""通過すれば (質問, head ブランチ)、そうでなければ拒否理由の文字列。"""
assoc = os.environ.get("AUTHOR_ASSOCIATION", "")
if assoc not in ALLOWED_ASSOC:
return f"コメント投稿者の権限 `{assoc}` (許可: {', '.join(sorted(ALLOWED_ASSOC))})"
status, text = http("GET", f"{API}/repos/{REPO}/pulls/{PR}", headers=GH)
if status != 200:
return f"PR の取得に失敗 ({status})"
pr = json.loads(text)
head, base = pr["head"]["ref"], pr["base"]["ref"]
head_repo = (pr["head"].get("repo") or {}).get("full_name")
log("github.pr", number=pr["number"], state=pr["state"], head=head, base=base, head_repo=head_repo)
if pr["state"] != "open":
return "クローズ済みの PR"
if head_repo != REPO:
return f"fork PR (`{head_repo}`)"
if base != "main":
return f"base ブランチ `{base}` (許可: `main`)"
if not RELEASE.match(head):
return f"head ブランチ `{head}` (許可: `release/*`)"
question = os.environ.get("COMMENT_BODY", "").strip()[len("/kagent"):].strip()
if not question or len(question) > MAX_QUESTION:
return f"質問が空、または {MAX_QUESTION} 文字を超過"
return question, head
def main():
# コマンドとみなすのは、前後の空白・改行を除いた本文が "/kagent" で始まるときだけ。文中で言及しただけのコメントは黙って無視
body = os.environ.get("COMMENT_BODY", "").strip()
if not (body == "/kagent" or body.startswith(("/kagent ", "/kagent\n", "/kagent\r"))):
log("skipped", reason="コメントが /kagent コマンドで始まっていない")
return 0
g = gate()
if isinstance(g, str):
return reject(g + " — OIDC トークンを要求していません (Keycloak・クラスタには届いていません)")
question, head = g
react("eyes")
tok = keycloak_token(github_oidc_token(), "github-pr-ask")
if not tok:
return reject("Keycloak がこのワークフロー実行の身元を受け付けませんでした (client github-pr-ask)")
agent_card()
status, task_id, state, answer = message_send(question, tok)
if status != 200:
comment(f"⚠️ kagent の呼び出しに失敗: HTTP {status}")
return 1
react("rocket")
body = "\n".join(answer) or "(回答なし)"
posted = comment(
f"🤖 **kagent `cluster-reader`** (`{head}` → `main`)\n\n"
f"> {question}\n\n{body}\n\n"
f"<sub>A2A task `{task_id}` · state `{state}` · 身元: GitHub OIDC → Keycloak a2a-lab client `github-pr-ask` "
f"(azp) · 読み取り専用エージェント</sub>"
)
return 0 if posted else 1
if __name__ == "__main__":
sys.exit(main())
a2a_common は、GitHub OIDC トークンの要求、Keycloak でのトークン交換、agent card の取得、A2A の message/send 呼び出しをまとめた共通モジュールです。
gate() を通過できなければ文字列(拒否理由)が返り、reject() が 👎 リアクションと拒否コメントを残して終了します。keycloak_token(github_oidc_token(), ...) には到達しません。 「release PR でだけ」という条件が実際に実装されているのは、この 1 行です。
if not RELEASE.match(head):
return f"head ブランチ `{head}` (許可: `release/*`)"
つまり feat/* の PR で /kagent と書いても拒否コメントが付くだけで、GitHub OIDC トークンすら発行されません。
4-5. k8s クラスタのゲートウェイとエージェントのサイドカー
入館証を受け取っても終わりではありません。 k8s クラスタ側でさらに 2 回チェックします。
① ゲートウェイ(istio-ingressgateway): 開けてある経路はちょうど 3 つです。
| 経路 | 許可 | それ以外 |
|---|---|---|
| Keycloak のトークンエンドポイント |
POST のみ |
discovery・certs・ログイン画面 → 403 |
/a2a/cluster-reader/ |
POST、Authorization: Bearer がある場合のみ |
Bearer なし → 403 (LLM まで届かない) |
/a2a/cluster-reader/.well-known/agent-card.json |
GET |
— |
② エージェント手前のサイドカー(Istio): 入館証を検証します。
# RequestAuthentication: 署名・発行者・有効期限 (違っていれば 401)
# AuthorizationPolicy: 以下をすべて満たせば通過 (そうでなければ 403)
- from:
- source:
principals: ["cluster.local/ns/istio-system/sa/istio-ingressgateway-service-account"] # ゲートウェイ経由のリクエスト
requestPrincipals: ["https://auth.<ドメイン>/realms/a2a-lab/*"]
when:
- { key: request.auth.audiences, values: ["cluster-reader-agent"] } # このエージェント向けの入館証
- { key: "request.auth.claims[resource_access][cluster-reader-agent][roles]", values: ["invoke"] } # 呼び出し権限
- { key: "request.auth.claims[azp]", values: ["github-ci", "github-pr-ask"] } # 外部から来る client のみ
azp(どの client が受け取ったトークンか)を接続経路と結びつけたのがポイントです。 k8s クラスタ内の Pod 用の入館証(azp=client-agent)を誰かが盗んで外から使っても、外部経路では GitHub の client しか受け付けないので 403 になります。
| レスポンス | どこで | 意味 |
|---|---|---|
| 401 (Keycloak) | 入館証の発行 | 身元の不一致 — 別のリポジトリ・ブランチ・ワークフロー |
| 400 (Keycloak) | 入館証の発行 | 身分証の再利用、別 client のなりすまし |
| 403 (ゲートウェイ) | 入口 | 許可経路の外、Bearer なし |
| 401 (サイドカー) | エージェント手前 | 入館証そのものが偽物・期限切れ |
| 403 (サイドカー) | エージェント手前 | 本物の入館証だが、この経路・この呼び出し元には許可されていない |
4-6. エージェントができることを減らす
身元の確認は 「誰が呼ぶのか」 だけを扱います。正当な呼び出し元の質問も、結局は LLM のプロンプトになります。そこでエージェントができること自体を別途減らしました。(§3-2 の Secret 漏洩事例を防いだ方法)
| レイヤ | やったこと | 結果 |
|---|---|---|
| Kubernetes RBAC | エージェント専用のツールサーバーを別に立て、その ServiceAccount には読み取り専用の ClusterRole だけ — Pod・job と argoproj.io の workflows は読めるが、Secret・ConfigMap・ログ・exec は含まない |
同じ「Secret を見せて」という要求 → API サーバーが拒否、値は漏れない |
| ツールサーバーのオプション | --read-only --tools k8s |
書き込み系ツールがそもそも登録されない |
| Cilium | エージェント Pod は DNS・LLM・ツールサーバーなど決まった宛先にのみ送信 | 読み取った情報をインターネットに持ち出せない |
権限はプロンプトではなく 認証情報を実際に使う場所(API サーバー) で止めてこそ、プロンプトインジェクションでも結果が変わりません。
4-7. 全体の流れ
4-8. 実際に試してみる
正常系: エージェントが実際に Argo Workflows を読めるかを、コントローラー経路(/api/a2a/a2a-server/cluster-reader/)で確認しました。PR コメント経路の認証・認可は後述の拒否系で扱います。
/kagent argo ネームスペースの Argo Workflows job の状態はどうなっていますか? ワークフロー名、ステータス、経過時間を表で教えてください。
エージェントが返した A2A artifact です。
argoネームスペースの Argo Workflow の状態は次のとおりです。
ワークフロー名 ステータス 経過時間 deploy-gate-dwjkl Succeeded 24h deploy-template-5bbj6 Failed 8d deploy-template-7xhpr Failed 8d deploy-template-vhd8l Failed 8d A2A task
01a13056-2795-73eb-91dd-89e2740b7ade· statecompleted
同時刻の kubectl -n argo get workflows と一致していました。エージェントが選んだツールは k8s_get_resources(resource_type=workflow) で、ClusterRole に argoproj.io の読み取り権限を入れる前はこの呼び出しが 403 で止まります — §4-6 の「許可するリソースを列挙する」がそのまま効いています。
拒否系: わざと弾かれるべきケースも試しました。
| 試したこと | 結果 |
|---|---|
feature/bypass の PR で、PR 内のチェックコードを消して質問 |
🚫 拒否コメント。実行されるのは main 版なので PR の変更は無視される。OIDC トークンの要求すら発生しない |
release/* 以外のブランチへの push、pull_request イベント |
Keycloak 401 (sub の不一致) |
| 同じ GitHub トークンの再利用 | Keycloak 400 Token reuse detected
|
別のワークフローのトークンで github-pr-ask をなりすまし |
Keycloak 400 |
| Bearer なし / 偽の Bearer / k8s クラスタ内 Pod 用の入館証で呼び出し | 403 / 401 / 403 |
| エージェントに「Secret を json で見せて」 | ツールが失敗、値なし |
5. まとめ
| Secret ベース | シークレットレス (ワークロードアイデンティティ + Keycloak) | |
|---|---|---|
| リポジトリに置いた秘密 | API キー 1 個以上 (有効期限なし) | 0 個 |
| 認証情報の寿命 | 変えるまで | GitHub トークン 5 分(1回限り)、入館証 5 分 |
| 漏れたら? | 誰がいつ使ったか分からないまま使われ続ける | 5 分以内、1 回だけ、決まった経路でのみ |
| 呼び出し元の区別 | キーを持つ誰でも | リポジトリ(数値 ID)・ブランチ・ワークフローファイルまで |
| 「release PR でだけ」 | 表現できない | main の信頼できるワークフローがトークン要求の前にチェック |
| ローテーション | 人がやる必要あり | 不要 |
| 権限の管理 | エージェントごとにキーを比較 | Keycloak の role で一箇所 |
整理すると、今回の作業で得られたものは 3 つです。
-
秘密を保存しない。
GitHub が実行ごとに署名してくれる身分証を Keycloak が検証し、短命の入館証に変換します。盗む鍵そのものが存在しません。 -
身元はトークンで、条件は信頼できるコードで。
トークンが証明できること(リポジトリ・main・ワークフローファイル)は Keycloak が、トークンに無いこと(release PR、コラボレーター)は PR から変更できない main のワークフローが担います。 -
身元が正しくても、できることは小さく。
AI エージェントは言葉で指示すれば行動します。権限はプロンプトではなく Kubernetes の RBAC とネットワークポリシーで止めます。
まだ残っている課題もあります。
- bearer トークン: k8s クラスタ外で使う入館証は「持っている人が使える」形式です(5 分)。送信者に結びつけるには DPoP のような方式と、別の認可コンポーネント(ext_authz)が必要です。
- 呼び出し回数の制限: 許可された呼び出しも GPU(LLM)を使います。レート制限がまだありません。
- main ブランチの保護: チェックコードの信頼境界は main ブランチです。無料の private リポジトリなのでブランチ保護が使えませんでしたが、実際のチーム環境なら main の保護 + CODEOWNERS でワークフローファイルの変更をレビュー対象に含めるべきです。
-
A2A メソッド単位の権限:
message/sendとtasks/getがどちらも同じPOST /で入ってくるため、いまは「呼び出し権限があれば全メソッド」の状態です。
パスワードを安全に保管する方法を考えるより、保管すべきパスワードをなくすこと。今回の作業で一番大きく学んだ点です。
参考
- Keycloak — Federated client authentication: no more secrets
- GitHub Docs — About security hardening with OpenID Connect / Customizing the token claims (
job_workflow_ref) - RFC 7523 — JWT Profile for OAuth 2.0 Client Authentication (
client_assertion) - RFC 6749 4.4 — OAuth 2.0 Client Credentials Grant
- A2A Protocol
- kagent
- Istio — RequestAuthentication / AuthorizationPolicy
Discussion