Gestão de segredos para desenvolvedores: ferramentas e práticas recomendadas para proteger credenciais

Projects

Adicione serviços, gere credenciais e gerencie o faturamento pela CLI, ou deixe seu agente fazer isso.

Saiba mais 
  1. Introdução
  2. Principais conclusões
  3. Por que as práticas recomendadas de gestão de segredos são importantes?
  4. Quais tipos de segredos os desenvolvedores precisam proteger?
  5. Como a gestão de segredos funciona?
  6. Quais são algumas práticas recomendadas de gestão de segredos?
  7. Quais são os riscos de uma gestão de segredos ineficiente?
  8. Como a gestão de segredos se aplica a agentes de IA e fluxos de trabalho de desenvolvimento?
  9. Como você escolhe as ferramentas certas de gestão de segredos?
  10. Como o Stripe Projects pode ajudar

A gestão de segredos é um conjunto de práticas e sistemas que os desenvolvedores usam para gerar, armazenar, distribuir e retirar credenciais. Os exemplos incluem uma chave de interface de programação de aplicativos (API) dentro de uma função sem servidor ou uma senha de banco de dados em um pool de conexões. A gestão de segredos limita quem e o que pode ler um determinado valor, por quanto tempo e sob quais condições. A exposição de segredos é um problema crescente, com quase 24 milhões de novos segredos hardcoded adicionados a commits públicos do GitHub em 2024.

Abaixo, abordaremos os tipos de segredos que os desenvolvedores gerenciam, como o armazenamento e o acesso funcionam e como o Stripe Projects pode ajudar a fornecer chaves de API separadas para cada projeto criado por um desenvolvedor ou equipe.

Principais conclusões

  • Chaves de interface de programação de aplicativos (API), tokens de acesso, credenciais de banco de dados, certificados e chaves de criptografia carregam seus próprios riscos e ciclos de vida.

  • Credenciais com escopo, rotação programada e logs de auditoria limitam os danos que um único segredo exposto pode causar.

  • Ferramentas autônomas que chamam interfaces de programação de aplicativos (APIs) e infraestrutura precisam de acesso distinto, com escopo e revogável, em vez de permissões amplas de conta.

Por que as práticas recomendadas de gestão de segredos são importantes?

A gestão de segredos abrange como você gera, armazena, distribui e descarta as credenciais das quais seus aplicativos (apps) dependem. Uma boa gestão de segredos limita os danos de uma credencial comprometida ao tornar seu acesso claro e fácil de revogar. Uma gestão de segredos ineficiente pode permitir que qualquer pessoa que encontre um único valor vazado acesse sistemas de produção.

Quais tipos de segredos os desenvolvedores precisam proteger?

Há algumas categorias comuns para segredos, e cada uma funciona de forma um pouco diferente.

A gestão de segredos normalmente abrange o seguinte:

  • Chaves de interface de programação de aplicativos (API): elas autenticam seu aplicativo em um serviço de terceiros, como um provedor de pagamento ou API de mapeamento. Normalmente, elas não expiram sozinhas, por isso uma chave vazada costuma conceder acesso total à conta até que alguém a revogue manualmente.

  • Tokens de acesso: tokens de acesso de autorização aberta (OAuth) e JSON Web Tokens (JWTs) carregam as permissões de um usuário ou serviço, geralmente com uma vida útil mais curta do que as chaves de API. Eles aparecem em aplicativos móveis, fluxos de logon único e chamadas entre serviços.

  • Credenciais de banco de dados: nomes de usuário, senhas e strings de conexão para sistemas como PostgreSQL, MySQL ou MongoDB ficam em arquivos de configuração e pools de conexão. Elas costumam ser duplicadas em vários ambientes ao mesmo tempo.

  • Certificados e chaves privadas: certificados de Transport Layer Security (TLS) e chaves de Secure Shell (SSH) verificam a identidade e protegem as conexões entre servidores. Certificados expirados ou armazenados incorretamente causam interrupções com a mesma frequência que causam violações.

  • Chaves de criptografia: chaves que criptografam dados em repouso ou em trânsito são gerenciadas por serviços como o Amazon Web Services Key Management Service (AWS KMS) ou o mecanismo de trânsito do HashiCorp Vault. Perder uma delas pode significar perder o acesso aos dados que ela protege.

  • Variáveis de ambiente: elas não são segredos por si só. São o mecanismo de entrega que muitos aplicativos usam para inserir segredos em um processo em execução, além de serem uma maneira fácil de vazar um valor em um arquivo de log ou relatório de falha.

Esses segredos aparecem em diferentes ambientes: máquinas locais de desenvolvimento, pipelines de Integração Contínua e Entrega Contínua (CI/CD), infraestrutura em nuvem e sistemas de produção. Um valor bem protegido em um ambiente pode ficar totalmente exposto em outro.

Como a gestão de segredos funciona?

A gestão de segredos substitui valores hardcoded por uma pesquisa. Em vez de gravar uma senha de banco de dados diretamente no seu código, o aplicativo a solicita a um repositório centralizado no tempo de execução, e esse repositório decide se a libera.

As variáveis de ambiente são mais simples. Sistemas de orchestration de contêineres permitem injetar segredos como variáveis de ambiente ou arquivos montados no momento da implantação, o que os mantém fora da base de código, mas não os criptografa depois que chegam a um contêiner em execução. Os sistemas de gestão de configurações ficam em um meio-termo: eles protegem um segredo em trânsito e dentro do seu repositório de configurações, mas você ainda tem a responsabilidade pela forma como o sistema receptor o processa depois disso.

Plataformas centralizadas de gestão de credenciais adicionam rotação, versionamento e trilhas de auditoria sobre o armazenamento. Quando o código precisa de um segredo, ele se autentica na plataforma por meio de uma conta de serviço, uma função de Identity and Access Management (IAM) ou um token de vida curta, e recebe uma credencial com escopo e tempo limitado em vez de uma credencial estática. Isso permite que uma equipe corte o acesso de um único serviço sem afetar nenhuma outra credencial no sistema.

Quais são algumas práticas recomendadas de gestão de segredos?

Uma boa gestão de segredos depende de hábitos que uma equipe mantém ao longo do tempo.

Essas práticas aparecem em quase todos os frameworks rigorosos:

  • Conceda acesso de menor privilégio: dê a cada serviço ou pessoa apenas os segredos específicos de que precisam, com escopo para ambientes e ações específicas. Um pipeline de Integração Contínua (CI) com implantação em staging nunca deve ter as mesmas credenciais de um pipeline com implantação em produção.

  • Faça a rotação de segredos de forma programada: chaves de API e senhas de banco de dados de vida longa devem ser rotacionadas regularmente e imediatamente após o desligamento de um funcionário ou suspeita de exposição. A rotação automatizada elimina a desculpa para não fazer isso.

  • Defina a validade de tokens: tokens de curta duração que expiram em minutos ou horas limitam a janela de danos em caso de vazamento. Os tokens de acesso OAuth geralmente são associados a tokens de atualização de duração mais longa em vez de um único valor estático.

  • Registre todas as solicitações de acesso: os logs de auditoria devem registrar qual identidade acessou qual segredo, quando e de onde. Dessa forma, você pode saber se uma credencial foi comprometida durante um incidente, em vez de tentar adivinhar.

  • Separe os segredos por ambiente: desenvolvimento, staging e produção devem ter suas próprias credenciais armazenadas em seus cofres ou namespaces individuais. A senha de um banco de dados de teste nunca deve funcionar no banco de dados de produção.

  • Compartilhe segredos pelo cofre, não por chat ou e-mail: colar uma credencial no Slack ou em um ticket de suporte a coloca em um sistema que não foi criado para protegê-la. Em vez disso, muitas plataformas de gestão de segredos aceitam links de compartilhamento temporários e revogáveis.

  • Verifique as credenciais expostas em cada commit: scanners como o GitHub secret scanning, TruffleHog e Gitleaks verificam commits e pull requests em busca de exposição acidental de credenciais antes ou logo após um merge.

  • Remova os segredos vazados do histórico de versões: revogue a credencial exposta primeiro, já que excluí-la do histórico do git não ajuda se o valor antigo ainda funcionar. Ferramentas como git filter-repo ou BFG Repo-Cleaner podem removê-la de commits anteriores (embora qualquer pessoa que tenha clonado o repositório anteriormente ainda tenha uma cópia).

Quais são os riscos de uma gestão de segredos ineficiente?

A pesquisa anual da GitGuardian sobre commits públicos do GitHub revelou que 15% dos autores de commits vazaram um segredo em 2024. O risco imediato é o acesso não autorizado. Uma credencial de banco de dados vazada pode ser encontrada, e scanners automatizados podem pesquisar repositórios públicos poucos minutos após um push.

Além da exposição inicial, uma chave roubada que passa despercebida pode permanecer ativa por meses, uma vez que muitas empresas têm um processo para identificar falhas de login, mas não para identificar o uso não autorizado de uma credencial que seja tecnicamente válida. Um invasor que entra dessa forma não precisa burlar a autenticação de jeito nenhum; ele já tem o acesso.

Uma gestão de segredos ineficiente também cria riscos que não têm nada a ver com criminosos. Certificados expirados causam interrupções. Credenciais rotacionadas que não foram atualizadas em todos os lugares interrompem as integrações em momentos aleatórios. Além disso, as equipes que compartilham segredos informalmente, por e-mail ou documento compartilhado, podem perder o controle de quem realmente tem acesso.

Como a gestão de segredos se aplica a agentes de IA e fluxos de trabalho de desenvolvimento?

Os agentes de programação com IA mudam o cenário porque geralmente precisam de credenciais reais para fazer um trabalho real, como chamar uma API, consultar um banco de dados ou implantar códigos. Um agente executa instruções na velocidade da máquina; por isso, uma credencial com escopo inadequado pode causar danos em vários sistemas antes que alguém perceba.

Esse risco aumenta com o número de ferramentas que um agente pode chamar. Um agente conectado a uma API de pagamentos, um provedor de nuvem e um sistema interno de tickets precisa de credenciais distintas e com escopo para cada um, e não de um único conjunto de permissões amplas que abranja tudo. Sem essa separação, uma única sessão de agente comprometida pode afetar muito mais do que o pretendido.

O Stripe Projects resolve parte disso para os desenvolvedores que criam na Stripe. Ele pode fornecer chaves de API separadas para cada projeto que um desenvolvedor ou equipe cria, com escopo para os dados e o ambiente daquele projeto. A chave usada por um agente ou aplicativo não carrega o acesso a outro. O Stripe Projects gerencia o provisionamento, o armazenamento de credenciais e o faturamento de serviços de infraestrutura de terceiros.

Como você escolhe as ferramentas certas de gestão de segredos?

A escolha certa depende da sua infraestrutura.

Algumas perguntas ajudam a restringir a lista rapidamente:

  • Integra-se ao seu provedor de identidade? Um sistema que não se autentica com sua configuração atual de Identity and Access Management (IAM) ou logon único (SSO) adiciona um segundo sistema de identidade para gerenciar. Isso costuma significar um controle de acesso mais fraco.

  • Aceita rotação automatizada para os serviços que você usa? A rotação nativa para bancos de dados comuns e serviços em nuvem economiza o trabalho manual de criar e manter scripts de rotação por conta própria.

  • Pode impor credenciais de curta duração e com escopo? Os segredos estáticos e de longa duração são o padrão do qual você está tentando se afastar. Um sistema que armazena apenas valores sem emitir valores dinâmicos resolve apenas metade do problema.

  • Produz logs de auditoria que você realmente pode usar? Os logs que registram o acesso sem os detalhes necessários para reconstruir um incidente não ajudam muito quando você precisa deles.

  • Como gerencia os segredos de que suas ferramentas de IA precisam? Se agentes ou fluxos de trabalho automatizados solicitarem credenciais, verifique se o sistema pode criar escopos e expirar essas credenciais separadamente do acesso humano.

Como o Stripe Projects pode ajudar

O Stripe Projects permite que os desenvolvedores e seus agentes de IA adicionem serviços, gerem credenciais e gerenciem o faturamento a partir da interface de linha de comando (CLI).

A Stripe Projects ajuda você a:

  • Provisionar serviços de terceiros pela linha de comando: use um único fluxo de trabalho para adicionar serviços, gerenciar credenciais e fazer upgrade de planos, em vez de ferramentas e fluxos de trabalho diferentes para cada provedor. Gerencie hospedagem, bancos de dados, autorização, IA e muito mais sem precisar de dashboards, arquivos de configuração ou código de infraestrutura.

  • Sincronizar credenciais automaticamente: mantenha as variáveis de ambiente portáteis entre configurações locais, máquinas, colegas de equipe e agentes, sem precisar copiar e colar chaves de interface de programação de aplicativos (API).

  • Gerenciar o faturamento pela CLI ou pelo seu agente de programação: configure os detalhes de faturamento uma única vez e compartilhe-os com segurança com serviços de terceiros. Faça upgrade e downgrade de níveis, monitore o uso e gerencie assinaturas pela CLI.

Saiba mais sobre como o Stripe Projects ajuda a simplificar o provisionamento de aplicativos, ou copie e cole este comando no seu terminal e comece já:

brew install stripe/stripe-cli/stripe && stripe plugin install projects && npx skills add https://github.com/stripe/ai --skill stripe-projects -y -g

O conteúdo deste artigo é apenas para fins gerais de informação e educação e não deve ser interpretado como aconselhamento jurídico ou tributário. A Stripe não garante a exatidão, integridade, adequação ou atualidade das informações contidas no artigo. Você deve procurar a ajuda de um advogado competente ou contador licenciado para atuar em sua jurisdição para aconselhamento sobre sua situação particular.

Mais artigos

  • Algo deu errado. Tente novamente ou entre em contato com o suporte.

Vamos começar?

Crie uma conta e comece a aceitar pagamentos sem precisar de contratos nem dados bancários, ou fale conosco para criar um pacote personalizado para sua empresa.
Payments

Payments

Aceite pagamentos online, presenciais e em todo o mundo com uma solução desenvolvida para todos os tipos de empresas.

Documentação do Payments

Encontre guias sobre como integrar as APIs de pagamento da Stripe.