Je Nexus instellen

Volg deze stappen als je verbinding wilt maken met Deque's Agora artifactorium-repository vanuit je Nexus-repository-instantie. Het instellen van deze geauthenticeerde externe repository binnen Nexus stelt je gebruikers in staat om toegang te krijgen tot Axe DevTools-componenten via je eigen softwaredistributienetwerk.

Vereisten

U moet inloggegevens voor Agora en beheerdersgegevens voor uw Nexus-instantie hebben om deze repositoryverbinding te configureren. Deque raadt aan om een Agora-serviceaccount te gebruiken voor deze inloggegevens in plaats van een persoonlijk account.

Een serviceaccount gebruiken

Deque raadt aan om deze verbinding te verifiëren met een Agora-serviceaccount in plaats van met uw eigen Agora-login. Een serviceaccount is een Agora-account dat toebehoort aan uw team in plaats van een persoonlijk account dat slechts aan één teamlid toebehoort.

Uw repositorymanager — de server die de externe repository host die u aan het opzetten bent — slaat de inloggegevens van het serviceaccount op en gebruikt ze telkens wanneer er toegang tot Agora nodig is. Het downloadt de pakketten niet van tevoren. De eerste keer dat een van uw ontwikkelaars of buildpipelines een Axe DevTools-pakket installeert, haalt de externe repository dat pakket op bij Agora en houdt een kopie bij, en latere installaties worden van de kopie bediend. Uw ontwikkelaars en geautomatiseerde systemen vragen alleen pakketten aan bij uw repositorymanager, zodat ze nooit hun eigen Agora-accounts nodig hebben.

Een verbinding die afhankelijk is van de login van één persoon, is afhankelijk van die persoon die toegang blijft houden tot Agora. Als die persoon uw organisatie verlaat, kan niemand inloggen op hun account om het Identity Token te vernieuwen wanneer het verloopt, en dan mislukken de installaties voor iedereen. Een serviceaccount is niet afhankelijk van één persoon.

Zorgen voor het Serviceaccount

Behandel het Identity Token van het serviceaccount — de wachtwoordachtige referentie die Agora voor het account uitgeeft — als een gedeeld infrastructuur-referentie en beheer het volgens de beveiligings- en referentiebeleid van uw organisatie. Sla het op in een geheimbeheerder of de geheimopslag van uw CI-provider en verwijs ernaar vanuit de configuratie van uw repositorymanager, in plaats van het toe te voegen aan de broncode. Vraag Deque om het serviceaccount alleen toe te wijzen aan de leesrechten die het nodig heeft wanneer u het aanvraagt, en vraag ons om het token in te trekken en opnieuw uit te geven als het mogelijk is blootgesteld of wanneer de accounteigenaar verandert.

Wijs een eigenaar toe aan het account vanuit uw organisatie. Identity Tokens verlopen (meestal na een jaar), dus de accounteigenaar moet het token vernieuwen voordat het verloopt. Degene die het vernieuwt, moet ook het opgeslagen token bijwerken dat door uw repositorymanager wordt gebruikt om verbinding te maken met Agora, want uw repositorymanager kan geen nieuwe en bijgewerkte pakketten downloaden totdat het opgeslagen token is bijgewerkt.

Een Identity Token aanmaken

Om te beginnen, aanmelden bij Agora als het serviceaccount, zodat de Identity Token bij het serviceaccount hoort in plaats van bij een persoonlijk account. Als u geen serviceaccount gebruikt, meld u dan aan als uzelf. Klik op de knop Welkom in de rechterbovenhoek om de profielpagina te openen. Genereer daar een Identity Token en kopieer deze.

Verbinden met Agora

1. Meld je aan bij je Nexus Repository Manager met je admincredentials.
2. Selecteer het tandwielpictogram in de header van de Nexus-repositorymanager. De repository-administratiepagina zou moeten verschijnen met de linkerzijbalk ververst om het Administratie-menu weer te geven.
3. Selecteer Repositories (Repository-administratie) om de repositorypagina weer te geven.
4. Selecteer Repository aanmaken bovenaan de repositories-pagina.
5. De repositorypagina zou een lijst van recepten moeten weergeven. Selecteer een proxyversie van de taal die je met Axe DevTools wilt gebruiken in de Recept selecteren-tabel.
6. De Repository aanmaken-pagina zou een formulier moeten weergeven. We raden aan de standaardinstellingen te gebruiken, behalve voor het volgende:
   1. Externe opslaglocatie voor Axe DevTools:

      Recept	Gebruik deze Artifactory-URL (driemaal klikken om te selecteren)
      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. Controleer de selectie van het authenticatievakje en merk op dat het authenticatietypemenu de Gebruikersnaam-lijstoptie in de HTTP-sectie weergeeft.
   3. Voer het e-mailadres van het serviceaccount in als de gebruikersnaam en de gekopieerde Identity Token als wachtwoord. Als u geen serviceaccount gebruikt, voer dan het e-mailadres in van het Agora-account waarmee u bent aangemeld.
7. Selecteer Repository aanmaken in de linkeronderhoek van de Repository aanmaken: <recept dat je hebt geselecteerd>-pagina.
8. Als dit is gelukt, wordt een bericht weergegeven dat de creatie van de externe repository aangeeft.