Installer le connecteur Axe DevTools Linter en tant que paquet npm

Cet article décrit comment télécharger et installer le connecteur Axe DevTools en utilisant Agora comme registre de paquets npm. Cela vous permet de profiter de l'infrastructure fournie par Node.js et npm pour télécharger, versionner et mettre à jour votre binaire du connecteur Axe DevTools Linter, évitant ainsi les étapes manuelles requises lorsque vous téléchargez le connecteur directement via la page de téléchargements .

Qu'est-ce qu'Agora ?

Agora est le dépôt de Deque (hébergé par JFrog comme usine d'artéfacts ou artifactory), qui stocke de manière sécurisée des artéfacts binaires (paquets, bibliothèques et exécutables) et nécessite un compte pour y accéder. Agora héberge le connecteur Axe Linter (à la fois le paquet npm et l'exécutable téléchargeable manuellement).

Créer un jeton d'identité Agora

La première étape consiste à créer un jeton d'identité qu'npm utilisera pour authentifier votre session Agora. Les jetons d'identité Agora expirent après un an, ils doivent donc être recréés annuellement.

1. Visitez votre page de profil Agora pour obtenir un jeton d'identité. (Si vous n'êtes pas connecté à Agora, vous pourriez être redirigé vers une page d'accueil différente de votre profil après vous être connecté. Cliquez à nouveau sur le même lien une deuxième fois après vous être connecté pour accéder à votre page de profil. Ou cliquez sur le bouton à droite du bouton d'aide dans le coin supérieur droit, puis cliquez sur Modifier le profil.)
2. Cliquez sur Générer un jeton d'identité.
3. Ajoutez une description pour identifier le jeton à l'avenir. (Optionnel)
4. Cliquez sur l'icône de copie pour copier le jeton d'identité dans votre presse-papiers. (Vous voudrez peut-être enregistrer ce jeton d'identité dans un gestionnaire de mots de passe car vous ne pourrez pas le récupérer.)

Configurez votre .npmrc

Maintenant que vous avez un jeton d'identité Agora, vous pouvez configurer votre .npmrc fichier pour permettre l'utilisation de l'infrastructure npm pour installer le connecteur.

1. Visitez le site Configurer l'accès aux paquets Agora pour créer la configuration à coller dans votre .npmrc fichier. Notez qu'aucune des informations de cette page n'est stockée ou transmise.
2. Ajoutez votre adresse e-mail (elle doit être celle avec laquelle vous êtes inscrit sur le site Agora).
3. Collez votre jeton d'identité dans la zone de texte correspondante.
4. Cliquez sur Générer la configuration pour créer une configuration et cliquez sur l'icône de copie.
5. Collez les lignes copiées dans votre .npmrc fichier. Le chemin vers le fichier est spécifié sur le site pour Linux, macOS et Windows.

Après avoir suivi ces étapes, vous pouvez utiliser le paquet npm Axe DevTools Linter Connector.

Exemple .npmrc

Voici un exemple des lignes à ajouter à votre configuration de .npmrc :

@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

La valeur incluse avec _auth est l'encodage base64 de <email>:<identity-token>.

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

Installation et utilisation

Vous pouvez installer la dernière version du connecteur Axe DevTools avec :

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

Cette commande installe le connecteur globalement. Vérifiez l'installation en utilisant l'option --version :

axe-linter-connector --version

Prochaines étapes

• Consultez la documentation pour le connecteur Axe Linter.
• (documentation externe de JFrog) Connecter votre client npm à Artifactory pour une discussion détaillée sur la configuration de votre .npmrc manuellement.