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.
O que é tratado como segredo
Seção intitulada “O que é tratado como segredo”- 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_URLdos bancos criados pela plataforma.
Ao editar uma sensível, o valor antigo não é exibido: você só pode Substituir valor.
Mascaramento
Seção intitulada “Mascaramento”- 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
nullsem o escopoenv:reveal.
Revelar
Seção intitulada “Revelar”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).
Nunca no front-end
Seção intitulada “Nunca no front-end”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.
Variável ou segredo
Seção intitulada “Variável ou segredo”| 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 |
Rotação
Seção intitulada “Rotação”- Gere o novo valor no serviço de origem (por exemplo, a chave no provedor).
- Edite a variável sensível e informe o novo valor em Substituir valor.
- Clique em Redeploy para aplicar.
- 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).