Skip to main content
A ferramenta Secrets armazena e criptografa secrets, as informações sensíveis do seu projeto Replit. Isso inclui chaves de API, tokens de autenticação e strings de conexão de banco de dados que seu projeto usa para se conectar a serviços externos. Por exemplo, seu projeto pode precisar de credenciais para chamar uma API de terceiros, conectar-se a um provedor de autenticação ou acessar um banco de dados. Quando você adiciona um secret, a ferramenta automaticamente criptografa os dados e os disponibiliza para o seu projeto Replit como uma variável de ambiente. Essa abordagem permite eliminar a codificação direta de secrets no seu código e reduzir o risco de expô-los.
Codificar secrets diretamente no seu código pode levar à exposição acidental nos seguintes cenários:
  • Compartilhar seu código com outras pessoas por meio de um projeto Replit público ou por cópia e colagem
  • Enviar seu código para controle de versão em um repositório público
  • Fazer transmissão ao vivo ou compartilhar a tela com seu código
Use a ferramenta Secrets para compartilhar seu código com confiança sem se preocupar em expor credenciais.
Ferramenta Secrets mostrando valores de secrets mascarados e uma seção separada de Configurations para informações não sensíveis

Secrets e Configurations na ferramenta Secrets. Os nomes dos secrets específicos do projeto foram ocultados.

​
Secrets versus configurations

A ferramenta Secrets tem seções separadas para secrets e configurations. Ambos permitem que o código do seu projeto leia valores como variáveis de ambiente sem codificá-los diretamente. As configurations são úteis quando uma definição difere entre testar no Replit e executar seu projeto publicado. Use um secret sempre que um valor contiver credenciais ou outros dados sensíveis.

​
Funcionalidades

A ferramenta Secrets inclui as seguintes funcionalidades:
  • Criptografia: Proteja seus secrets usando criptografia AES-256 em repouso e criptografia TLS em trânsito
  • Secrets no nível do projeto: Armazene e gerencie secrets específicos de um projeto Replit
  • Configurations: Gerencie variáveis de ambiente não sensíveis junto com seus secrets
  • Acesso por variáveis de ambiente: Acesse seus secrets no código usando variáveis de ambiente
  • Acesso colaborativo: Compartilhe secrets com colaboradores e membros da equipe

​
Uso

Secrets estão disponíveis para todos os tipos de implantação, exceto Implantações Estáticas.

​
Como encontrar Secrets

Abra a ferramenta Secrets no painel de ferramentas do seu projeto:
  1. Abra seu projeto no Project Editor.
  2. Selecione Tools na parte superior para abrir o painel de ferramentas.
  3. Encontre a seção Setup e selecione Secrets.
Painel de ferramentas do Project Editor com o botão Tools na parte superior e Secrets sob o título Setup

Selecione Tools e, depois, Secrets em Setup.

A ferramenta Secrets abre com os secrets do seu projeto, seguidos pela seção Configurations.

​
Gerenciar secrets do projeto

Gerencie os secrets do seu projeto diretamente na ferramenta Secrets. Use Filter Secrets by name para encontrar um secret. Adicionar um secret
  1. Selecione New Secret.
  2. Insira uma Key, o nome do secret, e um Value, o próprio secret.
  3. Selecione Add Secret para salvar a entrada.
Formulário New Secret com GOOGLE_API_KEY como chave de exemplo, um campo Value vazio e o botão Add Secret

Adicione um secret com uma chave e um valor. Os nomes dos secrets existentes foram ocultados.

Editar um secret
  1. Selecione o menu ícone de três pontos verticais de três pontos verticais ao lado do secret.
  2. Selecione Edit no menu contextual.
  3. Atualize o texto no campo Key ou Value e selecione Update Secret para salvar as alterações ou Cancel para descartá-las.
Visualizar ou ocultar um secret Para visualizar um secret, selecione o ícone de ícone de olho olho ao lado do secret. Para ocultar o secret, selecione o ícone de ícone de olho com barra olho com barra. Excluir um secret Para excluir um secret, selecione o menu ícone de três pontos verticais de três pontos verticais ao lado do secret e selecione Delete. Editar secrets em lote Abra o menu de três pontos verticais no cabeçalho de Secrets e selecione Edit as JSON ou Edit as .env. Revise a lista completa antes de salvar: a edição em lote substitui os secrets existentes do projeto.

​
Gerenciar secrets da conta

Os secrets da conta permitem reutilizar credenciais em seus projetos. Gerencie-os em Account Settings > Account Secrets. Para vincular secrets da conta a um projeto de sua propriedade:
  1. Abra a ferramenta Secrets do projeto.
  2. Selecione o ícone de corrente chamado Link Account Secrets no cabeçalho.
  3. Marque as caixas de seleção ao lado dos secrets que deseja usar.
  4. Selecione Link to this App.
Os secrets vinculados permanecem sincronizados com os secrets da sua conta. Para remover um vínculo, abra o menu de opções do secret vinculado e selecione Unlink.

​
Gerenciar configurations

Use a seção Configurations na ferramenta Secrets para valores não sensíveis. Para adicionar uma configuration:
  1. Selecione New configuration.
  2. Insira uma Key, como LOG_LEVEL, e um Value, como debug.
  3. Selecione Add configuration.
Para um valor específico de um ambiente, selecione More ao lado de New configuration e, depois, New published app configuration ou New testing configuration.
Seção Configurations com campos Key e Value vazios e um botão Add configuration

Adicione uma definição não sensível na seção Configurations.

Não armazene chaves de API, senhas ou tokens de autenticação como configurations. Use secrets para valores sensíveis.

​
Gerenciar secrets de produção

Para encontrar os secrets do seu projeto publicado, abra Publishing, selecione Adjust settings e localize Production app secrets. Revise os valores de que seu projeto publicado precisa, especialmente se você usa credenciais diferentes para teste e produção.

​
Gerenciar a visibilidade dos secrets

A visibilidade dos secrets depende do seu acesso a um projeto Replit e se você é o autor dele. Você pode usar uma das opções para compartilhar seu projeto Replit:
  • Multiplayer: Convide usuários do Replit para colaborar em tempo real
  • Cover page: Exiba uma prévia do seu projeto Replit com a opção de remixá-lo
  • Remix: Torne o projeto Replit individual ou da sua organização público para que outras pessoas possam criar a própria versão
A tabela a seguir mostra a visibilidade do nome e do valor dos secrets nos diferentes cenários:
Membros da organização sem a função de Proprietário não podem visualizar os valores dos secrets em um projeto Replit, mas podem acessá-los imprimindo as variáveis de ambiente.

​
Secrets relacionados ao banco de dados

Quando você adiciona o banco de dados da Replit, o Project Editor cria automaticamente o seguinte secret:
Bancos de dados de desenvolvimento Neon legados também podem incluir PGHOST, PGUSER, PGPASSWORD, PGDATABASE e PGPORT. Os bancos de dados de desenvolvimento atuais da Replit usam DATABASE_URL em vez disso.
Para visualizar todas as variáveis de ambiente no seu projeto Replit, execute printenv na ferramenta Shell do Project Editor ou imprima-as a partir do seu código.

​
Variáveis de ambiente predefinidas

A Replit define automaticamente as seguintes variáveis de ambiente que você pode acessar no código do seu projeto: Essas variáveis não estão listadas na ferramenta Secrets, mas o código do seu projeto pode lê-las como qualquer outra variável de ambiente.