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 : Devrait être au format PEM.

Sauvegarde

Avant de procéder, faites une capture complète du serveur. Cette sauvegarde peut être utilisée pour restaurer le système en cas de problème pendant ou après l'installation.

Note : Nous vous recommandons fortement de continuer seulement 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 aurait dû être exécuté
Les utilisateurs de base de données assure et assure_owner devraient exister
La base de données ciblée doit être créée

Mise en place des médias

Télécharger axeauditor-docker-on-prem-installer-2.25.0.tar.gz
Naviguez jusqu'au 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 certificat en :

nginx.crt
nginx.key

Instance Keycloak

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

URL : par exemple, https://auth.deque.com
Royaume : par exemple, axe
ID Client
ID Groupe
Secret Client

Installation

Configuration du rapport Axe

Modifier le fichier .env :

vi axeauditor-docker/.env

Migration de base de données

Naviguez jusqu'au dossier DB
Modifiez 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

Recherchez la ligne :

Starting axe Auditor…

Une fois visible, vous pouvez continuer avec les étapes restantes.

Jeton OIDC

Visitez l'URL d'authentification : par exemple, https://auth.deque.com
Accédez à 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

Configurer un nouveau client auditeur

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

Activer le paramètre de partage de test

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

Mise à jour de la version axe Core et de la norme d'accessibilité

Mettre à jour version axe-core vers dernière recommandée
Définir norme d'accessibilité par défaut sur WCAG 2.1 Niveau AA
Sélectionnez toutes les normes d'accessibilité

Afficher la carte des scores d'accessibilité

Devrait être coché 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 :

Définir l'option Mettre à jour axe Reports sur :
System Administrator only

Vérification de cohérence par l'équipe QA et les experts (SMEs)

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 base de l'interface utilisateur
Demandez à l'équipe QA d'effectuer une vérification de cohérence

Supprimer le dossier d'installation (Recommandation)

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

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