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édia

Vous pouvez trouver le média 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 continuer, 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 recommandons vivement de ne procéder qu'après avoir effectué une sauvegarde complète du serveur.

Prérequis

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

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

Configuration du média

Téléchargez axeauditor-docker-on-prem-installer-2.25.0.tar.gz
Accédez au répertoire de téléchargement
Extrayez 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 de Keycloak

Cet installateur nécessite un paramétrage externe de Keycloak. 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 d'Axe Report

Modifiez le .env fichier :

vi axeauditor-docker/.env

Migration de base de données

Accédez 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 poursuivre avec les étapes restantes.

Token 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

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 d'administration du domaine

Activer le paramètre de partage des tests

Accédez aux Paramètres d'administration
Assurez-vous que Activer le partage de test est désactivé par défaut
(sauf spécifié par le client)

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

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

Afficher le tableau de bord de l'accessibilité

Doit être coché ou selon la préférence du client

Mettre à jour les paramètres des rapports axe

Si **Rapports axe** a été activé pendant l'installation :

Définir **Mettre à jour les rapports axe** option sur :
System Administrator only

Vérification de la cohérence par l'assurance qualité et les experts métiers

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 la 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