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 NODE_USE_ENV_PROXY variabele werd geïntroduceerd in Node.js versie 24 om proxy-ondersteuning wereldwijd voor een proces in te schakelen. Axe DevTools Linter heeft ondersteuning voor deze variabele teruggeport om in alle Node.js-versies te werken.

Proxy-ondersteuning Inschakelen

Om proxy-ondersteuning in te schakelen, stel je een van de AXE_* variabelen in op 1. Om proxy-ondersteuning voor Axe DevTools Linter uit te schakelen terwijl het voor Node.js ingeschakeld blijft, stel je of 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 schakelt proxy-ondersteuning uit.

Voor HTTPS-verbindingen moet je het pad naar het certificaat van de certificaatautoriteit (CA) van je proxy opgeven met NODE_EXTRA_CA_CERTS. Zonder dit worden verbindingen 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 gebruik van de Axe DevTools Linter Connector, configureer 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 op te geven die niet door de proxy behandeld moeten worden. 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, NODE_USE_ENV_PROXY is standaard ingeschakeld voor alle verzoeken. Als u de proxy wilt omzeilen voor Axe DevTools Linter terwijl deze voor andere verzoeken ingeschakeld blijft, gebruik dan de NO_PROXY variabele:

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 u AXE_LINTER_USE_ENV_PROXY=0instelt, zal Node.js versie 24 of later nog steeds verzoeken via de proxy routeren vanwege de wereldwijde verzoekdispatcher. Gebruik NO_PROXY om de proxy voor specifieke domeinen te omzeilen.

Probleemoplossing

Certificaatfouten

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

Het NODE_EXTRA_CA_CERTS pad verwijst 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 AXE_LINTER_USE_ENV_PROXY is ingesteld, dat het niet is ingesteld op een andere waarde dan 1.
Controleer dat HTTPS_PROXY (of HTTP_PROXY voor lokale installaties) correct is ingesteld.
Zorg ervoor dat de doelhost of -domein 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 uw lokale server