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é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 : Doit ê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ème pendant ou après l'installation.
Remarque : Nous recommandons fortement 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
- Client
psql - Le script
CreateSSOCustomers.pydevrait avoir été exécuté - Les utilisateurs de la base de données
assureetassure_ownerdevraient exister - La base de données cible doit être créée
Mise en place des médias
- 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 certificat comme suit :
nginx.crtnginx.key
Instance Keycloak
Cet installateur nécessite un configuration externe de Keycloak. Assurez-vous d'avoir les informations suivantes :
- URL : par ex.,
https://auth.deque.com - Domaine : par ex.,
axe - ID Client
- ID Groupe
- Secret Client
Installation
Configuration du rapport Axe
Modifiez le fichier .env :
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-1Cherchez la ligne :
Starting axe Auditor…Une fois visible, vous pouvez procéder 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 sauvegardez 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'administrateur 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 non coché par défaut
(sauf spécification du client)
Mise à jour de la version axe Core et de la norme d'accessibilité
- Mettez à jour le version axe-core vers le dernière recommandée
- Réglez Norme d'accessibilité par défaut sur WCAG 2.1 Niveau AA
- Sélectionnez toutes les normes d'accessibilité
Afficher la carte de score d'accessibilité
- Devrait être coché ou selon les préférences du client
Mettre à jour les paramètres des rapports axe
Si rapports axe a été activé lors de l'installation :
- Réglez l'option Mettre à jour les rapports axe sur :
System Administrator only
Vérification par à QA et PME
- 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 sanitaire
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