Estamos felizes em anunciar que a versão beta do Provedor Terraform do Psono está agora disponível publicamente no\nRegistro de Provedores Terraform.
\nEquipes de infraestrutura agora podem gerenciar chaves individuais dentro das entradas de Variáveis de Ambiente já criadas no Psono como parte do seu fluxo de trabalho com Terraform. O provedor pode preservar valores existentes, gerar novas senhas, rotacionar valores gerenciados, gravar valores fornecidos externamente e ler segredos através de recursos efêmeros do Terraform.
\nO tratamento de segredos em infraestrutura como código exige cuidados especiais. Uma flag de sensibilidade pode esconder um valor da saída padrão do CLI, mas isso não necessariamente impede que esse valor seja salvo no estado do Terraform. O provedor do Psono utiliza as capacidades de somente escrita e recursos efêmeros do Terraform para evitar esse problema e requer o Terraform 1.11 ou superior.
\nO provedor suporta três fluxos de trabalho comuns:
\nIsso torna possível incluir operações do ciclo de vida de segredos no Terraform enquanto mantém os valores reais no Psono.
\nO provedor utiliza uma chave de API restrita do Psono. Você atribui apenas as entradas de Variáveis de Ambiente que o Terraform precisa e concede permissão de leitura para todas as operações. Para criar, atualizar, rotacionar ou excluir chaves, é necessário permissão de escrita adicionalmente. O provedor não precisa de uma chave de API irrestrita e não pode criar entradas de cofres, pastas ou depósitos de dados.
\nA criptografia e descriptografia ocorrem localmente no provedor. A verificação do certificado HTTPS não pode ser desativada, e autoridades certificadoras privadas podem ser adicionadas através de um bundle PEM de CA. Sistemas em produção devem sempre usar uma URL Psono com HTTPS.
\nÉ necessário o Terraform 1.11 ou mais recente. Adicione o provedor à sua configuração do 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\" {}\nConfigure as credenciais por variáveis de ambiente em vez de colocá-las nos arquivos do Terraform:
\nexport PSONO_SERVER_URL='https://psono.example.com/server'\nexport PSONO_API_KEY_ID='SUBSTITUA_PELO_ID_DA_API_KEY'\nexport PSONO_API_SECRET_KEY='SUBSTITUA_PELO_API_SECRET_KEY'\nDepois, inicialize o diretório de trabalho:
\nterraform init\nO Terraform baixa a versão assinada do provedor e verifica sua assinatura de checksum.
\nO recurso abaixo gerencia o DB_PASSWORD em uma entrada existente de Variáveis de Ambiente do Psono:
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}\nSe a chave já existir, o provedor a adota sem alterar seu valor. Se não existir, o provedor gera e armazena um novo valor no Psono. O valor gerado não é retornado pelo recurso gerenciado e não entra no estado do Terraform.
\nIncremente o rotation_version quando o Terraform precisar gerar uma substituição. Isso também substitui valores que foram originalmente adotados ou importados, portanto, mudanças de rotação devem ser revisadas antes de aplicá-las.
Um valor efêmero de outro provedor pode ser gravado no Psono com o value_wo:
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}\nO valor fica disponível durante a operação do Terraform, mas não é armazenado no plano ou estado. Incremente o value_wo_version quando o Terraform precisar gravar uma substituição.
Destruir um recurso gerenciado mantém sua chave no Psono por padrão. Isso protege valores que o Terraform adotou, mas não criou. Defina deletion_policy = \"Delete\" apenas quando o Terraform deve remover explicitamente a chave do Psono durante a destruição ou substituição do recurso.
O provedor é open source e está disponível hoje:
\nA versão beta foca deliberadamente em entradas de Variáveis de Ambiente e chaves de API restritas. Isso mantém permissões reduzidas, evita acesso irrestrito ao cofre e proporciona uma base prática para gerenciar segredos operacionais com segurança a partir do Terraform.
","frontmatter":{"date":"August 22, 2026","slug":"introducing-the-psono-terraform-provider","title":"Apresentando o Provedor Terraform do Psono","description":"Gerencie valores gerados, somente de escrita e efêmeros no Psono diretamente pelo Terraform sem armazenar segredos no estado do Terraform.","author":"Sascha Pfeiffer","featuredImage":null}}},"pageContext":{"slug":"introducing-the-psono-terraform-provider","lang":"pt","langPathPrefix":"/pt"}},"staticQueryHashes":["2149092236","3128451518","3192060438"]}