Installatie-instructies voor On-premises

Inleiding

Deze handleiding behandelt de Docker-gebaseerde on-prem 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: Moeten in PEM-formaat zijn.

Backup

Neem voordat je verdergaat een volledige snapshot van de server. Deze backup kan worden gebruikt om het systeem te herstellen in geval van problemen tijdens of na de installatie.

Opmerking: We raden ten zeerste aan om pas door te gaan nadat je een volledige serverbackup hebt gemaakt.

Vereisten

Zorg ervoor dat het volgende beschikbaar en geconfigureerd is:

• 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. Ga 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-directory bestaat:

ls axeauditor-docker/volumes/nginx/

2. Als deze niet bestaat, maak deze dan 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

Voor deze installer is een externe Keycloak-setupvereist. Zorg ervoor dat je de volgende informatie hebt:

• URL: bijv. https://auth.deque.com
• Rijk: bijv. axe
• Client-ID
• Groep-ID
• Client Secret

Installatie

Axe Rapport Configuratie

Bewerk het .env bestand:

vi axeauditor-docker/.env

Databasemigratie

1. Ga naar de DB-map
2. Bewerk auditor_db_deploy.sh om de juiste variabelen in te stellen
   (Let op: DB-gebruiker moet een 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

Docker-containers starten

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: bijvoorbeeld, https://auth.deque.com
2. Navigeer naar Clients → zoek en selecteer uw client
3. Ga naar het Installatie tabblad
4. Selecteer Keycloak OIDC JSON
5. Kopieer en bewaar de waarde voor later gebruik

Een nieuwe auditor-client instellen

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

Deel testrun-instelling inschakelen

• Ga naar de Beheerinstellingen pagina
• Zorg ervoor dat Deel testrun-inschakeling standaard is uitgeschakeld
  (tenzij gespecificeerd door de klant)

Bijwerken van axe Core Versie & Toegankelijkheidsstandaard

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

Toegankelijkheidsscorekaart weergeven

• Moet aangevinkt zijn of volgens de voorkeur van de klant

Instellingen voor axe-rapporten bijwerken

Als **axe Reports** was ingeschakeld tijdens de installatie:

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

Validatie door QA en SME's

1. Navigeer naar de URL van de Axe Auditor-server
2. Controleer de applicatievoet voor versie: 2.25.0
3. Voer een basisverificatie van de gebruikersinterface uit
4. Vraag het QA-team om een validatie uit te voeren

Verwijder de installatiemap (Aanbeveling)

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

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