Pular para o conteúdo principal
Os segredos são onde seu app guarda chaves de API, tokens e senhas. Assim, as funções de backend podem usá-los sem que os valores apareçam no código do app. Você adiciona, altera e exclui segredos na página Segredos do dashboard do seu app. Você também pode colar uma chave no chat de IA, e a Base44 a salva para você.
A página Segredos aparece no seu dashboard quando seu app usa funções de backend.

Obtendo uma chave de API

Uma chave de API funciona como uma senha privada entre seu app e um serviço externo. Ela prova que a conta é sua e mantém a conexão segura. Você cria a chave no próprio serviço e depois a adiciona ao seu app.
Nunca compartilhe sua chave de API publicamente. Trate-a como uma senha.
Para obter uma chave de API:
  1. Entre no serviço externo, por exemplo OpenAI, Resend ou Stripe.
  2. Abra a seção Desenvolvedor, API ou Integrações dele.
  3. Crie uma nova chave de API ou um novo token.
  4. Copie a chave.
  5. Adicione a chave ao seu app como um segredo. Você pode adicioná-la na página Segredos ou colá-la no chat de IA.

Adicionando segredos

Adicione um segredo quando um serviço der a você uma chave de que seu app precisa. Se o chat de IA precisar de uma chave, ele mostra um formulário onde você pode inseri-la, e a chave é salva como segredo para você. Suas funções de backend encontram cada segredo pelo nome exato. Se o chat de IA já escreveu uma função que espera uma chave, use o nome que ele informou.
O cartão Action needed do chat de IA pedindo um segredo RESEND_API_KEY, com os botões Skip e Submit Secrets

O chat de IA pedindo um segredo

Para adicionar um segredo:
  1. Acesse o editor do app.
  2. Clique em Painel.
  3. Clique em Segredos.
  4. Clique em Adicionar segredo.
  5. Digite o Nome do segredo, por exemplo STRIPE_API_KEY. Os nomes não podem ter espaços, então use underscores.
  6. Cole a chave em Valor do segredo.
  7. Clique em Adicionar segredo.
Página Application Secrets com Secrets destacado na barra lateral e 4 segredos mascarados

Os segredos salvos do seu app

Para adicionar vários segredos de uma vez, clique em Importar .env em vez de Adicionar segredo. Depois, envie ou cole seu arquivo .env. Cada linha KEY=VALUE vira um segredo, e um segredo existente com o mesmo nome recebe o novo valor.

Colando chaves no chat

Quando você cola uma chave de API em uma mensagem no chat de IA, a Base44 a salva como um segredo para você. Ela também remove a chave da mensagem antes que a IA a leia. Isso acontece em todos os modos de chat. A IA trabalha com o nome do segredo, nunca com a própria chave. Na sua mensagem, a chave é substituída por uma linha que começa com “Secret detected and saved as” e mostra o nome do segredo, como $STRIPE_SECRET_KEY. O segredo então aparece na página Segredos, onde você pode alterá-lo ou excluí-lo como qualquer outro segredo. A Base44 reconhece chaves da OpenAI, Anthropic, Stripe, AWS, GitHub, Google e Slack, tokens de bot do Telegram e do Discord e JSON Web Tokens. Para chaves de outros serviços, adicione-as você mesmo como segredos em vez de colá-las no chat.

Alterando ou excluindo segredos

Atualize um segredo quando você gerar uma nova chave no serviço de origem. Exclua-o quando seu app não usar mais esse serviço. Escolha o que você quer fazer:
Você pode substituir o valor de um segredo, mas não pode renomeá-lo. Para usar outro nome, adicione um novo segredo e exclua o antigo.Para alterar o valor de um segredo:
  1. Acesse o editor do app.
  2. Clique em Painel.
  3. Clique em Segredos.
  4. Clique no ícone de editar ao lado do segredo.
  5. Cole o novo valor.
  6. Clique em Salvar.
A exclusão acontece na hora, sem confirmação, e não pode ser desfeita. Uma função que ainda lê o segredo não recebe nenhum valor. Peça ao chat de IA para remover ou atualizar esse código também.Para excluir um segredo:
  1. Acesse o editor do app.
  2. Clique em Painel.
  3. Clique em Segredos.
  4. Clique no ícone de excluir ao lado do segredo.

Aplicando suas mudanças

Quando você adiciona, altera ou exclui um segredo, suas funções de backend recebem a mudança automaticamente enquanto você constrói e visualiza. Seu app publicado pode manter os valores da última publicação. Publique seu app de novo para garantir que o app ao vivo use a mudança.

Mantendo os segredos privados

Os segredos são criptografados, armazenados com segurança e ficam no servidor. Suas funções de backend os leem quando rodam. Assim, os valores completos nunca chegam ao navegador nem às pessoas que usam seu app. Depois que você salva um segredo, o valor completo fica oculto, até para você. Quando você salva um valor com 30 caracteres ou mais, como a maioria das chaves de API, a página Segredos mostra os 10 primeiros caracteres. Assim, você sabe qual chave está salva. Valores mais curtos ficam totalmente mascarados. Qualquer pessoa que pode editar seu app pode ver essas dicas e adicionar, alterar ou excluir os segredos dele. Guarde sua própria cópia de qualquer chave que você não consiga gerar de novo.
Outros lugares para guardar chaves:
  • APIs compartilhadas: Os segredos do app pertencem a um único app. Para compartilhar uma API e as credenciais dela com todos os apps do seu workspace, use uma integração OpenAPI personalizada.
  • Seu próprio código: Se você mesmo escreve funções de backend, veja como ler segredos no código.
  • Chaves que dão a outras ferramentas acesso aos seus apps: As configurações do seu workspace têm a própria página Segredos. Ela guarda tokens de acesso pessoal e, em um plano Enterprise (Business ou Enterprise), chaves de API do workspace. Essas chaves permitem que seus próprios scripts e ferramentas trabalhem com seus apps de fora da Base44. As chaves que seu app usa para chamar outros serviços, como OpenAI ou Resend, ficam nos segredos do seu app.
Esta página foi traduzida usando IA. Para as informações mais precisas e atualizadas, consulte a versão em inglês.