Stel je Artifactory in

This page is not available in the language you requested. You have been redirected to the English version of the page.

Link to this page copied to clipboard

Je Artifactory-instantie configureren om verbinding te maken met Deque's Agora artefactrepository

Not for use with personal data

Je Artifactory-repository configureren om verbinding te maken met Deque’s Agora artefactrepository

Volg deze stappen wanneer je verbinding wilt maken met Deque’s Agora artefactrepository vanuit je Artifactory-instantie. Het instellen van deze geauthenticeerde externe repository binnen Artifactory stelt je gebruikers in staat om Axe DevTools-componenten te openen via je eigen softwaredistributienetwerk.

Vereisten

Je moet Agora-aanmeldingsgegevens en beheerdersgegevens voor je Artifactory-instantie hebben om deze repositoryverbinding te configureren. Deque beveelt aan een Agora-serviceaccount voor die gegevens te gebruiken 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.

note

Om een serviceaccount aan te vragen, neem direct contact op met uw Deque-vertegenwoordiger, vraag het ons via onze supportdesk, of stuur ons een e-mail. We helpen u graag met het opzetten.

Een Agora Identity Token maken

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

important

Vergeet niet de waarde van je Identity Token te kopiëren bij het aanmaken, want dit is je enige kans. Anders moet je een nieuwe token aanmaken.

Identity Tokens verlopen (meestal na een jaar), dus je moet je token periodiek opnieuw aanmaken.

Verbinden met Agora

Log in op je Artifactory Repository Manager met je beheerdersgegevens.
Selecteer Admin in het linker navigatiemenu.
Selecteer „Remote“ onder „Repositories“ om de pagina met externe repositories weer te geven.
Selecteer „Create New“ rechtsboven op de pagina Externe Repositories.
De pagina zou een lijst van pakkettypen moeten weergeven
Selecteer je pakketsoort (bijv. npm)
De pagina 'Maak repository aan:' zou een formulier moeten weergeven (zie bovenstaand voorbeeld van een npm-repository).
1. Typ in het veld Repository Key de naam die je wilt gebruiken om naar de repository te verwijzen. De repositorysleutel mag geen spaties of speciale tekens bevatten, moet uniek zijn, mag niet beginnen met een cijfer en is beperkt tot 58 tekens.
2. Voer de URL naar het Agora-register in (zie Agora Registry URL's hieronder).
3. Selecteer de geschikte layouts (standaardinstellingen zouden voor elk repositorytype moeten werken)
Klik op de knop „Test“ om de verbinding te testen
Klik op „Save and Finish“
Als je wilt dat gebruikers deze repository standaard gebruiken, moet je het in een van je virtuele registers opnemen

Agora Registry URL's

important

Deze links zijn niet bedoeld om bezocht te worden. Klik in plaats daarvan met de rechtermuisknop op de gewenste link, kies Copy Link en plak vervolgens de URL in de Agora-instellingspagina voor de URL van het Agora-register.