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 téléchargements.

Qu'est-ce qu'Agora ?

Agora est le dépôt de Deque (hébergé par JFrog en tant qu'usine d'artéfacts ou artifactory), qui stocke de manière sécurisée les 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 page de profil après vous être connecté. Cliquez une seconde fois sur même lien après vous être connecté pour aller sur votre page de profil. Ou cliquez sur le bouton à droite du bouton d'aide en haut à droite, 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.)

Configurer votre .npmrc

Maintenant que vous avez un jeton d'identité Agora, vous pouvez configurer votre fichier .npmrc pour activer 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 fichier .npmrc. Notez qu'aucune des informations sur cette page n'est stockée ni 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 fichier .npmrc. 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 de .npmrc

Voici un exemple des lignes qui doivent être ajoutées à votre configuration .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 JFrog) Connecter votre client npm à Artifactory pour une discussion détaillée sur la manière de configurer votre .npmrc manuellement.