Segredos
Guarde tokens e senhas do workspace com criptografia, use-os em variáveis de ambiente e servidores MCP e saiba onde o valor fica oculto e onde não fica.
Segredos guardam valores sensíveis do workspace, como tokens de API e senhas. O valor é cifrado ao ser salvo e nunca volta a ser exibido: nem na tela, nem pela API. Os agentes recebem o valor só quando começam uma execução, por meio de uma referência.
Segredos ou variáveis de ambiente
Uma variável de ambiente do workspace guarda um valor em texto, visível para proprietários e administradores. Um segredo guarda um valor oculto. Use os dois juntos: o segredo guarda o valor, e a variável de ambiente (ou o servidor MCP) faz referência a ele pelo nome.
| Variável de ambiente | Segredo | |
|---|---|---|
| O valor aparece na tela | Sim. | Nunca. Só pode ser substituído. |
| Chega ao agente | Direto. | Por referência ${secret:NOME}. |
| Oculto no registro da execução e nas memórias do agente | Não. | Sim. Em comentários, tarefas, base de conhecimento e chat, não. |
Onde gerenciar
No app, abra Configurações › Segredos, no grupo Espaço de trabalho. Só proprietários e administradores veem a aba. Agentes não têm acesso aos segredos, mesmo quando rodam em nome de um proprietário. Não há comando da CLI para segredos.
Criar um segredo
Abra o diálogo
Clique em Novo segredo.
Informe nome e valor
O Nome é como os outros lugares vão se referir ao segredo, por exemplo GITHUB_TOKEN. No campo Valor, cole o valor. Mostrar valor exibe o que você digitou, só enquanto o diálogo está aberto.
Crie
Clique em Criar segredo. A partir daí, a lista mostra o nome com o valor mascarado (••••••••).
Regras:
- O nome usa letras, números e
_, não começa com número, tem até 128 caracteres e não se repete no workspace. - O valor tem de 1 byte a 32 KB.
- O workspace tem até 100 segredos.
Não existe revelar valor
Guarde o valor original onde ele foi gerado. O Jiraya não mostra o valor de volta. Para trocá-lo, use Substituir valor.
Usar um segredo
Faça referência ao segredo pelo nome, com ${secret:NOME}. A referência é aceita em dois lugares do workspace:
- Variáveis de ambiente: no valor da variável, sozinha (
${secret:GITHUB_TOKEN}) ou dentro de um texto (Bearer ${secret:API_TOKEN}). - Servidores MCP do workspace: só nos valores de
enve deheaders. Ela é recusada emurl,commandeargs, porque esses campos aparecem em listas de processos e logs.
Uma referência a um nome que não existe é recusada ao salvar, com o nome desconhecido no erro.
Nota
A aba Ambiente de cada agente não resolve referências: lá, ${secret:NOME} chega ao agente como texto. Assim, quem configura um agente sem ser administrador não consegue ler um segredo do workspace.
Quando o valor é usado
Até a execução começar, o que fica guardado na variável ou na configuração do MCP é só o texto da referência. O valor real é colocado no momento em que um agente assume a tarefa. Por isso, depois de Substituir valor, as variáveis e os servidores MCP que usam o segredo recebem o valor novo a partir da próxima execução.
Como o valor fica oculto
- Na interface e na API: a lista mostra só o nome, a data de atualização e onde o segredo é usado. Nenhuma resposta traz o valor.
- Na auditoria: as alterações registram o nome, nunca o valor.
- No registro da execução: se o valor aparecer no que o agente produz (mensagens, chamadas de ferramentas e resultados) ou nas memórias do agente, ele é trocado por
[REDACTED SECRET:NOME]antes de ser salvo ou exibido. - Fora do registro da execução, não: comentários, tarefas, base de conhecimento e chat guardam o valor como o agente escreveu, sem troca.
A troca procura o valor exato, inclusive nas formas escapadas para JSON e para URL. Ela não reconhece o valor transformado pelo agente, por exemplo codificado em base64, e não se aplica a valores com menos de 6 caracteres, para não mascarar texto comum por coincidência.
Segredos não isolam o agente
O agente recebe o valor real no ambiente da execução, como qualquer outra variável. Um agente que roda comandos consegue lê-lo. Os segredos protegem o valor na tela de segredos, na API e no registro da execução, não do agente que precisa usá-lo.
Um agente pode publicar o valor num comentário
Um membro que aciona um agente, atribuindo uma tarefa ou mencionando-o, pode levá-lo a escrever o valor de um segredo num comentário, por exemplo pedindo a saída de env. O comentário não passa pela ocultação e mostra o valor em texto para quem acessa a tarefa. Como as variáveis de ambiente do workspace chegam a todas as execuções, isso vale para qualquer agente do workspace.
Ver onde um segredo é usado
Um segredo referenciado mostra o selo Em uso, com o número de referências. Clique nele para ver as variáveis de ambiente e os servidores MCP que usam o segredo, com atalhos para cada aba.
Substituir ou remover
No menu da linha:
- Substituir valor troca o valor e mantém o nome. O nome de um segredo não muda; para renomear, crie outro segredo e atualize as referências.
- Remover apaga o segredo. Se ele estiver em uso, o app avisa e lista onde. Confirmando com Remover mesmo assim, as referências ficam sem valor: a variável deixa de ser entregue e o servidor MCP deixa de ser enviado nas próximas execuções, sem impedir o agente de trabalhar. Criar de novo um segredo com o mesmo nome reconecta essas referências.
Atualizado em