Configure seu Nexus

Siga estas etapas quando quiser se conectar ao repositório de artefatos Agora da Deque a partir de sua instância repositório Nexus. Configurar esse repositório remoto autenticado no Nexus permite que seus usuários acessem os componentes Axe DevTools através de sua própria rede de distribuição de software.

Pré-requisitos

Você deve ter credenciais de login no Agora e credenciais de administrador para sua instância do Nexus para configurar essa conexão de repositório. A Deque recomenda usar uma conta de serviço do Agora para essas credenciais em vez de uma conta pessoal.

Usando uma Conta de Serviço

A Deque recomenda que você autentique esta conexão com uma conta de serviço Agora ao invés de usar seu próprio login Agora. Uma conta de serviço é uma conta Agora que pertence à sua equipe em vez de uma conta pessoal que pertence a apenas um membro da equipe.

Seu gerenciador de repositório — o servidor que hospeda o repositório remoto que você está configurando — armazena as credenciais da conta de serviço e as utiliza sempre que precisa acessar o Agora. Ele não faz o download dos pacotes antecipadamente. Na primeira vez que um dos seus desenvolvedores ou pipelines de build instala um pacote do Axe DevTools, o repositório remoto busca esse pacote do Agora e mantém uma cópia, e as instalações posteriores são servidas a partir da cópia. Seus desenvolvedores e sistemas automatizados sempre solicitam pacotes do seu gerenciador de repositório, de modo que eles nunca precisam de suas próprias contas Agora.

Uma conexão baseada no login de uma única pessoa depende de que ela mantenha o acesso ao Agora. Se essa pessoa sair da organização, ninguém poderá entrar em sua conta para recriar o Token de Identidade quando expirar, e as instalações falharão para todos. Uma conta de serviço não depende de apenas uma pessoa.

Cuidados com a Conta de Serviço

Trate o Token de Identidade da conta de serviço — a credencial semelhante a uma senha que o Agora emite para a conta — como uma credencial de infraestrutura compartilhada, e gerencie-o de acordo com as políticas de segurança e credenciais da sua organização. Armazene-o em um gerenciador de segredos ou no armazenamento de segredos do seu provedor de CI e faça referência a ele na configuração do seu gerenciador de repositório, em vez de comprometê-lo no controle de versão. Solicite à Deque que restrinja o escopo da conta de serviço apenas ao acesso de leitura necessário quando solicitá-la, e peça-nos para revogar e emitir novamente o token se ele puder ter sido exposto ou quando o dono da conta mudar.

Atribua um responsável pela conta dentro de sua organização. Os Tokens de Identidade expiram (geralmente após um ano), então o responsável pela conta deve recriar o token antes que ele expire. Quem quer que o recrie também deve atualizar o token armazenado que o seu gerenciador de repositório usa para se conectar ao Agora, pois seu gerenciador de repositório não pode baixar pacotes novos e atualizados até que o token armazenado seja atualizado.

Criando um Token de Identidade

Para começar, faça login no Agora como a conta de serviço, para que o Token de Identidade pertença à conta de serviço em vez de a uma conta pessoal. Se você não estiver usando uma conta de serviço, faça login como você mesmo. Clique no botão Bem-vindo no canto superior direito para abrir a página de perfil. Gere um Token de Identidade lá e copie-o.

Conectando-se ao Agora

1. Faça login no seu Nexus Repository Manager com suas credenciais de administrador.
2. Selecione o ícone de engrenagem no cabeçalho do gerenciador de repositórios Nexus. A página de administração do repositório deve ser exibida com a barra lateral esquerda atualizada para mostrar o menu Administração.
3. Selecione Repositórios (Administração de repositório) para exibir a página de repositórios.
4. Selecione Criar repositório no topo da página de repositórios.
5. A página de repositórios deve exibir uma lista de receitas. Selecione uma versão proxy do idioma que deseja usar com o Axe DevTools na tabela Selecionar Receita.
6. A página Criar Repositório deve exibir um formulário. Recomendamos o uso das configurações padrão, exceto para o seguinte:
   1. Local de armazenamento remoto para Axe DevTools:

      Receita	Use este URL do Artifactory (clique três vezes para selecionar)
      npm (proxy)	https://agora.dequecloud.com/artifactory/api/npm/devtools-npm/
      maven2 (proxy)	https://agora.dequecloud.com/artifactory/devtools-maven/
      nuget (proxy)	https://agora.dequecloud.com/artifactory/api/nuget/devtools-nuget/
      rubygems (proxy)	https://agora.dequecloud.com/artifactory/devtools-gems/
      pypi (proxy)	https://agora.dequecloud.com/artifactory/api/pypi/devtools-python/simple/

   2. Verifique a seleção da caixa de autenticação e observe que o menu tipo de autenticação exibe a opção de lista Nome de usuário na seção HTTP.
   3. Insira o endereço de e-mail da conta de serviço como nome de usuário e o Token de Identidade que você copiou como senha. Se você não estiver usando uma conta de serviço, insira o endereço de e-mail da conta do Agora com a qual você fez login.
7. Selecione Criar repositório no canto inferior esquerdo da página Criar Repositório: <receita que você selecionou>.
8. Se bem-sucedido, uma mensagem será exibida indicando a criação do repositório remoto.