Instructions d'installation sur site
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, effectuez 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.
Remarque : Nous vous recommandons fortement de ne continuer 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
psqlclientCreateSSOCustomers.pyle script doit avoir été exécuté- Utilisateurs de la base de données
assureetassure_ownerdoivent exister - La base de données cible doit être créée
Configurer le 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.gzCertificats 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.crtnginx.key
Instance Keycloak
Cet installateur nécessite un paramétrage Keycloak externe. Assurez-vous d'avoir les informations suivantes :
- URL : par ex.,
https://auth.deque.com - Royaume : par ex.,
axe - ID client
- ID de groupe
- Secret client
Installation
Configuration du rapport Axe
Modifiez le .env fichier :
vi axeauditor-docker/.envMigration de la base de données
- Accédez au dossier DB
- Modifiez
auditor_db_deploy.shpour définir les variables correctes
(Remarque : l'utilisateur DB doit être un superutilisateur) - Exécutez le script :
./auditor_db_deploy.shCharger les images Docker
docker load -i resources/axeauditor-2.25.0-ironbank-images.tarDémarrer les conteneurs Docker
cd axeauditor-docker/
docker compose up -dVérifier les journaux
docker logs -ft axeauditor-docker-axeauditor-1Recherchez la ligne :
Starting axe Auditor…Une fois visible, vous pouvez passer aux étapes suivantes.
Jeton OIDC
- Visitez l'URL d'authentification : par exemple,
https://auth.deque.com - Naviguez vers **Clients** → recherchez et sélectionnez votre client
- Accédez à 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 JSON Keycloak OIDC de l'étape précédente
- Entrez les identifiants administratifs du royaume
Activer le paramètre de partage de test
- Allez à la page **Paramètres d'administration**
- Assurez-vous que **Activer le partage de test** est **décoché par défaut**
(sauf indication contraire du client)
Mise à jour de la version axe Core et de la norme d'accessibilité
- Mettez à jour la **version axe-core** vers la **dernière recommandée**
- Définissez la **norme d'accessibilité par défaut** sur **WCAG 2.1 Niveau AA**
- Sélectionnez **toutes les normes d'accessibilité**
Afficher le tableau de score d'accessibilité
- Devrait être **coché** ou **selon la préférence du client**
Mettre à jour les paramètres des rapports axe
Si rapports axe a été activé lors de l'installation :
- Définir Mettre à jour les rapports axe option sur :
System Administrator only
Vérification de base par l'équipe QA et les experts en la matière
- 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 base
Supprimer le dossier d'installation (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