Installatie-instructies voor lokaal gebruik

Inleiding

Deze handleiding behandelt de op Docker gebaseerde lokale installatie van Axe Auditor versie 2.25.0.

Media

Je kunt de media vinden op de SFTP-server.

• Installatiebestand: axeauditor-docker-on-prem-installer-2.25.0.tar.gz
• SSL-certificaten: Moet in PEM-formaat zijn.

Backup

Maak een volledige momentopname van de server voordat je verdergaat. Deze backup kan worden gebruikt om het systeem te herstellen als er problemen optreden tijdens of na de installatie.

Opmerking: We raden ten zeerste aan om pas verder te gaan na het voltooien van een volledige serverbackup.

Vereisten

Zorg ervoor dat de volgende beschikbaar en geconfigureerd zijn:

• Docker Engine
• Docker Compose / Podman Compose
• psql client
• CreateSSOCustomers.py script moet zijn uitgevoerd
• Databasegebruikers assure en assure_owner moeten bestaan
• Doeldatabase moet zijn aangemaakt

Media instellen

1. Download axeauditor-docker-on-prem-installer-2.25.0.tar.gz
2. Navigeer naar de downloadmap
3. Pak het archief uit:

tar -xzf axeauditor-docker-on-prem-installer-2.25.0.tar.gz

SSL-certificaten

1. Zorg ervoor dat de SSL-map bestaat:

ls axeauditor-docker/volumes/nginx/

2. Als deze niet bestaat, maak hem aan:

mkdir -p axeauditor-docker/volumes/nginx/ssl

3. Kopieer je certificaten naar:

axeauditor-docker/volumes/nginx/ssl

4. Hernoem je certificaatbestanden naar:

• nginx.crt
• nginx.key

Keycloak-instantie

Deze installer vereist een externe Keycloak-setup. Zorg ervoor dat je over de volgende informatie beschikt:

• URL: bijv. https://auth.deque.com
• Realm: bijv. axe
• Client-ID
• Groep-ID
• Clientgeheim

Installatie

Axe-rapportconfiguratie

Bewerk het .env bestand:

vi axeauditor-docker/.env

Database-migratie

1. Navigeer naar de DB-map
2. Bewerk auditor_db_deploy.sh om de juiste variabelen in te stellen
   (Opmerking: DB-gebruiker moet superuser zijn)
3. Voer het script uit:

./auditor_db_deploy.sh

Docker-afbeeldingen laden

docker load -i resources/axeauditor-2.25.0-ironbank-images.tar

Start Docker-containers

cd axeauditor-docker/
docker compose up -d

Controleer logs

docker logs -ft axeauditor-docker-axeauditor-1

Zoek naar de regel:

Starting axe Auditor…

Zodra deze zichtbaar is, kunt u doorgaan met de resterende stappen.

OIDC-token

1. Bezoek de auth-URL: bijv., https://auth.deque.com
2. Navigeer naar Cliënten → zoek en selecteer uw cliënt
3. Ga naar het tabblad Installatie
4. Selecteer Keycloak OIDC JSON
5. Kopieer en bewaar de waarde voor later gebruik

Een nieuwe auditor cliënt instellen

1. Bezoek de systeemclient setup-URL:
   bijv., docker-fi-215.dequeindiadev.com/system/client
2. Plak de Keycloak OIDC JSON uit de vorige stap
3. Voer de beheerdersreferenties van de realm in

Deeltestruninstelling inschakelen

• Ga naar de pagina Beheerinstellingen
• Zorg ervoor dat Deeltestrun inschakelen is standaard uitgeschakeld
  (tenzij gespecificeerd door de klant)

axe Core-versie en toegankelijkheidsstandaard bijwerken

• Werk de axe-core versie bij naar de laatst aanbevolen
• Stel Standaard toegankelijkheidsnorm in op WCAG 2.1 Niveau AA
• Selecteer alle toegankelijkheidsnormen

Toegankelijkheidsscorekaart weergeven

• Moet ingeschakeld of volgens klantvoorkeur zijn

axe Reports-instellingen bijwerken

Als axe Reports werd ingeschakeld tijdens de installatie:

• Stel de axe Reports bijwerken optie in op:
  System Administrator only

Nacontrole door QA en deskundigen

1. Blader naar de Axe Auditor server-URL
2. Controleer de applicatie-voettekst voor versie: 2.25.0
3. Voer een basiscontrole van de gebruikersinterface uit
4. Vraag het QA-team om een nacontrole uit te voeren

De installatiemap verwijderen (aanbeveling)

Na installatie wordt aanbevolen om het installarchiefr en de uitgepakte bestanden te verwijderen:

rm -f axeauditor-docker-on-prem-installer-2.25.0.tar.gz