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: