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 une capture complète 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 vivement de ne poursuivre 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 :

Docker Engine
Docker Compose / Podman Compose
psql client
CreateSSOCustomers.py le script devrait 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é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 dans :

axeauditor-docker/volumes/nginx/ssl

Renommez vos fichiers de certificat en :

nginx.crt
nginx.key

Instance Keycloak

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

URL : p. ex., https://auth.deque.com
Royaume : p. ex., axe
ID Client
ID Groupe
Secret Client

Installation

Configuration du Rapport Axe

Éditez le .env fichier :

vi axeauditor-docker/.env

Migration de la base de données

Accédez au dossier DB
Modifiez auditor_db_deploy.sh pour définir les variables correctes
(Remarque : l'utilisateur de la base de données 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 suivante :

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

Configuration d'un nouveau client d'audit

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

Activer le paramètre de partage du test

Allez à la page **Paramètres administrateur**
Assurez-vous que **Activer le partage du test** est **désactivé par défaut**
(sauf indication du client)

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

Mettre à jour la **version axe-core** à la **dernière recommandée**
Définir la **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é

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

Mettez à 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 le contrôle qualité 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 l'IU de base
Demandez à l'équipe QA d'effectuer une vérification

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