Instructies voor installatie op locatie

Inleiding

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

Media

U kunt de media vinden op de SFTP-server.

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

Back-up

Maak voordat u verder gaat een volledige momentopname van de server. Deze back-up 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 voltooien van een volledige serverback-up.

Vereisten

Zorg ervoor dat het volgende beschikbaar en geconfigureerd is:

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

Het instellen van de Media

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. Controleer of de SSL-directory bestaat:

ls axeauditor-docker/volumes/nginx/

2. Als deze niet bestaat, maak hem 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-opstelling. Zorg ervoor dat u over de volgende informatie beschikt:

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

Installatie

Configuratie van Axe-rapport

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

Docker Images laden

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

Docker Containers starten

cd axeauditor-docker/
docker compose up -d

Logbestanden controleren

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: bv., 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 auditorclient instellen

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

Deel Test Run Instelling inschakelen

• Ga naar de Beheerinstellingen pagina
• Zorg ervoor dat Deel Test Run inschakelen is uitgeschakeld
  (tenzij anders gespecificeerd door de klant)

axe Core Versie & Toegankelijkheidsnorm bijwerken

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

Toegankelijkheidsscorekaart tonen

• Moet ingeschakeld of volgens klantvoorkeur zijn

Axe-rapportinstellingen bijwerken

Als axe Reports was ingeschakeld tijdens de installatie:

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

Sanity Check door QA en SME's

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

Verwijder de Installer-map (Aanbeveling)

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

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