Axe DevTools Linter Gebruiken met een 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

Hoe configureer je Axe DevTools Linter om te werken met HTTP-proxies

Not for use with personal data

Axe DevTools Linter ondersteunt proxy-configuratie via omgevingsvariabelen, zodat je lintingverzoeken kunt routeren via de proxy-infrastructuur van je organisatie.

Vereisten

Om proxy-ondersteuning met Axe DevTools Linter te gebruiken, heb je het volgende nodig:

Proxysoftware die lokaal draait of op de servers van je organisatie
Het eindpunt van je proxy
Het certificaat van de certificaatautoriteit (CA) van de proxy (om het op je apparaat te autoriseren)

important

Bij gebruik van de door Deque gehoste SaaS-servers is HTTPS het enige ondersteunde protocol. Als je zelf een on-premises instantie host, kun je HTTP gebruiken en heb je het HTTP-eindpunt van je proxy nodig. Het HTTP-eindpunt bevindt zich meestal op dezelfde host als het HTTPS-eindpunt, maar op poort 80 in plaats van 443; verifieer dit bij je netwerkbeheerder.

Omgevingsvariabelen

Proxyconfiguratie voor Axe DevTools Linter wordt volledig afgehandeld via omgevingsvariabelen, die in twee categorieën vallen.

Standaard Proxy Omgevingsvariabelen

Variabele	Beschrijving
`HTTPS_PROXY`	Het eindpunt dat wordt gebruikt voor HTTPS-protocolverzoeken
`HTTP_PROXY`	Het eindpunt dat wordt gebruikt voor HTTP-protocolverzoeken
`NO_PROXY`	Een door komma's gescheiden lijst van hostnamen die de proxy moeten omzeilen

Axe DevTools Linter en Node.js Omgevingsvariabelen

Variabele	Beschrijving
`AXE_LINTER_USE_ENV_PROXY`	Schakelt proxy-ondersteuning specifiek in voor Axe DevTools Linter
`AXE_USE_ENV_PROXY`	Schakelt proxy-ondersteuning in voor alle Deque-tools die deze variabele ondersteunen
`NODE_USE_ENV_PROXY`	Node.js-native proxy-ondersteuning (alleen versie 24 of later)
`NODE_EXTRA_CA_CERTS`	Pad naar vertrouwde CA-certificaten voor HTTPS-verbindingen

note

De variabele NODE_USE_ENV_PROXY is geïntroduceerd in Node.js versie 24 om proxy-ondersteuning wereldwijd voor een proces mogelijk te maken. Axe DevTools Linter heeft ondersteuning voor deze variabele teruggeport naar alle Node.js-versies.

Proxy-ondersteuning Inschakelen

Om proxy-ondersteuning in te schakelen, stel je een van de variabelen AXE_* in op 1. Om proxy-ondersteuning voor Axe DevTools Linter uit te schakelen terwijl deze ingeschakeld blijft voor Node.js, stel je AXE_LINTER_USE_ENV_PROXY of AXE_USE_ENV_PROXY in op 0.

important

Alleen de waarden 1 (ingeschakeld) en 0 (uitgeschakeld) worden herkend. Elke andere waarde zal proxy-ondersteuning uitschakelen.

Voor HTTPS-verbindingen moet je het pad naar het certificaat van de certificeringsinstantie (CA) van je proxy opgeven met NODE_EXTRA_CA_CERTS. Zonder dit zullen verbindingen worden afgewezen als onbetrouwbaar.

Voorbeelden van Configuratie

Je kunt omgevingsvariabelen op twee manieren instellen: globaal voor een machine of CI-taak, of inline voor een enkel commando.

GitHub Actions Workflow

Het volgende voorbeeld laat zien hoe je proxy-omgevingsvariabelen configureert in een GitHub Actions workflow:

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

Lokale Commandoregel

Om proxy-variabelen in te stellen voor een enkel commando op Linux of macOS:

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

Axe DevTools Linter Connector Gebruiken met een Proxy

Bij het gebruik van Axe DevTools Linter Connector, configureer je de proxy-variabelen voordat je de connector uitvoert:

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/

De Proxy Omzeilen voor Specifieke Hosts

Gebruik de NO_PROXY-omgevingsvariabele om bestemmingshosts of domeinen aan te geven die niet via de proxy moeten gaan. Dit is nuttig wanneer bepaalde domeinen directe toegang nodig hebben.

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

Node.js 24 en Later

In Node.js versie 24 en later is NODE_USE_ENV_PROXY standaard ingeschakeld voor alle verzoeken. Als je de proxy voor Axe DevTools Linter wilt omzeilen terwijl deze ingeschakeld blijft voor andere verzoeken, gebruik dan de variabele 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

Zelfs als je AXE_LINTER_USE_ENV_PROXY=0 instelt, zal Node.js versie 24 of later verzoeken nog steeds via de proxy verzenden vanwege de wereldwijde verzoekverwerker. Gebruik NO_PROXY om de proxy voor specifieke domeinen te omzeilen.

Probleemoplossing

Certificaatfouten

Als u certificaatgerelateerde fouten ontvangt, zorg er dan voor dat:

Het pad van NODE_EXTRA_CA_CERTS wijst naar een geldig certificaatbestand
Het certificaat in PEM-formaat is
Het certificaat overeenkomt met de CA van uw proxy

Verbinding Geweigerd

Als verbindingen worden geweigerd:

Controleer of het proxy-eindpunt correct en toegankelijk is.
Controleer of de proxy actief is en verbindingen accepteert.
Bevestig dat u het juiste protocol gebruikt (HTTP versus HTTPS).

Proxy Wordt Niet Gebruikt

Als aanvragen niet via de proxy verlopen:

Controleer of, als AXE_LINTER_USE_ENV_PROXY is ingesteld, deze niet is ingesteld op een andere waarde dan 1.
Controleer of HTTPS_PROXY (of HTTP_PROXY voor on-premises) correct is ingesteld.
Zorg ervoor dat de doelhost of het doeldomein niet is opgenomen in NO_PROXY.

Zie Ook

De Axe DevTools Linter Connector Gebruiken voor command-line linting-opties
Het Inrichten van de Lokale Server voor zelf-gehoste installaties
Axe DevTools Linter Gebruik met een Reverse Proxy voor het beveiligen van je on-premises server