OIDC接続の疎通確認

Anthropic Console側でOIDC連携の登録は済みましたが、まだGitHub Actions側からのトークン交換が発生していないため、Anthropic Consoleの接続テストは「認証を待機中…」のまま停止しています。実際にトークン交換が動くことを確認するため、Anthropic Consoleが生成した接続テスト用のワークフローをリポジトリに配置し、プルリクエストで起動させます。

疎通が確認できたらテスト用ワークフローは削除し、次のセクションでAIレビュー用のワークフロー作成に進みます。

1. サブジェクトパターンの修正

Anthropic Consoleのウィザードが自動生成したサブジェクトパターンは repo:<owner>/<repo>:* の形式ですが、GitHub Actionsが実際に発行するOIDCトークンの sub クレームは、リネームへの耐性のため 数値IDが埋め込まれた形式(repo:<owner>@<owner_id>/<repo>@<repo_id>:<event>)になっています。このままだと接続テストで match_subject_prefix エラーになるので、フェデレーションルールのサブジェクトパターンをこの形式に合わせて修正します。

1.1 GitHubの数値IDを確認する

先ほど作成したGitHubリポジトリに対して、ご自身の 数値ユーザID と 数値リポジトリID を取得します。

まず、ユーザIDを確認します(<your-username> はご自身のGitHubユーザ名に置き換えてください)。

curl https://api.github.com/users/<your-username>

以下のような出力の "id" の値をメモします。

{
  "login": "<your-username>",
  "id": 46599122,
  ...
}

続いて、リポジトリIDを確認します。

curl https://api.github.com/repos/<your-username>/ai-review-handson

以下のような出力の "id" の値をメモします。

{
  "id": 1383273738,
  "name": "ai-review-handson",
  ...
}

1.2 サブジェクトパターンの書き換え

Anthropic Consoleで 「APIキー」→「ワークロード ID フェデレーション」→「ルール」タブ → ai-review-handson を開き、右上の「編集」をクリックします。

サブジェクトパターン の値を、以下の形式に書き換えます。

repo:<your-username>@<user_id>/ai-review-handson@<repo_id>:pull_request

具体例(your-username=kymx1983、user_id=46599122、repo_id=1383273738 の場合):

repo:kymx1983@46599122/ai-review-handson@1383273738:pull_request

「追加のクレーム条件」はそのままで問題ありません。画面下部の「保存」をクリックして修正を反映します。

📝 サブジェクトパターンの補足
GitHub Actionsは、リポジトリやユーザがリネーム/削除されて再作成された場合に信頼条件が壊れることを防ぐため、sub クレームに数値IDを埋め込んだ形式を使います。数値IDはリネームでは変わらない値なので、この形式でパターンを固定すると「リポジトリ名を悪意ある第三者が同名で再取得しても認証が通らない」状態を作れます。

2. 接続テストワークフローの配置

Anthropic Consoleの「ワークロードを接続」ウィザード最後で表示された anthropic-wif-test.yml を、リポジトリに配置します。コピーしていない場合は、Anthropic Consoleで対象のフェデレーションルールを開き、テスト用ワークフローを再表示してコピーしてください。

Visual Studio Codeのエクスプローラーで ai-review-handson フォルダを右クリックし、「新しいフォルダー」から .github/workflows を作成し、その中に anthropic-wif-test.yml を作成します。

ai-review-handson
├── app.py
└── .github/
    └── workflows/
        └── anthropic-wif-test.yml  ← このファイルを作成

作成したファイルに、Anthropic Consoleからコピーしたテスト用YAMLをそのまま貼り付けて保存します。ご自身の環境では以下のような形になっているはずです(federation_rule_id / organization_id / service_account_id / workspace_id の値はご自身のものになります)。

name: anthropic-wif-test
on: pull_request
permissions:
  id-token: write
  contents: read
jobs:
  call-claude:
    runs-on: ubuntu-latest
    steps:
      - name: Fetch GitHub OIDC token
        uses: actions/github-script@v8
        with:
          script: |
            const token = await core.getIDToken('https://api.anthropic.com');
            core.setSecret(token);
            core.exportVariable('JWT', token);
      - name: Exchange for an Anthropic access token
        run: |
          curl -sS https://api.anthropic.com/v1/oauth/token \
            -H "content-type: application/json" \
            --data @- <<JSON | jq 'with_entries(if (.key | test("token$")) then .value = "<redacted>" else . end)'
          {
            "grant_type": "urn:ietf:params:oauth:grant-type:jwt-bearer",
            "assertion": "$JWT",
            "federation_rule_id": "fdrl_xxx...",
            "organization_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
            "service_account_id": "svac_xxx...",
            "workspace_id": "wrkspc_xxx..."
          }
          JSON

主要な部分を解説します。

permissions:
  id-token: write
  contents: read

id-token: write は、GitHub ActionsのランナーがOIDCトークンを取得するために必要な権限です。OIDC連携を使うワークフローには必ず付与します。

- name: Fetch GitHub OIDC token
  uses: actions/github-script@v8
  with:
    script: |
      const token = await core.getIDToken('https://api.anthropic.com');

audience として https://api.anthropic.com を指定してOIDCトークンを取得します。このaudience値は、後段のトークン交換先であるAnthropicに向けたトークンであることを主張するために使います。

- name: Exchange for an Anthropic access token
  run: |
    curl -sS https://api.anthropic.com/v1/oauth/token \
      ...

取得したOIDCトークンを、Anthropicのトークン交換エンドポイント (/v1/oauth/token) に渡し、短命なアクセストークンと引き換えます。federation_rule_id / organization_id / service_account_id / workspace_id の4つの識別子で、どのルールに対する認証かをAnthropic側に伝えます。

3. プルリクエストからの起動

このワークフローは on: pull_request で動くため、mainへの単純なpushでは起動しません。プルリクエストを開いて起動させます。

まず、追加したファイルをmainブランチにコミット・pushします。

git add .github/workflows/anthropic-wif-test.yml
git commit -m "Add OIDC connectivity test workflow"
git push origin main

続いて、疎通確認用の別ブランチを作成します。今回のワークフローは on: pull_request トリガーで設定したので、実行するにはプルリクエストを開く必要があります。プルリクエストは「あるブランチの内容を別のブランチに取り込む提案」なので、main に対して差分を持つ別ブランチが必要です。ここではその差分を作る作業ブランチとして test/oidc を作成します。

git switch -c test/oidc

軽微な変更として、README.md を新規作成します。Visual Studio Codeのエクスプローラーで ai-review-handson フォルダを右クリックし、「新しいファイル」から README.md を作成します。

ai-review-handson
├── app.py
├── README.md  ← このファイルを作成
└── .github/
    └── workflows/
        └── anthropic-wif-test.yml

作成したファイルに以下の内容を記述して保存します。

# ai-review-handson

コミット・pushします。

git add README.md
git commit -m "Trigger OIDC test"
git push -u origin test/oidc

GitHubのリポジトリページで test/oidc ブランチから main に対するプルリクエストを作成します。プルリクエストが作成されると、anthropic-wif-test ワークフローが自動的に走ります。

4. 認証成功の確認

GitHub Actions側とAnthropic Console側の両方で成功を確認します。

4.1 GitHub Actions側

リポジトリの「Actions」タブで anthropic-wif-test ワークフローの実行が緑になっていることを確認します。Exchange for an Anthropic access token ステップのログを開くと、以下のようなJSONレスポンスが表示されているはずです(トークン本体は自動でマスクされます)。

{
  "access_token": "<redacted>",
  "token_type": "Bearer",
  "expires_in": 3600,
  ...
}

access_token が返っていれば、GitHub Actions → Anthropicのトークン交換が成立しています。

4.2 Anthropic Console側

Anthropic Consoleで、対象のフェデレーションルール ai-review-handson を開き、上部のタブを 「接続テスト」 に切り替えます。ページ下部の 「認証ログ」 セクションに、直近のトークン交換が「成功」(緑丸)として記録されているはずです。前節「サブジェクトパターンの修正」の書き換え前に走った試行があれば、そちらは「拒否」(赤丸、match_subject_prefix)としてタグ付きで並びます。

該当のエントリをクリックすると、Anthropic側が検証したJWTのクレーム一覧が展開されます。ここで sub / repository / repository_owner_id などがフェデレーションルールの一致条件と噛み合っていたことを意味します。

⚠️ match_subject_prefix エラーで失敗する場合
認証ログのエントリに match_subject_prefix タグが付いている場合、サブジェクトパターンとJWTの sub クレームが一致していません。多くは前節「サブジェクトパターンの修正」の書き換えを忘れているか、<user_id> / <repo_id> の値が誤っているケースです。認証ログのエントリを展開してJWTクレーム欄に表示される sub の値を、フェデレーションルールのサブジェクトパターンに書き写す形で合わせ直してください。
⚠️ その他の認証エラーが出る場合
ワークフローに permissions: id-token: write が付いていないと、OIDCトークン自体が取得できずに失敗します。また、必須クレーム(repository_owner_id など)の数値がずれていても弾かれます。認証ログのエントリを展開して reason に相当する値をまず確認し、失敗理由に応じてフェデレーションルールを修正してください。

これでOIDC連携の疎通確認は完了です。次のセクションで、AIレビュー用のワークフローを構築していきます。

💡 ポイント
疎通確認用の anthropic-wif-test.yml は、そのまま残しておいても、削除しても構いません。次のセクションで作成するAIレビュー用ワークフローとは別ファイルなので競合はしません。以降のプルリクエストで空回りのトークン交換が走るのが気になる場合は、.github/workflows/anthropic-wif-test.yml を削除してmainにpushしておきます。