Pular para o conteúdo principal

Fornecendo credenciais ao Devin

O Devin pode usar suas próprias credenciais de login para acessar plataformas que exigem autenticação, tanto no Browser quanto pela linha de comando. Recomendamos configurar uma conta dedicada para o Devin usar (por exemplo, devin@company.com) em cada serviço ao qual ele precisa ter acesso. Em seguida, você pode salvar o nome de usuário e a senha do Devin como Segredos na sua conta, para que ele possa fazer login como parte das suas sessões futuras. A inclusão de segredos é feita principalmente pela página Segredos. Essa página é particularmente relevante para segredos no nível de organização. Para segredos específicos de repositório ou de sessão, consulte as seções abaixo. Para adicionar vários segredos de uma vez, clique em Adicionar segredos em massa, ao lado de Adicionar segredo, e importe um arquivo .env (até 2 MB) ou cole um KEY=value por linha. Cookies e códigos TOTP precisam ser adicionados um de cada vez.
Devin
Ao adicionar um segredo, você pode adicionar uma Note que explique contexto adicional ou instruções de uso desse segredo. Use esse campo para transmitir informações úteis tanto para o Devin quanto para outros membros da sua organização. Exemplos de notas incluem:
  • Esta Chave de API deve ser usada apenas em nosso ambiente de produção e nunca em staging ou dev.
  • Usada para nosso banco de dados AWS RDS em us-west-2
  • Essas credenciais estão programadas para serem descontinuadas após o 3º trimestre de 2025
  • Expira automaticamente a cada 30 dias - entre em contato com o time de SecOps para rotação se isso começar a falhar
  • Esta Chave de API está vinculada à conta de usuário devin@company.com
Em More controls, no formulário Novo segredo, a opção Redact value vem ativada por padrão. Depois de ocultado, o valor não pode ser exibido novamente. Para alterá-lo ou desativar Redact value, abra o segredo, clique em Edit e insira um novo valor.

Segredos Globais Persistentes

Segredos adicionados em Settings → Resources → Segredos são persistidos em sessões futuras e se aplicam a toda a organização. Observe que quaisquer segredos que você compartilhar aqui poderão ser usados pelo Devin em todas as futuras sessões do Devin na sua organização. Todos os segredos são criptografados em repouso. Todos os membros da sua organização podem usar Segredos Globais em suas sessões. Por padrão, eles também podem criar, editar e excluir esses segredos, pois a função padrão membro inclui a permissão Gerenciar segredos. Tenha cuidado para adicionar apenas segredos especificamente associados à sua organização e que possam ser usados por todos os seus membros. No Devin Enterprise, um administrador do Enterprise pode remover a permissão Gerenciar segredos da função membro no nível da organização e concedê-la por meio de uma função personalizada; consulte Funções personalizadas e RBAC.

Segredos Pessoais

Além dos segredos de toda a organização, você pode criar segredos pessoais que ficam associados apenas às suas próprias sessões. Segredos pessoais não são compartilhados com outros membros da sua organização. Isso é útil para credenciais vinculadas às suas contas pessoais ou para testar segredos que não devem ser expostos à equipe em geral. Para criar um segredo pessoal, selecione o escopo Personal ao adicionar um novo segredo na página Segredos. Segredos pessoais só ficam acessíveis em sessões que você criar e não ficam visíveis para outros membros da organização nem para administradores. Há alguns tipos de segredos disponíveis:
Este tipo é o mais adequado para a maioria dos segredos genéricos com um único valor. No campo Type, selecione Key-value. Cada Nome do segredo (também conhecido como Chave do segredo) está associado a um único Valor do segredo. Exemplos de segredos armazenados aqui incluem:
  • Chaves de API
  • Chaves SSH
  • Nomes de usuário ou senhas
  • Tokens
Se um único segredo exigir múltiplos valores, crie um segredo distinto para cada valor. Por exemplo, você pode armazenar GITHUB_USERNAME e GITHUB_PASSWORD como dois Segredos brutos. Para ver um exemplo que armazena uma chave de API como vários segredos brutos, consulte Importar builds do iOS para o TestFlight.
Senhas de uso único baseadas em tempo (TOTP) são usadas para autenticação de dois fatores (2FA). O Devin pode armazenar segredos TOTP que funcionam de forma semelhante aos do Google Authenticator ou Authy. Para mais detalhes sobre como adicionar um segredo TOTP, consulte Adicionando um novo TOTP
O Devin costumava oferecer suporte a segredos que lidavam com várias chaves por segredo. No entanto, esse recurso não está mais disponível.Em vez disso, recomendamos simplesmente criar um segredo Key-value para cada campo distinto. Por exemplo, em vez de criar um único segredo para JIRA_LOGIN, você poderia criar dois segredos: JIRA_USERNAME e JIRA_PASSWORD.

Segredos específicos do Bot

Um Devin Bot pode armazenar segredos usados apenas por esse Bot e pelas sessões dele, além dos segredos da sua organização. Adicione-os na página Segredos das configurações do Bot. Consulte Conexões e segredos do Devin Bot.

Segredos específicos de repositório

Para restringir segredos a um repositório específico, adicione-os no editor de blueprint desse repositório:
  1. Acesse Configurações > Ambiente > Blueprints e selecione o repositório. O repositório já deve fazer parte do seu ambiente.
  2. Abra a aba Segredos.
  3. Clique em Criar segredo para adicionar um único segredo ou em Importar segredos para adicionar vários de uma vez.
Nessa mesma aba, você pode pesquisar, exibir, editar e excluir os segredos do repositório. Para criar, editar e excluir segredos de repositório, é necessária a permissão Gerenciar segredos, incluída na função padrão Membro. Os segredos de repositório ficam disponíveis somente para aquele repositório: para as etapas do blueprint durante builds do snapshot e para o Devin quando ele trabalha nesse repositório durante as sessões. Eles são armazenados de forma criptografada e nunca são gravados no seu blueprint ou snapshot. Consulte Segredos na referência de blueprints para saber como são injetados.
Não coloque valores de segredos no YAML do blueprint, em comandos de configuração ou em arquivos .env comitados no repositório. Em vez disso, armazene-os na aba Segredos do repositório e referencie-os pelo nome (por exemplo, $MY_SECRET).

Segredos Específicos de Sessão

Enquanto Devin está trabalhando, ele pode pedir que você forneça credenciais (chaves de API, credenciais de login etc.) na conversa atual, assim:
Devin
Um segredo informado neste cartão vale apenas para a sessão atual, a menos que a opção Save for future sessions esteja selecionada. Devin pode deixar essa opção pré-selecionada, então confira-a antes de enviar o segredo. Como alternativa, você também pode definir segredos específicos de sessão por conta própria:
Devin

Trabalhando com segredos

O Devin fornece cada segredo apenas aos comandos e ferramentas que precisam dele. No navegador, o Devin digita o valor diretamente. Para comandos de shell, ele vincula os segredos como variáveis de ambiente sempre que necessário. Isso se aplica a segredos da organização, segredos específicos de repositório e segredos específicos de sessão. Os segredos não são exportados para todos os shells, então os scripts não devem presumir que uma variável como $API_KEY já esteja definida. Se um script depender de um segredo, informe ao Devin qual variável de ambiente ele lê e o Devin a vinculará aos comandos pertinentes. Os segredos da organização e os segredos pessoais têm uma opção Require approval before each use em More controls no formulário Novo segredo. Ela vem desativada por padrão. O Devin realiza algumas conversões de texto para garantir que seus segredos sejam variáveis de ambiente (ENV) válidas:
  • Ele remove caracteres inválidos, substituindo qualquer coisa que não seja letra, dígito ou sublinhado por outro sublinhado. Por exemplo, o segredo chamado Abc%123 se tornaria a variável de ambiente Abc_123
  • Se o nome do seu segredo começar com um dígito, o Devin adiciona um sublinhado ao início do nome. Por exemplo, o segredo 123MYVAR se tornaria a variável de ambiente _123MYVAR (nomes que já começam com uma letra ou sublinhado não são alterados)
  • Se você tiver dois segredos com o mesmo nome, o Devin adicionará um contador ao final. Por exemplo, se você tiver dois segredos chamados MY_SECRET, você acabará com duas variáveis de ambiente chamadas MY_SECRET e MY_SECRET_2, e assim por diante.
Para adicionar um Cookie de Site, siga as etapas abaixo:
  1. Faça login normalmente na conta que você deseja compartilhar com o Devin. Isso irá gerar cookie(s).
  2. Adicione o cookie exportado ao Devin pela página Segredos.
  3. Ao usar o cookie para um site, o Devin deve identificar que já está autenticado quando navegar para esse site. Peça para o Devin testar!
Se você não usa o Chrome, selecione JSON no formulário Novo segredo e cole os cookies como JSON. Se você codifica os cookies manualmente, selecione base64. O Devin espera uma string codificada em base64 de objetos JSON delimitados por ; no formato padrão de cookies do Chromium.

Adicionando uma nova TOTP

Devin agora oferece suporte à autenticação de dois fatores (2FA) usando uma senha de uso único baseada em tempo (TOTP). Para isso, você precisará fornecer ao Devin as informações disponibilizadas no momento em que a 2FA é configurada na conta do Devin para o aplicativo específico:
  1. Acesse a conta do Devin para o serviço que exige 2FA.
  2. Vá até as configurações de segurança da conta e procure uma opção para regenerar ou visualizar o código QR. Isso pode ser chamado de Set up ou Replace Authenticator.
  3. Se o aplicativo permitir, selecione a opção para visualizar o código QR.
  4. Quando o código QR for exibido na tela, faça uma captura de tela.
  5. Acesse Segredos do Devin, clique no botão Adicionar segredo e altere o Type para One-Time Password (TOTP). Defina um nome descritivo. Clique no pequeno ícone de código QR no canto superior direito do campo de entrada Value e faça upload da captura de tela do seu código QR. Você também pode colar um URI otpauth://totp/.
Forneça apenas códigos 2FA associados a contas que foram configuradas especificamente para uso exclusivo do Devin. Não recomendamos fornecer ao Devin nenhum código 2FA das suas contas pessoais.

Dicas para TOTPs

  • Alguns aplicativos podem não permitir que você visualize o código QR existente depois que a 2FA estiver ativada. Nesses casos, regenerar o código QR é a única opção.
  • Sempre salve os novos códigos de backup fornecidos durante o processo em um local seguro.