Pular para o conteúdo

Segredos no painel

Um segredo é uma variável marcada como Sensível. Depois de salva, a Nebular não devolve o valor: ele fica mascarado na tela, nos logs e nas leituras da API, e só quem tem permissão o revela, com confirmação de identidade.

  • Toda variável em que você liga Sensível. A marca é opcional e escolha sua; uma vez sensível, ela nunca volta a ser não sensível.
  • Variáveis que referenciam algo sensível, como ${{db.DATABASE_URL}}: o valor resolvido herda a sensibilidade.
  • Senhas e DATABASE_URL dos bancos criados pela plataforma.

Ao editar uma sensível, o valor antigo não é exibido: você só pode Substituir valor.

  • Na tabela, aparece “Sensível: valor oculto” (••••••••).
  • Nos logs, os segredos saem mascarados.
  • No histórico de configuração, o valor aparece como mascarado.
  • Na API, o valor vem null sem o escopo env:reveal.

Valores não sensíveis podem ser mostrados por 30 segundos com Mostrar por 30 s, por membros ou acima. Valores sensíveis só são revelados por administradores e proprietários, depois de confirmar a identidade. Sem permissão, o painel diz: “Você não tem permissão para revelar este valor; peça a um administrador do time.” Veja Confirmação de identidade.

Para tokens de API, revelar exige o escopo env:reveal, que você marca de propósito ao criar o token (Tokens e escopos).

Variáveis com prefixo NEXT_PUBLIC_, VITE_, PUBLIC_ ou EXPO_PUBLIC_ vão para o código do navegador e ficam visíveis a qualquer visitante, mesmo marcadas como sensíveis. Chaves de API, senhas e tokens ficam em variáveis sem esses prefixos, lidas só no servidor do seu app.

Dado Como guardar
Nível de log, região, nome de exibição Variável comum
URL privada de outro serviço Variável com referência, como ${{api.PRIVATE_URL}}
Senha, chave de API, secret de assinatura Variável com Sensível ligado
Conexão de banco Referência ${{db.DATABASE_URL}} (Conexão e referências)
Valor visível ao navegador Variável comum com prefixo público, nunca um segredo
  1. Gere o novo valor no serviço de origem (por exemplo, a chave no provedor).
  2. Edite a variável sensível e informe o novo valor em Substituir valor.
  3. Clique em Redeploy para aplicar.
  4. Revogue o valor antigo no provedor.

Para tokens de API e credenciais de banco, a rotação é própria: tokens têm carência de 1 a 24 horas (Tokens e escopos), e bancos têm credencial rotacionável (Painel de bancos).