Het installeren van de Axe DevTools Linter Connector als een npm-pakket

Dit artikel beschrijft hoe u de Axe DevTools Connector kunt downloaden en installeren met Agora als een npm-pakketregister. Dit stelt u in staat om gebruik te maken van de infrastructuur die wordt geboden door Node.js en npm om uw Axe DevTools Linter Connector-binaire te downloaden, te versioneren en bij te werken, waardoor u de handmatige stappen vermijdt die nodig zijn als u de Connector direct via de downloads-pagina downloadt.

Wat is Agora?

Agora is Deque's repository (gehost door JFrog als een artifact fabriek of artifactory), die binaire artifacts (pakketten, bibliotheken en uitvoerbare bestanden) veilig opslaat en een account vereist voor toegang. Agora host de Axe Linter Connector (zowel het npm-pakket als het handmatig downloadbare uitvoerbare bestand).

Maak een Agora Identiteitstoken aan

De eerste stap is het aanmaken van een identiteitstoken dat npm zal gebruiken om je Agora-sessie te authenticeren. Agora-identiteitstokens verlopen na een jaar, dus ze moeten jaarlijks worden vernieuwd.

1. Bezoek uw Agora profielpagina om een identiteitstoken te verkrijgen. (Als u niet ingelogd bent op Agora, kunt u na het inloggen worden doorgestuurd naar een andere landingspagina dan uw profielpagina. Klik nogmaals op de dezelfde link nadat u bent ingelogd om naar uw profielpagina te gaan. Of klik op de knop rechts van de helpknop in de rechterbovenhoek en klik vervolgens op Profiel bewerken.)
2. Klik op Genereer een Identiteitstoken.
3. Voeg een beschrijving toe om het token in de toekomst te kunnen identificeren. (Optioneel)
4. Klik op het kopieericoon om het identiteitstoken naar je klembord te kopiëren. (Het kan handig zijn om dit identiteitstoken in een wachtwoordmanager op te slaan, omdat je het niet opnieuw kunt ophalen.)

Stel uw .npmrc in

Nu u een Agora-identiteitstoken heeft, kunt u uw .npmrc-bestand instellen om gebruik van de npm-infrastructuur mogelijk te maken voor het installeren van de Connector.

1. Bezoek de Toegang instellen voor Agora-pakketten site om de configuratie te maken die u in uw .npmrc-bestand kunt plakken. Let op dat geen van de informatie op deze pagina wordt opgeslagen of verzonden.
2. Voeg je e-mailadres toe (dit moet het adres zijn waarmee je bent geregistreerd op de Agora-site).
3. Plak je identiteitstoken in het bijbehorende tekstvak.
4. Klik op Genereer Configuratie om een configuratie te maken en klik op het kopieericoon.
5. Plak de gekopieerde regels in uw .npmrc-bestand. Het pad naar het bestand wordt op de site gespecificeerd voor Linux, macOS en Windows.

Na het volgen van deze stappen kun je het Axe DevTools Linter Connector npm-pakket gebruiken.

Voorbeeld .npmrc

Het volgende is een voorbeeld van de regels die aan uw .npmrc-configuratie moeten worden toegevoegd:

@axe-devtools:registry=https://agora.dequecloud.com/artifactory/api/npm/devtools-npm/
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:_auth="am9obmRvZUBleGFtcGxlLmNvbTpUaGlzIGlzbid0IGEgdmFsaWQgaWRlbnRpdHkgdG9rZW4K"
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:email=johndoe@example.com
//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:always-auth=true

De waarde die bij _auth is inbegrepen, is de base64-codering van <email>:<identity-token>.

//agora.dequecloud.com/artifactory/api/npm/devtools-npm/:_authToken="VGhpcyBpc24ndCBhIHZhbGlkIGlkZW50aXR5IHRva2VuCg=="

Installeren en Gebruiken

Je kunt de nieuwste versie van de Axe DevTools Connector installeren met:

npm install @axe-devtools/axe-linter-connector -g

Deze opdracht installeert de Connector wereldwijd. Controleer de installatie door de --version-optie te gebruiken:

axe-linter-connector --version

Volgende Stappen

• Zie de documentatie voor de Axe Linter Connector.
• (Externe JFrog-documentatie) Verbind je npm-client met Artifactory voor een gedetailleerde bespreking over hoe u uw .npmrc handmatig configureert.