# 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

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

## 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 `null` sem o escopo `env:reveal`.

## 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](/seguranca/confirmacao-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](/seguranca/tokens-e-escopos/)).

## 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

| 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](/bancos/conexao-e-referencias/)) |
| Valor visível ao navegador | Variável comum com prefixo público, nunca um segredo |

## Rotação

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](/seguranca/tokens-e-escopos/)), e bancos têm credencial rotacionável ([Painel de bancos](/bancos/painel-de-bancos/)).

## Próximos passos

- [Variáveis no painel](/conectados/variaveis-no-painel/)
- [Variáveis e referências](/conectados/variaveis-e-referencias/)
- [O que não é permitido](/seguranca/o-que-nao-e-permitido/)
