Instructies voor Installatie op Locatie

Inleiding

Deze gids behandelt de Docker-gebaseerde installatie op locatie van Axe Auditor versie 2.25.0.

Media

U 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

Maak een volledige momentopname van de server voordat u verder gaat. 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 pas verder te gaan nadat u een volledige backup van de server heeft gemaakt.

Vereisten

Zorg ervoor dat de volgende zaken beschikbaar en geconfigureerd zijn:

• Docker Engine
• Docker Compose / Podman Compose
• psql client
• CreateSSOCustomers.py script moet uitgevoerd zijn
• Databasegebruikers assure en assure_owner 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 deze dan aan:

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

3. Kopieer uw certificaten naar:

axeauditor-docker/volumes/nginx/ssl

4. Hernoem uw certificaatbestanden naar:

• nginx.crt
• nginx.key

Keycloak-instantie

Deze installer vereist een externe Keycloak-setup. Zorg ervoor dat u de volgende informatie heeft:

• URL: bijv. https://auth.deque.com
• Realm: bijv. axe
• Client-ID
• Groeps-ID
• Client-secret

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 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 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:
   bijv., docker-fi-215.dequeindiadev.com/system/client
2. Plak de Keycloak OIDC JSON van de vorige stap
3. Voer de realm admingegevens in

Deel testrun-instelling inschakelen

• Ga naar de **Admin-instellingen** pagina
• Zorg ervoor dat **Deel testrun inschakelen** standaard **is uitgeschakeld**
  (tenzij gespecificeerd door de klant)

axe Core-versie & toegankelijkheidsstandaard updaten

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

Toegankelijkheidsscorekaart weergeven

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

axe Reports-instellingen updaten

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

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

Controle door QA en vakspecialisten

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

Verwijder de Installatiemap (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