mcpField
I
infisical-terraform

infisical-terraform

github.com/infisicalクラウド・DevOps36493 回インストール1 週間前に更新
リポジトリ

infisical-terraform について

infisical-terraformは、Infisical Terraform providerでInfisicalのリソースを管理し、HCLからシークレットを読み取るためのスキルです。プロバイダー認証、Terraformのリソースとデータソース、Terraform CloudのOIDC設定を扱います。

主な機能

  1. 01プロバイダー認証と設定の案内
  2. 02シークレットとデータソースのHCLパターン
  3. 03プロジェクトロールとアクセス承認のリソース
  4. 04Terraform CloudのOIDC設定
  5. 05エフェメラルなシークレットリソースの案内

活用シーン

  1. 01TerraformでのInfisical認証設定
  2. 02状態ファイルに保存せずHCLからシークレットを取得
  3. 03プロジェクトロールとアクセス承認ポリシーの定義
  4. 04Terraform CloudとInfisicalのOIDC設定

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/infisical/ai-skills --skill infisical-terraform

インストール後、Claude Code で/infisical-terraformを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
provider-setup.md
resources-and-data-sources.md
terraform-cloud-oidc.md

詳細

Infisical Terraform Provider

ユーザーが Infisical のシークレット管理を Terraform インフラストラクチャに自信を持って統合できるように支援します。

このスキルが対象としないもの

ユーザーがやりたいこと...使用するもの
実行中のアプリ、コンテナ、パイプラインにシークレットを渡すinfisical-setup
HCL ではなく生の REST API 呼び出しinfisical-api
サードパーティサービスにシークレットをプッシュするinfisical-secret-syncs
オンデマンドの一時的なデータベース認証情報infisical-dynamic-secrets
ロールと権限モデルの設計infisical-access-control
Terraform 経由で Gateway または Relay をデプロイするinfisical-gateway
Infisical 自体をデプロイするinfisical-self-host

このスキルは Infisical Terraform Provider に関するものです — Infisical リソースの管理と、HCL からの シークレットの読み取りを扱います。Terraform 全般の使い方に関するものではありません。

ユーザーがよく尋ねる内容

  • 「Infisical を Terraform で使うにはどうすればいいですか？」 — Provider のセットアップと認証
  • 「Terraform の state にシークレットが入らないようにするにはどうすればいいですか？」 — Ephemeral リソース
  • 「Terraform Cloud と Infisical を連携させるにはどうすればいいですか？」 — OIDC 統合
  • 「プロジェクトのロールと権限を設定するにはどうすればいいですか？」 — ロール定義
  • 「Ephemeral とデータソースの違いは何ですか？」 — リソースパターン

クイックルーティング

守るべき主要な原則

  1. 認証情報はネストされた auth 属性の内部に記述します: Provider は auth = { universal = { client_id, client_secret } } または auth = { oidc = { identity_id, token_environment_variable_name } } を受け取ります。 client_id、client_secret、identity_id を provider "infisical" ブロックに直接記述しないでください — それはサポートされていない引数であり、plan 時に失敗します。(レガシーの service_token が唯一の 例外で、トップレベルに配置します。)
  2. Ephemeral シークレットのキーは name です: ephemeral "infisical_secret" は name、workspace_id、env_slug、および省略可能な folder_path を取ります。secret_key という引数はありません。
  3. state よりも Ephemeral を優先: シークレットには常に ephemeral リソース (Terraform 1.10 以降) を 推奨してください — 値が state ファイルに残ることはありません。Ephemeral 値を含む output は、それ自体を ephemeral = true としてマークする必要があります。
  4. マシン ID 認証: Universal Auth または OIDC を使用し、Service Token (レガシー) は決して使用しないでください。
  5. 権限の v2 フォーマット: permissions_v2 (subject/action 構造) を使用し、permissions (v1) は非推奨とします。
  6. Terraform Cloud には OIDC: これが推奨される本番パターンです。
  7. Provider のソース: Terraform Registry の infisical/infisical を使用し、コミュニティ Provider は使用しないでください。
  8. フォルダパスのデフォルト: 省略した場合、folder_path = "/" になります。
  9. セルフホストには host が必要: Provider ブロックに host 属性を設定してください。サイト URL の環境変数は存在しません。

ユーザーをリファレンスへ誘導すべき場合

  • 認証の混乱や環境変数のセットアップ → provider-setup.md
  • シークレット、ロール、承認ポリシー用の HCL の作成 → resources-and-data-sources.md
  • TFC + Infisical の手順 → terraform-cloud-oidc.md

コメント

Markdown 対応