flows.md · documentação · Blocos

@secret#

Uma chave de API, um token ou uma senha que uma página precisa guardar e que ninguém deve ler na página. O texto da página guarda só um nome; o valor fica fora dele, cifrado no servidor. Quem lê a página vê o valor mascarado. Quem edita a página revela (por 30 segundos), copia sem mostrar, e define ou troca o valor.

Ao vivo#

```@secret name:exemplo-api label:"Chave de API (exemplo)" show_start:12 show_end:4 note:"Um valor de mentira: só para mostrar a máscara"
```

Variações#

Ainda sem valor. Um bloco cujo nome ainda não tem valor diz "Não definido". Quem edita a página define o valor pelo botão Definir valor do bloco, no editor.

```@secret name:exemplo-sem-valor label:"Token do webhook"
```

O que nunca vai no texto#

O valor nunca é escrito na linha do bloco nem abaixo dela: value:, um corpo, ou um nome que parece uma chave são recusados, com o motivo. Assim o valor não entra no histórico da página, na busca, nas exportações, nem no que o MCP e o assistente leem e mandam para um provedor de IA — eles veem o nome e a máscara.

Quem revela, copia ou define: o dono da página e quem tem um papel com edição da página inteira. Leitores, visitantes, quem chega por um link de compartilhamento e quem edita só pelo acesso geral veem só a máscara. Cada revelação, cópia e troca fica registrada (quem, quando, qual nome — nunca o valor).

Copiar a página leva os valores junto quando quem copia pode revelá-los; mover a página os mantém; apagar a página apaga os valores.

Argumentos#

• name — o nome do segredo nesta página (letras minúsculas, dígitos, - e _, até 48). Obrigatório.
• label — o que é, acima do valor.
• note — uma linha abaixo dele.
• show_start — quantos caracteres do começo aparecem na máscara (0 a 24; padrão 0).
• show_end — quantos do fim (0 a 8; padrão 4). Juntos, nunca mais de um terço do valor.