Psono Terraform プロバイダーのベータリリースが、パブリックの\nTerraform Registry\nで利用可能になったことをお知らせします。
\nインフラチームは、作成済みの Psono 環境変数エントリ内の個別キーを Terraform のワークフローの一部として管理できるようになりました。\nプロバイダーは既存の値の維持、新しいパスワードの生成、管理された値のローテーション、外部で供給された値の書き込み、\nTerraform の一時リソースを通じたシークレットの読み取りなどを行うことができます。
\nIaC（Infrastructure as Code）でのシークレット管理には特別な注意が必要です。\nセンシティブフラグで CLI 出力から値を隠すことはできますが、その値を Terraform の状態からも排除できるとは限りません。\nPsono プロバイダーは Terraform の「書き込み専用」と「一時的」なリソース機能を活用し、この課題を回避します（Terraform 1.11 以降が必要）。
\nプロバイダーは主に以下の 3 つのワークフローをサポートしています：
\nこれらにより、実際のシークレット値を Psono 内に保管しつつ、シークレットのライフサイクル操作を Terraform で安全に含めることが可能となります。
\nこのプロバイダーは制限された Psono API キーを使用します。\nTerraform が必要とする環境変数エントリだけを割り当て、すべての操作に対し「読み取り権限」を付与します。\nキーの作成・更新・ローテーション・削除にはさらに「書き込み権限」が必要です。\nプロバイダーは無制限の API キーを必要とせず、また金庫エントリやフォルダ、データストアの作成はできません。
\n暗号化および復号はプロバイダー内部でローカルに実行されます。\nHTTPS 証明書の検証は無効化できず、プライベート認証局（CA）は PEM 形式の CA バンドル追加により対応可能です。\n本番システムでは必ず HTTPS の Psono URL を使用してください。
\nTerraform 1.11 以上が必要です。Terraform 構成ファイルにプロバイダーを追加します：
\nterraform {\n required_version = \">= 1.11.0\"\n\n required_providers {\n psono = {\n source = \"psono/psono\"\n version = \"~> 1.0\"\n }\n }\n}\n\nprovider \"psono\" {}\nTerraform ファイルに認証情報を記載せず、環境変数で設定してください：
\nexport PSONO_SERVER_URL='https://psono.example.com/server'\nexport PSONO_API_KEY_ID='REPLACE_WITH_API_KEY_ID'\nexport PSONO_API_SECRET_KEY='REPLACE_WITH_API_SECRET_KEY'\n作業ディレクトリを初期化します：
\nterraform init\nTerraform は署名済みのプロバイダーリリースをダウンロードし、そのチェックサム署名を検証します。
\n以下のリソースは、既存の Psono 環境変数エントリ内にあるDB_PASSWORDを管理します：
resource \"psono_environment_variable\" \"database_password\" {\n secret_id = var.psono_environment_variables_secret_id\n name = \"DB_PASSWORD\"\n\n length = 32\n min_lower = 4\n min_upper = 4\n min_numeric = 4\n min_special = 4\n\n rotation_version = 1\n}\nキーがすでに存在する場合、プロバイダーは値を変更せずにそのまま引き継ぎます（アドプト）。\n存在しない場合は、Psono で新しい値を生成して格納します。\n生成された値は管理リソースから返却されず、Terraform の状態にも保存されません。
\nrotation_versionをインクリメントすると、Terraform が値の置き換えを行います。\nこの操作は、もともとアドプトまたは import した値でも置き換えるため、ローテーションの変更は適用前に慎重に確認してください。
他のプロバイダーで生成した一時的な値をvalue_woで Psono に書き込む例です：
ephemeral \"random_password\" \"database\" {\n length = 32\n}\n\nresource \"psono_environment_variable\" \"database_password\" {\n secret_id = var.psono_environment_variables_secret_id\n name = \"DB_PASSWORD\"\n value_wo = ephemeral.random_password.database.result\n value_wo_version = 1\n}\nこの値は Terraform の操作中のみ利用され、plan や state には保存されません。\n値の置き換えが必要な場合はvalue_wo_versionをインクリメントしてください。
管理リソースを削除しても、デフォルトでは Psono のキーは保持されます。\nこれは Terraform がアドプトしたが作成していない値の保護のためです。\n削除やリソース置き換え時に明示的に Psono からキーを消したい場合のみ\ndeletion_policy = \"Delete\"を設定してください。
このプロバイダーはオープンソースで、すぐにご利用いただけます：
\n\nベータリリースはあえて環境変数エントリと制限付き API キーに絞っています。\nこれにより、権限が最小限になり、無制限なボールトアクセスを避けながら、Terraform から運用シークレットを安全に管理できる、\n実用的な基盤を提供します。
","frontmatter":{"date":"August 22, 2026","slug":"introducing-the-psono-terraform-provider","title":"Psono Terraformプロバイダーのご紹介","description":"Terraformの状態にシークレットを保存せずに、Psonoで生成・書き込み専用・一時的な値を直接Terraformから管理できます。","author":"Sascha Pfeiffer","featuredImage":null}}},"pageContext":{"slug":"introducing-the-psono-terraform-provider","lang":"ja","langPathPrefix":"/ja"}},"staticQueryHashes":["2149092236","3128451518","3192060438"]}