Gerenciamento de secrets

Armazenamento seguro de credenciais

Quando seu aplicativo precisa se conectar a serviços externos — como enviar e-mails por meio do SendGrid, processar pagamentos com Stripe ou usar OpenAI para recursos de IA — você precisa armazenar com segurança as chaves e credenciais de API. O sistema de gerenciamento de secrets do Kliv cuida disso automaticamente.

O que torna os secrets seguros:

  • Armazenamento criptografado no banco de dados
  • Nunca exibido por completo depois de salvá-los
  • Injetado automaticamente em Edge Functions quando necessário
  • Em toda a conta para que você armazene cada chave apenas uma vez
  • Trilhas de auditoria rastreando quando secrets foram criados ou atualizados

Como funcionam os secrets

Quando você informa à IA que deseja integrar-se a um serviço externo, ela solicitará as credenciais necessárias. Depois de fornecer uma chave de API, a IA a armazena de forma segura com um nome descritivo (como OPENAI_API_KEY ou STRIPE_SECRET_KEY). A partir de então, qualquer função de borda que precise dessa credencial poderá acessá-la automaticamente.

Exibição mascarada: depois de salvar um secret, você verá apenas uma versão parcialmente mascarada na interface do administrador. Por exemplo, sk-proj-abc123xyz789 aparece como sk-p****9789. Isso permite verificar qual chave é qual sem expor o valor completo.

Injeção automática: quando uma função de borda é executada, os secrets que ela referencia são injetados com segurança para aquela execução. A IA escreve a função para lê-los por meio da interface de secrets da plataforma, e a plataforma fornece o valor real em tempo de execução — assim, uma chave rotacionada passa a valer na próxima execução da função.

Gerenciando secrets

Através da interface administrativa, você pode:

  • Ver todos os seus secrets (com valores mascarados)
  • Adicionar novos secrets ou atualizar os existentes
  • Excluir secrets de que você não precisa mais
  • Ver quando cada secret foi criado ou atualizado pela última vez

A IA também pode criar e atualizar secrets para você quando você descreve integrações que deseja construir.

Usos comuns para secrets

  • Serviços de e-mail: credenciais SendGrid, Mailgun ou SMTP
  • Processamento de pagamento: Stripe, PayPal ou outras chaves de API de pagamento
  • Serviços de IA: chaves OpenAI, Anthropic ou Google API
  • SMS/chamadas: tokens de autenticação Twilio
  • APIs externas: qualquer serviço de terceiros ao qual seu aplicativo se integra
  • Webhooks: assinatura de secrets para verificar webhooks recebidos
  • Conexões de banco de dados: cadeias de conexão para bancos de dados externos

Melhores práticas

✅ Use nomes descritivos - Nomeie os secrets claramente como SENDGRID_API_KEY em vez de key1 ou secret.

✅ Faça a rotação regularmente - Atualize os secrets periodicamente, especialmente para serviços críticos.

✅ Excluir quando terminar - Remova secrets de serviços que você não usa mais.

❌ Não compartilhe secrets - Cada ambiente (teste, produção) deve usar chaves de API diferentes.

❌ Não faça commit no código - Os secrets são armazenados separadamente do seu código por um motivo. Nunca coloque chaves de API diretamente em seus arquivos de origem.


Documentação relacionada: