Anleitungen zur Installation vor Ort

This page is not available in the language you requested. You have been redirected to the English version of the page.
Link to this page copied to clipboard
Not for use with personal data

Einleitung

Diese Anleitung behandelt die Docker-basierte Installation von Axe Auditor Version 2.25.0 für On-Premise.

Medien

Sie finden die Medien auf dem SFTP-Server.

  • Installationsdatei: axeauditor-docker-on-prem-installer-2.25.0.tar.gz
  • SSL-Zertifikate: Sollte im PEM-Format sein.

Backup

Vor dem Fortfahren erstellen Sie eine vollständige Momentaufnahme des Servers. Dieses Backup kann verwendet werden, um das System bei auftretenden Problemen während oder nach der Installation wiederherzustellen.

Hinweis: Wir empfehlen dringend, erst nach Abschluss einer vollständigen Sicherung des Servers fortzufahren.

Voraussetzungen

Stellen Sie sicher, dass Folgendes verfügbar und konfiguriert ist:

  • Docker-Engine
  • Docker Compose / Podman Compose
  • psql Client
  • CreateSSOCustomers.py Skript sollte ausgeführt worden sein
  • Datenbankbenutzer assure und assure_owner sollten existieren
  • Zieldatenbank sollte erstellt werden

Einrichten der Medien

  1. Laden Sie axeauditor-docker-on-prem-installer-2.25.0.tar.gz herunter
  2. Navigieren Sie zum Download-Verzeichnis
  3. Archiv extrahieren:
tar -xzf axeauditor-docker-on-prem-installer-2.25.0.tar.gz

SSL-Zertifikate

  1. Stellen Sie sicher, dass das SSL-Verzeichnis existiert:
ls axeauditor-docker/volumes/nginx/
  1. Falls es nicht existiert, erstellen Sie es:
mkdir -p axeauditor-docker/volumes/nginx/ssl
  1. Kopieren Sie Ihre Zertifikate nach:
axeauditor-docker/volumes/nginx/ssl
  1. Benennen Sie Ihre Zertifikatdateien um zu:
  • nginx.crt
  • nginx.key

Keycloak-Instanz

Dieser Installer benötigt eine externe Keycloak-Konfiguration. Stellen Sie sicher, dass Sie die folgenden Informationen haben:

  • URL: z. B. https://auth.deque.com
  • Realm: z. B. axe
  • Client-ID
  • Gruppen-ID
  • Client-Geheimnis

Installation

Axe-Report-Konfiguration

Bearbeiten Sie die .env-Datei:

vi axeauditor-docker/.env

Datenbankmigration

  1. Navigieren Sie zum DB-Verzeichnis
  2. Bearbeiten Sie auditor_db_deploy.sh, um die korrekten Variablen
    (Hinweis: Der DB-Benutzer muss ein Superuser sein) festzulegen
  3. Führen Sie das Skript aus:
./auditor_db_deploy.sh

Docker-Images laden

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

Docker-Container starten

cd axeauditor-docker/
docker compose up -d

Protokolle prüfen

docker logs -ft axeauditor-docker-axeauditor-1

Suchen Sie nach der Zeile:

Starting axe Auditor…

Sobald sichtbar, können Sie mit den restlichen Schritten fortfahren.

OIDC-Token

  1. Besuchen Sie die Auth-URL: z.B. https://auth.deque.com
  2. Navigieren Sie zu Clients → suchen und wählen Sie Ihren Client aus
  3. Gehen Sie zum Installation-Tab
  4. Wählen Sie Keycloak OIDC JSON aus
  5. Kopieren und speichern Sie den Wert für die spätere Verwendung

Einrichten eines neuen Auditor-Clients

  1. Besuchen Sie die URL für die System-Client-Einrichtung:
    z.B. docker-fi-215.dequeindiadev.com/system/client
  2. Fügen Sie das Keycloak OIDC JSON aus dem vorherigen Schritt ein
  3. Geben Sie die Administratoranmeldedaten des Realms ein

Einstellung 'Teilen von Testruns' aktivieren

  • Gehen Sie zur Admin-Einstellungen-Seite
  • Stellen Sie sicher, dass Teilen von Testruns aktivieren standardmäßig deaktiviert
    (sofern nicht vom Kunden angegeben) ist

Aktualisierung der axe-Core-Version & Barrierefreiheitsstandard

  • Aktualisieren Sie das axe-core-Version auf das neueste empfohlene
  • Setzen Sie Standard-Barrierefreiheitsstandard auf WCAG 2.1 Level AA
  • Wählen Sie alle Barrierefreiheitsstandards aus

Barrierefreiheitsbewertungsbogen anzeigen

  • Sollte aktiviert oder nach Kundenwunsch sein

Aktualisierung der axe-Berichtseinstellungen

Falls axe-Berichte während der Installation aktiviert war:

  • Setzen Sie die axe-Berichte aktualisieren-Option auf:
    System Administrator only

Prüfung durch QA und Fachexperten

  1. Navigieren Sie zur Axe Auditor-Server-URL
  2. Überprüfen Sie die Fußzeile der Anwendung auf die Version: 2.25.0
  3. Führen Sie eine grundlegende UI-Überprüfung durch
  4. Fordern Sie das QA-Team auf, eine Prüfung durchzuführen

Löschen des Installationsordners (Empfehlung)

Nach der Installation wird empfohlen, das Installationsarchiv und die extrahierten Dateien zu löschen:

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

Is this page helpful?

Help us improve this page

Still need help?