Uso de Axe DevTools Linter con un Proxy

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

Cómo configurar Axe DevTools Linter para trabajar con proxies HTTP

Not for use with personal data

Axe DevTools Linter admite la configuración de proxy a través de variables de entorno, lo que le permite enrutar solicitudes de análisis a través de la infraestructura de proxy de su organización.

Requisitos

Para usar el soporte de proxy con Axe DevTools Linter, necesita:

Software de proxy en ejecución localmente o en los servidores de su organización
El endpoint de su proxy
El certificado de autoridad (CA) del proxy (para autorizarlo en su máquina)

important

Al utilizar los servidores SaaS alojados por Deque, HTTPS es el único protocolo compatible. Si aloja una instancia local por su cuenta, puede usar HTTP y necesitará el endpoint HTTP de su proxy. El endpoint HTTP generalmente está en el mismo host que el endpoint HTTPS, pero en el puerto 80 en lugar de 443; verifique esto con su administrador de red.

Variables de Entorno

La configuración de proxy para Axe DevTools Linter se maneja completamente a través de variables de entorno, que se dividen en dos categorías.

Variables de Entorno Estándar de Proxy

Variable	Descripción
`HTTPS_PROXY`	El endpoint utilizado para solicitudes de protocolo HTTPS
`HTTP_PROXY`	El endpoint utilizado para solicitudes de protocolo HTTP
`NO_PROXY`	Una lista de hostnames, separada por comas, que deberían eludir el proxy

Variables de Entorno de Axe DevTools Linter y Node.js

Variable	Descripción
`AXE_LINTER_USE_ENV_PROXY`	Habilita el soporte de proxy específicamente para Axe DevTools Linter
`AXE_USE_ENV_PROXY`	Habilita el soporte de proxy para todas las herramientas Deque que admiten esta variable
`NODE_USE_ENV_PROXY`	Soporte nativo de proxy de Node.js (solo versión 24 o posterior)
`NODE_EXTRA_CA_CERTS`	Ruta a los certificados CA de confianza para conexiones HTTPS

note

La variable NODE_USE_ENV_PROXY fue introducida en Node.js versión 24 para habilitar el soporte de proxy globalmente para un proceso. Axe DevTools Linter ha retroportado soporte para esta variable para funcionar en todas las versiones de Node.js.

Habilitar el Soporte de Proxy

Para habilitar el soporte de proxy, configure cualquiera de las variables AXE_* en 1. Para desactivar el soporte de proxy para Axe DevTools Linter mientras lo mantiene habilitado para Node.js, configure AXE_LINTER_USE_ENV_PROXY o AXE_USE_ENV_PROXY en 0.

important

Solo se reconocen los valores 1 (habilitado) y 0 (deshabilitado). Cualquier otro valor desactivará el soporte de proxy.

Para conexiones HTTPS, debe especificar la ruta al certificado de autoridad (CA) de su proxy usando NODE_EXTRA_CA_CERTS. Sin esto, las conexiones serán rechazadas como no confiables.

Ejemplos de Configuración

Puede establecer variables de entorno de dos maneras: globalmente para una máquina o tarea de CI, o en línea para un solo comando.

Flujo de Trabajo de GitHub Actions

El siguiente ejemplo muestra cómo configurar las variables de entorno de proxy en un flujo de trabajo de GitHub Actions:

jobs:
  lint:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Run Axe DevTools Linter
        env:
          HTTPS_PROXY: https://localhost:9090
          NODE_EXTRA_CA_CERTS: /path/to/ca.pem
          AXE_LINTER_USE_ENV_PROXY: 1
        run: npm run lint

Línea de Comando Local

Para establecer las variables de proxy para un solo comando en Linux o macOS:

AXE_LINTER_USE_ENV_PROXY=1 HTTPS_PROXY=https://localhost:9090 NODE_EXTRA_CA_CERTS=/path/to/ca.pem npm run lint

Uso del Conector de Axe DevTools Linter con un Proxy

Al usar el Conector de Axe DevTools Linter, configure las variables de proxy antes de ejecutar el conector:

export HTTPS_PROXY=https://proxy.example.com:9090
export NODE_EXTRA_CA_CERTS=/path/to/ca.pem
export AXE_LINTER_USE_ENV_PROXY=1

axe-linter-connector -s . -d . --api-key YOUR_API_KEY --url https://axe-linter.deque.com/

Evitar el Proxy para Hosts Específicos

Utilice la variable de entorno NO_PROXY para especificar los hosts o dominios de destino que no deben pasar por el proxy. Esto es útil cuando ciertos dominios necesitan acceso directo.

NO_PROXY=internal.example.com,localhost axe-linter-connector -s . -d .

Node.js 24 y Posteriores

En la versión 24 de Node.js y posteriores, NODE_USE_ENV_PROXY está habilitado por defecto para todas las solicitudes. Si necesita evitar el proxy para Axe DevTools Linter mientras lo mantiene habilitado para otras solicitudes, use la variable NO_PROXY:

NODE_USE_ENV_PROXY=1 HTTPS_PROXY=https://our.intranet/proxy NO_PROXY=axe.deque.com,axe-linter.deque.com npm run lint

tip

Incluso si establece AXE_LINTER_USE_ENV_PROXY=0, la versión 24 de Node.js o posterior aún enrutará las solicitudes a través del proxy debido al despachador de solicitudes global. Use NO_PROXY para evitar el proxy para dominios específicos.

Solución de Problemas

Errores de Certificado

Si recibe errores relacionados con certificados, asegúrese de que:

La ruta NODE_EXTRA_CA_CERTS apunte a un archivo de certificado válido
El certificado esté en formato PEM
El certificado coincida con el CA de su proxy

Conexión Rechazada

Si se rechazan las conexiones:

Verifique que el endpoint del proxy sea correcto y accesible.
Compruebe que el proxy esté ejecutándose y aceptando conexiones.
Confirme que está utilizando el protocolo correcto (HTTP vs HTTPS).

El Proxy No Está Siendo Utilizado

Si las solicitudes no pasan a través del proxy:

Verifique que si AXE_LINTER_USE_ENV_PROXY está configurado, no esté configurado con un valor distinto a 1.
Compruebe que HTTPS_PROXY (o HTTP_PROXY para instalaciones locales) esté configurado correctamente.
Asegúrese de que el host o dominio de destino no esté listado en NO_PROXY.

Ver También

Uso del Conector de Axe DevTools Linter para opciones de linting en la línea de comandos
Configuración del Servidor Local para instalaciones autohospedadas
Uso de Axe DevTools Linter con un Proxy Inverso para asegurar su servidor local