Installatie-instructies voor on-premises

Inleiding

Deze gids behandelt de Docker-gebaseerde on-prem installatie 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.

Back-up

Neem voordat u verdergaat een volledige snapshot 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 nadat u een volledige back-up van de server heeft gemaakt.

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 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-map 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-configuratie. Zorg ervoor dat u de volgende informatie heeft:

• 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: De 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

Logs Controleren

docker logs -ft axeauditor-docker-axeauditor-1

Zoek naar de regel:

Starting axe Auditor…

Zodra zichtbaar, kunt u doorgaan met de resterende stappen.

OIDC-token

1. Bezoek de auth-URL: bijv. https://auth.deque.com
2. Ga 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

Opzetten van een Nieuwe Auditor Client

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 beheerdersreferenties van het realm in

Delen Test Run Instelling Inschakelen

• Ga naar de **Beheerinstellingen** pagina
• Zorg ervoor dat **Delen Test Run Inschakelen** standaard is **uitgeschakeld**
  (tenzij gespecificeerd door de klant)

Axe Core Versie & Toegankelijkheidsstandaard Bijwerken

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

Toegankelijkheidsscore Kaart Tonen

• Moet **ingeschakeld** zijn of **volgens de voorkeur van de klant**

Instellingen voor Axe-rapporten Bijwerken

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

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

Controle door QA en deskundigen

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

Verwijder de installer map (Aanbeveling)

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

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