Instructies voor installatie op locatie

Inleiding

Deze gids behandelt de Docker-gebaseerde installatie op locatie 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 voor 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 sterk aan om pas verder te gaan na het maken van een volledige serverbackup.

Vereisten

Zorg ervoor dat het volgende beschikbaar en geconfigureerd is:

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

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-directory 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-installatie. Zorg ervoor dat je de volgende informatie hebt:

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

Installatie

Axe Report Configuratie

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 een superuser zijn)
3. Voer het script uit:

./auditor_db_deploy.sh

Laad Docker-afbeeldingen

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 overige stappen.

OIDC-token

1. Bezoek de auth URL: bijv. https://auth.deque.com
2. Navigeer naar **Clients** → zoek en selecteer uw client
3. Ga naar de **Installatie** tab
4. Selecteer **Keycloak OIDC JSON**
5. Kopieer en bewaar de waarde voor later gebruik

Een nieuwe auditorclient instellen

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

Deel testrun-instelling inschakelen

• Ga naar de **Beheerinstellingen** pagina
• Zorg ervoor dat **Deel testrun inschakelen** standaard **uitgevinkt**
  (tenzij gespecificeerd door de klant)

axe Core-versie & toegankelijkheidsstandaard bijwerken

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

Toegankelijkheidsscorekaart weergeven

• Moet **aangevinkt** zijn of **volgens klantvoorkeur**

axe Reports-instellingen bijwerken

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

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

Sanity Check door QA en SMEs

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

Verwijder de Installer-map (Aanbeveling)

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

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