Pular para o conteúdo principal
Os segredos permitem que o Research use suas outras ferramentas, como PagerDuty, Grafana ou uma API interna. O Research escreve um script curto, e o script lê o segredo como uma variável de ambiente, por exemplo $PAGERDUTY_API_KEY. O Research nunca vê o valor.
A página Secrets em Settings com quatro segredos da organização

Adicionar um segredo

  1. Abra Settings → Secrets. Escolha a aba Organization ou Personal e clique em New secret.
  2. Informe um Name com letras maiúsculas, dígitos e sublinhados, como DATADOG_API_KEY. Os scripts usam esse nome.
  3. Cole o Value. A maioria das credenciais é Key-value. Para um código de dois fatores, escolha TOTP e cole a seed de configuração; os scripts geram o código atual a partir dela.
  4. Adicione uma Note dizendo para que serve o segredo e para qual host ele é enviado. O Research lê a nota para escolher o segredo certo.
  5. Clique em Create secret.
O painel New secret com um nome, um valor oculto e uma nota
Redact value vem ativado por padrão. Depois de salvar, ninguém pode ver o valor de novo, e você não pode desativar a ocultação. Você ainda pode substituir o valor.
Para adicionar vários segredos de uma vez, clique em Bulk add secrets e cole um NAME=value por linha, como em um arquivo .env.

Deixe o Research pedir um segredo

Quando o Research precisa de uma credencial que você não salvou, ele mostra um cartão no chat. Cole o valor e clique em Save secret. O valor vai direto para Secrets, não para o chat. O Research pode usá-lo a partir do próximo comando e em sessões futuras.
Uma sessão do Research com um cartão que pede ao usuário para salvar uma chave de API do PagerDuty

Quem pode usar um segredo

  • Organization: funciona nas sessões do Research de todos os membros e nas execuções de workflows. Só Owner e Admin podem adicioná-lo, editá-lo ou excluí-lo. Os membros veem o nome e a nota, mas não o valor.
  • Personal: funciona só nas suas próprias sessões do Research. Qualquer pessoa pode adicionar um.
Se os dois tiverem o mesmo nome, seu segredo pessoal é usado.

Editar ou excluir um segredo

Clique em um segredo na lista para substituir o valor, mudar a nota ou excluí-lo. Scripts que usam um segredo excluído param de funcionar.
O Research envia um segredo apenas para o host oficial da API do serviço ou para um host que você indicar. Ele nunca mostra o valor de um segredo, mesmo que você peça.