Instalación del Conector de Axe DevTools Linter como paquete de npm

Este artículo describe cómo descargar e instalar el Conector de Axe DevTools usando Agora como un registro de paquetes npm. Al hacerlo, puedes aprovechar la infraestructura proporcionada por Node.js y npm para descargar, versionar y actualizar tu binario del Conector de Axe DevTools Linter, evitando los pasos manuales requeridos cuando descargas el Conector directamente desde la página de descargas .

¿Qué es Agora?

Agora es el repositorio de Deque (alojado por JFrog como una fábrica de artefactos o artifactory), que almacena de manera segura artefactos binarios (paquetes, bibliotecas y ejecutables) y requiere una cuenta para acceder. Agora aloja el Conector de Axe Linter (tanto el paquete de npm como el ejecutable descargable manualmente).

Crear un Token de Identidad de Agora

El primer paso es crear un token de identidad que npm usará para autenticar tu sesión de Agora. Los tokens de identidad de Agora vencen después de un año, por lo que deben recrearse anualmente.

1. Visita tu página de perfil de Agora para obtener un token de identidad. (Si no has iniciado sesión en Agora, podrías ser redirigido a una página de inicio diferente a tu página de perfil después de iniciar sesión. Haz clic en el mismo enlace una segunda vez después de iniciar sesión para ir a tu página de perfil. O haz clic en el botón a la derecha del botón de ayuda en la esquina superior derecha, y luego haz clic en Editar Perfil.)
2. Haz clic en Generar un Token de Identidad.
3. Añade una descripción para ayudar a identificar el token en el futuro. (Opcional)
4. Haz clic en el icono de copiar para copiar el token de identidad a tu portapapeles. (Quizás quieras guardar este token de identidad en un gestor de contraseñas porque no podrás recuperarlo nuevamente.)

Configura Tu .npmrc

Ahora que tienes un token de identidad de Agora, puedes configurar tu .npmrc archivo para habilitar el uso de la infraestructura de npm para instalar el Conector.

1. Visita el sitio de Configuración de Acceso a los paquetes de Agora para crear la configuración que debes pegar en tu .npmrc archivo. Ten en cuenta que ninguna de la información de esta página se almacena o transmite.
2. Añade tu dirección de correo electrónico (debe ser la que está registrada en el sitio de Agora).
3. Pega tu token de identidad en el cuadro de texto correspondiente.
4. Haz clic en Generar Configuración para crear una configuración y haz clic en el icono de copiar.
5. Pega las líneas copiadas en tu .npmrc archivo. La ruta al archivo está especificada en el sitio para Linux, macOS y Windows.

Después de seguir estos pasos, puedes utilizar el paquete de npm del Conector de Axe DevTools Linter.

Ejemplo .npmrc

Lo siguiente es un ejemplo de las líneas que deben añadirse a tu .npmrc configuración:

@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

El valor incluido con _auth es la codificación base64 de <email>:<identity-token>.

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

Instalación y Uso

Puedes instalar la última versión del Conector Axe DevTools con:

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

Este comando instala el Conector globalmente. Verifica la instalación usando la opción --version :

axe-linter-connector --version

Próximos Pasos

• Consulta la documentación para el Conector de Axe Linter.
• (Documentación externa JFrog) Conecta Tu Cliente npm a Artifactory para una discusión detallada de cómo configurar tu .npmrc manualmente.