Google CloudがIAM Helperを発表、エージェントによる403エラーの解消を支援

IAM Helperでできること

IAM Helperは、Policy IntelligenceやPAMなど中核のIAMエンジンを補う、Google Cloud IAM向けの層です。自律型のコード支援ツールやデプロイのパイプライン、独自のエージェントから、IAMのスキルを直接呼び出せます。^[1]

図1　IAMのスキルを呼び出せる主体

Google Cloudは、IAM Helperの利用によって、最小権限とエージェントの統制を保つ管理の負担を減らし、実用性を最大化し、デプロイを速められるとしています。IAM Helper Agent Skillsは、トークンと費用の効率を最大化し、エージェントが複数段階の管理作業を自律的に実行できる設計です。

IAM Helperは、エージェントがアクセス管理を動的に扱えるようにし、ポリシー評価の負担を人の管理者やLLMsから外します。複雑な処理はGoogle Cloudのバックエンドに任せ、トークン効率を最大化して費用のかかる運用上の滞りを防ぎます。

図2　IAM Helperによるポリシー評価の分担

IAM Helperの主なスキル

IAM Helper Agent Skillsは、クラウドのアクセス管理の各段階でエージェントを導き、複数の関数やAPIを組み合わせてIAMの複雑な作業を解決できます。作業の流れや補助スクリプト、安全策をオープンなAgent Skills標準でまとめた主なスキルは、以下の通りです。

ポリシー作成時の自動検出

iam-helper-for-policy-managementは、IAM v1のallowバインディングとIAM v2のdenyルールを生成し検証します。適用前にallUsersの公開アクセスやroles/ownerとroles/editorなど広い基本ロールを自動で検出して止めます。

図3　ポリシー管理のスキルが止める設定

403エラーの原因特定

権限の不足を手作業で調べると、開発者や管理者の手間が増えます。近道でエージェントに広い権限を与えると、最小権限が損なわれかねません。

Google Cloudの利用例では、デプロイ中に403エラーが出たコーディングエージェントが、iam-helper-for-troubleshootingを使います。不足しているPub/Subの権限を特定した後、iam-helper-for-privileged-access-managementで1時間のJIT付与を申請する流れです。

図4　403エラーから権限申請までの例

役割に応じた2つのflow

iam-helper-for-troubleshootingは、403 PERMISSION_DENIEDエラーの原因となる不足権限やルールを数秒で特定します。開発者はRequester flow、セキュリティ管理者はResolver flowと、役割に応じた流れを使える仕組みです。

403 PERMISSION_DENIEDエラーが出た場合、Requester flowでは、開発者が手元で自力解除できるかを確かめるか、管理者向けの構造化したチケットを作れます。同じ場合にResolver flowでは、セキュリティ管理者が組織やフォルダ、プロジェクトの階層で継承されたallowルールとv2 denyルールをたどり、問題を解消できます。

図5　403 PERMISSION_DENIEDへの役割別の対応

PAMによる一時的な権限昇格

本番環境への一時的なアクセスでは、iam-helper-for-privileged-access-managementがPAMで必要時の認証情報を管理します。依頼者や管理者、承認者のワークフローに対応し、昇格した権限は監査され、期限付きで、作業後に自動で取り消されます。

図6　PAMのスキルによる一時的な権限昇格

HITLを含む変更前の確認

iam-helper-for-policy-simulatorは、計画、試験、分析、適用の順でエージェントを導きます。ポリシー更新やIAM Recommenderによるロール削減の前に、提案した変更を過去90日のアクセスログで試し、既存の通信が妨げられないかを確かめます。

図7　ポリシー変更前の試験の流れ

IAM Helperの各スキルは、読み取りだけの調査とポリシーの変更を分ける作りです。診断や試験は自動で進み、アクセスポリシーの変更は、カスタマイズ可能なリスク段階に応じて人の確認（HITL）を待ちます。

例えば、デプロイのパイプラインが権限で止まった場合は、IAM Helper Agent Skillsで最小権限の修正版ポリシーを作れます。修正版は、iam-helper-for-policy-simulatorで過去90日のログから稼働中のサービスへの影響を確かめ、管理者の承認へ回す流れです。

IAM Helperを支えるMCP tools

IAM Helper Agent Skillsは高いレベルのワークフローの処理を担い、共通の基盤となるMCP toolsの上に作られています。Google Cloud IAM Helper MCP toolsは、Googleが管理するMCPサーバーを通じて、読み取り専用の細かな単位の関数を提供します。^[1]

図8　IAM Helper MCP toolsの提供範囲

MCP toolsの接続先は、Policy TroubleshooterやPolicy Analyzer、Policy Simulator、IAM v1/v2 APIsです。階層のたどりやグループの展開、ポリシー評価は、専用のIAMエンドポイントで処理されます。

専用のIAMエンドポイントがまたがる範囲は、IAM v1のallowロールやIAM v2のdeny、Policy Troubleshooter、Policy Analyzerです。階層のたどりやグループの展開、ポリシー評価をこの専用エンドポイントで処理するため、IAM Helperのスキルは少ないトークン使用量で速く正確に動作します。

図9　専用のIAMエンドポイントで処理する操作

エージェントは、チームが独自のAPIラッパーを書かなくても、標準の方法でバックエンドに問い合わせて正確な答えを得られます。独自の処理が必要な場合は、権限の確認やロールの一覧取得のために、ツールを動的に見つけて呼び出せる仕組みです。

IAM Helperを使い始める場所

IAM Helper Agent Skillsは、Google Cloud Agent Skills Catalogから使い始められます。詳しい内容を確かめる入口は、公式のIAMドキュメントです。^[1]

図10　IAM Helperを使い始める前の確認

IAM Helper Agent Skillsが動作する一般的なエージェントには、Gemini CLIやGemini Cloud Assist、ADKがあります。Claude CodeやCursorも、動作の対象に含まれます。

IAM Helperの利用条件

IAM Helperの提供状態（一般提供・プレビュー）や提供地域、課金の条件は、今回の発表に含まれていません。東京や大阪のリージョンでの扱いも含め、利用前に公式のIAMドキュメントで確かめることを、編集部は勧めます。^[1]

図11　今回の発表に含まれない点と変更時の確認

IAM Helperでは、アクセスポリシーの変更を、カスタマイズ可能なリスク段階に応じて人の確認まで止める作りです。アクセスポリシーの変更をエージェントに任せる場合は、リスク段階の設定と人の確認の運用を導入前に決めておく手順を、編集部は勧めます。

目的別のIAM Helperの使い分け

IAM Helperには、作業の流れや補助スクリプトをまとめたIAM Helper Agent Skillsと、読み取り専用の関数を提供するMCP toolsがあります。チームは独自のAgent SkillsでMCP toolsを直接使い、社内のチケット管理や独自のコンプライアンス確認、既存のデプロイのパイプラインと組み合わせられる点が特徴です。^[1]

図12　IAM Helperのスキルとツールの違い

用意された流れで403エラーの調査やポリシー作成を進めたい場合は、IAM Helper Agent Skillsを使う整理が考えられます。社内のチケット管理や既存のデプロイのパイプラインと組み合わせたい場合は、MCP toolsで独自のAgent Skillsを書く方法が候補です。

本番環境への一時的なアクセスが必要な場合は、iam-helper-for-privileged-access-managementで期限付きの権限を使う方法があります。ポリシーを更新する場合は、iam-helper-for-policy-simulatorでの試験を適用前に挟む順序を、編集部は勧めます。