AIエージェント認可APIキー管理DifyCopilot StudioWorkload IdentitySecret Manager

Dify・Copilot Studio・社内スクリプトの「APIキー直書き」が招く統制崩壊と解消手順

目安: 10分

DifyやMicrosoft Copilot Studioなどの生成AIワークフロー基盤、あるいは業務自動化を担う社内Pythonスクリプトの導入が進む現場で、最も多く見られる統制不備が「APIキー・OAuthトークンの直書き(ハードコーディング)」と「複数システムでの共有キー使い回し」です。

本記事では、OWASP・NIST・IPAおよび主要プラットフォームの公式ドキュメントに基づき、直書き・共有キー運用が招くインシデント構造を整理したうえで、Dify・Copilot Studio・3大クラウドの公式シークレット管理仕様と、キーレス認証・自動ローテーションへ段階的に移行するための実務手順を解説します。

[!IMPORTANT] 要点サマリー

  • 生成AI特有の増幅リスク: 従来のGit・CI/CDログ漏洩に加え、プロンプトインジェクション(LLM01)や過剰権限(LLM06)と結びつくことで、直書きされた特権キーが自律アクションや外部送信に悪用されるリスクが高まります。
  • プラットフォーム標準の活用: Difyの KEY_PROVIDER_TYPE=azure-keyvault やCopilot StudioのAzure Key Vault環境変数+タグ制御(AllowedBots / AllowedEnvironments)など、各基盤のネイティブ保護機能を初期設計に組み込む必要があります。
  • 3段階の移行ロードマップ: ①GitHub Push Protectionによる即時封じ込め、②Managed Identity / Workload Identity Federationによるキーレス化、③Secret Managerの4段階ローテーションと役割分離の順で、業務を止めずに移行します。

1. 「直書き」と「共有キー運用」が招く統制崩壊の構造

OWASP Secrets Management Cheat Sheetは、APIキーやDB認証情報を平文のままソースコードや設定ファイルへ直書きする行為を典型的なアンチパターンとして警告しています。生成AIや自動化の現場では、以下の3つの経路で被害が拡大します。

1.1 Git履歴・CI/CDログ・フォーク経由の流出

開発中に検証用として記述したキーがGitリポジトリにコミットされると、後から削除しても履歴に残り続けます。また、CI/CDパイプラインの環境変数に長寿命の認証情報を設定している場合、ビルドログやエラー出力への平文露出や、リポジトリのフォーク・ジョブ複製に伴う意図しない権限引き継ぎが発生します。なお、漏洩した動的・静的クレデンシャルは、アプリを再起動しただけでは失効せず、バックエンド側で明示的に失効(Revoke)手続きを行わない限り有効なまま残ります。

1.2 共有キー運用による影響範囲の不透明化と退職者リスク

単一のAPIキーや個人発行のサービスアカウントキーを複数のDifyワークフローや社内スクリプトで共有していると、不正利用が発覚しても「どのワークフロー・誰の操作が原因か」を監査ログから切り分けられません。さらに、キーを無効化すれば依存する全業務が停止するため更新が先送りされ、結果として退職者や異動者が退職後も社内システムへアクセスできる状態が温存されます。

1.3 OWASP Top 10 for LLM Applications にみる生成AI特有の脅威

AIエージェントが自律的にツールを呼び出す環境では、シークレット管理の不備がOWASP Top 10 for Large Language Model Applicationsの主要リスクと直結します。

リスク分類(OWASP LLM Top 10)シークレット管理不備による影響典型的なインシデントシナリオ
LLM06:2025 Excessive Agencyツール用APIキーに過剰な権限が付与され、意図しない破壊的・変更操作が実行される要約用メール連携プラグインに削除権限付きAPIキーを渡し、プロンプトインジェクションで受信トレイが全削除される(LLM06:2025)
LLM02:2025 Sensitive Information Disclosure不適切に保持された環境変数や過剰権限キーで取得したバックエンド情報が応答へ混入するハードコードされた内部APIキーや設定値が巧妙なプロンプトで抽出され、チャット画面に平文出力される(LLM02:2025)
LLM01:2025 Prompt Injection外部文書やWebページの指示により、直書きされた特権トークンが外部通信へ悪用される間接プロンプトインジェクションにより、エージェントが保持する特権SaaSトークンを使って外部サーバーへデータを送信する(LLM01:2025)

AIエージェントの権限委任と最小権限設計の全体像については、AIエージェントに社内システムを安全に操作させるMCP・OAuth委任認可の設計原則もあわせて参照してください。


2. 主要基盤における公式シークレット管理仕様

直書きを排除するには、各プラットフォームが公式に用意している暗号化・Vault連携・アイデンティティ認証の仕組みを正しく適用する必要があります。

2.1 Difyの環境変数・暗号化鍵管理とプラグイン署名検証

Difyをセルフホスト運用する場合、システム全体の暗号化設計を誤ると「既存ワークスペースの外部APIキーが復号不能になる」などの重大な障害につながります。

  • SECRET_KEY の永続保護: .env に設定する SECRET_KEY はJWT署名やシステムレベルのOAuth認証情報の暗号化に用いられます。空のまま起動するとストレージ内の .dify_secret_key が使われますが、アップグレードやリストア時に鍵が変化すると既存トークンや暗号化済み認証情報が読み取れなくなるため、厳重なバックアップと固定管理が必須です(Environment Variables - Dify Docs)。
  • KEY_PROVIDER_TYPE によるVault連携: ワークスペース単位の外部APIキー暗号化鍵は、デフォルトの local(ストレージ上にRSA鍵ペア保存)ではなく、エンタープライズ環境では azure-keyvault の指定が推奨されます。DefaultAzureCredential によりプライベートキーをVault外へ出さずに保護でき、AZURE_KEYVAULT_ROTATION_INTERVAL_DAYS で自動ローテーション間隔も制御できます(local と azure-keyvault 間に互換性はないため構築初期の決定が必要です)。
  • プラグイン署名検証: サードパーティ製プラグイン経由の認証情報窃取を防ぐため、公開鍵暗号方式によるサードパーティ署名検証(Dify Docs)を有効化し、承認済みプラグインのみを実行許可します。

2.2 Microsoft Copilot Studio / Power Platform の Azure Key Vault 連携

Copilot StudioやPower Platformでは、シークレットをDataverseに平文保存せず、環境変数(データ型:Secret)から「Azure Key Vault」を参照する構成が公式標準です(Configure secrets in Azure Key Vault(Microsoft Learn)、Use environment variables for Azure Key Vault secrets)。

  1. 最小権限RBAC: Dataverseサービスプリンシパルおよび「Microsoft Copilot Studio Service」に対し、対象Key Vaultの Key Vault Secrets User ロールのみを付与します。
  2. タグによる境界制御: Key Vault側のシークレットに AllowedBots(許可するコパイロットID)や AllowedEnvironments(許可する環境ID)タグを設定し、同一テナント内であっても未承認のボットからの参照を遮断します。
  3. Pythonバックエンドの標準化: 連携する社内Pythonスクリプトでは認証情報を記述せず、Azure Identityライブラリの DefaultAzureCredential を用いて、開発環境から本番コンテナまでソース変更なしでWorkload Identity / マネージドID認証へ統一します。

2.3 AWS Secrets Manager の無停止4段階ローテーション

AWS環境では、AWS KMSで暗号化されたAWS Secrets Managerを利用し、Lambda関数による無停止の自動ローテーションを実装します。ローテーションは以下の4フェーズで厳密に制御されます(Lambda rotation functions)。

  1. createSecret: 現行キーを変更せず、新バージョンをステージングラベル AWSPENDING として生成します。
  2. setSecret: AWSPENDING の新シークレットを、対象DBや外部SaaSへAPI経由で反映します。
  3. testSecret: 新シークレットで実際に認証テストを実行します。失敗時は即座に中断され、本番接続の障害を防ぎます。
  4. finishSecret: テスト成功後にのみ AWSCURRENT へ昇格させ、旧バージョンへ AWSPREVIOUS を付与して即時ロールバック可能性を確保します。

マルチリージョン構成でのDR要件がある場合は、クロスリージョン/クロスアカウントレプリケーションとスタンドアロン昇格機能により可用性を担保します。

2.4 Google Cloud Secret Manager と Workload Identity Federation

Google Cloudでは、Secret Managerによるバージョン管理・CMEK暗号化・バージョン単位の無効化/破棄(Disable / Destroy)に加え、CI/CDや外部スクリプトからの静的サービスアカウントJSONキーを完全に廃止する「Workload Identity Federation(WIF)」の採用が推奨されます(Workload Identity Federation)。

比較観点従来のサービスアカウントJSONキーWorkload Identity Federation(WIF)
クレデンシャルの寿命永続的(手動で無効化するまで有効)短命(Short-lived。数十分〜数時間で自動失効)
漏洩時の影響インターネット上のどこからでも利用可能属性条件により特定リポジトリ・特定ブランチ等の実行文脈に限定
ローテーション負荷手動再発行・再配布の運用が継続発生不要(OIDCトークンとの動的交換によりキーレス化)
監査証跡の粒度サービスアカウント単位の記録にとどまるIdP側の属性(リポジトリ名・ジョブ主体等)まで特定可能

3. 個人キー直書きからモダン管理への段階的移行手順(3フェーズ)

現場の開発スピードや既存業務を止めずに統制を回復するには、以下の3フェーズで段階的に移行を進めることが実務的です。

第1フェーズ:流出経路の即時遮断と既存シークレットの棚卸し

まず、新たな直書きがリポジトリへ混入するのをプロトコルレベルで防止します。GitHubを利用している場合は、組織全体でPush protection(GitHub Docs)を有効化し、シークレットを含むコミットのプッシュを自動ブロックします。

  • 委任バイパス(Delegated Bypass): テスト用ダミー値などで例外が必要な場合でも、開発者個人の単独バイパスを禁止し、セキュリティ担当者の承認を必須とするDelegated bypassを構成します。
  • カスタムパターンと有効性確認: 社内独自フォーマットのトークンはCustom patternsで検知対象に追加し、検知済みアラートはValidity checksで「現在も有効なキー」を優先トリアージして即時失効・再発行します。

第2フェーズ:静的キーの廃止とアイデンティティ認証・Vault集約

次に、バックエンドのPythonスクリプトやCI/CDジョブに残る静的認証情報を置き換えます。

  • キーレス認証への切り替え: クラウド内部通信やCI/CDデプロイは、Azure Managed Identity、AWS IAM Role、Google Cloud WIFへ切り替え、アプリケーション側が認証情報を持たない設計へ移行します。
  • 外部LLM / SaaSキーのVault集約: 外部LLMプロバイダー等のAPIキーのようにアイデンティティ連携が未対応のものは、各クラウドのSecret Manager / Key Vaultへ移設し、アプリ起動時または実行時にメモリ上へ動的取得する構成へリファクタリングします。共有キーは廃止し、ワークフロー・サービス単位でキーを分離します。

第3フェーズ:Short-lived Token と自動ローテーションの定着

最終段階として、万が一メモリダンプやプロンプト経由で情報が漏洩しても被害を極小化するため、有効期限の短縮と自動更新を定着させます。AWS Secrets ManagerのLambdaローテーションやGoogle Cloud Pub/Sub連携による定期自動更新を組み込み、可能であればDBアクセス等にオンデマンドで数十分単位の認証情報を払い出す動的シークレット(Dynamic Secrets)を採用します。


4. 監査観点と公的鍵管理指針(NIST SP 800-57 / IPA)

技術移行と並行し、内部監査およびセキュリティ規程へ以下のガバナンス要件を組み込む必要があります。

  • ライフサイクルとクリプトピリオドの定義: NIST SP 800-57 Part 1およびIPA『暗号鍵管理ガイドライン』に基づき、APIキーや暗号鍵ごとに有効期間(クリプトピリオド)と状態遷移(生成・活性化・一時停止・非活性化・破棄)を定義します。退職者の関与や漏洩疑いが生じた際に即座に無効化・再配布できる「侵害回復計画」の事前文書化も必須です。
  • 役割分離(Separation of Duties): IPA『暗号鍵管理システム設計指針(基本編)』が求める通り、シークレットを生成・更新・破棄する「運用担当者」と、その妥当性を検証する「監査担当者」の権限を分離し、同一人物による単独操作を防ぎます。
  • 平文を含まない監査証跡の保全: 誰が・どのワークフローから・いつシークレットを参照またはローテーションしたかのコンテキストをCloudTrailやCloud Audit Logsへ記録し、平文シークレット自体をログへ残さずに検証できる体制を整えます。監査ログ設計の詳細は「誰の権限でAIが実行したか」を追跡する監査ログ設計と内部統制の実装ポイントも参照してください。

AIエージェント・ワークフロー基盤のシークレット統制支援

Dify・Copilot Studio・社内Pythonスクリプトが混在する環境では、業務を止めずにキーの棚卸しからVault集約、Workload Identity移行までを一貫して進める設計が求められます。

AI Nexusでは、既存ワークフローのシークレット露出診断、クラウド標準Vault・キーレス認証への移行設計、およびNIST・IPA準拠の権限・監査ガバナンス構築を支援しています。

記事連動・実務用チェックリスト(PDF無料)

AIエージェント本番稼働前「キルスイッチ・HITL」承認設計チェックリスト

操作リスクTier分類、Out-of-Band人間承認、Egress既定拒否、緊急停止キルスイッチ、End-to-End監査ログの実装完了判定シート。

関連ソリューション / 認可・エージェント統制

AgentSecure DX(AIエージェント認可・統合支援)

MCP / OAuth委任認可・監査ログ設計

AIエージェントへのAPIキー直書きを廃し、権限委任・Human-in-the-loop承認・監査ログを実装するための技術支援メニューです。

情シス・DX推進部門向け 無料診断

自社のAI利用リスク・シャドーAI対策を整理しませんか?

「規程が追いつかない」「RAGやAIエージェントの権限設計に不安がある」といった課題に対し、現状の棚卸しから現実的な統制ラインの設計まで、30分のオンライン相談で方向性を整理します。