> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Gerenciando os segredos do app

> Armazene chaves de API, tokens e senhas como segredos do app para que suas funções de backend possam usá-los. Adicione uma chave ou cole-a no chat de IA e depois altere ou exclua.

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ê.

> [!NOTE]
>
> 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.

> [!WARNING]
>
> 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](#adding-secrets) ou [colá-la no chat de IA](#pasting-keys-in-chat).

***

## 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](https://mintcdn.com/base44/nv1IVmq8CgUm8kOS/images/chataiapi.png?fit=max\&auto=format\&n=nv1IVmq8CgUm8kOS\&q=85\&s=f424f38d37b23f20d56314a9c0a9d067)

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](https://mintcdn.com/base44/md0uEgmxEQCB9Nzh/images/apikeys.png?fit=max\&auto=format\&n=md0uEgmxEQCB9Nzh\&q=85\&s=38737506f2d314b714dcc48fbfea347c)

Os segredos salvos do seu app

> [!TIP]
>
> 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](#adding-secrets) 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:

> [accordion] Alterar o valor de um segredo
>
> 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**.

> [accordion] Excluir um segredo
>
> 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.

> [!TIP]
>
> **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](https://docs.base44.com/pt-BR/documentation/integrations/using-custom-integrations.md).
> * **Seu próprio código:** Se você mesmo escreve funções de backend, veja [como ler segredos no código](https://docs.base44.com/pt-BR/developers/backend/resources/backend-functions/overview.md#read-secrets).
> * **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](https://docs.base44.com/pt-BR/Workspaces/Personal-access-tokens.md) e, em um plano Enterprise (Business ou Enterprise), [chaves de API do workspace](https://docs.base44.com/pt-BR/Enterprise/workspace-secrets.md). 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.

> [!NOTE]
>
> Esta página foi traduzida usando IA. Para as informações mais precisas e atualizadas, consulte a [versão em inglês](https://docs.base44.com/index.md).


## Related topics

- [Usando integrações](https://docs.base44.com/pt-BR/Integrations/Using-integrations.md)
- [Gerenciando os apps do seu workspace](https://docs.base44.com/pt-BR/documentation/using-your-workspaces/managing-your-workspace-apps.md)
- [Gerenciando segredos do workspace](https://docs.base44.com/pt-BR/Enterprise/workspace-secrets.md)
- [Gerenciando os membros do seu workspace](https://docs.base44.com/pt-BR/Account-and-billing/Managing-your-workspaces.md)
- [Gerenciando os dados do seu aplicativo](https://docs.base44.com/pt-BR/Building-your-app/Managing-your-app-data.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.