Instructions d'installation sur site

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

Introduction

Ce guide couvre l'installation sur site basée sur Docker de la version 2.25.0 d'Axe Auditor.

Médias

Vous pouvez trouver les médias sur le serveur SFTP.

Fichier d'installation : axeauditor-docker-on-prem-installer-2.25.0.tar.gz
Certificats SSL : Doivent être au format PEM.

Sauvegarde

Avant de procéder, prenez un instantané complet du serveur. Cette sauvegarde peut être utilisée pour restaurer le système en cas de problèmes pendant ou après l'installation.

Remarque : Nous vous recommandons fortement de continuer uniquement après avoir effectué une sauvegarde complète du serveur.

Prérequis

Assurez-vous que les éléments suivants sont disponibles et configurés :

Docker Engine
Docker Compose / Podman Compose
psql client
CreateSSOCustomers.py le script doit avoir été exécuté
Utilisateurs de la base de données assure et assure_owner doivent exister
La base de données cible doit être créée

Configuration des médias

Télécharger axeauditor-docker-on-prem-installer-2.25.0.tar.gz
Naviguer vers le répertoire de téléchargement
Extraire l'archive :

tar -xzf axeauditor-docker-on-prem-installer-2.25.0.tar.gz

Certificats SSL

Assurez-vous que le répertoire SSL existe :

ls axeauditor-docker/volumes/nginx/

S'il n'existe pas, créez-le :

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

Copiez vos certificats vers :

axeauditor-docker/volumes/nginx/ssl

Renommez vos fichiers de certificats en :

nginx.crt
nginx.key

Instance Keycloak

Cet installateur nécessite une configuration Keycloak externe. Assurez-vous d'avoir les informations suivantes :

URL : par exemple, https://auth.deque.com
Royaume : par exemple, axe
ID client
ID de groupe
Secret client

Installation

Configuration du rapport Axe

Éditer le .env fichier :

vi axeauditor-docker/.env

Migration de la base de données

Naviguer vers le dossier DB
Modifier auditor_db_deploy.sh pour définir les variables correctes
(Remarque : l'utilisateur DB doit être un superutilisateur)
Exécutez le script :

./auditor_db_deploy.sh

Charger les images Docker

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

Démarrer les conteneurs Docker

cd axeauditor-docker/
docker compose up -d

Vérifier les journaux

docker logs -ft axeauditor-docker-axeauditor-1

Cherchez la ligne :

Starting axe Auditor…

Une fois visible, vous pouvez procéder aux étapes restantes.

Jeton OIDC

Visitez l'URL d'authentification : par exemple, https://auth.deque.com
Naviguez vers Clients → recherchez et sélectionnez votre client
Allez à l'onglet Installation
Sélectionnez Keycloak OIDC JSON
Copiez et enregistrez la valeur pour une utilisation ultérieure

Configuration d'un nouveau client auditeur

Visitez l'URL de configuration du client système :
par exemple, docker-fi-215.dequeindiadev.com/system/client
Collez le JSON OIDC de Keycloak de l'étape précédente
Entrez les identifiants administratifs du domaine

Activer le paramètre de partage du test

Allez à la page des Paramètres Admin
Assurez-vous que Activer le partage de test soit désactivé par défaut
(sauf indication contraire du client)

Mise à jour de la version de axe Core & standard d'accessibilité

Mettez à jour la version axe-core vers la version dernière recommandée
Définissez le standard d'accessibilité par défaut à WCAG 2.1 Niveau AA
Sélectionnez tous les standards d'accessibilité

Afficher la carte de score d'accessibilité

Cela doit être activé ou selon la préférence du client

Mettre à jour les paramètres des rapports axe

Si **axe Reports** a été activé lors de l'installation :

Réglez **Mettre à jour les axe Reports** option sur :
System Administrator only

Vérification de cohérence par QA et experts

Accédez à l'URL du serveur Axe Auditor
Vérifiez le pied de page de l'application pour la version : 2.25.0
Effectuez une vérification de l'interface utilisateur de base
Demandez à l'équipe QA de réaliser une vérification de cohérence

Supprimer le dossier de l'installateur (Recommandation)

Après l'installation, il est recommandé de supprimer l'archive de l'installateur et les fichiers extraits :

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